1

Vue d'ensemble

Comprendre la méthode en 2 minutes avant de commencer.

Cette méthode structure la façon dont un développeur travaille avec Claude Code CLI au quotidien. Au lieu de tout réexpliquer à chaque session, on organise le projet en dossiers clés que Claude consulte automatiquement.

Les 3 principes fondamentaux
A

Contexte persistant

Le projet contient des dossiers /agents, /constraints, /context… Claude les lit en début de session. Fini de réexpliquer le projet à chaque fois.

B

Un rôle par intervention

À chaque tâche, un seul agent est actif : agent_debugger, agent_reviewer… On ne mélange pas les rôles dans un même prompt.

C

Validation avant modification

Claude annonce ce qu'il va faire, propose un diff, et attend ton accord explicite avant de toucher quoi que ce soit.

💡 Les prompts doivent être rédigés en anglais — Claude est nettement plus précis et économe en tokens dans cette langue.
2

Installation

Mettre en place Claude Code CLI dans un projet existant ou nouveau.

Prérequis
1

Cloner ou créer le projet

Récupère ton projet ASP.NET existant ou crée-en un nouveau. La méthode fonctionne avec tout type de projet.

2

Initialiser Claude Code

À la racine du projet, lance la commande d'initialisation :

# À la racine du projet
npx claude
3

Créer l'arborescence agents

Crée les dossiers à la racine du projet. Voir l'étape suivante pour le détail.

4

Utiliser Claude.ai pour préparer les prompts

Avant d'exécuter dans le CLI, formule ton prompt depuis l'interface Claude.ai en te positionnant toujours comme prompt engineer. Colle ensuite le résultat dans le terminal.

⚠️ Utilise Claude open source (claude.ai) pour préparer les prompts et éviter le gaspillage de tokens dans le CLI.
3

Arborescence du projet

Les dossiers à créer à la racine et le rôle de chacun.

🤖

/agents

Qui intervient et comment il raisonne. Un fichier par rôle.

🛡️

/constraints

Règles absolues que tous les agents respectent. Toujours.

🗺️

/context

Ce que Claude doit savoir sur le projet. Chargé une fois, jamais réécrit.

🔧

/tools

Commandes et requêtes SQL prêtes à l'emploi par environnement.

🕒

/sessions

Logs horodatés. Chaque session démarre en lisant le dernier log.

⚠️

/errors

Bugs connus, symptôme + cause + solution. On ne résout pas deux fois.

📋

/decisions

Architecture Decision Records. Traçabilité des choix techniques.

👁️

/reviews

Rapports de code review horodatés avec statut de résolution.

Détail des fichiers clés
/agents _orchestrator.md # Point d'entrée de chaque session agent_architect.md # Conception, choix techniques agent_backend_dev.md # Implémentation C#/ASP.NET/Web API agent_debugger.md # Debug, analyse de flux, rapport agent_reviewer.md # Code review senior agent_sql.md # T-SQL, schéma BDD, migrations agent_session_logger.md# Génère les logs de fin de session /constraints _global.md # Invariants absolus — chargé toujours validation_rules.md # Plan avant code, diff avant modif readonly_context.md # Fichiers/BDD en lecture seule code_style.md # Conventions C#, nommage /context project_overview.md # Présentation projet + stack domain_glossary.md # Vocabulaire métier db_schema.md # Tables, colonnes, relations integrations.md # Contrats avec systèmes externes /sessions _template.md YYYY-MM-DD_[feature].md _README.md init_session.md
💡 Commence par constraints/_global.md puis context/project_overview.md. Ce sont les deux fichiers les plus importants à rédiger en premier.
4

Rédiger un prompt efficace

La structure d'un bon prompt — toujours en anglais, toujours ancré.

Structure en pile

Un bon prompt se construit couche par couche. Chaque couche répond à une question précise.

prompt structure
[WHO YOU ARE]→ agents/agent_debugger.md
[WHAT YOU KNOW]→ context/project_overview.md
context/db_schema.md
[WHAT YOU FOLLOW]→ constraints/_global.md
constraints/db_rules.md
[TOOLS YOU USE]→ tools/gorecep_inspect.md
[WHAT WE DID]→ sessions/2026-06-23_etat.md
[YOUR MISSION]→ Ton prompt spécifique ici
Exemple concret — bon vs mauvais
❌ Vague
"Analyse le code en tant que développeur senior"

Pas de rôle précis, pas de contraintes, pas de livrable attendu. Claude improvise.

✅ Ancré
# En anglais dans le CLI
You are agent_reviewer.md
Follow: constraints/_global.md + constraints/validation_rules.md
Context: context/project_overview.md

Produce a structured report:
- ✅ What works correctly
- ❌ What is problematic
- 🔧 Fix proposed as diff

One point at a time. Wait for my validation between each.
💡 Prépare toujours le prompt sur Claude.ai en te positionnant comme prompt engineer, puis colle-le dans le terminal CLI. Tu gagnes en précision et tu évites le gaspillage de tokens.
5

Démarrer une session

Les 3 fichiers à toujours charger avant tout autre chose.

Claude n'a pas de mémoire entre les sessions. Ces 3 fichiers reconstituent le contexte complet en quelques secondes. 

# Début de chaque session — coller dans npx claude

Read these files before doing anything:
- context/project_overview.md
- constraints/_global.md
- sessions/[last_log].md

Do not propose anything until you confirm reading these 3 files.
Un seul agent à la fois
→

L'orchestrateur sélectionne

Décris ta tâche à _orchestrator.md. Il choisit quel agent activer et quelles contraintes charger.

→

Un agent, une mission

Ne jamais charger plusieurs agents simultanément. Chaque intervention est ciblée sur un rôle précis et un livrable défini.

→

Validation avant modification

Claude annonce ce qu'il va faire. Tu réponds "ok", "vas-y" ou "confirme". Il propose un diff — jamais le fichier complet.

✅ Le fichier init_session.md à la racine du projet contient ce prompt de démarrage pré-rempli. Copie-colle, c'est tout.
6

Logger la session

Ne jamais fermer sans enregistrer ce qui a été fait.

En fin de session, une commande suffit. L'agent génère le log automatiquement dans le bon format et au bon endroit. 

# Taper en fin de session
/log this session
Format du log généré
## 2026-06-23 — etat_extension

### Done
- Added Etat column to UrgencyExtension table
- Implemented POST /api/Urgency_UpsertExtension

### Modified files
- api_urgency.cs
- urgencyService.cs
- db_schema.md (updated)

### Decisions made
- Etat is nullable int — null means no state set

### Pending
- GFL side: Nicolas to add select in popup

### Next action
- Test endpoint with Postman using api_test_calls.md
💡 La prochaine session commence en chargeant ce fichier. Claude sait exactement où tu t'étais arrêté sans que tu aies à réexpliquer quoi que ce soit.
7

Erreurs à éviter

Les pièges les plus fréquents et comment les corriger.

❌ Erreur fréquente ✅ Ce qu'il faut faire
Charger plusieurs agents en même temps Un seul agent actif par session
Oublier de préciser les contraintes Toujours référencer constraints/_global.md
Laisser Claude modifier sans validation Forcer le diff + confirmation explicite
Fermer sans logger la session /log this session systématique en fin
Réexpliquer le projet à chaque session S'appuyer sur context/project_overview.md
Prompt vague sans livrable attendu Toujours préciser le format de sortie attendu
Écrire les prompts en français dans le CLI Rédiger en anglais — Claude est plus précis
Demander "analyse tout le dossier" Cibler les fichiers pertinents uniquement
★

La règle d'or

Ce qu'il faut retenir si on ne retient qu'une seule chose.

Règle d'or

Un bon prompt = 1 agent + contraintes applicables + contexte minimal suffisant + livrable attendu précis

Récapitulatif de la méthode
1

Crée l'arborescence une fois

Agents, contraintes, contexte, outils, sessions, erreurs. Remplis _global.md et project_overview.md en premier.

2

Prépare chaque prompt sur Claude.ai

Interface web pour formuler, CLI pour exécuter. Toujours en anglais.

3

Démarre chaque session avec les 3 fichiers

project_overview + _global + dernier log de session.

4

Valide avant chaque modification

Claude annonce → tu confirmes → diff uniquement.

5

Log en fin de session

/log this session — la prochaine session repart exactement d'ici.

✅ Cette méthode fonctionne pour tout type de projet. Elle s'adapte à ton équipe en ajoutant des agents, des contraintes, et du contexte spécifiques à ton domaine.