Wat er gebeurt → wat je eraan doet
Zoek op symptoom, niet op titel. De link onder "wat je eraan doet" gaat naar de sectie die de aanpak beschrijft. De lijst van artikelen staat onderaan deze pagina, buiten de omgekeerde index.
Deze tabel gaat uit van Claude Code (de coding-agent van Anthropic). hook, CLAUDE.md, subagent en auto memory zijn de namen van zijn functies.
De zin die een mens typt als er iets misgaat
「Wis alle todo's. Bekijk https://typing-tube.net/articles/nl/lookup.md, loop deze sessie terug en controleer of er iets is misgegaan.」
Hieruit komt alleen een lijst met problemen. Hoe je ze oplost, bepaal jij, passend bij je eigen project.
| Wat er gebeurt | Voorgestelde aanpak |
|---|---|
| No.1 Elke keer dat de AI de tests laat draaien, stromen er tienduizenden regels output de context in |
Voorbeeld:Bundel testruns in één wrapper en geef de AI alleen een samenvatting van de fouten terug. |
| No.2 Hoe meer kennisnotities de AI opslaat, hoe meer elke volgende sessie moet lezen |
Voorbeeld:Laat vóór het schrijven naar memory de checklist lezen; zet in het altijd gelezen bestand maar één regel. |
| No.3 De tests slagen, maar het is onduidelijk of ze werkelijk iets beschermen |
Voorbeeld:Laat de AI mutation testing uitvoeren. |
| No.4 De AI gebruikt een geregistreerde skill de ene keer wel en de andere keer niet |
Voorbeeld:Blokkeer verkeerd gebruik bij de ingang en verwijs naar de juiste documentatie. |
| No.5 Zodra werk aan een sub-agent wordt overgedragen, is niet zichtbaar wat er gebeurt totdat het klaar is |
Voorbeeld:Maak een lijst van de taken die gedelegeerd mogen worden en controleer deze met een hook vóór het starten. |
| No.6 Hoe meer regels aan het instructiebestand worden toegevoegd, hoe minder de eerder toegevoegde regels worden nageleefd |
Voorbeeld:Herschrijf elk verbod, één voor één, als een geautomatiseerde test die overtredingen detecteert. |
| No.7 De memory die parallel draaiende sessies delen, raakt rommelig; ze laten lezen van het beleid helpt niet |
Voorbeeld:Verander de inhoud niet, alleen het moment: toon het direct na het opslaan. |
| No.8 Zelfs als is vastgelegd hoe met een fout om te gaan, maakt de AI de volgende keer dezelfde fout opnieuw |
Voorbeeld:Voeg bij het detecteren van de fout automatisch het retrybeleid toe. |
| No.9 Zelfs na het lezen van de overdrachtstekst en het opleveringsrapport ontbreken de ongemakkelijke details |
Voorbeeld:Zet altijd machinaal geteld cijfers naast het opleveringsrapport. |
| No.10 Een getal dat door de machine is geteld, verandert onderweg naar het rapport in een ander getal |
Voorbeeld:Geef de cijferregel een vast voorvoegsel en gebruik een hook om te controleren of dit letterlijk is gekopieerd. |
| No.11 Als je de AI tijdens het werk onderbreekt, raakt alles wat daarna komt verstoord |
Voorbeeld:Onderbreek niet tijdens het werk; wacht op een breekpunt. Laat een mechanisme onderbreken. |
| No.12 Aan het einde van een sessie staat niet vast wat wel en niet gelezen hoeft te worden |
Voorbeeld:Lees noch het werk noch het log; beoordeel alleen op de exit code. |
| No.13 Een voorstel dat al eens is afgewezen, duikt in de volgende sessie weer op |
Voorbeeld:Verzamel afgewezen beslissingen in één document. |
| No.14 Ondanks een verbod van één regel wordt het zowel te ruim als te strikt geïnterpreteerd |
Voorbeeld:Schrijf bij elk verbod de "reden" naast de conclusie. |
| No.15 Het verbod staat correct beschreven maar wordt niet nageleefd, en elke keer komt er een vraag over binnen |
Voorbeeld:Schrijf bij elk verbod het "toepassingsbereik" en noem de twijfelgevallen één voor één. |
| No.16 Als dezelfde instructie naar meerdere sub-agents gaat, komt elk resultaat in een andere vorm terug |
Voorbeeld:Vermeld in de takenlijst welke invoer vóór het starten nodig is. |
| No.17 Verboden zonder geautomatiseerde test stapelen zich op als niets meer dan tekst op een pagina |
Voorbeeld:Geef bij elk verbod aan of er een bijbehorende geautomatiseerde test bestaat. |
| No.18 Elke keer eindigt het werk van de AI met "open het scherm en controleer het zelf" |
Voorbeeld:Beoordeel niet op het uiterlijk van het scherm, maar op de data die achterblijft. |
| No.19 Telkens als de AI iets net niet goed zegt, moet jij het zelf uitleggen en corrigeren |
Voorbeeld:Leg het niet zelf uit; laat een hook en de foutmeldingen van geautomatiseerde tests dat doen. |
| No.20 De lijst met afgewezen beslissingen blijft groeien en dreigt op een gegeven moment niet meer gelezen te worden |
Voorbeeld:Zet afgewezen voorstellen in de sectie "niet overgenomen voorstellen" achteraan. |
| No.21 De "voer dit altijd uit"-regels in het instructiebestand blijven zich ophopen |
Voorbeeld:Controleer of "altijd uitvoeren"-commando's ook echt in het systeem staan. |
| No.22 Zelfs met de exacte werkwijze erbij, komt de fix niet op die manier terug |
Voorbeeld:Schrijf geen procedure voor; bepaal alleen de invoer vóór het starten. |
| No.23 Om een bug te melden, schrijf je zelf steeds opnieuw de stappen en de symptomen uit |
Voorbeeld:Laat de mens alleen het symptoom noteren; verzamel de rest automatisch. |
| No.24 Elke keer opnieuw "geef eerst een plan" typen kost telkens moeite |
Voorbeeld:Plaats één ontwerpdocument; de AI volgt automatisch die opzet. |
| No.25 Juist de regels die het meest moeten worden nageleefd, zijn het sterkst benadrukt, maar het is onduidelijk of dat helpt |
Voorbeeld:Meet geen effect; tel benadrukte regels en stel een maximum in. |
| No.26 Het opgeleverde werk van een sub-agent komt terug in een andere vorm dan verwacht |
Voorbeeld:Bepaal de acceptatiecriteria voor het opgeleverde werk vóór het overdragen. |
| No.27 Als je een fout vindt, wil je vragen: "heb je dit wel echt gelezen?" |
Voorbeeld:Verwijt niets; vraag in de vorm "is het niet zo dat ...?". |
| No.28 Reageren met "nee, zo bedoel ik het niet" op het antwoord maakt het niet beter |
Voorbeeld:Wijs het niet zelf aan; toon het verbod samen met de diff na het opslaan. |
| No.29 De AI praat over de inhoud van een bestand alsof het is geopend, terwijl dat niet zo is |
Voorbeeld:Laat dezelfde identifier zowel in de referentie als in de implementatie opnemen, en gebruik een geautomatiseerde test om te controleren of die identifier bestaat. |
| No.30 De AI blijft vragen "A of B?" en het werk komt stil te liggen terwijl jij beslist |
Voorbeeld:Antwoord niet direct; laat een geautomatiseerde test of hook de keuze bepalen. |
| No.31 De AI voert de review uit, maar het is onduidelijk wat er niet wordt bekeken |
Voorbeeld:Spoor van buitenaf geautomatiseerde tests op die bestanden scannen maar geen ondergrens voor het aantal controleren. |
| No.32 Screenshots stapelen zich op, maar het is onduidelijk welke wat heeft geverifieerd |
Voorbeeld:Laat vóór het schieten opschrijven wat je verifieert; probeer eerst de goedkoopste methode. |
| No.33 Er is een stap ingebouwd die iets moet vastleggen, maar het aantal runs dat dit oversloeg valt niet te tellen |
Voorbeeld:Laat vóór screenshot of E2E opschrijven wat je verifieert; zonder dat geen run. |
| No.34 Dezelfde test draait opnieuw terwijl de code niet is veranderd, en je wacht er onnodig op |
Voorbeeld:Maak het vorige log herleesbaar, zodat een herhaalde run overbodig wordt. |
| No.35 Er is niets kapotgemaakt, maar er verschijnt een hele rij onbekende fouten |
Voorbeeld:Neem een exclusieve lock voor de testrun; zonder lock geen run. |
| No.36 Het rapport "de tests slagen" vermeldt niet welk deel niet is gedraaid |
Voorbeeld:Sla zware tests standaard over en toon steeds de niet-uitgevoerde domeinen. |
| No.37 Achteraf is niet vast te stellen of een instructie die de werkwijze voorschreef, ook is gevolgd |
Voorbeeld:Versterk de instructie niet; laat het opgeleverde werk zelf het gevolgde spoor tonen. |
| No.38 Een geïnstalleerde wrapper wordt halverwege weer vervangen door het kale commando |
Voorbeeld:Versterk de instructie niet; kijk of er nog een reden is om terug te vallen. |
| No.39 Dezelfde vraag herhaaldelijk stellen levert elke keer een ander antwoord op, en bij het samenvatten verdwijnt er iets |
Voorbeeld:Toon vóór het samenvatten per type bevinding hoeveel van hoeveel het noemden. |
| No.40 Onduidelijk is of een regel als "doe dit indien nodig" ooit daadwerkelijk in werking is getreden |
Voorbeeld:Schrijf geen "indien nodig"; blokkeer de voortgang zonder die stap. |
| No.41 Terugsturen met "denk er nog eens over na" verandert het antwoord, maar het is onduidelijk of de AI echt overtuigd is |
Voorbeeld:Stuur niet terug; wijs concreet aan welke aanname onjuist is. |
| No.42 Sinds "geen aannames doen" is voorgeschreven, komt de AI terug zonder iets te hebben gebouwd |
Voorbeeld:Geef niet alleen een verbod; bied ook de uitweg "niet van toepassing". |
| No.43 Hoe langer een goedlopend gesprek wordt voortgezet, hoe meer moeite het kost om te verifiëren |
Voorbeeld:Beëindig de sessie bij een breekpunt en begin de volgende in een nieuwe sessie. |
| No.44 Alle opgeleverde resultaten kloppen, maar er stapelt zich verspilling op die daarin niet zichtbaar is |
Voorbeeld:Analyseer, zodra het werk compleet is, eenmalig het werklog. |
| No.45 Kennis die voor de volgende persoon is vastgelegd, raakt achterhaald en komt niet meer overeen met de werkelijkheid |
Voorbeeld:Leg kennis niet vast in een document; bed het in het stopbericht in. |
| No.46 Het uitzoeken van de oorzaak gaat door, en het lezen blijft doorgaan zelfs nadat het antwoord al is gevonden |
Voorbeeld:Tel ongewijzigde leesreeksen en schrijf vooraf, vóór het uitzoeken, een stopvoorwaarde. |
| No.47 Het goedkoopste model per eenheid wordt standaard ingesteld zonder te meten of het bij het gebruiksdoel past |
Voorbeeld:Geef dezelfde taak aan beide modellen en beslis pas na het tellen van beurten en volume. |
| No.48 Als iets niet werkt, wordt er gegrepen naar een groter model in plaats van naar een beter mechanisme |
Voorbeeld:Geef dezelfde taak aan beide modellen; maak een geautomatiseerde test van waar alleen het goedkope faalt. |
| No.49 Onderzoek dat de hoofdsessie zelf kan afronden, wordt uit voorzorg toch aan een sub-agent overgedragen |
Voorbeeld:Delegeer niet wat de bovenliggende agent al heeft; geef alleen het ontbrekende leeswerk. |
| No.50 Het werk wordt zomaar in vieren gesplitst en gelijktijdig uitgevoerd |
Voorbeeld:Geef een sub-agent alleen wat in één antwoord past. Rondes bepalen de kosten, niet het aantal. |
| No.53 Halverwege het werk wordt van buitenaf "kijk hier ook nog even naar" ingebracht |
Voorbeeld:Wacht op een breekpunt en vraag met kleiner bereik. Voeg toe: "schrijf het op als het genoeg is". |
| No.52 Welk model te gebruiken wordt bepaald door ze rechtstreeks te vergelijken |
Voorbeeld:Tel vóór het vergelijken hoeveel mechanismen die vergelijking aan moeite kost. |
| No.51 "Er was geen verschil" wordt gebruikt als reden om de verificatie af te sluiten |
Voorbeeld:Tel vóór het afsluiten de buiten de telling gelaten resultaten en de overal-nul items opnieuw. |
| No.54 Van de ene dag op de andere werkt de AI anders, terwijl je noch de instructies noch de instellingen hebt gewijzigd |
Voorbeeld:Schrijf niets dat botst met de systeeminstructies; vul alleen aan wat die openlaten. Wissel voor ander gedrag de instelling. |
Lijst van artikelen
Vanaf hier hoort het niet meer bij de omgekeerde index: dit zijn links naar de artikelen, per reeks, van de inleiding tot het laatste deel.
はじめに —— 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 根拠で読む —— 突き合わせた報告に、症状が混ざります
- あとがき —— 本当の事実はどうでもいい話