Gabarit AGENTS.md pour les équipes d'ingénierie

Un seul fichier à la racine de ton repo, lu par l’agent à chaque tâche. Nomme-le AGENTS.md, ou CLAUDE.md pour Claude Code. Six sections, courtes.

🃏 Pourquoi chaque section compte

Touchez une carte pour la retourner

De quoi il s'agitUn paragraphe de contexte pour que l'agent sache ce que fait le système et qui l'utilise avant de toucher à quoi que ce soit.CommandesLes commandes exactes pour installer, tester, linter et vérifier les types. Sans elles, l'agent devine, et deviner gaspille des tours.ArchitectureUne carte des dossiers principaux et des frontières, pour que le nouveau code atterrisse à la bonne place plutôt qu'au plus proche.ConventionsNommage, gestion des erreurs, journalisation, bibliothèques à privilégier. L'agent imite ce qu'il voit : dis-lui quoi imiter.Garde-fousCe qu'il ne faut jamais modifier et ce qu'il faut demander avant. Chaque ligne évite une erreur que tu as déjà payée une fois.Définition de « terminé »Les vérifications qu'un changement doit passer avant que l'agent le déclare fini. « Ça a l'air fini » devient « c'est fini ».

🎮 Dans le AGENTS.md ou pas?

1 / 10 · Pointage: 0

Est-ce que cette ligne mérite sa place dans un fichier que l'agent lit à chaque tâche?

Ça va dedansOn laisse faire

Suivant →

/ 10

↺ Recommencer

Le gabarit

# Projet : <nom>

## De quoi il s'agit
Un paragraphe : ce que fait le système et qui l'utilise.

## Commandes
- Installation : `...`
- Serveur de dev : `...`
- Tests : `...` (lancer un seul test : `...`)
- Lint / vérification des types : `...`

## Architecture
- `src/api/` — ...
- `src/domain/` — ...
Les frontières clés et où le nouveau code doit aller.

## Conventions
- Nommage, gestion des erreurs, patrons de journalisation à suivre.
- Les bibliothèques à privilégier, et celles à éviter.

## Garde-fous
- Ne jamais modifier : fichiers générés, migrations déjà appliquées, ...
- Demander avant : d'ajouter des dépendances, de changer des API publiques, ...

## Définition de « terminé »
- Tests ajoutés ou mis à jour, et qui passent.
- Lint et vérification des types sans erreur.

Remplis-le

✅ Ta première version

0 / 9 complété

• Écrire un paragraphe sur ce que fait le système et qui l'utilise
• Coller les commandes exactes d'installation, de dev, de test et de lint
• Ajouter comment lancer un seul test
• Lister les dossiers principaux et ce que contient chacun
• Noter deux ou trois conventions que l'agent doit imiter
• Ajouter au moins un garde-fou « ne jamais modifier » et un « demander avant »
• Définir « terminé » : tests, lint et vérification des types
• L'enregistrer à la racine du repo sous AGENTS.md ou CLAUDE.md
• Donner une petite tâche à un agent et vérifier qu'il a suivi le fichier

↺ Réinitialiser

Comment l’utiliser

1. 1

   Jour 1

   Commence par les commandes

   Remplis la section des commandes en premier. C'est elle qui évite le plus de tours perdus.

2. 2

   En continu

   Fais grandir les garde-fous

   Ajoute un garde-fou chaque fois qu'un agent fait la même erreur deux fois.

3. 3

   Chaque trimestre

   Révise-le

   Révise le fichier chaque trimestre, comme n'importe quelle documentation. Coupe ce qui est périmé.