Mon AGENTS.md commenté
Le fichier de règles global que je donne à mes agents, pour tous mes projets, avec le pourquoi de chaque règle.
# Agent rules
## Process
- Plan first on non-trivial work (3+ steps).
> pourquoi : sans plan, l’agent part dans tous les sens.
- Verify before done: tests, logs, diff.
> pourquoi : « ça compile » ne veut pas dire « ça marche ».
- After a correction, add a rule to tasks/lessons.md.
- Never --no-verify. Prefer trash over rm -rf.
« Je ne code plus du tout. Je cadre, mes agents exécutent dans l’app Claude. »
Le truc qui change tout, ce n’est pas le modèle, c’est ce fichier, lu en premier par tous mes agents. Un seul fichier pour tous mes projets. Dans l’app Claude, il va dans ~/.claude/CLAUDE.md. Sans ça l’agent improvise, avec ça il suit ton process.
4 règles, et pourquoi
Plan d’abord
Sans plan, l’agent part dans tous les sens sur un petit changement.
Vérifier avant de dire fini
Tests, logs, diff de comportement : ça évite le « ça compile donc c’est bon ».
Une correction = une leçon
Tu l’écris dans tasks/lessons.md, relue à chaque session. Sinon tu re-corriges la même chose chaque semaine.
Jamais --no-verify
trash plutôt que rm -rf : les agents adorent contourner les hooks, et un agent qui efface est dangereux.