Travailler avec Claude Code sur un vrai projet : contexte, plan, revue
Contexte et CLAUDE.md, exploration et plan avant le code, permissions, hooks et workflow de revue en place sur votre dépôt.
Passer de « je demande et j'espère » à un cadre de travail fiable avec Claude Code sur un dépôt qui compte : de l'argent, des données, des utilisateurs. Vous apprenez à gérer ce que l'agent a en tête (contexte, CLAUDE.md, sessions), à conduire une tâche en explorant et en planifiant avant de coder, à choisir entre subagent, skill, serveur MCP et hook, à régler ses permissions, à poser des garde-fous qui s'appliquent à coup sûr et à relire son travail avant qu'il parte. Vous repartez avec CLAUDE.md, permissions, hooks et workflow de revue en place sur votre dépôt.
Ce que vous saurez faire
- Expliquer ce qui occupe la fenêtre de contexte de Claude Code et la gérer (/context, /clear, /compact, reprise et nommage de sessions), en tenant compte du coût.
- Rédiger un CLAUDE.md court et utile, placé au bon niveau de la hiérarchie (utilisateur, projet, local, sous-dossier, règles par chemin), avec des imports si besoin.
- Conduire une tâche sur un code existant en explorer, planifier, coder, commiter, avec le mode plan, des critères de vérification et Git plutôt que les seuls points de restauration.
- Choisir et justifier le bon mécanisme pour un besoin (CLAUDE.md, skill ou commande, subagent, serveur MCP, hook) et l'installer dans le dépôt.
- Choisir un mode de permission et écrire des règles allow, ask et deny adaptées au risque du projet, dans le bon fichier de réglages.
- Écrire des hooks simples comme garde-fous déterministes (bloquer, formater, vérifier) et en connaître les risques et les limites.
- Relire le travail de l'agent avec une checklist (périmètre, tests, secrets, migrations, dépendances) et une revue indépendante, et savoir quand l'automatiser en mode non interactif ou dans GitHub Actions.
Prérequis
- Avoir déjà construit quelque chose avec Claude Code : une app comme celle du cours « Construire et mettre en ligne une app web avec un agent de code IA », idéalement enrichie dans « Ajouter une base de données, l'authentification et le paiement à son app »
- Savoir lancer une commande dans un terminal, lire un diff et faire un commit
- Outils : Claude Code (plan Claude payant, Pro ou supérieur, ou compte API), Git, un dépôt GitHub. Sans Claude Code, une partie du livrable reste faisable : le CLAUDE.md devient un AGENTS.md (que Claude Code lit aussi en l'absence de CLAUDE.md) ou les règles de votre agent, les garde-fous deviennent des hooks Git (pre-commit) et une protection de branche, et la checklist de revue sert telle quelle ; les permissions, hooks Claude Code, subagents, /code-review et le mode plan, eux, demandent Claude Code
- Cours liés : « Créer des Claude Skills fiables pour votre travail produit » pour les skills en profondeur, « Git pour les PM : livrer en équipe sans risquer la prod » pour les branches, pull requests et protections
- Construire et mettre en ligne une app web avec un agent de code IA
Programme
Que vais-je mettre en place sur mon dépôt dans ce cours, et dans quel ordre ?
- Présentation du cours2 étapes
Objectif · À la fin de cette présentation, vous saurez ce que vous serez capable de faire (encadrer Claude Code sur un vrai dépôt : contexte, plan, extensions, permissions, hooks, revue), le livrable que vous installerez sur votre dépôt et par quels quatre modules le cours vous y conduit.
Que sait l'agent de mon projet à chaque instant, et comment lui donner les bonnes informations sans le noyer ?
Objectif · À la fin de cette leçon, vous serez capable d'expliquer ce qui occupe la fenêtre de contexte de Claude Code (instructions, CLAUDE.md, fichiers lus, sorties de commandes, conversation), de la mesurer avec /context et de choisir entre continuer, compacter, repartir de zéro ou reprendre une session nommée, en tenant compte du coût.
Objectif · À la fin de cette leçon, vous serez capable de rédiger un CLAUDE.md court et utile pour votre dépôt, de choisir où placer chaque instruction (utilisateur, projet, local, sous-dossier, règle par chemin, import) et de le faire évoluer à partir des erreurs de l'agent.
Comment conduire une vraie tâche sans que l'agent parte dans la mauvaise direction, et quel outil lui confier pour quoi ?
Objectif · À la fin de cette leçon, vous serez capable de conduire une tâche non triviale sur un code existant en quatre temps (explorer, planifier, coder, commiter), avec le mode plan, des critères de vérification que l'agent exécute et des commits Git, et de savoir quand les points de restauration suffisent et quand ils ne suffisent pas.
Objectif · À la fin de cette leçon, vous serez capable de choisir entre CLAUDE.md, skill ou commande, subagent, serveur MCP et hook pour un besoin donné, de créer dans votre dépôt un subagent de relecture et une commande réutilisable, et de brancher un serveur MCP avec une portée et des droits limités.
Qu'est-ce que l'agent peut faire sans me demander, et comment imposer ce qui ne doit jamais arriver ?
Objectif · À la fin de cette leçon, vous serez capable de choisir un mode de permission adapté à la tâche, d'écrire des règles allow, ask et deny dans le bon fichier de réglages selon les risques de votre dépôt, et de savoir ce que ces règles ne couvrent pas.
Objectif · À la fin de cette leçon, vous serez capable d'écrire et de tester des hooks simples qui bloquent une action interdite, formatent ou vérifient automatiquement, de choisir le bon événement, et d'évaluer les risques d'un hook avant de l'installer.
Comment savoir que le travail de l'agent est bon avant qu'il parte, et installer le tout sur mon dépôt ?
Objectif · À la fin de cette leçon, vous serez capable de relire un changement produit par Claude Code avec une checklist (périmètre, tests, secrets, migrations, dépendances), d'y ajouter une revue indépendante dans un contexte neuf, de décider de fusionner, corriger ou refuser, et de savoir quand automatiser une partie de la revue en mode non interactif ou dans GitHub Actions.
Objectif · À la fin de cet atelier, vous aurez installé sur votre propre dépôt un CLAUDE.md relu, un .claude/settings.json avec permissions et hooks testés, une extension utile (subagent de revue ou commande) et une checklist de revue, et vous les aurez appliqués à une vraie tâche, preuves à l'appui.
Objectif · À la fin de cette leçon, vous disposerez des modèles, prompts et checklists du cours (CLAUDE.md, réglages, hook, subagent, checklist de revue) et vous aurez planifié leur application à votre dépôt sur 7 et 30 jours.