# AGENTS.md : les règles de votre agent

> Kit offert par Hugo, L'IA faite pour vous (iafaitepourvous.fr). Copiez ce fichier à la racine de votre
> projet et remplacez les lignes entre < >. Codex le lit tout seul. Pour Claude Code, créez à côté un
> fichier CLAUDE.md qui contient une seule ligne : @AGENTS.md

## Le projet

<En 3 lignes : ce que fait le projet, et pour qui. Pas son histoire.>

## Ce que tu fais seul, ce que tu me demandes

- **Seul :** tout ce qui se défait facilement. Modifier un fichier, lancer les tests, enregistrer ton
  travail sur une branche à part.
- **Tu me demandes d'abord :** supprimer un fichier ou des données, mettre en ligne, payer, écrire à
  quelqu'un, toucher à un compte ou à un réglage en ligne.

## Avant de dire « c'est fait »

- Lance ce que tu as changé et regarde le résultat. Une explication n'est pas une preuve.
- Dis en une ligne ce que tu as vérifié et ce que tu n'as pas vérifié.
- Un échec se dit avec sa ligne d'erreur, sans l'enrober.

## Avant de corriger un bug

- Trouve la cause et montre-la avant de changer le code.
- Écris d'abord un test qui échoue à cause du bug, puis corrige, puis montre le test qui passe.

## Mise en ligne

- Jamais directement sur la branche principale : une branche, puis une demande de fusion.
- Mise en ligne seulement si les contrôles passent, dans la même commande :
  `npm test && <commande de mise en ligne>`. Le `&&` arrête tout si un test échoue.
- Chaque mise en ligne a sa commande de retour arrière, écrite dans HANDOFF.md avant de lancer.

## Secrets

- Les clés et les mots de passe vivent dans un fichier `.env`, listé dans `.gitignore` : jamais dans le
  code, jamais dans git, jamais affichés dans la conversation.

## Les commandes du projet

| Faire | Commande |
|---|---|
| Lancer en local | <…> |
| Lancer les tests | <…> |
| Mettre en ligne | <…> |

## Les pièges connus

- <Ce qui a déjà cassé, et ce qui l'évite. Deux lignes après chaque incident.>

## Fin de séance

- Mets à jour HANDOFF.md : la prochaine action, ce qui reste ouvert, ce qui bloque, le retour arrière.
- La séance suivante commence par la lecture de HANDOFF.md, et toi aussi quand ta mémoire a été
  compressée.
