Claude Code : Piloter ton Développement par la Spec — Méthode, Gardes-fous, Zéro Dérive
Transforme Claude Code en contributeur discipliné : la spec comme source de vérité, révision en amont, TDD, et des gardes-fous (hooks, subagents) que le modèle ne peut pas contourner.
Tu as sûrement déjà vécu ça : tu lances Claude Code sur une feature, ça part vite, et trois minutes plus tard l’agent a réécrit un fichier que tu n’avais pas mentionné, inventé une approche « maligne » à moitié juste, et annoncé « c’est fait » alors que rien n’est vérifié. Le problème n’est pas la capacité du modèle. C’est l’absence de cadre.
Ce cours enseigne une seule discipline : transformer Claude Code en contributeur gouverné, qui travaille à partir d’une spec qui fait autorité. La colonne vertébrale est une boucle en cinq temps — écrire la spec, réviser la spec (pas le code), implémenter, tester, et — le mouvement que la plupart des tutos zappent — imposer, pour que l’agent ne puisse pas dériver ni crier victoire trop tôt.
La distinction qui change tout, tirée de la doc officielle : « les règles de permission sont appliquées par Claude Code, pas par le modèle. Tes instructions et ton CLAUDE.md orientent ce que Claude essaie de faire, mais ne changent pas ce que Claude Code autorise. » Tout le cours tient sur cette ligne : la couche molle (ce que le modèle lit et tente, ~70 % d’adhérence) contre la couche dure (permissions, hooks, subagents — ce que le CLI garantit, ~100 %).
Tu repartiras avec un « walk-away workflow » : une suite de tests verrouillée par hook, un subagent revieweur qui ne peut pas éditer, des frontières de scope explicites — de quoi réviser des preuves au lieu de surveiller un chat. Et une posture honnête sur le ROI : on vend du contrôle, pas de la magie.
Basé sur une recherche de terrain (juillet 2026) : documentation officielle Claude Code (permissions, hooks, subagents, best-practices), BMAD-METHOD et GitHub Spec Kit, retours de développeurs seniors sur X et Hacker News, et travaux empiriques (METR, études sur la clarté des exigences et le TDD).
Ce que tu vas apprendre
- Distinguer les deux couches de contrôle : ce que le modèle *essaie* (CLAUDE.md, prompts) vs. ce que le CLI *impose* (permissions, hooks)
- Écrire une spec intent-first, auto-suffisante et testable (grammaire EARS), qui nomme le hors-scope et l'étape de vérification
- Réviser la spec en amont avec clarify et analyze, et repérer la dérive de spécification (spec drift)
- Appliquer le modèle BMAD à deux phases et le context-engineering par story files auto-suffisants
- Verrouiller le projet en lecture seule avec Plan Mode et des règles de permission deny → ask → allow
- Piloter un cycle TDD RED → commit → GREEN avec un agent, tests figés comme spec immuable
- Poser des gardes-fous mécaniques : hook de test PostToolUse, Stop hook, subagent revieweur en lecture seule
- Assembler un « walk-away workflow » complet et le codifier en slash-command réutilisable
After This Course, You Can
What You'll Build
Programme du cours
Prérequis
- Être développeur confirmé (idéalement fullstack) et à l'aise avec git, les tests et la CLI
- Avoir déjà utilisé Claude Code au moins une fois (installation, prompts, édition de fichiers) — sinon, suis d'abord « Maîtriser Claude Code »
- Un projet réel sous la main sur lequel appliquer le workflow (le capstone livre une vraie feature)
