DLN.

Préparez votre codebase pour les agents

Préparez votre codebase pour les agents
English English Español Español Français Français

Vous êtes submergé par les outils de code IA en ce moment. Claude Code, Cursor, Aider, AMP, Droid—peut-être que vous les utilisez tous en même temps. J’y suis passé exactement comme vous. Et voici le problème : chaque outil veut sa propre façon de charger les règles, compétences et commandes.

Le résultat ? De la duplication partout. Les mêmes instructions éparpillées dans cinq dossiers de config différents. Croyez-moi, c’est un cauchemar.

Laissez-moi vous montrer comment j’ai réglé ça.

Le Problème

Imaginez, mon ami. Vous écrivez une directive de code une fois. Puis vous la copiez dans .claude/, dans .cursor/, dans .aider.conf.yml. Une semaine plus tard, vous mettez à jour l’original. Maintenant vos configs sont complètement désynchronisées.

Ce n’est pas viable. Et vous le savez.

Vous avez besoin d’une seule source de vérité pour toutes vos instructions d’agents. Un seul endroit. Pas cinq.

La Solution

Voici ce qui fonctionne vraiment : un seul fichier AGENTS.md à la racine de votre projet, plus un répertoire agents/ pour le contenu modulaire.

Pensez à AGENTS.md comme l’index. La table des matières. Le patron. Chaque outil pointe vers lui.

agents/
├── rules/
│   ├── python.md
│   ├── nextjs.md
│   ├── security.md
│   └── ...
├── skills/
│   ├── testing.md
│   ├── infrastructure.md
│   ├── refactoring.md
│   └── ...
├── commands/
│   ├── fix-tests.md
│   ├── fix-linter.md
│   ├── add-feature.md
│   └── ...
└── scripts/
    ├── parse_test_coverage.py
    ├── run_linter_fix.sh
    └── ...

Votre AGENTS.md devient le hub central :

  • Instructions obligatoires en haut
  • Sections pour règles, compétences, commandes avec références style @ où c’est supporté
  • Guide de chargement clair (“Toujours charger rules/python.md pour les fichiers Python”)

Maintenant, configurons chaque outil pour pointer ici. Je vais vous guider à travers chacun d’eux.

Configuration des Outils

La Bonne Nouvelle D’abord

Voici quelque chose qui va vous simplifier la vie. Beaucoup d’outils supportent maintenant les compétences compatibles Claude (le format .claude/skills/) :

  • OpenCode
  • AMP
  • Cursor

Pourquoi c’est important ? Parce que vous pouvez partager les fichiers de compétences entre eux avec des changements minimes. Un format, plusieurs outils. Écrivez une fois, utilisez partout.

Claude Code

Docs : Skills • Changelog

Répertoire : .claude/

État (2026) : Les commandes slash et les compétences sont maintenant unifiées (v2.1+). Vos fichiers de commandes existants fonctionnent toujours.

Créez .claude/skills/my-skill/SKILL.md :

---
description: Brief purpose of this skill
user-invocable: true           # optional: show in / menu
---

# My Skill

Follow the relevant instructions in `AGENTS.md` (usually under /skills/ or /commands/).
Load matching content from agents/ when the task matches.

Et votre CLAUDE.md (ou mieux, utilisez AGENTS.md directement) :

## Mandatory

- **ALWAYS** read and follow `AGENTS.md` at the project root before any action.
- For language-specific rules, load from `agents/rules/`.
- For task patterns, reference `agents/skills/` or `agents/commands/`.

OpenCode

Docs : Rules • Skills • Commands

Répertoire : Racine du projet (pas de dossier obligatoire)

OpenCode préfère déjà AGENTS.md nativement. Il se rabat sur CLAUDE.md si besoin. C’est la config la plus facile que vous verrez aujourd’hui.

Vous voulez inclure plus de fichiers automatiquement ? Créez opencode.json :

{
  "$schema": "https://opencode.ai/config.json",
  "instructions": [
    "AGENTS.md",
    "agents/rules/*.md"
  ]
}

Terminé. C’est tout.

AMP

Docs : Agent Skills • Custom Commands

Répertoire : .agents/

Créez .agents/skills/my-skill/SKILL.md (format compatible Claude) :

---
description: [your description]
---

# My Skill

Read and follow instructions in `AGENTS.md` — usually under agents/skills/.

Pour les commandes, utilisez .agents/commands/my-command-name.md :

---
name: my-command-name
description: [brief description]
---

# My Command

Follow the matching section in `AGENTS.md`.

Aider

Docs : Config Reference

Fichier : .aider.conf.yml (ou ~/.aider.conf.yml)

C’est la config la plus simple de toutes. Je suis sérieux :

read:
  - AGENTS.md
  - agents/rules/python.md     # optional: include specific rules

Aider charge ces fichiers dans le contexte automatiquement. Boom. C’est fait.

Droid

Docs : Skills • Custom Slash Commands

Répertoire : .factory/

Créez .factory/skills/my-skill/SKILL.md :

---
description: [your description]
---

# My Skill

Refer to `AGENTS.md` for detailed instructions (agents/skills/ section).

Les commandes fonctionnent de la même manière dans .factory/commands/.

Cursor

Docs : Rules • Skills • Commands

Répertoire : .cursor/

Voici l’astuce avec Cursor : il charge automatiquement AGENTS.md quand il est présent. Pas de config nécessaire. Zéro effort.

Mais si vous voulez être absolument sûr que vos règles s’appliquent toujours, créez .cursor/rules/general.mdc :

---
description: Core project instructions — always apply
alwaysApply: true
---

## Mandatory Instructions

- **ALWAYS** read `AGENTS.md` at project root.
- Load relevant rules from `agents/rules/` based on file type.
- Use `@agents/skills/...` syntax to reference skills when applicable.

Les compétences et commandes suivent le format compatible Claude.

Antigravity

Docs : Rules & Workflows • Skills

Répertoire : .agent/ (projet) ou global ~/.gemini/

Créez .agent/rules/general.md :

---
description: Always read this before anything
trigger: always_on
---

## Core Rules

- **ALWAYS** read `AGENTS.md`.
- Reference `agents/` subfolders as needed.

Les compétences utilisent le format standard dans .agent/skills/my-skill/SKILL.md.

Conseils Qui Comptent Vraiment

Laissez-moi partager ce que j’ai appris à la dure.

Gardez AGENTS.md sous 400-500 lignes. La pression de contexte est réelle. Votre IA ne peut garder qu’une quantité limitée d’informations en mémoire de travail avant que les choses ne deviennent floues.

Utilisez les titres Markdown et les ancres. Pourquoi ? Parce que ça facilite énormément le référencement de sections spécifiques. Votre futur vous vous remerciera.

Pour les équipes : committez agents/ et AGENTS.md dans git. Envisagez des symlinks ou sous-modules pour les règles partagées entre projets. C’est comme ça qu’on scale.

Testez votre config. Demandez à chaque outil “Explique les règles du projet” et vérifiez qu’il référence AGENTS.md. S’il ne le fait pas, votre config est cassée. Réparez-la maintenant.

Et s’il vous plaît—ne mettez jamais de secrets dans ces fichiers. Je ne devrais pas avoir à le dire, mais je l’ai vu arriver. Utilisez des variables d’environnement ou des vaults sécurisés. Toujours.

Le Bénéfice

Un seul endroit pour toutes vos instructions d’agents. Mettez à jour une fois, chaque outil le récupère.

Plus de duplication. Plus de dérive. Plus de chaos.

C’est ça. C’est comme ça que ça devrait fonctionner.