Cours Vibe coding avec Claude Code · Module 15: Claude Code avancé
Projet final : de SPEC au déploiement avec Claude Code
Dans cette leçon13
Tu as construit douze clones en suivant les cartes des leçons. Chaque leçon disait quoi construire, quel fichier ouvrir dans Cursor et quoi vérifier dans le diff. Le projet final n'a pas de telle carte : c'est ta propre application, avec ton idée, et pas un clone de plus. Sans leçon, il est facile de retomber dans la vieille habitude, c'est-à-dire une seule demande : "construis-moi une application pour mes entraînements". Une heure plus tard, tu as quarante fichiers modifiés que personne n'a lus, et tu ne sais pas quelle étape a tout cassé. Cette leçon te donne la carte de tout le voyage. C'est la même méthode de travail que dans le cours, étape par étape, et chaque étape laisse dans le dépôt une preuve que le mentor verra à la fin.
Ce que tu sais déjà
Rien ici n'est nouveau. L'interview et SPEC.md, tu les connais depuis les leçons 1_6 et 13_5, le court CLAUDE.md depuis les leçons 1_7 et 14_3, les règles deny depuis la leçon 8_4, le mode planification depuis la leçon 0_4, le test avant le code depuis les leçons 4_1 et 10_4, /code-review depuis la leçon 2_9, /security-review depuis la leçon 8_7, la liste de contrôle depuis la leçon 15_4, le déploiement que tu approuves toi-même depuis la leçon 10_5, et /rewind et Git depuis les leçons 0_6 et 1_5. La seule nouveauté, c'est que tu les assembles tout seul, sans une leçon qui te souffle l'étape suivante.
La carte du voyage
| Étape | Preuve dans le dépôt |
|---|---|
| Interview et spécification | SPEC.md avec une section "Ce que nous ne faisons pas" |
| Règles de l'équipage | un court CLAUDE.md et .claude/settings.json avec des règles deny |
| Plan | PLAN.md avec de petites étapes |
| Construction | de petits commits et des tests lancés par une seule commande |
| Revues | une note avec les remarques acceptées et rejetées |
| Déploiement | l'adresse de production et un plan de retour en arrière |
| Casse et récupère | une mauvaise modification et son revert dans l'historique |
Choisis ta propre terre
Un bon projet final résout un petit problème que tu connais dans la vie : un journal d'entraînement, un échange de livres dans la classe, un planning de corvées à la maison. Une action principale de l'utilisateur, des données décrites par quelques champs, deux rôles au plus, par exemple l'invité et le propriétaire. Un petit projet terminé et déployé t'apprendra plus qu'un grand projet abandonné à moitié, et je te le recommande sans hésiter.
Si tu manques d'idée, prends la liste de fonctionnalités de l'ancienne version de cette leçon, corrigée pour dire la vérité sur le cours :
- connexion : Better Auth de la leçon 8_5, Supabase pour les curieux de la leçon 13_7 ;
- base de données : Prisma et PostgreSQL de la leçon 13_4 ;
- entrées et commentaires par des routes d'API : leçons 13_5 et 15_4 ;
- envoi de fichiers : la vidéo de la leçon 5_4, la photo pour la loupe de la leçon 13_3 ;
- recherche et filtres dans l'adresse : leçons 4_5 et 6_5 ;
- messages en direct : Server-Sent Events de la leçon 6_4 ;
- thème sombre : le préfixe
dark:de la leçon 1_3 ; - déploiement : Vercel de la leçon 10_5, conteneur de la leçon 12_4.
Ce que le cours n'a pas enseigné, nous le disons franchement : les WebSockets, les paiements et l'envoi d'e-mails. Si ton idée en a besoin, écris-les dans SPEC.md comme un risque et commence par une recherche dans la documentation, comme dans la leçon 5_4, avant que la première ligne de code n'existe. L'ancienne leçon montrait aussi une arborescence de dossiers. Après correction, elle pourrait ressembler à ceci :
mon-projet/
├── app/
│ ├── api/auth/[...all]/route.ts
│ ├── api/entrees/route.ts
│ ├── entrees/[id]/page.tsx
│ └── generated/prisma/
├── components/
├── lib/auth.ts, lib/prisma.ts
├── prisma/schema.prisma
├── SPEC.md, PLAN.md, CLAUDE.md
└── .claude/settings.jsonPrends-la comme un exemple, pas comme un modèle à copier. app/api/auth/[...all] est la route de Better Auth de la leçon 8_5, et app/generated/prisma est le client Prisma généré de la leçon 13_4. Ta propre arborescence, c'est Claude qui la proposera dans le plan, à partir de ta spécification.
Étape 1 : l'interview et SPEC.md
Claude crée un projet Next.js vide comme dans la leçon 1_2, puis tu commences par une conversation, pas par du code. La session est en mode Manual, parce que l'interview ne change rien :
Demande pour Claude Code :
Je veux construire une application : [une phrase sur le problème et
l'utilisateur]. Fais-moi passer une interview, trois questions au plus à
la fois : qui s'en sert, ce qu'il fait le plus souvent, quelles données
nous enregistrons, qui peut changer quoi, ce que la première version ne
fait pas. Ensuite, écris SPEC.md : objectif, utilisateurs, fonctionnalités
de la première version, données, routes et droits, ce que nous ne faisons
pas, comment nous vérifierons que ça marche. N'écris pas de code.La section "Ce que nous ne faisons pas" tient le voyage en main quand, à mi-chemin, l'envie vient d'une fonctionnalité de plus. Tu lis la spécification dans Cursor et tu la corriges avant qu'une seule ligne de code n'existe. Ensuite, un commit avec la spécification et le dépôt sur GitHub, comme dans la leçon 1_5.
Étape 2 : les règles de l'équipage
/init donne un point de départ pour CLAUDE.md, puis tu supprimes surtout des lignes, comme dans la leçon 14_3. Restent les commandes de vérification, les pièges et les décisions que Claude ne lira pas dans le code. À côté, dans .claude/settings.json, se trouvent les règles dures des leçons 8_4 et 10_5 :
{
"permissions": {
"deny": ["Read(./.env)", "Read(./.env.*)"],
"ask": ["Bash(vercel*)", "Bash(npx vercel*)", "Bash(git push *)"]
}
}deny interdit à Claude de lire les fichiers de secrets dans tous les modes, avec les exceptions que tu connais de la leçon 8_4, et ask arrête le déploiement et l'envoi des changements pour te demander ton accord. Une demande dans CLAUDE.md est lue par le modèle, qui décide seul quoi en faire, alors qu'une règle dans les réglages est appliquée par le programme. Les deux fichiers vont dans le dépôt.
Étape 3 : le plan
Tu commences la construction dans une session neuve, car la conversation de l'interview est pleine d'idées rejetées. Tu tapes /clear, puis :
/plan Planifie la première version d'après @SPEC.md. Découpe le travail en
étapes dont chacune se termine par une application qui marche, un test et
un commit. D'abord le modèle de données et les tests de ses règles, puis
les routes, enfin les écrans. Pour chaque étape, donne les fichiers et la
commande qui prouvera que ça marche. Écris le plan dans PLAN.md avec des
cases à cocher.Dans le plan, tu cherches deux choses : des étapes assez petites pour que tu lises le diff de chacune en quelques minutes, et une commande pour chaque étape. Une étape du genre "connexion et tout le tableau de bord", tu la découpes avant d'accepter le plan. PLAN.md survit à chaque /clear, alors que le plan de la conversation, non.
Étape 4 : petite étape, épreuve, commit
Chaque étape de PLAN.md est une demande de la même forme : l'objectif, les fichiers par @, les contraintes et la définition de "terminé", par exemple "terminé quand npm run test -- --run, npm run lint et npx tsc --noEmit passent". Le test naît avant le code, comme dans la leçon 4_1, et il doit d'abord échouer. Ensuite, tu lis le diff dans Cursor et tu demandes un commit portant le nom de l'étape. Une étape, un commit, car c'est la seule façon de savoir où revenir.
Quand quelque chose ne marche pas, tiens-toi à la règle de la leçon 0_5 : après deux corrections ratées du même défaut, tu tapes /clear et tu écris une meilleure demande, au lieu d'en réclamer une troisième. Meilleure veut dire plus précise : le fichier, le symptôme, le résultat de la commande et la description de ce à quoi ressemble "corrigé". Les étapes plus longues, que tu laisses à Claude sans surveillance, reçoivent l'épreuve de la leçon 14_8 : /goal ou un hook Stop.
Étape 5 : les revues
Avant le premier déploiement, toute la branche passe deux revues et une liste. /code-review de la leçon 2_9 cherche les erreurs de fonctionnement, /security-review de la leçon 8_7 cherche les brèches, et la liste de la leçon 15_4 surveille les secrets, les verrous, la validation, les réponses, les en-têtes et les paquets. Les remarques sont des hypothèses. Tu vérifies chacune, tu corriges celle que tu acceptes avec une demande étroite et un test, et dans docs/REVUE.md tu notes en une phrase ce que tu as accepté, ce que tu as rejeté et pourquoi. Cette note montre le mieux qu'un humain a lu la revue.
Étape 6 : le déploiement que tu approuves toi-même
Tu déploies comme dans la leçon 10_5. Le premier déploiement d'un nouveau projet sur Vercel va toujours en production, donc tu le fais toi-même, seulement après les revues. Les suivants passent par un aperçu : Claude le construit avec le skill /deploy, tu ouvres l'adresse dans le navigateur et tu promeus la version en production dans le tableau de bord de Vercel. Avant de promouvoir, tu sais quel déploiement précédent Instant Rollback restaurera. Les variables, tu les définis dans le tableau de bord, et leurs noms sont dans .env.example.
Étape 7 : casse et récupère
La dernière étape est un exercice d'alerte. Tu demandes à Claude une mauvaise modification et tu la valides par un commit, comme si elle avait passé la revue :
Exercice : supprime la vérification du propriétaire dans la route qui
modifie des données, et fais un commit "Mauvaise modification (exercice)".
Ne touche pas aux tests.Si les tests passent toujours, l'exercice a déjà été rentable : tu sais qu'aucun test ne surveille ce verrou, et tu en ajoutes un après ton retour. Et le retour ? /rewind de la leçon 0_6 est ici la mauvaise corde. Il annule les fichiers modifiés par les outils de Claude dans cette conversation, mais il n'annulera pas un commit, car l'historique de Git a été écrit par une commande du terminal. Dans un vrai voyage, la mauvaise modification se révèle souvent des jours plus tard, dans une autre session, ou déjà sur GitHub. La documentation de Claude Code dit clairement que les checkpoints servent à revenir vite en arrière au sein d'une session, et que l'historique durable, c'est Git. Tu reviens donc comme dans la leçon 1_5 :
git log --oneline -3
git revert --no-edit 9b17e63
npm run test -- --rungit log montre le numéro du mauvais commit, chez toi différent de celui de l'exemple. git revert enregistre un nouveau commit qui inverse ses effets, et --no-edit prend le message prêt qui commence par Revert. L'historique reste intact, donc cette corde marche aussi quand la mauvaise modification est déjà sur GitHub. Les tests verts à la fin prouvent que le verrou est revenu.
Ce que tu envoies au mentor
Le lien vers le dépôt sur GitHub. Le mentor vérifiera ce que la carte a laissé : SPEC.md, un court CLAUDE.md, .claude/settings.json avec les règles deny, des tests lancés par une seule commande, l'historique de petits commits avec la mauvaise modification et son revert, la note des revues et l'adresse de production dans la description du dépôt.
La revue du capitaine
- La spécification avant le code. Le commit avec
SPEC.mdest dans l'historique avant le premier commit avec le code d'une fonctionnalité. - De petites étapes. Aucun commit ne mélange deux étapes de
PLAN.md, et chacun, sauf l'exercice de l'étape 7, laisse les tests verts. - Secrets.
git ls-filesne montre aucun fichier.enven dehors de.env.example. - Le dernier mot. La production, c'est toi qui l'as promue, et les règles
askarrêtent chaquevercelet chaquegit push.
L'erreur typique de l'agent : une seule grande étape. Tu demandes la première étape du plan, et Claude crée "au passage" les écrans, les routes et la connexion d'un coup, parce qu'il les voit dans SPEC.md. Tu le reconnais à la liste des fichiers dans Source Control, plus longue que celle du plan. Tant qu'il n'y a pas de commit, tu reviens par /rewind et tu répètes la demande avec la liste des fichiers que tu autorises à changer. Dans l'éditeur ci-dessous t'attend la carte du voyage : coche les étapes et regarde ce qui manque avant d'envoyer le lien, et dans l'exercice d'alerte, vois quelle corde te ramène de chaque haut-fond.
N'oublie pas : tu mènes ton propre navire avec la même carte que celui des autres, et chaque étape du voyage laisse dans le journal de bord une trace qu'on peut vérifier.
Fin du voyage
Félicitations ! C'est la dernière leçon du cours Vibecoding.
Tu as commencé par la première commande dans le terminal, et tu finis sur ton propre projet qui a parcouru toute la carte : de l'interview, par de petites étapes et des revues, jusqu'au déploiement que tu as approuvé toi-même. En chemin, tu as appris le quart que Claude Code tient sans toi, et le budget que tu comptes avant d'appareiller. Commence chaque nouveau projet par un court CLAUDE.md, des règles deny et une épreuve, et la carte se remplira toute seule. Bon vent, et va découvrir de nouvelles terres de code !
Code de cette leçon : App.tsx
// La carte du voyage du projet final : chaque étape laisse une preuve, et l’exercice d’alerte montre quelle corde te ramène
import { useState } from 'react';
export interface Stage {
id: string;
name: string;
proof: string;
}
export type Situation = 'edition-sans-commit' | 'commande-dans-le-terminal' | 'mauvais-commit' | 'mauvais-commit-sur-github' | 'deux-corrections-ratees';
export interface Advice {
tool: string;
why: string;
}
export const STAGES: Stage[] = [
{ id: 'spec', name: 'Interview et SPEC.md', proof: 'SPEC.md avec une section Ce que nous ne faisons pas' },
{ id: 'rules', name: 'Règles de l’équipage', proof: 'un court CLAUDE.md et .claude/settings.json avec des règles deny' },
{ id: 'plan', name: 'Plan', proof: 'PLAN.md avec de petites étapes et une commande pour chacune' },
{ id: 'build', name: 'Construction', proof: 'de petits commits et des tests lancés par une seule commande' },
{ id: 'review', name: 'Revues', proof: '/code-review, /security-review, la liste de la leçon 15_4 et une note avec les décisions' },
{ id: 'deploy', name: 'Déploiement', proof: 'l’adresse de production, promue par toi, et un plan de retour en arrière' },
{ id: 'drill', name: 'Casse et récupère', proof: 'une mauvaise modification et son revert dans l’historique, tests verts' },
];
export const SITUATIONS: { id: Situation; label: string }[] = [
{ id: 'edition-sans-commit', label: 'Claude a cassé un fichier dans cette conversation, il n’y a pas encore de commit' },
{ id: 'commande-dans-le-terminal', label: 'Le fichier n’a été changé que par une commande du terminal, sans commit' },
{ id: 'mauvais-commit', label: 'La mauvaise modification est déjà dans un commit' },
{ id: 'mauvais-commit-sur-github', label: 'Le mauvais commit est déjà sur GitHub' },
{ id: 'deux-corrections-ratees', label: 'Deux corrections de la même erreur de suite n’ont rien donné' },
];
export function missing(done: string[]): Stage[] {
return STAGES.filter((s) => !done.includes(s.id));
}
// Étapes cochées alors qu’une étape précédente de la carte attend encore
export function outOfOrder(done: string[]): string[] {
const out: string[] = [];
STAGES.forEach((stage, i) => {
if (!done.includes(stage.id)) return;
const gap = STAGES.slice(0, i).find((s) => !done.includes(s.id));
if (gap) out.push(stage.name + ' avant l’étape ' + gap.name);
});
return out;
}
export function recover(s: Situation): Advice {
if (s === 'edition-sans-commit') {
return { tool: '/rewind et Restore code', why: 'Le changement vient des outils de Claude dans cette conversation et il n’y a pas de commit, donc le checkpoint suffit.' };
}
if (s === 'commande-dans-le-terminal') {
return { tool: 'git restore <fichier>', why: 'Les checkpoints ne suivent pas un fichier changé seulement par une commande du terminal. Tu annules le changement avec Git.' };
}
if (s === 'mauvais-commit') {
return { tool: 'git revert <numéro du commit>', why: 'Le commit a été écrit par la commande git. /rewind annulerait les fichiers, mais le commit resterait dans l’historique.' };
}
if (s === 'mauvais-commit-sur-github') {
return { tool: 'git revert <numéro du commit>, puis git push', why: 'Revert ajoute un nouveau commit et ne réécrit pas l’historique, donc tu n’as besoin ni de reset --hard ni de push --force.' };
}
return { tool: '/clear et une meilleure demande', why: 'Une troisième correction s’ajoute à une conversation pleine de fausses pistes. Donne le fichier, le symptôme, le résultat de la commande et la description de ce à quoi ressemble « corrigé ».' };
}
export default function App() {
const [done, setDone] = useState<string[]>(['spec', 'build']);
const [situation, setSituation] = useState<Situation>('mauvais-commit');
const toggle = (id: string) => setDone(done.includes(id) ? done.filter((d) => d !== id) : [...done, id]);
const left = missing(done);
const warnings = outOfOrder(done);
const advice = recover(situation);
return (
<div className="min-h-screen space-y-4 bg-slate-950 p-4 text-slate-100">
<h1 className="text-xl font-bold">La carte du voyage : le projet final</h1>
<p className="text-sm text-slate-300">Coche une étape seulement quand sa preuve est dans le dépôt.</p>
<ol className="space-y-2">
{STAGES.map((stage, i) => (
<li key={stage.id} className="rounded border border-slate-800 p-2">
<label className="flex items-center gap-2 text-sm font-semibold">
<input type="checkbox" checked={done.includes(stage.id)} onChange={() => toggle(stage.id)} />
{i + 1}. {stage.name}
</label>
<p className="pl-6 text-xs text-slate-400">Preuve : {stage.proof}</p>
</li>
))}
</ol>
{warnings.length > 0 ? (
<ul className="space-y-1 text-sm text-amber-400">
{warnings.map((w) => (
<li key={w}>Ordre : {w}.</li>
))}
</ul>
) : null}
<p className={'text-sm ' + (left.length === 0 ? 'text-emerald-400' : 'text-rose-400')}>
{left.length === 0 ? 'Toutes les preuves sont dans le dépôt. Colle le lien pour le mentor.' : 'Avant d’envoyer le lien, il manque : ' + left.map((s) => s.name).join(', ') + '.'}
</p>
<section className="space-y-2 rounded border border-slate-800 p-3">
<h2 className="font-semibold">Exercice d’alerte : quelle corde te ramène ?</h2>
<select className="w-full rounded bg-slate-900 p-1 text-sm" value={situation} onChange={(e) => setSituation(e.target.value as Situation)}>
{SITUATIONS.map((s) => (
<option key={s.id} value={s.id}>{s.label}</option>
))}
</select>
<p className="font-mono text-sm text-emerald-400">{advice.tool}</p>
<p className="text-sm text-slate-300">{advice.why}</p>
</section>
</div>
);
}Tu as repéré une erreur dans cette leçon ?
Teste tes connaissances
Réponds aux questions de cette leçon. Choisis une réponse pour voir tout de suite si elle est correcte.
1. Pour la deuxième fois de suite, tu demandes à Claude de corriger la même erreur dans le formulaire, et c'est toujours faux. Que fais-tu ?
2. La branche du projet final est prête et les tests passent. Que fais-tu avant le premier déploiement ?
Voici 2 des 4 questions de cette leçon. Réponds aux autres dans le jeu.
Tâches pratiques dans le jeu
- Tri vertical
Mets les étapes du projet final dans l'ordre de la carte du voyage :
Exercices après cette leçon
- QuestionQuiz : Deux corrections ratées de suite
- QuestionQuiz : La dernière revue avant publication
- Remets dans l'ordreTri : Le cycle complet du projet final
- QuestionQuiz : La mauvaise modification est déjà dans un commit
- QuestionQuiz : Ce que tu envoies au mentor
- Projet à envoyerFélicitations - tu as terminé Vibecoding !
- VidéoRésumé du module