Cours Vibe coding avec Claude Code · Module 10: Clone de TikTok

Ton propre subagent relecteur : video-reviewer

11 min de lecture
Dans cette leçon13

Repasse dans ta mémoire les trois dernières revues du capitaine. Dans le feed, tu cherchais pause, dans l'enregistreur getTracks et clearInterval, dans l'éditeur revokeObjectURL. À chaque fois la même liste : la caméra s'éteint-elle, le lecteur s'arrête-t-il, l'adresse de l'enregistrement est-elle libérée, un refus d'accès donne-t-il un message. Ces erreurs n'abîment pas l'apparence, donc le lint et le build ne les voient pas, et Treasure Reels va recevoir d'autres composants vidéo. Au lieu de coller cette liste dans la conversation à chaque fois, tu vas engager un maître d'équipage qui fait chaque soir le tour du gréement avec la même liste en main : ton propre subagent.

Ce que tu vas apprendre

  • reconnaître quand un subagent personnel est rentable et quand une simple demande suffit ;
  • commander à Claude Code le fichier .claude/agents/video-reviewer.md et lire dans Cursor son frontmatter et son instruction ;
  • appeler le relecteur par son nom et vérifier toi-même chaque point de son rapport ;
  • distinguer un subagent d'un skill de la leçon 6_1 et de /code-review.

Le subagent en un paragraphe

Le subagent intégré Explore, tu le connais depuis la leçon 5_4. La documentation de Claude Code décrit chaque subagent de la même façon : il travaille dans sa propre fenêtre de contexte, avec sa propre instruction, des outils choisis et des permissions séparées. Il démarre avec un contexte vierge, donc il ne voit ni votre conversation ni les fichiers que Claude a déjà lus, et vers la conversation principale ne revient que son résumé. La documentation conseille d'écrire son propre subagent quand tu envoies encore et encore le même assistant avec les mêmes instructions. C'est exactement notre liste issue de trois revues.

Quand c'est rentable

Un subagent personnel a du sens quand trois conditions sont réunies en même temps :

  1. La répétition. Le même contrôle revient à chaque modification des composants vidéo.
  2. Un champ étroit. Cinq questions précises, pas "trouve toutes les erreurs".
  3. Son propre contexte. Le relecteur lit plusieurs longs fichiers, et vers la conversation ne revient qu'un court rapport.

Une question ponctuelle, tu la poses par une simple demande. Une procédure que tu veux lancer comme une commande dans ta conversation, tu l'enregistres comme skill. Le subagent est un membre d'équipage à part, avec sa propre cabine et sa propre liste.

Demande pour Claude Code

Tu peux écrire le fichier de l'agent à la main, mais il est plus simple de le commander. Dans les anciens tutoriels, tu verras un assistant sous la commande /agents. Selon la documentation, dans la version actuelle cette commande se contente de rappeler de demander un agent à Claude ou de modifier les fichiers de .claude/agents/, donc tu demandes :

Crée le subagent de projet .claude/agents/video-reviewer.md.
Il doit seulement lire le code : outils Read, Grep et Glob, modèle
sonnet. Il vérifie les fichiers avec video, audio, getUserMedia,
MediaRecorder et createObjectURL : la caméra, l'enregistrement, les
intervalles et les adresses d'objets sont-ils libérés au démontage,
play() gère-t-il le rejet, un refus d'accès donne-t-il un message.
Rapport en français, chaque trouvaille sous la forme fichier:ligne,
ce qui ne va pas, ce que ça risque, comment le vérifier. Ne corrige
rien, montre-moi seulement le fichier.

Ce que Claude a écrit : le frontmatter

Ouvre .claude/agents/video-reviewer.md dans Cursor. En haut se trouve le frontmatter, c'est-à-dire les réglages entre les lignes ---, avec la même notation que dans le skill de la leçon 6_1 :

---
name: video-reviewer
description: Relecteur des composants vidéo, caméra et son de Treasure Reels. Vérifie que la caméra, le lecteur, l'enregistrement et les adresses d'objets sont libérés au démontage et qu'un refus d'accès donne un message. À utiliser après chaque modification des fichiers avec video, audio, getUserMedia, MediaRecorder ou createObjectURL.
tools: Read, Grep, Glob
model: sonnet
---

Selon la documentation, seuls deux champs sont obligatoires. name est le nom par lequel tu appelles l'agent. description est lue par Claude quand il décide à qui confier la tâche, c'est pourquoi la description dit ce que l'agent vérifie et quand l'utiliser. La documentation conseille d'ajouter une formule du genre "use proactively", c'est-à-dire "à utiliser de façon proactive", si tu veux que Claude fasse appel à l'agent de lui-même.

tools est le laissez-passer : le subagent ne reçoit que les outils listés. Read lit un fichier, Grep cherche du texte dans les fichiers, Glob cherche des fichiers par leur nom. Sans le champ tools, l'agent hérite de tous les outils disponibles pour les subagents, y compris la modification de fichiers et Bash. model est facultatif : sans lui, l'agent travaille sur le même modèle que la conversation, et sonnet est l'alias du modèle Sonnet. Chez nous, l'enregistrement de l'exécution a montré deux modèles : la session principale sur le modèle des réglages du compte et le relecteur sur Sonnet.

Ce que Claude a écrit : l'instruction

Sous le frontmatter se trouve le contenu. La documentation dit clairement que c'est toute l'instruction système du subagent : il la reçoit avec les données de base sur l'environnement, mais sans l'instruction système de Claude Code. C'est pourquoi la liste doit être concrète :

1. Caméra et micro : chaque flux issu de getUserMedia a un stop() sur chaque piste
   (getTracks) dans le nettoyage de l'effet, lors du remplacement du flux et au
   démontage, même quand le composant disparaît avant que l'utilisateur donne son accord.
2. Enregistrement : MediaRecorder arrêté au démontage seulement si state n'est pas
   "inactive" ; chaque setInterval et setTimeout a son clearInterval ou clearTimeout.

Ce sont deux des cinq points : les autres portent sur play() et pause(), sur revokeObjectURL et sur le message en cas de NotAllowedError et NotFoundError. Chaque point est une erreur que tu as trouvée dans les leçons 9_1 à 9_3, pas une généralité du genre "vérifie la qualité". Le dernier paragraphe de l'instruction fixe le format du rapport et demande de le terminer par une phrase disant de quelles trouvailles l'agent n'est pas sûr.

L'appel par le nom

La documentation donne deux voies. Tu peux écrire une phrase ordinaire avec le nom de l'agent, ou taper @ et choisir l'agent dans les suggestions. Claude peut aussi y recourir de lui-même quand la tâche correspond à la description. Si le dossier .claude/agents/ est apparu pendant la session, la documentation demande de la relancer : /exit, puis claude -c.

Une limite découle du laissez-passer. Un relecteur sans Bash ne lancera ni git diff ni les tests, donc tu lui désignes les fichiers. Voici notre appel après l'ajout du bouton "Retourner la caméra" :

Utilise le subagent video-reviewer et relis @components/VideoRecorder.tsx
après la modification du dernier commit (le bouton de changement de caméra).
Quand il a fini, recopie-moi son rapport, puis écris dessous quels points
ne peuvent pas être confirmés par la seule lecture du code.

Sur cette branche, nous avons volontairement supprimé l'effet qui éteignait la caméra, car c'est exactement ainsi que l'agent peut perdre le nettoyage à l'occasion d'une autre modification. Le lint et npx tsc --noEmit sont passés, et le test de la leçon 9_2 a échoué avec le nom éteint la caméra après la sortie de la page. Le test dit pourtant seulement que la caméra reste allumée après la sortie.

Ce qu'a apporté le relecteur

Nous avons lancé cette demande en mode sans fenêtre, claude -p, que tu découvriras dans la location 13. L'exécution a duré environ deux minutes et demie, et l'enregistrement a confirmé un appel de video-reviewer. Le rapport commençait ainsi (abrégé) :

1. VideoRecorder.tsx:102-110 (`switchCamera`) - le flux précédent ne reçoit
   jamais `stop()`. `setStream(media)` ne fait que remplacer l'état, donc
   l'ancienne caméra et l'ancien micro continuent de fonctionner.
2. VideoRecorder.tsx:137-141 (`disableCamera`) - `setStream(null)` n'arrête
   pas les pistes, et il n'y a pas non plus de `getTracks().forEach(stop)`.
3. VideoRecorder.tsx:88-100 (nettoyage au démontage) - le flux de `stream`
   n'est pas arrêté au démontage.

Le rapport comptait 11 points et se terminait par la phrase : "Je n'ai exécuté ni le code ni les tests." Le relecteur n'a pas apporté un verdict, mais une liste d'hypothèses avec des adresses.

Comment lire le rapport

Chaque point, tu le vérifies de la même façon que le rapport de /security-review dans la leçon 8_7 : tu ouvres le fichier dans Cursor, tu vas à la ligne indiquée et tu cherches la preuve.

  1. Une cause commune. Chez nous, les points 1, 2 et 3 avaient une seule cause : l'absence d'un effet qui appelle stop() sur les pistes à chaque changement de flux. Une seule correction ferme trois points.
  2. Vrai, mais à part. Le point sur l'absence de try/catch dans switchCamera était juste : un refus lors du retournement de la caméra ne donnait pas de message.
  3. Des remarques, pas des erreurs. Les trois derniers points sont des broutilles et des descriptions de ce qui fonctionne. Un long rapport fatigue, donc à l'appel suivant, ajoute "au plus 5 trouvailles, seulement des erreurs" ou corrige l'instruction dans le fichier de l'agent.
  4. Des détails à vérifier. La session principale avait écrit dans son commentaire "React 18", alors que le projet a React 19. La version, tu la vérifies dans package.json, pas dans le rapport.

La correction et la seconde exécution

La correction passe par une seule demande étroite, comme dans la leçon 8_7 : "Dans @components/VideoRecorder.tsx, rétablis l'effet qui arrête les pistes quand le flux change, et dans switchCamera ajoute un try/catch avec cameraErrorMessage et la vérification de mountedRef. Rien d'autre. Ensuite lint, types et tests." Chez nous, les 32 tests sont passés. La seconde exécution, nous l'avons lancée par claude --agent video-reviewer, c'est-à-dire toute la session en tant que cet agent, avec la mention "au plus 5 trouvailles, seulement des erreurs". Elle a duré 34 secondes, elle n'a plus signalé la fuite de caméra, mais elle a donné trois nouveaux points plus petits, dont un qu'elle a elle-même marqué comme incertain. Chacun, tu l'évalues comme les précédents : correction, note TODO ou rejet avec justification.

Subagent, skill ou /code-review

Trois outils se ressemblent, mais font autre chose :

  • /code-review de la leçon 2_9 est une revue générale des erreurs de fonctionnement dans un subagent tout neuf. Sans --fix, il ne fait que rapporter, mais il ne reçoit pas ta liste de questions vidéo.
  • Le skill de la leçon 6_1 est une recette que Claude charge dans ta conversation quand tu tapes la commande ou quand elle convient à la tâche. Il travaille dans ta conversation et dans son contexte.
  • video-reviewer est un membre d'équipage permanent : son propre contexte, ta liste étroite et un laissez-passer en lecture seule.

Mon conseil : commence par /code-review. Quand tu colles pour la troisième fois la même liste de contrôle, enregistre-la comme subagent.

Un fichier commun pour l'équipage

Le fichier .claude/agents/video-reviewer.md se trouve dans le projet, donc il voyage dans le dépôt comme .claude/settings.json de la leçon 8_4. La documentation conseille de garder les agents du projet dans le système de gestion de versions, pour que l'équipage puisse les utiliser et les améliorer. Les agents rien que pour toi, tu les gardes dans ~/.claude/agents/, et à nom égal, l'agent du projet l'emporte. Souviens-toi aussi de la facture de la leçon 5_10 : selon la documentation, les appels de subagents comptent dans les mêmes limites que la conversation principale.

Étape suivante

Demande un commit, par exemple "Subagent video-reviewer et correction du changement de caméra". Au mentor, tu enverras une capture de Treasure Reels qui fonctionne, le rapport de video-reviewer et une phrase sur ce que tu as corrigé après la revue.

Dans l'éditeur ci-dessous t'attend le rapport du relecteur sur un composant qui fuit. À chaque point, va voir la ligne indiquée, juge-le juste ou faux, puis passe le composant à la version corrigée et vérifie le voyant de la caméra.

À retenir : un maître d'équipage avec une bonne liste fait le tour du gréement plus vite que tout l'équipage, mais c'est le capitaine qui vérifie chaque cordage qu'il a désigné avant d'ordonner de le remplacer.

Code de cette leçon : App.jsx
// Rapport du subagent video-reviewer en miniature : vérifie chaque trouvaille dans le code.
// Le relecteur n'a que Read, Grep et Glob : il désigne des lignes, mais ne change rien.
import { useState } from 'react';

const BUGGY = [
  'export function VideoRecorder() {',
  '  const [stream, setStream] = useState(null);',
  '  const [facing, setFacing] = useState("user");',
  '',
  '  async function switchCamera() {',
  '    const next = facing === "user" ? "environment" : "user";',
  '    const media = await navigator.mediaDevices.getUserMedia({',
  '      video: { facingMode: next },',
  '    });',
  '    setFacing(next);',
  '    setStream(media);',
  '  }',
  '',
  '  function disableCamera() {',
  '    setStream(null);',
  '  }',
  '  // ...aperçu et boutons',
  '}',
];

const FIXED = [
  'export function VideoRecorder() {',
  '  const [stream, setStream] = useState(null);',
  '  const [facing, setFacing] = useState("user");',
  '',
  '  useEffect(() => {',
  '    if (!stream) return;',
  '    return () => stream.getTracks().forEach((t) => t.stop());',
  '  }, [stream]);',
  '',
  '  async function switchCamera() {',
  '    const next = facing === "user" ? "environment" : "user";',
  '    try {',
  '      const media = await navigator.mediaDevices.getUserMedia({',
  '        video: { facingMode: next },',
  '      });',
  '      setFacing(next);',
  '      setStream(media);',
  '    } catch (err) {',
  '      setError(cameraErrorMessage(err));',
  '    }',
  '  }',
  '  // ...aperçu et boutons',
  '}',
];

const FINDINGS = [
  { id: 1, line: 11, text: 'switchCamera remplace le flux sans stop() sur les anciennes pistes : la vieille caméra continue de tourner.', real: true,
    why: 'Juste : à la ligne 11 il n’y a que setStream(media), et getTracks() n’apparaît nulle part.' },
  { id: 2, line: 15, text: 'disableCamera met null, mais les pistes ne reçoivent pas stop() : le voyant reste allumé après la coupure.', real: true,
    why: 'Juste : le fichier ne contient aucun effet de nettoyage qui arrêterait les pistes.' },
  { id: 3, line: 7, text: 'getUserMedia dans switchCamera sans try/catch : un refus d’accès ne donne aucun message.', real: true,
    why: 'Juste : la promesse rejetée n’aboutit à aucun message.' },
  { id: 4, line: 11, text: 'Pas de URL.revokeObjectURL pour l’adresse de l’aperçu : la mémoire grossit à chaque enregistrement.', real: false,
    why: 'Faux : ce fichier ne contient pas createObjectURL, donc il n’y a rien à libérer. Un grep sur createObjectURL ne trouvera rien.' },
];

export default function App() {
  const [fixed, setFixed] = useState(false);
  const [selected, setSelected] = useState(null);
  const [verdicts, setVerdicts] = useState({});
  const [mounted, setMounted] = useState(true);
  const [liveTracks, setLiveTracks] = useState(0);
  const [note, setNote] = useState('');

  const lines = fixed ? FIXED : BUGGY;

  function enable() {
    if (!mounted) return;
    setLiveTracks((n) => (fixed ? 1 : n + 1));
  }
  function switchCam() {
    if (!mounted || liveTracks === 0) return;
    setLiveTracks((n) => (fixed ? 1 : n + 1));
  }
  function disable() {
    if (fixed) setLiveTracks(0);
  }
  function toggleMounted() {
    if (mounted && fixed) setLiveTracks(0);
    setMounted((m) => !m);
  }
  function changeVersion(next) {
    setFixed(next);
    setLiveTracks(0);
    setMounted(true);
    setSelected(null);
  }

  const lamp = liveTracks > 0;

  return (
    <div className="min-h-screen bg-gray-950 p-4 text-white flex flex-col gap-4 lg:flex-row">
      <section className="lg:w-1/2">
        <div className="mb-2 flex gap-2 text-sm">
          <button type="button" onClick={() => changeVersion(false)} className={!fixed ? 'rounded bg-red-700 px-3 py-1' : 'rounded bg-gray-700 px-3 py-1'}>Version avec l&apos;erreur de l&apos;agent</button>
          <button type="button" onClick={() => changeVersion(true)} className={fixed ? 'rounded bg-green-700 px-3 py-1' : 'rounded bg-gray-700 px-3 py-1'}>Après correction</button>
        </div>
        <p className="text-xs text-gray-400">components/VideoRecorder.tsx (skrót)</p>
        <pre className="overflow-x-auto rounded bg-gray-900 p-2 text-xs">
          {lines.map((line, i) => (
            <div key={i} className={selected === i + 1 ? 'bg-yellow-700' : ''}>
              <span className="inline-block w-6 text-gray-500">{i + 1}</span>{line}
            </div>
          ))}
        </pre>
      </section>

      <section className="flex-1 space-y-3 text-sm">
        <div>
          <p className="font-semibold">Rapport de video-reviewer (tools : Read, Grep, Glob)</p>
          {fixed ? (
            <p className="rounded bg-gray-800 p-2">Seconde exécution : aucune fuite de caméra signalée. Vérifie le voyant avant de le croire.</p>
          ) : (
            <ul className="space-y-2">
              {FINDINGS.map((f) => (
                <li key={f.id} className="rounded bg-gray-800 p-2">
                  <p>{f.id}. VideoRecorder.tsx:{f.line} - {f.text}</p>
                  <div className="mt-1 flex flex-wrap gap-2">
                    <button type="button" onClick={() => setSelected(f.line)} className="rounded bg-gray-700 px-2 py-1">Voir la ligne</button>
                    <button type="button" onClick={() => setVerdicts((v) => ({ ...v, [f.id]: true }))} className="rounded bg-gray-700 px-2 py-1">Juste</button>
                    <button type="button" onClick={() => setVerdicts((v) => ({ ...v, [f.id]: false }))} className="rounded bg-gray-700 px-2 py-1">Faux</button>
                  </div>
                  {f.id in verdicts && (
                    <p className={verdicts[f.id] === f.real ? 'mt-1 text-green-400' : 'mt-1 text-red-400'}>
                      {verdicts[f.id] === f.real ? 'Bien. ' : 'Vérifie encore une fois. '}{f.why}
                    </p>
                  )}
                </li>
              ))}
            </ul>
          )}
          <button
            type="button"
            onClick={() => setNote('video-reviewer n’a pas d’outil Edit ni Write : il ne fait que lire. Tu commandes la correction dans la session principale par une seule demande étroite.')}
            className="mt-2 rounded bg-amber-600 px-3 py-1 text-black"
          >
            Demander la correction au relecteur
          </button>
          {note && <p className="mt-1 text-amber-300">{note}</p>}
        </div>

        <div className="rounded bg-gray-900 p-2">
          <p className="font-semibold">Fausse caméra</p>
          <p>
            Voyant de la caméra : <span className={lamp ? 'text-red-500' : 'text-gray-500'}>{lamp ? '● allumé' : '○ éteint'}</span>
            {' '}| flux actifs : {liveTracks} | composant : {mounted ? 'sur la page' : 'démonté'}
          </p>
          <div className="mt-2 flex flex-wrap gap-2">
            <button type="button" onClick={enable} className="rounded bg-gray-700 px-2 py-1">Allumer la caméra</button>
            <button type="button" onClick={switchCam} className="rounded bg-gray-700 px-2 py-1">Retourner la caméra</button>
            <button type="button" onClick={disable} className="rounded bg-gray-700 px-2 py-1">Éteindre la caméra</button>
            <button type="button" onClick={toggleMounted} className="rounded bg-gray-700 px-2 py-1">{mounted ? 'Quitter la page' : 'Revenir sur la page'}</button>
          </div>
        </div>
      </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. 1. Qu'est-ce qu'un subagent dans Claude Code ?

  2. 2. Comment traites-tu le rapport du subagent video-reviewer ?

Voici 2 des 6 questions de cette leçon. Réponds aux autres dans le jeu.

Tâches pratiques dans le jeu

  • Tri vertical

    Ordonne les étapes du travail avec ton relecteur video-reviewer :

  • Tri horizontal

    Ordonne le chemin du fichier d'un subagent de projet :

  • Clique dans l'ordre

    Construis la ligne par laquelle la route renvoie la couverture issue de b64_json (clique dans l'ordre) :

  • Tri vertical

    Ordonne les étapes de la route POST /api/cover dans l'ordre du code :

  1. QuestionQu'est-ce qu'un subagent
  2. Remets dans l'ordreDu fichier de l'agent au commit
  3. QuestionLe rapport du relecteur, ce sont des hypothèses
  4. QuestionLes outils du relecteur
  5. Remets dans l'ordreLe fichier de l'agent dans le projet
  6. QuestionLa clé de l'API d'images
  7. Clique dans l'ordreLa couverture comme adresse data:
  8. QuestionLe champ description
  9. QuestionCe que le relecteur ne fera pas
  10. Remets dans l'ordreLes étapes de la route des couvertures
  11. Projet à envoyerEnvoie les Bobines du Trésor au mentor
  12. VidéoRésumé du module

Articles utiles