Normes stockées dans le serveur¶
Les normes de développement vivent dans le serveur, pas dans les dépôts.
Cette page explique ce que cela change, et comment y renvoyer un agent depuis AGENTS.md.
Ce que le serveur conserve¶
- Les normes sont stockées en base, comme les règles. Elles ne sont pas dans votre dépôt.
- Un administrateur les écrit dans l'écran Normes de l'interface web. Il peut aussi les importer depuis un fichier TOML.
- Chaque norme indique ses technologies et ses motifs de fichiers (
*.py,angular.json). - Tous les projets reçoivent les mêmes normes. Une mise à jour s'applique tout de suite à tous les agents.
Avantage : vous écrivez vos conventions une fois, pour toute l'organisation. Chaque dépôt n'a plus besoin de les recopier.
Comment en parler dans AGENTS.md¶
- Ne recopiez pas les normes dans
AGENTS.md. Elles divergeraient vite. - Dites à l'agent de les demander au serveur avant de coder.
- Citez les outils et ressources utiles :
get_development_standards,list_development_standards,standard://{slug}. - Gardez dans
AGENTS.mdce qui est propre au dépôt : commandes de test, structure, exceptions locales. - En cas de conflit, dites qui gagne. Par exemple : «
AGENTS.mdprévaut sur les normes du serveur ».
Exemple de section :
## Conventions de code
Les normes de développement sont fournies par le serveur MCP `security-review`.
Consultez-les avant d'écrire du code :
- outil `get_development_standards` (par technologie ou par fichier) ;
- outil `list_development_standards` pour voir le catalogue ;
- ressource `standard://python` pour lire une norme précise.
Ce fichier ne garde que les règles propres à ce dépôt. En cas de conflit, il prévaut.
Une norme ne peut jamais affaiblir la sécurité. Si c'est le cas, l'agent garde le comportement sûr et signale le conflit.