TIL : un AGENTS.md par sous-dossier remplace les instructions répétées

OpenCode (et la plupart des agents) lit les fichiers CLAUDE.md ou AGENTS.md en remontant l’arborescence depuis le fichier actif. Un fichier dans src/Service/AGENTS.md est lu en plus du fichier racine quand l’agent travaille dans ce dossier.

monprojet/
├── AGENTS.md           ← conventions globales du projet
├── src/
│   ├── Service/
│   │   └── AGENTS.md   ← conventions spécifiques aux services Symfony
│   └── ApiResource/
│       └── AGENTS.md   ← conventions API Platform
└── tests/
    └── AGENTS.md       ← conventions de test PHPUnit

# src/Service/AGENTS.md

- Les services sont final par défaut
- Injection via constructeur uniquement (pas de setter injection)
- Pas de logique métier dans le constructeur
- Les méthodes publiques de plus de 20 lignes sont à découper

En pratique, ça évite de répéter les conventions de chaque couche dans chaque prompt. L’agent les connait dès qu’il ouvre un fichier dans ce répertoire.