Construire un cerveau IA pour votre travail de dev

La plupart des gens utilisent les outils de codage IA avec l'amnésie activée. Chaque session repart de zéro : réexpliquer le projet, réexpliquer les conventions, regarder l'outil refaire la même erreur que la semaine dernière.

La solution n'est pas un meilleur prompt. C'est un cerveau : un petit ensemble de fichiers texte que votre IA lit au début de chaque session. Je fais tourner mon studio là-dessus. Voici la configuration complète.

Les trois couches

1. Instructions — un fichier CLAUDE.md qui dit qui vous êtes, comment vous travaillez et ce que l'outil ne doit jamais faire. Lu automatiquement à chaque début de session.
2. Mémoire — un fichier par fait que l'IA doit retenir d'une session à l'autre : état du projet, décisions, corrections que vous avez faites.
3. Compétences — des guides réutilisables pour les tâches qui reviennent : votre processus de déploiement, vos conventions de design, votre liste de revue.

Le tout en markdown, versionné dans git. Aucune dépendance à un fournisseur, aucune base de données.

Couche 1 : le fichier d'instructions

Créez un CLAUDE.md à la racine de votre projet (ou ~/.claude/CLAUDE.md pour des règles globales). Court et direct. Le mien impose entre autres : vérifier avant de déclarer terminé, ne jamais commettre de fichiers sans lien, commencer par la réponse.

Gabarit à copier-coller :

# Règles de travail

## Vérification — non négociable
- Ne jamais déclarer une tâche terminée avant que le typecheck et le lint passent.
- Écrire un fichier n'est pas un succès. Le code doit compiler.

## Discipline git
- Une fonctionnalité par branche. Commits ciblés : ajouter les fichiers exacts, jamais `git add .`
- Ne jamais pousser sans exécuter la liste de contrôle du projet.

## Discipline de sortie
- Commencer par le résultat. Pas de remplissage, pas de reformulation de la question.
- Quand la réponse tient en une ligne, donner une ligne.

## Faits du projet
- Stack : [votre stack]
- Commandes : typecheck `npx tsc --noEmit`, lint `npx eslint . --quiet`, test `npm test`

La dernière section compte le plus : des commandes que l'IA peut exécuter pour vérifier son propre travail. Ce seul bloc élimine la moitié de la surveillance.

Couche 2 : les fichiers de mémoire

Un fichier par fait, plus un index. L'index est chargé à chaque session; les mémoires individuelles sont consultées au besoin. Structure :

memory/
  MEMORY.md              <- index : une ligne par mémoire
  limites-api.md         <- un fait
  portee-client-x.md     <- un fait

Chaque fichier de mémoire :

---
name: limites-api
description: Notre fournisseur plafonne à 100 req/min — regrouper en conséquence
type: project
---

Le fournisseur de paiement limite à 100 requêtes/minute.
Pourquoi : atteint en production le 2026-05-02.
Comment appliquer : regrouper les relances de webhooks, jamais de boucle sans limitation.

La règle qui fait fonctionner le système : après chaque correction, écrire une mémoire. Si vous avez dit une fois à l'IA « non, ici on utilise des tabulations », cette phrase appartient à un fichier, pas à votre patience.

Couche 3 : les compétences

Une compétence est un guide markdown que l'IA charge quand une tâche correspond. Conventions de design, étapes de déploiement, listes de revue — tout ce que vous réexpliqueriez autrement.

---
name: gout-design
description: À invoquer avant tout travail d'interface — typographie, espacement, règles de mouvement
---

## Typographie
- Texte courant : maximum 65 caractères par ligne
- Gras pour l'emphase, jamais d'italique. Souligné réservé aux liens.

## Mouvement
- N'animer que transform et opacity. Rester sous 300 ms.
- Toujours respecter prefers-reduced-motion.

Claude Code les détecte automatiquement dans .claude/skills/. Dix compétences courtes valent mieux qu'un document géant : l'IA ne charge que ce dont la tâche a besoin.

Les sous-agents : le multiplicateur

Pour les grosses tâches, ne laissez pas une seule session tout faire. Faites dispatcher des sous-agents par la session principale : un explore le code, un implémente, un fait la revue. Chacun reçoit un contexte propre et une seule mission. La session principale reste le chef d'orchestre et garde la vue d'ensemble.

Règle pratique : la recherche et l'exploration vont aux sous-agents, les décisions restent avec vous et la session principale.

Commencez aujourd'hui, petit

1. Écrivez un CLAUDE.md de 20 lignes avec vos commandes de vérification.
2. Créez memory/MEMORY.md, vide.
3. À la prochaine correction que vous faites à votre IA, sauvegardez-la comme fichier de mémoire.

Cette boucle — corriger une fois, retenir pour toujours — c'est tout le cerveau. Le reste n'est que du raffinement.