Charte d'équipe pour les agents
Une page lisible par les humains qui fixe l'usage des agents dans l'équipe : autonomie, interdits, qui fusionne les PR, quand rejouer les tests. Elle renvoie vers AGENTS.md et les hooks.
- charte
- équipe
- merge
- fusion
- onboarding
- contributing
Syntaxe
Document humain (CONTRIBUTING.md ou wiki d'équipe), une page au maximum : - Autonomie : quand passer par un plan - Interdits, et où ils sont appliqués (deny, hooks) - Fusion : toujours par un humain, jamais par l'agent - Tests golden : quand les rejouerRenvois : AGENTS.md (pour l'agent), .claude/settings.json, hooks, skillsExemple
## Agents de code : règles de l'équipe- Plan obligatoire au-delà de 3 fichiers ou pour l'authentification- Interdits : lire .env, push forcé, commit par l'agent (bloqués dans settings.json)- Toute PR produite avec un agent est relue et fusionnée par un humain- Tests golden rejoués avant chaque démonstration et après chaque changement de configurationRésultat attendu : un nouvel arrivant sait en deux minutes ce qu'il peut déléguer.À retenir
- Test du clone : un nouvel équipier doit être correctement cadré par le dépôt seul, sans connaître les règles personnelles des autres.
- Les agents qui travaillent dans le cloud ou relisent les PR automatiquement ne vous demandent pas de confirmation : leur configuration doit être versionnée et relue avant activation.
- Quand un même débordement se répète (fichiers hors périmètre, tests affaiblis), traduisez-le en rule, en skill ou en hook plutôt qu'en rappel oral.
- Piège : une charte de dix pages. Personne ne la lit ; au-delà d'une page, déplacez le détail dans AGENTS.md ou dans les skills.
Voir aussi
- Les 5 tâches goldenCinq tests binaires rejoués après chaque changement de rules, de hooks ou de modèle : trois tâches que l'agent doit réussir, deux interdits qu'il doit refuser. Le refus compte comme une réussite.
- Brief de sessionUn agent travaille comme un prestataire : il lui faut un but, ce qui est hors périmètre, les fichiers concernés et un critère de fin observable. « Améliore la landing » n'est pas un brief.
- Rules et AGENTS.mdAGENTS.md et les rules sont des instructions lues à chaque session : stack, arborescence, commandes, conventions et interdits. Ils évitent de réexpliquer le projet à chaque nouvelle demande.
- Confidentialité des donnéesCe que vous collez dans un chatbot quitte votre poste : selon l'offre, ce peut être conservé, relu ou utilisé pour l'entraînement. On choisit donc l'outil d'après la sensibilité des données.