Tu as commenté DETTE. Dans la vidéo, je te dis qu'à force de réparer ton système, tu finis par travailler pour tes agents au lieu de travailler avec eux. Voici la sortie : pourquoi réparer ce qui casse entretient le cercle des trois dettes, et la seule chose à faire à la place, dans l'ordre.

<aside> ⚠️

Tu n'as pas encore Claude Code ?

Rien ne t'oblige à l'installer pour te servir de cette page : le prompt de la partie 4 fonctionne collé dans n'importe quel assistant, avec ta consigne à côté. Si tu veux faire tourner tes agents sur ton ordinateur, copie ce prompt dans ton IA (Claude, ChatGPT, un autre assistant) :

Aide-moi à installer Claude Code sur mon ordinateur.
Avant de commencer, va lire la documentation officielle Anthropic
https://code.claude.com/docs/en/setup sans te fier à tes seules connaissances
pré-entraînement : elle porte la procédure exacte selon mon système
(Mac / Windows / Linux) et la dernière version.
Ensuite, donne-moi les étapes une par une. Je n'ai jamais utilisé un terminal.

Ton IA va te guider pas à pas. Reviens ici après.

</aside>

<aside> ✅

Tu l'as installé mais tu l'utilises encore peu ? Tu es au bon endroit, et c'est même le meilleur moment.

Ce cercle n'attend pas un gros projet pour s'installer : il commence à la première correction faite à la main dans un résultat, au lieu d'être faite dans la consigne. Le réflexe que tu prends maintenant, tu n'auras jamais à le désapprendre. Continue.

</aside>

<aside> 💡

Tu utilises un autre outil que Claude Code ?

Rien ici ne dépend de Claude Code. Le cercle ne vit pas dans un outil, il vit dans ce que tu fais quand quelque chose casse. Sur Codex (OpenAI), sur Cursor, sur Copilot CLI, sur Antigravity CLI (qui a remplacé Gemini CLI pour les comptes particuliers le 18/06/2026), sur Hermes Agent ou sur OpenClaw, ta consigne de départ vit simplement dans un autre fichier. (Liste vérifiée le 11/09/2026.)

Copie ce prompt dans ton outil pour transposer :

J'utilise [nom de mon outil] et je veux appliquer ce principe : quand un
résultat sort mal, je corrige la consigne qui l'a produit au lieu de corriger
le résultat.
Avant de répondre, va lire la documentation officielle de mon outil si elle
existe, pour ne pas te baser sur des suppositions.
Dis-moi ensuite : où vit ma consigne de départ chez moi (fichier
d'instructions, spec, prompt système, emplacement exact), comment relancer une
exécution proprement depuis une consigne corrigée, et ce qui n'a pas
d'équivalent. Ne présume rien : si l'équivalent n'existe pas, dis-le au lieu
d'inventer.

</aside>

<aside> 🧭

Tu ne codes pas ? Lis quand même.

Ce que cette page appelle le cadrage, chez toi c'est la consigne que tu donnes à ton assistant : la procédure pour rédiger une relance, qualifier un dossier, préparer un devis. Le cabinet qui corrige à la main chaque compte rendu mal sorti colmate, et il recommence la semaine suivante. Celui qui ajoute à la consigne la phrase qui manquait ne corrige qu'une fois. Le temps passé à corriger, c'est du temps qui n'est plus passé avec les clients. Le cercle est le même, seuls les exemples changent.

</aside>

Pourquoi cette page existe

La vidéo pose le cercle. Cette page ne refait pas l'inventaire des trois dettes une par une : elle part du moment exact où le cercle se referme, celui où quelque chose casse et où tu t'apprêtes à réparer. Et elle te donne le geste à faire à la place, avec un prompt prêt à coller.

1. Le cercle, dessiné

Plus d'une centaine de systèmes d'agents me sont passés entre les mains, et tout le monde passe par là, moi compris. Dans un système d'agents, rien ne se construit, rien ne s'exécute avant d'être cadré : tu clarifies, tu spécifies, et c'est ce cadrage qui devient un plan, puis une exécution. Voilà ce qui arrive quand ce cadrage a des trous :

flowchart TD
    A["Cadrage troué<br>clarifier et spécifier ont été bâclés"] --> B["Dette documentaire<br>des trous dans ce qui guide l'exécution"]
    B --> C["Une exécution<br>à l'image de ces trous"]
    C --> D["Dette technique<br>tu la vois, tu la sens"]
    D --> E["Le réflexe :<br>réparer ce qui casse"]
    E --> F["Dette cognitive<br>la charge mentale de réparer sans fin"]
    F --> G["Moins vigilant, moins rigoureux,<br>moins patient au moment de cadrer"]
    G --> A

Les trois grands méchants loups des systèmes agentiques. Mais regarde la dernière flèche : ce ne sont pas trois problèmes côte à côte, c'est un cercle vicieux.

<aside> 🐍

Le maillon qui referme le cercle, c'est ta tête.

Réparer ne te coûte pas seulement du temps : ça te prend l'attention dont tu as besoin pour cadrer la suite. Tu cadres moins bien, tu laisses de nouveaux trous, qui fabriquent de nouvelles dettes techniques, qui te demandent encore plus de réparation. C'est le serpent qui se mord la queue.

</aside>

Et le vrai coût n'est pas le temps de réparation. C'est que tu passes plus de temps à réparer ton système qu'à être dans la production, c'est-à-dire dans ce pour quoi tu l'as construit. Tu travailles pour tes agents, et non plus avec eux.

2. Le piège : réparer ce qui se voit

La dette technique, tu la vois et tu la sens : quelque chose casse, là, maintenant. La dette documentaire, elle, est en amont : elle ne casse rien toute seule, elle fabrique ce qui casse. Alors le réflexe va là où ça fait mal, et c'est exactement ce qui entretient le cercle.

<aside> 🗣️

« C'est un petit défaut, ça ne justifie pas de revoir toute la documentation. »

C'est là que tu te trompes. La taille du défaut n'est pas le critère, son origine l'est. Un petit défaut né d'un trou dans ton cadrage revient à chaque exécution, et tu le paies à chaque fois.

</aside>