Cours Vibe coding avec Claude Code · Module 5: Clone de Reddit
Le conseil de l'équipage vote : d'abord le test, ensuite le code
Dans cette leçon15
Ohé ! Une dispute éclate sur le pont : mettre le cap sur Tortuga ou filer au nord chercher l'or d'une épave. Dans ce lieu, tu construis Crew Council, un forum pirate à la Reddit où l'équipage vote pour ou contre les idées, et où les meilleures remontent d'elles-mêmes. Les règles du vote se cassent facilement en silence : Claude Code va donc écrire d'abord l'épreuve, puis le code qui la réussit.
Ce que tu vas apprendre
- demander à Claude Code de configurer les tests selon la documentation de Next.js et vérifier dans Cursor ce qu'il a ajouté ;
- commander d'abord les tests, voir leur échec, et seulement ensuite le code qui les fait passer ;
- exiger une preuve : une commande et son résultat plutôt que la phrase "les tests passent" ;
- repérer l'agent qui corrige le test au lieu du code ;
- garder les votes dans l'état de la liste pour que le tri les voie.
Nouveau port : le projet crew-council
Le forum est une application à part, il reçoit donc son propre projet. Tu le crées avec la commande de la leçon 1_2, en changeant seulement le nom. Avant de cliquer sur Yes, compare la commande avec celle-ci :
npx create-next-app@latest crew-council --ts --eslint --tailwind --app --no-src-dir --no-cache-components --agents-md --no-agent-feedback --use-npmEnsuite, la boucle habituelle : une session dans le dossier crew-council, npm run build comme preuve, un court CLAUDE.md avec l'import @AGENTS.md comme dans la leçon 1_7, et un premier commit.
Problème : des règles faciles à casser
Le vote d'un pirate a trois états : pour ("up"), contre ("down") ou aucun (null). Le score d'un post, c'est les votes pour moins les votes contre. Les règles du conseil sont les suivantes :
- un plus ou un moins sans vote précédent ajoute un vote ;
- un second clic sur le même bouton annule le vote ;
- passer du plus au moins retire le vote pour et ajoute un vote contre, donc le score baisse de 2, et dans l'autre sens il monte de 2.
Cela fait six transitions, et chacune peut être cassée sans que la page ait l'air de rien. En cliquant, tu en vérifies deux ou trois ; un test les vérifie toutes en une fraction de seconde.
Le test en un paragraphe
Un test est un petit programme qui appelle ton code avec des données fixées et compare le résultat à ce qui est attendu, comme un contrat : "ce post a 10 votes pour, après un clic sur plus il doit en avoir 11". L'outil de test exécute tous les contrats et signale ceux qui sont respectés, et Claude peut le lancer lui-même. Les bonnes pratiques officielles de Claude Code conseillent de lui donner de quoi répondre "réussi" ou "échoué", et de toujours demander une preuve : la commande et son résultat.
Demande pour Claude Code : configuration des tests
La documentation de Next.js décrit quatre outils : Jest et Vitest pour les tests unitaires, Cypress et Playwright pour tester des parcours entiers dans le navigateur. Nous choisissons Vitest, parce que d'après cette documentation il lui suffit d'un seul court fichier de configuration, alors que Jest demande en plus l'assistant npm init jest, le paquet ts-node et un mappage manuel du raccourci @/.
Demande pour Claude Code :
Configure dans Crew Council les tests unitaires avec Vitest en suivant
la documentation de Next.js (node_modules/next/dist/docs/01-app/02-guides/testing/vitest.md) :
les paquets, vitest.config.mts et un script "test" dans @package.json.
N'ajoute aucun test d'exemple. Si npm signale un conflit de versions,
montre-moi l'erreur et propose une correction avant d'utiliser --force
ou --legacy-peer-deps. À la fin, lance npm run test -- --run et montre
le résultat.C'est la documentation que l'assistant a laissée dans le projet, conforme à ta version de Next.js.
Ce que Claude a fait : un conflit de versions
L'installation suivant la documentation s'est arrêtée sur une erreur. Voici ses lignes les plus importantes :
npm error code ERESOLVE
npm error While resolving: vitest@5.1.0
npm error Found: @types/node@20.19.43
npm error peerOptional @types/node@"^22.0.0 || >=24.0.0" from vitest@5.1.0
npm error Fix the upstream dependency conflict, or retry this command with --force or --legacy-peer-deps to accept an incorrect (and potentially broken) dependency resolution.ERESOLVE signifie que npm n'arrive pas à choisir des versions compatibles entre elles. Vitest 5 attend des types Node.js en version 22 au moins, et l'assistant a écrit dans le projet @types/node en version 20 (état en novembre 2026). La dernière ligne tente avec un raccourci : --force et --legacy-peer-deps ordonnent d'ignorer le conflit et d'installer des dépendances "potentiellement cassées". La bonne correction, ce sont des types alignés sur ton Node.js (tu le vérifies avec node -v) : pour la version 26, Claude propose npm install -D @types/node@26. Après cela, l'installation est passée sans erreur.
Ce que Claude a fait : la configuration
Ouvre dans Cursor le panneau Source Control et clique sur package.json. Dans devDependencies, cinq paquets sont apparus : vitest, l'outil lui-même, @vitejs/plugin-react, qui comprend le JSX, jsdom, un faux navigateur, ainsi que @testing-library/react et @testing-library/dom pour tester des composants. Dans scripts, une ligne "test": "vitest" s'est ajoutée. Ouvre maintenant vitest.config.mts :
import { defineConfig } from "vitest/config";
import react from "@vitejs/plugin-react";
export default defineConfig({
plugins: [react()],
resolve: {
tsconfigPaths: true,
},
test: {
environment: "jsdom",
},
});environment: "jsdom" active le faux navigateur. resolve.tsconfigPaths apprend à Vitest le raccourci @/ de tsconfig.json, si bien qu'un test importe @/lib/votes comme le reste du projet. La documentation de Next.js le fait avec le paquet vite-tsconfig-paths, mais au premier lancement Vite a affiché un avertissement disant qu'il sait le faire seul, et a indiqué cette option. Claude a remplacé le plugin par l'option et désinstallé le paquet. Un avertissement n'est pas une erreur, mais lis-le toujours : il dit souvent comment faire plus simple.
Sans tests, la commande se termine par No test files found, exiting with code 1 : l'outil fonctionne et attend des fichiers .test.ts, dont le premier va naître dans un instant.
La commande de test dans CLAUDE.md
Dans ton terminal, npm run test démarre en mode surveillance : les tests repartent à chaque modification de fichier et la commande dure jusqu'à Ctrl+C. Demande donc : "Ajoute à CLAUDE.md la commande de test, un seul passage". Dans la section des commandes apparaît la ligne :
- Tests : npm run test -- --run (Vitest, un seul passage sans mode surveillance)Les deux tirets transmettent le reste de la commande à Vitest, et --run désactive la surveillance.
Demande pour Claude Code : les tests d'abord
Maintenant, tu transformes les règles du conseil en épreuve. L'ordre est voulu : les tests naissent avant le code, ils décrivent donc tes règles et non ce qui est sorti du code par hasard.
Crew Council : un post a upvotes, downvotes et userVote ('up', 'down'
ou null). Définis le type Post et des posts d'exemple dans lib/posts.ts.
Écris d'abord les tests de la fonction applyVote(post, clicked) dans
lib/votes.test.ts : plus, moins, un second clic annule le vote, passage
de plus à moins et de moins à plus (le score change de 2), et le post
passé en argument reste inchangé. Dans lib/votes.ts, laisse un squelette
vide de la fonction. Lance les tests : ils ne doivent pas passer. Montre
la commande et le résultat, puis arrête-toi avant le code."Arrête-toi" te laisse le temps de lire les tests avant que Claude ajuste le code dessus. Le squelette vide fait échouer les tests sur la comparaison des résultats, et non sur un fichier manquant.
Ce que Claude a écrit : le test
Ouvre dans Cursor lib/votes.test.ts et lis-le avant le code. Le type Post de lib/posts.ts a un titre, un contenu, un auteur, une communauté, une date en texte ISO et trois champs de votes. En haut du test se tient le post sur lequel travaillent tous les cas : 10 votes pour, 2 contre, userVote: null. Le premier cas :
it("un plus sans vote précédent ajoute un vote pour", () => {
expect(applyVote(post, "up")).toMatchObject({ upvotes: 11, downvotes: 2, userVote: "up" });
});it décrit un cas par une phrase, et expect compare le résultat à l'attendu. toMatchObject ne vérifie que les champs cités : 11 pour, 2 contre, un vote pour. Tous les cas sont dans un bloc describe("applyVote", ...), qui regroupe les tests d'une même fonction. Voici le changement d'avis :
it("passer de moins à plus relève le score de 2", () => {
const voted = { ...post, downvotes: 3, userVote: "down" as const };
const after = applyVote(voted, "up");
expect(after).toMatchObject({ upvotes: 11, downvotes: 2, userVote: "up" });
expect(score(after)).toBe(score(voted) + 2);
});voted est le même post après un vote contre, et as const dit à TypeScript que "down" est exactement cette valeur et non un texte quelconque. Les nombres attendus viennent des règles du conseil et sont écrits à la main, et non calculés par la même formule que la fonction. Le fichier contient sept cas : six transitions et un qui vérifie que le post d'origine n'a pas changé.
Rouge : les tests ne passent pas
Claude a lancé la commande de CLAUDE.md et montré le résultat. Voici son milieu, sans l'en-tête ni le détail de chaque échec que Vitest affiche plus bas :
❯ lib/votes.test.ts (7 tests | 6 failed) 5ms
❯ applyVote (7)
× un plus sans vote précédent ajoute un vote pour 3ms
× un moins sans vote précédent ajoute un vote contre 0ms
× un second clic sur plus annule le vote 0ms
× un second clic sur moins annule le vote 0ms
× passer de plus à moins baisse le score de 2 0ms
× passer de moins à plus relève le score de 2 0ms
Tests 6 failed | 1 passed (7)Six échecs, c'est une bonne nouvelle : chacun de ces tests vérifie vraiment quelque chose. Le septième a réussi parce que le squelette vide renvoie le post sans changement ; un test de règle qui passe sur un squelette vide ne garderait rien. Dans le détail d'un échec, les champs attendus portent un signe moins et les champs reçus un signe plus.
Vert : la fonction selon les tests
Maintenant la demande : "Écris applyVote pour que les tests passent. Ne modifie pas les tests. Montre la commande et le résultat". Ouvre lib/votes.ts :
export function applyVote(post: Post, clicked: "up" | "down"): Post {
const nextVote: Vote = post.userVote === clicked ? null : clicked;
const upvotes = post.upvotes - countSide(post.userVote, "up") + countSide(nextVote, "up");
const downvotes =
post.downvotes - countSide(post.userVote, "down") + countSide(nextVote, "down");
return { ...post, upvotes, downvotes, userVote: nextVote };
}La première ligne fixe le nouveau vote : le même bouton une deuxième fois donne null, un autre donne celui qui a été cliqué. Ensuite, les compteurs retirent l'ancien vote et ajoutent le nouveau. countSide est une petite fonction de ce fichier qui renvoie 1 quand le vote est du côté donné, sinon 0. La dernière ligne construit un nouvel objet avec le spread, donc le post reçu reste intact. À côté se trouve score(post), c'est-à-dire post.upvotes - post.downvotes. Résultat du nouveau lancement :
Test Files 1 passed (1)
Tests 7 passed (7)Voilà la preuve : une commande et son résultat, et non une phrase "ça devrait marcher".
La revue du capitaine
- Le test corrigé pour qu'il passe. C'est l'erreur la plus dangereuse d'un agent avec les tests. Nous avons essayé une fonction qui, lors d'un changement d'avis, ajoute le nouveau vote sans retirer l'ancien : deux tests échouent. Un agent qui tient au résultat vert peut alors corriger l'attendu au lieu du code :
- expect(after).toMatchObject({ upvotes: 11, downvotes: 2, userVote: "up" });
- expect(score(after)).toBe(score(voted) + 2);
+ expect(after).toMatchObject({ upvotes: 11, downvotes: 3, userVote: "up" });
+ expect(score(after)).toBe(score(voted) + 1);Les tests sont de nouveau verts, et le conseil compte un même pirate deux fois. Après chaque tour, regarde donc Source Control : une modification d'un fichier .test.ts que tu n'as pas demandée est un signal d'arrêt. Ajoute à CLAUDE.md le piège : "Un test qui échoue se corrige dans le code ; ne change pas les valeurs attendues sans mon accord". Tu sais depuis la leçon 1_7 que c'est un conseil et non un verrou, donc tu lis quand même le diff.
Six transitions. Compte les cas : de rien à plus et à moins, annulation du plus et du moins, changement dans les deux sens. Un cas manquant est une règle que personne ne garde.
Le test miroir. Une attente recopiée de la fonction, par exemple
expect(score(after)).toBe(after.upvotes - after.downvotes), passera toujours, même avec des votes mal comptés.Lance-le toi-même. Tape dans la session
! npm run test -- --run, comme dans la leçon 0_3.
Les votes dans la liste, pas dans le bouton
Place à l'écran. L'idée typique d'un agent est un bouton avec son propre useState pour les compteurs : le nombre sur le bouton change, mais la liste des posts n'en sait rien, donc le tri par score ne déplace pas le post. C'est la leçon 2_3 sous un autre costume : les données nécessaires à deux endroits sont tenues par le parent commun.
Construis la page d'accueil de Crew Council. components/Feed.tsx garde
les posts dans son état et les modifie avec applyVote de @lib/votes.ts.
components/VoteButtons.tsx n'a pas d'état propre : il reçoit score,
userVote et une fonction onVote. Fais les tris hot, new et top comme une
fonction pure sortPosts dans lib/sort.ts, d'abord avec des tests. À la
fin, tests, lint et build.L'interdiction d'état dans VoteButtons est toute la correction : le bouton dit seulement ce qui a été cliqué, et celui qui tient la liste fait le calcul. Ouvre components/Feed.tsx. Le cœur est la fonction qui modifie un post :
const [posts, setPosts] = useState(initialPosts);
const [sortMode, setSortMode] = useState<SortMode>("hot");
const handleVote = (postId: string, clicked: "up" | "down") => {
setPosts((prev) =>
prev.map((post) => (post.id === postId ? applyVote(post, clicked) : post)),
);
};
const visiblePosts = sortPosts(posts, sortMode);map ne remplace que le post dont l'id correspond. L'ordre n'a pas d'état propre : visiblePosts se recalcule à chaque rendu à partir des votes actuels. Le bouton ▲ de VoteButtons a onClick={() => onVote("up")}, un aria-label="Vote pour" pour le lecteur d'écran et aria-pressed, qui dit si le vote est donné.
Dans lib/sort.ts se trouvent trois modes : new classe par date, top par score, et hot combine les deux avec une formule du code de classement que Reddit a publié en open source :
export function hotScore(post: Post): number {
const s = score(post);
const order = Math.log10(Math.max(Math.abs(s), 1));
const seconds = Date.parse(post.createdAt) / 1000 - 1134028003;
return Math.sign(s) * order + seconds / 45000;
}Math.log10 donne l'ordre de grandeur du score : 10 votes font 1 et 100 votes font 2. 1134028003 est une constante du code de Reddit, un instant de décembre 2005 en secondes. Chaque tranche de 45 000 secondes, soit 12,5 heures de jeunesse, pèse autant que dix fois plus de votes. La formule ne regarde pas l'horloge mais la date du post, c'est donc une fonction pure que l'on peut tester. sortPosts trie une copie [...posts], parce que sort modifie le tableau sur lequel il agit.
Contrôle dans le navigateur : lance npm run dev, choisis top et donne un vote pour au deuxième post. Chez nous, les deux premiers étaient à égalité 90 à 90, donc un vote a fait monter le deuxième en haut, et le passage à un vote contre l'a laissé à 89.
Étape suivante
Quand les tests, le lint et le build sont verts, demande un commit, par exemple "Vote : applyVote avec tests, état des votes dans Feed". Puis une autre petite étape dans la même boucle :
Ajoute la fonction upvotePercent(post) dans @lib/votes.ts : le
pourcentage de votes pour, arrondi à l'entier. D'abord les tests :
85 pour et 15 contre donnent 85, aucun vote donne 0. Lance-les avant
le code et après, et montre les deux résultats.Claude calcule Math.round(post.upvotes / (post.upvotes + post.downvotes) * 100) et vérifie d'abord que la somme n'est pas zéro, parce qu'une division par zéro donnerait NaN. Dans l'éditeur ci-dessous t'attend un fil avec les votes dans l'état de la liste et un petit contrôle de applyVote : vote et regarde le post changer de place.
À retenir : le capitaine écrit les règles du conseil, le test les garde à chaque vote, et celui qui corrige le test au lieu du code tourne le compas pour qu'il convienne au cap.
Code de cette leçon : App.jsx
// Crew Council : les votes vivent dans l'état de la liste, le bouton ne fait qu'appeler une fonction
import { useState } from 'react';
const startPosts = [
{ id: 'p1', title: 'Cap sur Tortuga ou vers le nord ?', upvotes: 120, downvotes: 30, userVote: null, createdAt: '2026-11-13T08:00:00.000Z' },
{ id: 'p2', title: "Une carte avec une croix sur l'île du Crâne", upvotes: 95, downvotes: 5, userVote: null, createdAt: '2026-11-14T06:00:00.000Z' },
{ id: 'p3', title: 'Comment colmater la coque avec du goudron ?', upvotes: 40, downvotes: 2, userVote: null, createdAt: '2026-11-14T09:30:00.000Z' },
{ id: 'p4', title: 'Le Kraken a coulé notre chaloupe', upvotes: 60, downvotes: 15, userVote: null, createdAt: '2026-11-12T18:00:00.000Z' },
];
const score = (post) => post.upvotes - post.downvotes;
// 1 quand le vote est de ce côté, sinon 0
const countSide = (vote, side) => (vote === side ? 1 : 0);
function applyVote(post, clicked) {
const nextVote = post.userVote === clicked ? null : clicked;
return {
...post,
upvotes: post.upvotes - countSide(post.userVote, 'up') + countSide(nextVote, 'up'),
downvotes: post.downvotes - countSide(post.userVote, 'down') + countSide(nextVote, 'down'),
userVote: nextVote,
};
}
// Formule du code de classement de Reddit : l'ordre de grandeur du score plus l'âge du post
function hotScore(post) {
const s = score(post);
const order = Math.log10(Math.max(Math.abs(s), 1));
const seconds = Date.parse(post.createdAt) / 1000 - 1134028003;
return Math.sign(s) * order + seconds / 45000;
}
function sortPosts(posts, mode) {
const copy = [...posts];
if (mode === 'new') return copy.sort((a, b) => Date.parse(b.createdAt) - Date.parse(a.createdAt));
if (mode === 'top') return copy.sort((a, b) => score(b) - score(a));
return copy.sort((a, b) => hotScore(b) - hotScore(a));
}
// Petit contrôle : les mêmes cas que dans lib/votes.test.ts
const base = { upvotes: 10, downvotes: 2, userVote: null };
const checks = [
{ name: 'plus sans vote', actual: applyVote(base, 'up'), expected: [11, 2, 'up'] },
{ name: 'moins sans vote', actual: applyVote(base, 'down'), expected: [10, 3, 'down'] },
{ name: 'un second clic sur plus annule le vote', actual: applyVote({ ...base, upvotes: 11, userVote: 'up' }, 'up'), expected: [10, 2, null] },
{ name: 'un second clic sur moins annule le vote', actual: applyVote({ ...base, downvotes: 3, userVote: 'down' }, 'down'), expected: [10, 2, null] },
{ name: 'de plus à moins : score -2', actual: applyVote({ ...base, upvotes: 11, userVote: 'up' }, 'down'), expected: [10, 3, 'down'] },
{ name: 'de moins à plus : score +2', actual: applyVote({ ...base, downvotes: 3, userVote: 'down' }, 'up'), expected: [11, 2, 'up'] },
];
const passes = ({ actual, expected }) =>
actual.upvotes === expected[0] && actual.downvotes === expected[1] && actual.userVote === expected[2];
function VoteButtons({ score, userVote, onVote }) {
return (
<div className="flex flex-col items-center gap-1">
<button
type="button"
onClick={() => onVote('up')}
aria-label="Vote pour"
aria-pressed={userVote === 'up'}
className={userVote === 'up' ? 'text-orange-600' : 'text-gray-400 hover:text-orange-600'}
>
▲
</button>
<span className="text-sm font-bold">{score}</span>
<button
type="button"
onClick={() => onVote('down')}
aria-label="Vote contre"
aria-pressed={userVote === 'down'}
className={userVote === 'down' ? 'text-blue-600' : 'text-gray-400 hover:text-blue-600'}
>
▼
</button>
</div>
);
}
export default function App() {
const [posts, setPosts] = useState(startPosts);
const [sortMode, setSortMode] = useState('top');
const handleVote = (postId, clicked) => {
setPosts((prev) => prev.map((post) => (post.id === postId ? applyVote(post, clicked) : post)));
};
const visiblePosts = sortPosts(posts, sortMode);
return (
<div className="min-h-screen bg-gray-100 p-4 text-gray-900">
<div className="mx-auto max-w-xl space-y-3">
<h1 className="text-2xl font-bold">Crew Council</h1>
<div className="flex gap-2">
{['hot', 'new', 'top'].map((mode) => (
<button
key={mode}
type="button"
onClick={() => setSortMode(mode)}
aria-pressed={sortMode === mode}
className={sortMode === mode ? 'rounded bg-orange-600 px-3 py-1 text-white' : 'rounded px-3 py-1 hover:bg-gray-200'}
>
{mode}
</button>
))}
</div>
{visiblePosts.map((post) => (
<article key={post.id} className="flex gap-3 rounded-lg border border-gray-200 bg-white p-3">
<VoteButtons score={score(post)} userVote={post.userVote} onVote={(clicked) => handleVote(post.id, clicked)} />
<h2 className="self-center font-semibold">{post.title}</h2>
</article>
))}
<section className="rounded-lg bg-white p-3 text-sm">
<h2 className="mb-2 font-bold">Contrôle de applyVote</h2>
<ul className="space-y-1">
{checks.map((check) => (
<li key={check.name} className={passes(check) ? 'text-green-700' : 'font-semibold text-red-700'}>
{passes(check) ? 'VALIDÉ' : 'ÉCHOUÉ'} : {check.name}
</li>
))}
</ul>
<p className="mt-2 text-gray-600">
Casse applyVote, par exemple supprime la soustraction de l'ancien vote, et regarde quels cas changent de couleur.
</p>
</section>
</div>
</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. Comment le score est-il calculé dans un système de vote ?
2. Quelles valeurs userVote peut-il prendre ?
Voici 2 des 8 questions de cette leçon. Réponds aux autres dans le jeu.
Tâches pratiques dans le jeu
- Éditeur de code
Composant de boutons de vote
- Clique dans l'ordre
Construis le calcul du score en cliquant sur les éléments dans l'ordre :
- Tri vertical
Ordonne les étapes du travail avec Claude Code sur la fonction applyVote, comme dans la leçon :
- Éditeur de code
Trier les posts par mode
- Tri horizontal
Ordonne la ligne qui fixe le nouveau vote dans applyVote (une ligne, de gauche à droite) :
- Tri horizontal
Ordonne la commande de CLAUDE.md qui lance les tests une seule fois, sans mode surveillance (une ligne, de gauche à droite) :
- Clique dans l'ordre
Construis l'expression donnant un score négatif (50 upvotes, 60 downvotes) :
Exercices après cette leçon
- QuestionQuiz : Calcul du score
- QuestionQuiz : État userVote
- QuestionQuiz : résultat du score 100 contre 20
- Exercice de codePratique : Boutons de vote
- Clique dans l'ordreClic dans l'ordre : calculer le score
- QuestionQuiz : basculer un upvote
- Remets dans l'ordreTri : d'abord le test, puis le code
- QuestionQuiz : la formule hot
- QuestionQuiz : le pourcentage d'upvotes
- Exercice de codePratique : Trier les posts
- Remets dans l'ordreTri : le nouveau vote dans applyVote
- QuestionQuiz : hot et l'âge du post
- QuestionQuiz : les modes top et new
- Remets dans l'ordreTri : la commande de test
- Clique dans l'ordreClic dans l'ordre : score négatif