CLAUDE.md et AGENTS.md

Définition

Fichiers Markdown lus par l'agent en début de session pour connaître le projet : commandes de build et de test, conventions, architecture, interdits. AGENTS.md est un format ouvert adopté par plus de 60 000 dépôts et plus de 25 outils (Codex, Cursor, Copilot, Jules, Devin, Zed…). CLAUDE.md est le fichier de Claude Code, hiérarchisé (~/.claude/CLAUDE.md, ./CLAUDE.md, CLAUDE.local.md, .claude/rules/) ; Claude Code lit aussi AGENTS.md.

Analogie

Le README écrit pour le nouveau collègué robot : où sont les choses, comment on teste, ce qu'on ne touche pas.

Exemple de code

# CLAUDE.md (racine du dépôt) — concis, vérifiable, une consigne par ligne
# Projet
- Monorepo pnpm : apps/api (NestJS), apps/web (Next.js), packages/shared
# Commandes
- Tests : `pnpm test` (Vitest) — toujours les lancer avant de proposer un diff
- Lint  : `pnpm lint --fix`
# Conventions
- TypeScript strict, pas de `any`, erreurs métier via `DomainError`
- Migrations SQL dans apps/api/migrations, jamais de `DROP` sans revue
# Interdits
- Ne jamais modifier `.env*` ni committer de secret
@docs/architecture.md

Cas d'usage

Tout dépôt sur lequel travaille un agent : réduit les erreurs répétées et les questions.

Anti-pattern

Termes liés

Sources

• agents.md/
• code.claude.com/docs/en/memory