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.

AGENTS.md

# 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.