Claude Code — Le playbook de l’ingénieur
⏱️ TL;DR — Tu utilises déjà Claude Code pour coder, mais tu as l’impression de mal t’y prendre : designs incohérents, conventions pas respectées, direction floue au démarrage. Ce playbook est fait pour ça. Objectif : piloter Claude Code comme un architecte, pas comme un distributeur de code. On avance par parcours de travail réel (cadrer → conventionner → coder → garder la cohérence → automatiser → déléguer → réviser), on construit une vraie app en fil rouge (TaskFlow), et on finit avec un Cookbook de recettes prêtes à copier.
À qui s’adresse ce playbook
À toi : un développeur web (Next.js / React / TypeScript / Tailwind) qui utilise Claude Code au quotidien et veut passer de « ça marche à peu près » à « je pilote une équipe d’un agent avec méthode ». Ce n’est pas une doc de référence neutre ; c’est un playbook opinionated — des opinions tranchées, des méthodes, des anti-patterns nommés.
💡 Le pari central de ce playbook — Ta productivité avec Claude Code ne dépend presque pas de « savoir prompter ». Elle dépend de ce que tu mets autour de la conversation : le cadrage, le fichier
CLAUDE.md, les conventions, les hooks, les skills, la boucle de revue. Un bon architecte configure le terrain, puis délègue. C’est ce qu’on apprend ici.
Ce que tu sauras faire à la fin
- Cadrer un nouveau projet pour donner la bonne direction dès la première minute (design, stack, conventions), au lieu de laisser l’IA improviser.
- Écrire un
CLAUDE.mdqui fait que l’agent respecte tes conventions — même trois semaines plus tard, même sur un gros codebase. - Garder un design et un code cohérents dans la durée (design system, réutilisation de l’existant, anti-dérive).
- Automatiser le lint/format/test et poser des garde-fous avec les hooks.
- Déléguer proprement avec les subagents et les workflows (et savoir quand ne PAS déléguer).
- Choisir et écrire les skills qui comptent (on passe en revue les plus populaires, dont celles de Matt Pocock).
- Connecter des outils externes via MCP, et étendre Claude Code (commandes, plugins, output styles).
- Réviser, debugger, refactorer, industrialiser avec une vraie boucle qualité (
/code-review,/diagnose, tests, CI). - Adopter les modèles mentaux de l’architecte augmenté : quand faire confiance, quand vérifier, comment monter TOI en niveau.
Le sommaire (parcours de travail)
| # | Partie | Ce que ça résout |
|---|---|---|
| 1 | Le bon modèle mental | Comprendre CC = agent, pas chatbot. Prise en main. |
| 2 | Cadrer un nouveau projet | « Comment démarrer, quelle direction donner ? » |
| 3 | CLAUDE.md, mémoire & conventions | « Faire que l’IA reprenne MES conventions. » |
| 4 | Design cohérent & anti-dérive | « Mes designs ne sont pas cohérents. » |
| 5 | Faire coder sans déraper | Prompting, contexte, permissions, vérification. |
| 6 | Reprendre un projet existant | « Aider l’IA à continuer un projet déjà commencé. » |
| 7 | Automatiser avec les hooks | Lint/format/test auto, garde-fous. |
| 8 | Déléguer : subagents & workflows | Quand et comment déléguer, parallélisme. |
| 9 | Les Skills | « Les meilleures skills à utiliser. » |
| 10 | MCP, commandes, plugins, output styles | Le reste de l’écosystème d’extension. |
| 11 | Réviser, debugger, industrialiser | /code-review, /diagnose, tests, CI, sécu. |
| 12 | Devenir architecte AVEC l’IA | Le cœur : confiance vs vérification, anti-patterns. |
| 13 | Claude Cowork (découverte) | Ce que c’est, et si ça te concerne. |
| 14 | Cookbook | Recettes prêtes à copier (prompts, CLAUDE.md, hooks…). |
| 15 | Annexes | Cheatsheet, glossaire, ressources, quiz. |
Le fil rouge : TaskFlow
Tout au long des parties 2 → 11, on construit TaskFlow, un petit SaaS de gestion de tâches en Next.js (App Router) + TypeScript + Tailwind + Prisma + auth. Pas pour l’app en elle-même — pour montrer, sur du vrai code, comment on pilote Claude Code proprement : le kickoff, le CLAUDE.md, le design system, la première feature, les hooks de test, une skill maison, la boucle de revue et la CI. Chaque partie fait avancer TaskFlow d’un cran.
Comment lire ce playbook
- Dans l’ordre, la première fois : c’est un parcours, chaque partie s’appuie sur la précédente.
- En marque-page ensuite : le Cookbook et les Annexes sont faits pour être consultés en pleine session.
- Les mots ont un sens précis ici. Skill, subagent, hook, commande, MCP, plugin ne sont pas synonymes — voir le glossaire. Le playbook les distingue rigoureusement.
⚠️ Piège — L’écosystème Claude Code bouge vite (skills, marketplace, features). Les principes de ce playbook sont stables ; les noms de commandes et de skills peuvent évoluer. En cas de doute, la source de vérité est
claude --help,/helpdans l’app, et la doc officielle.
Prêt ? On commence par le plus important : le bon modèle mental.