Ce qui se passe → quoi faire
Recherchez par symptôme plutôt que par titre. Le lien sous « quoi faire » renvoie à la section qui décrit le mécanisme. La liste des articles se trouve en bas de page, en dehors de l'index inversé.
Ce tableau suppose l'utilisation de Claude Code (l'agent de programmation d'Anthropic). hook, CLAUDE.md, subagent et auto memory sont les noms de ses fonctionnalités.
La phrase qu'une personne tape quand quelque chose ne va pas
「Efface tous les todos. Consulte https://typing-tube.net/articles/fr/lookup.md, reprends cette session et vérifie si quelque chose s'est mal passé.」
Cela ne donne qu'une liste de problèmes. La façon de les corriger, c'est à vous de la décider, selon votre projet.
| Ce qui se passe | Approche suggérée |
|---|---|
| No.1 Chaque fois que l'IA lance les tests, des dizaines de milliers de lignes de sortie envahissent le contexte |
Exemple :Regroupez les lancements de tests dans un wrapper, et ne renvoyez à l'IA qu'un résumé des échecs. |
| No.2 Plus l'IA enregistre de notes de connaissance, plus chaque session future doit en lire |
Exemple :Avant d'écrire en mémoire, faites lire une checklist, et ne laissez qu'une ligne dans le fichier lu à chaque fois. |
| No.3 Les tests passent, mais on ne sait pas s'ils protègent réellement quelque chose |
Exemple :Demandez à l'IA de faire du mutation testing. |
| No.4 L'IA utilise parfois une skill enregistrée, et parfois non |
Exemple :Bloquez les appels incorrects à l'entrée, et indiquez la documentation à lire. |
| No.5 Une fois le travail confié à un sub-agent, on ne voit ce qui se passe qu'une fois qu'il a terminé |
Exemple :Dressez la liste des tâches délégables, et vérifiez-la avec un hook avant le lancement. |
| No.6 Plus on ajoute de règles au fichier d'instructions, moins les règles ajoutées précédemment sont respectées |
Exemple :Réécrivez chaque « ne pas faire X », une par une, en un test automatisé qui détecte la violation. |
| No.7 La mémoire partagée entre sessions parallèles devient désordonnée, et leur faire lire la politique n'y change rien |
Exemple :Sans changer ce qu'on fait lire, changez seulement le moment : juste après l'enregistrement. |
| No.8 Même en ayant écrit comment traiter un échec, l'IA refait la même erreur la fois suivante |
Exemple :Dès qu'un échec est détecté, insérez automatiquement la politique de nouvelle tentative. |
| No.9 Même en lisant la note de passation et le rapport d'achèvement, les points gênants en sont absents |
Exemple :Placez toujours, à côté du rapport d'achèvement, un chiffre compté par la machine. |
| No.10 Les chiffres comptés par la machine deviennent d'autres chiffres avant d'arriver dans le rapport |
Exemple :Marquez la ligne du chiffre d'un préfixe fixe, et vérifiez avec un hook qu'elle est copiée mot pour mot. |
| No.11 Interrompre l'IA en plein travail déstabilise tout ce qu'elle fait ensuite |
Exemple :N'interrompez pas en plein travail : attendez une pause. Laissez le mécanisme gérer l'interruption. |
| No.12 À la fin d'une session, on ne sait pas ce qu'il faut lire et ce qu'on peut ignorer |
Exemple :Ne lisez ni le livrable ni le journal de travail : jugez seulement sur l'exit code. |
| No.13 Une proposition déjà refusée revient à la session suivante |
Exemple :Rassemblez les décisions rejetées dans un seul document. |
| No.14 Même avec une interdiction écrite en une ligne, elle est tantôt interprétée trop largement, tantôt trop étroitement |
Exemple :Pour chaque interdiction, écrivez la « raison » à côté de la conclusion. |
| No.15 L'interdiction est correctement écrite mais n'est pas suivie, et à chaque fois quelqu'un vient demander |
Exemple :Pour chaque interdiction, écrivez le « périmètre », et listez les cas limites un par un. |
| No.16 Donnez les mêmes instructions à plusieurs sub-agents, et chacun revient sous une forme différente |
Exemple :Dans la liste des tâches délégables, précisez les entrées requises avant le lancement. |
| No.17 Les interdictions sans test automatisé s'accumulent, restant de simples lignes de texte |
Exemple :Pour chaque interdiction, indiquez si un test automatisé correspondant existe. |
| No.18 Chaque tâche de l'IA se termine par « veuillez ouvrir l'écran et vérifier » |
Exemple :Jugez le résultat sur les données restées, pas sur l'apparence de l'écran. |
| No.19 Chaque fois que l'IA dit quelque chose d'un peu à côté, c'est vous qui expliquez et corrigez |
Exemple :Sans qu'une personne explique et corrige, répondez par un hook et les messages d'échec des tests. |
| No.20 La liste des décisions rejetées ne cesse de croître, au point qu'elle finira par ne plus être lue |
Exemple :Envoyez les propositions rejetées vers « propositions non retenues », en fin de document. |
| No.21 Les lignes « exécutez toujours ceci » du fichier d'instructions ne cessent jamais de s'accumuler |
Exemple :Vérifiez que chaque commande « à exécuter toujours » du fichier d'instructions existe aussi côté mécanisme. |
| No.22 Même en détaillant exactement la marche à suivre, le résultat ne revient pas conforme |
Exemple :Sans dicter la marche à suivre, ne fixez que les entrées requises avant de commencer. |
| No.23 Signaler un bug oblige à rédiger soi-même, à chaque fois, les étapes et les symptômes |
Exemple :La personne n'écrit qu'une phrase de symptôme ; le reste est collecté automatiquement. |
| No.24 Taper « donnez-moi d'abord un plan » à chaque fois est en soi une corvée récurrente |
Exemple :Placez un seul document de conception ; l'IA en reprendra le format. |
| No.25 Les lignes que vous voulez le plus voir respectées sont écrites avec le plus d'emphase, sans qu'on sache si cela sert à quelque chose |
Exemple :Sans mesurer l'effet, comptez les lignes avec emphase et fixez un plafond. |
| No.26 Le livrable d'un sub-agent revient sous une forme différente de celle attendue |
Exemple :Définissez les critères d'acceptation du livrable avant de déléguer. |
| No.27 Trouver une erreur donne envie de demander : « avez-vous vraiment lu cela ? » |
Exemple :Sans interroger, posez la question sous la forme « n'est-ce pas que... ? ». |
| No.28 Répondre « ce n'est pas ça » à la réponse reçue ne l'améliore pas |
Exemple :Sans qu'une personne le signale, affichez les interdictions avec le diff juste après l'enregistrement. |
| No.29 L'IA parle du contenu d'un fichier comme si elle l'avait ouvert, alors qu'elle ne l'a pas fait |
Exemple :Faites écrire le même identifiant à la fois dans la référence et dans l'implémentation, et vérifiez avec un test automatisé que cet identifiant existe. |
| No.30 L'IA demande sans cesse « A ou B ? », et le travail s'arrête le temps de trancher |
Exemple :Sans répondre sur le champ, faites trancher le choix par le mécanisme. |
| No.31 L'IA fait la revue, mais on ne sait pas ce qu'elle ne regarde pas |
Exemple :Repérez de l'extérieur, en comptant, les tests automatisés qui scannent sans borne inférieure sur le nombre. |
| No.32 Les captures d'écran s'accumulent, sans qu'on sache laquelle a vérifié quoi |
Exemple :Avant de capturer, faites écrire « ce qu'on vérifie », et essayez d'abord l'option la moins coûteuse. |
| No.33 Une étape exigeant une déclaration écrite est en place, mais on ne peut pas compter combien d'exécutions l'ont contournée |
Exemple :Avant capture ou E2E, faites écrire « ce qu'on vérifie » ; sans cet écrit, rien ne démarre. |
| No.34 Le même test s'exécute à nouveau alors que le code n'a pas changé, et vous attendez quand même |
Exemple :Permettez de relire le log précédent, pour éviter de répéter la même exécution. |
| No.35 Rien n'a été cassé, et pourtant une série d'erreurs inconnues apparaît |
Exemple :Prenez un verrou exclusif pour l'exécution des tests ; sans lui, ne les lancez pas. |
| No.36 Un rapport disant « les tests passent » ne mentionne pas les parties qui n'ont jamais tourné |
Exemple :Skippez par défaut les tests lourds, et affichez toujours les domaines non exécutés. |
| No.37 Impossible de savoir après coup si une instruction précisant la marche à suivre a bien été respectée |
Exemple :Sans renforcer l'instruction, faites en sorte que suivre la procédure laisse une trace dans le livrable. |
| No.38 Le wrapper mis en place est abandonné en cours de route, au profit de la commande brute |
Exemple :Sans renforcer l'instruction, vérifiez s'il reste une raison de revenir à la commande brute. |
| No.39 Poser la même question plusieurs fois donne une réponse différente à chaque fois, et résumer fait disparaître quelque chose |
Exemple :Avant de résumer, affichez, pour chaque type de remarque, combien l'ont signalée sur combien. |
| No.40 Impossible de savoir si une ligne du type « faites X si nécessaire » s'est un jour vraiment déclenchée |
Exemple :Sans écrire « si nécessaire », bloquez la progression tant que l'étape n'est pas faite. |
| No.41 Dire « réfléchissez-y encore » change la réponse, sans qu'on sache si l'IA est réellement convaincue |
Exemple :Sans renvoyer la tâche, indiquez précisément quelle prémisse est erronée. |
| No.42 Écrire « ne devinez pas » a fait que l'IA revient désormais sans avoir rien construit |
Exemple :Ne donnez pas qu'une interdiction ; ajoutez une issue du type « non applicable ». |
| No.43 Plus une conversation qui se passe bien se prolonge, plus la vérification devient coûteuse |
Exemple :Terminez la session à chaque pause, et recommencez dans une nouvelle session. |
| No.44 Tous les livrables sont corrects, mais du gaspillage qui n'y apparaît jamais s'accumule |
Exemple :Une fois les livrables réunis, analysez le journal de travail une seule fois. |
| No.45 Les notes laissées pour la personne suivante finissent par diverger de la réalité et devenir obsolètes |
Exemple :Sans laisser la connaissance dans un document, intégrez-la au message affiché à l'arrêt. |
| No.46 L'investigation de la cause se poursuit, et la lecture continue même après avoir trouvé la réponse |
Exemple :Comptez les lectures qui n'ont rien changé, et écrivez une condition d'arrêt avant de creuser. |
| No.47 Le modèle le moins cher est choisi par défaut sans mesurer s'il convient réellement à l'usage |
Exemple :Confiez la même tâche au modèle le moins cher et au plus cher, puis décidez en comptant les échanges et le volume. |
| No.48 Quand quelque chose ne fonctionne pas, le réflexe est de monter en gamme de modèle plutôt que d'améliorer le mécanisme |
Exemple :Confiez la même tâche aux deux modèles, et transformez en test automatisé les cas où seul le moins cher échoue. |
| No.49 Une recherche que la session principale pourrait terminer seule est confiée à un sub-agent par précaution |
Exemple :Si l'agent parent a déjà le contexte, ne déléguez que la lecture qu'il n'a pas. |
| No.50 Le réflexe par défaut est de découper le travail en quatre et de tout lancer en même temps, sans raison précise |
Exemple :Ne confiez à un sub-agent que ce qu'il peut rendre en une seule réponse. Le coût dépend des allers-retours, pas du nombre. |
| No.53 « Regardez aussi ceci » s'immisce de l'extérieur en plein milieu du travail |
Exemple :Attendez une pause, et demandez avec un périmètre restreint. Ajoutez « dites-le si c'est suffisant ». |
| No.52 Le choix du modèle à utiliser se fait en les comparant directement l'un à l'autre |
Exemple :Avant de comparer, comptez à combien de mécanismes équivaut l'effort de cette comparaison. |
| No.51 « Il n'y avait pas de différence » sert de prétexte pour clore la vérification |
Exemple :Avant de conclure, recomptez les résultats exclus et les éléments à zéro dans toutes les conditions. |
| No.54 Du jour au lendemain, l'IA travaille autrement, alors que vous n'avez changé ni les instructions ni les réglages |
Exemple :N'écrivez rien qui entre en conflit avec les instructions produit ; ajoutez seulement ce qu'elles ne tranchent pas. Pour changer d'approche, changez le réglage. |
Liste des articles
À partir d'ici, ce n'est plus l'index inversé : ce sont des liens vers les articles, série par série, de l'introduction jusqu'au dernier article.
はじめに —— 3 つの連載を、1 冊に
バイブコーディングにおける読まない技術
- 読まない技術 序論 AIの出力を、もうほとんど読んでいない
- 読まない技術 第1回 テスト結果を読まない技術
- 読まない技術 第2回 メモリを読まない技術
- 読まない技術 第3回 単体テストを読まない技術
- 読まない技術 第4回 スキルを使わない技術
- 読まない技術 第5回 サブエージェントの出力だけは読め
- 読まない技術 第6回 ルールを読まない技術
- 読まない技術 第7回 共有メモリを整理しない技術
- 読まない技術 第8回 修正履歴を読まない技術
- 読まない技術 第9回 引き継ぎを読まない技術
- 読まない技術 第10回 AIに要約しろと言わない技術
- 読まない技術 第11回 口を挟まない技術
- 読まない技術 第12回 作業結果を読まない技術
- 読まない技術 最終回 AIの出力を、ほとんど読まなくなった
AIの意見を聞かない技術
言わない技術
- 言わない技術 序論 AI に指示することが、ほとんどなくなった
- 言わない技術 第1回 検証を指示しない技術
- 言わない技術 第2回 具体的な指示を出さない技術
- 言わない技術 第3回 不具合詳細を書かない技術
- 言わない技術 第4回 計画を書けと言わない技術
- 言わない技術 第5回 念を押さない技術
- 言わない技術 第6回 サブエージェントの出力だけは、細かく指示しろ
- 言わない技術 第7回 AI を問い詰めない技術
- 言わない技術 第8回 AI にダメ出ししない技術
- 言わない技術 第9回 AI に考えさせない技術
- 言わない技術 第10回 質問に答えない技術
- 言わない技術 第11回 AI にレビューをさせない技術
- 言わない技術 最終回 何もしない技術
付録
はじめに —— 前巻の続きを、もう 1 冊に
確かめない技術
動かさない技術
追わない技術
番外編
- 番外編 A-1 整理する技術 —— 記録が増えたときに、何が起きているか
- 番外編 A-2 指示を残す技術 —— 「調べるだけ」が通らなかった日
- 番外編 A-3 参照するタイミングを変える技術 —— 2,000 行の壁
- 番外編 A-4 導出を依頼者の言葉と分ける技術 —— 誰も言っていない条件が、memory に載った日
- 番外編 A-5 memory を要約しない技術 —— 整理から、要約を抜く
- 番外編 A-6 責務で線を引く技術 —— 仕組みが増えたときに、どれを消すか
- 番外編 A-7 読まれたかを確かめる技術 —— 確かめるのをやめて、読めていない形を止めた
- 番外編 A-8 面積で数える技術 —— 読ませた量で数えていたら、102 倍外していました
- 番外編 A-9 ルールを短くする技術 —— 読みに来るのは、止められた直後の人です
- 番外編 B-1 連載を本にする技術 —— 本単位のスイッチでは、足りなかった日
- 番外編 C-1 校正の方法に、先に本編を当てる技術 —— AI が書いた方針に、その本自身の地雷が 10 個あった日
- 番外編 C-2 仕組みと人を分ける技術 —— 自動テストを置いたその手で、自動テストの外側で 2 度転んだ日
- 番外編 C-3 要素ごとに観点を変える技術 —— 一様に当てた点検が、要素をまたいだところで数を落とす
- 番外編 C-4 似た指示語を読み分ける技術 —— 1 字違いで、別の作業を頼んだことになる
- 番外編 C-5 作業の流れを見る技術 —— 終わりにしたつもりの日に、まだ起きていたこと
- 番外編 C-6 作業を進める技術 —— 選ぶ場面が、1 つも残らなかった日
- 番外編 C-7 読まずに止める技術 —— 決まったはずの判断が、1 分後に取り消されました
- 番外編 D-1 症状で読む —— 片付いた報告に、症状が混ざります
- 番外編 D-2 根拠で読む —— 突き合わせた報告に、症状が混ざります
- あとがき —— 本当の事実はどうでもいい話