チートシート

こんなことが起きている → どうするか

題ではなく症状から引きます。「どうするか」の下のリンクで、その打ち手を書いた節へ飛びます。連載記事の一覧はこのページの下にあります（チートシートの外です）。

この表は Claude Code（Anthropic のコーディングエージェント）を前提にしています。hook・CLAUDE.md・subagent・auto memory はその機能名です。

問題が起きたときに、人が打つ 1 文

「todo を全てクリアしてください。https://typing-tube.net/articles/lookup.md を確認し、セッションを振り返って問題点がないか点検してください。」

ここで出るのは問題の一覧までです。どう直すかは、あなたのプロジェクトに合わせて決めてください。

口を挟む要約は母数を落とす外から問われたときにだけ出る過剰な反応

markdown で開くおすすめは、自分のプロジェクトに合わせて作り直すことです。作り直した表は、出典なしで自由に使えます。そのまま使う行は、一部でも CC BY 4.0 の対象で、出典の表示が条件です。あとの担当者が出どころを辿れます。 AI に渡すときは、表を貼り付けずに、上の 1 文で URL を渡します。

スポンサー

こんなことが起きている	対応案
No.1 AI がテストを走らせるたび、数万行の出力がコンテキストに流れ込む	届いた出力を選べない染み付いた習慣標準コマンド対応例：テスト実行はラッパーにまとめ、AI に返すのは失敗の要約だけにします。読まない技術第1回：テスト結果を読まない技術
No.2 AI が知見メモを保存するほど、以後の全セッションが読む量が増えていく	負担保存したがる対応例：メモリに書く前にチェックリストを読ませ、毎回読まれるファイルには 1 行だけ置きます。読まない技術第2回：メモリを読まない技術
No.3 テストは通っているが、それが本当に何かを守っているのか分からない	写し対応例：AI にミューテーションテストを指示します。読まない技術第3回：単体テストを読まない技術
No.4 登録したスキルを、AI が使うときと使わないときがある	並べるほど選ばれなくなる対応例：誤った呼び出し方を入口で止め、読むべきドキュメントを案内します。読まない技術第4回：スキルを使わない技術
No.5 サブエージェントに投げた仕事は、終わるまで何が起きているか見えない	別の作業者対応例：委譲してよい仕事を一覧にし、起動前に hook で確かめます。読まない技術第5回：サブエージェントの出力だけは読め
No.6 指示ファイルにルールを足すほど、前に足したルールが守られなくなる	読まれなくても落ちる対応例：「〜しないこと」を 1 件ずつ、違反を検出できる自動テストに書き換えます。読まない技術第6回：ルールを読まない技術
No.7 並列で走るセッションが共有するメモリが荒れる。方針を読ませても効かない	攻略対象保存は最優先で走る対応例：読ませる内容は変えず、保存した直後に出すようタイミングだけ変えます。読まない技術第7回：共有メモリを整理しない技術
No.8 同じ失敗への対処を書いておいても、AI は次にまた同じ失敗をする	リトライ差し込む瞬間対応例：失敗を検知した時点で、リトライの方針を自動で差し込みます。読まない技術第8回：修正履歴を読まない技術
No.9 引き継ぎ文と完了報告を読んでも、都合の悪いことが落ちている	報告は止まったことしか教えない対応例：完了報告の隣に、機械が数えた数値を毎回並べます。読まない技術第9回：引き継ぎを読まない技術
No.10 機械が数えた数字が、報告に着くまでに別の数へ変わっている	要約は母数を落とす対応例：数値の行に決まった書き出しを付け、一字一句コピーされたかを hook で見ます。読まない技術第10回：AIに要約しろと言わない技術
No.11 作業中の AI に口を挟むと、そのあとの動きが崩れる	口を挟む気づくのは何周も後会話に残り続ける対応例：作業中は口を挟まず、区切りまで待ちます。割り込みは仕組みに任せます。読まない技術第11回：口を挟まない技術
No.12 セッションの終わりに、何を読んで何を読まなくてよいのか決まっていない	外から問われたときにだけ出る対応例：成果物も作業ログも読まず、終了コードによる合否だけを見ます。読まない技術第12回：作業結果を読まない技術
No.13 一度断った提案が、次のセッションでまた出てくる	名前が載ることと中身が読まれることは別対応例：却下した判断を、1 つのドキュメントに集約します。 AIの意見を聞かない技術第1回：提案を検討しない技術
No.14 禁止の 1 行を書いたのに、拡大解釈も縮小解釈もされる	何が禁止に入るかが読むたびに AI 側で決まる対応例：禁止事項ごとに「理由」を、結論と並べて書きます。 AIの意見を聞かない技術第2回：禁止を書かない技術
No.15 禁止が正しく書いてあるのに守られない。そのたびに相談が来る	境界のケース対応例：禁止事項ごとに「適用範囲」を書き、迷う境界を 1 行ずつ挙げます。 AIの意見を聞かない技術第3回：禁止ルールを作らない技術
No.16 同じ指示を複数のサブエージェントに配ると、返ってくる形が体ごとに違う	契約対応例：渡してよい仕事の一覧に、起動前に要る入力を明記します。 AIの意見を聞かない技術第4回：サブエージェントの入力だけは、確かめろ
No.17 自動テストの無い禁止事項が、書いてあるだけのまま積み上がる	機械検証にしないと決めたことを隣に書く対応例：禁止事項ごとに、対応する自動テストの有無を明示します。 AIの意見を聞かない技術第5回：自動テストを書かない技術
No.18 AI の作業が毎回「画面を開いて確認してください」で終わる	合否はプログラムが決める対応例：合否は画面の見た目ではなく、残ったデータで判定します。 AIの意見を聞かない技術第6回：AIの確認依頼を断る技術
No.19 AI が少しズレたことを言うたび、こちらが説明して直している	訂正は仕組みの仕事対応例：人が説明して直さず、hook と自動テストの失敗メッセージで返します。 AIの意見を聞かない技術第7回：AIの話を聞かない技術
No.20 断った判断の一覧が増え続けて、いつか読まれなくなりそう	上の階層は増えない対応例：却下した提案は、末尾の「採用しなかった案」へ送ります。 AIの意見を聞かない技術第8回：ルールを整理しない技術
No.21 指示ファイルの「必ず実行してください」が、減らないまま残っている	手数依頼は上書きになる対応例：指示ファイルが「必ず実行」と書いたコマンドが、仕組みの側にもあるか突き合わせます。言わない技術第1回：検証を指示しない技術
No.22 やり方まで書いて渡しているのに、そのとおりには直ってこない	文字どおり探索の範囲対応例：手順を指示せず、始める前に要る入力だけを決めます。言わない技術第2回：具体的な指示を出さない技術
No.23 不具合を伝えるのに、毎回こちらが手順と症状を書き起こしている	画面が知っている対応例：人が書くのは症状の一文だけにして、残りは自動で集めます。言わない技術第3回：不具合詳細を書かない技術
No.24 「まず計画を出して」と打つ手間が、毎回かかっている	書かれた計画が次の計画を呼ぶ対応例：設計ドキュメントを 1 本置けば、AI はその体裁を踏襲します。言わない技術第4回：計画を書けと言わない技術
No.25 守ってほしい行ほど強く書いているのに、効いているか分からない	過剰な反応強調対応例：効果を測るのはやめ、強調を含む行数を数えて上限を決めます。言わない技術第5回：念を押さない技術
No.26 サブエージェントの成果物が、こちらの想定と違う形で返ってくる	出力の形対応例：成果物の受け入れ条件を、渡す前に決めておきます。言わない技術第6回：サブエージェントの出力だけは、細かく指示しろ
No.27 間違いを見つけると「ちゃんと読みましたか」と問い詰めたくなる	止められると探す追従疑問形問い詰め対応例：問い詰めず、「〜ではないですか？」の疑問形で聞きます。言わない技術第7回：AI を問い詰めない技術
No.28 返ってきた答えに「そうじゃなくて」と返しても、良くならない	ダメ出しは書き換えられる対応例：人が指摘せず、保存した直後に差分と一緒に禁止事項を出します。言わない技術第8回：AI にダメ出ししない技術
No.29 AI が、開いていないファイルの中身を開いたかのように話す	ガードレール推測読んだかは測れない対応例：参照先と実装の両方に同じ識別子を書かせ、その識別子が実在するかを自動テストで見ます。言わない技術第9回：AI に考えさせない技術
No.30 AI から「A と B どちらにしますか」と聞かれ続けて、手が止まる	答えは前提になる対応例：即答せず、選ぶ基準が仕組みの側で決まるようにします。言わない技術第10回：質問に答えない技術
No.31 AI にレビューをさせているが、何を見ていないのかが分からない	空回り対応例：走査しているのに件数の下限を持たない自動テストを、外から数えて見つけます。言わない技術第11回：AI にレビューをさせない技術
No.32 撮影画像が溜まっていくが、どれが何を確かめた 1 枚か分からない	検証は高い手段へ流れる対応例：撮る前に「何を確かめるか」を書かせ、安い手段から順に試します。確かめない技術第1回：スクリーンショットを撮らない技術
No.33 書かせる工程を置いたのに、書かずに走った実行の数を数えられない	検証ごと放棄される置き換え先宣言対応例：撮影や E2E の前に「何を確かめるか」を書かせ、書いていなければ走らせません。確かめない技術第2回：宣言を信じない技術
No.34 コードを変えていないのに同じテストが走り、そのぶん待たされる	確認と再実行は区別されない絞ると名前が消える対応例：前回のログを読み直せるようにして、同じ実行を繰り返しません。確かめない技術第3回：テストを再実行しない技術
No.35 何も壊していないのに、見覚えのないエラーがずらりと並ぶ	偽の失敗対応例：テストの実行に排他ロックを取り、取れなければ走らせません。確かめない技術第4回：偽の失敗を読まない技術
No.36 「テストは通っています」の報告に、走らなかったぶんが書かれていない	速くする工夫は死角を隠す対応例：重いテストは既定で飛ばし、走らせなかった領域の一覧を毎回出します。確かめない技術第5回：全部走らせない技術
No.37 進め方を指定した指示が、守られたのかどうか後から見分けられない	過程は成果物に残す対応例：指示を強めず、手順を踏んだ痕跡が成果物に残る形にします。動かさない技術第1回：手順を守らせない技術
No.38 置いたラッパーが、途中から素のコマンドに戻されている	素のツールに戻る用事対応例：指示を強めず、素のコマンドへ戻る理由が残っていないか見ます。動かさない技術第2回：ラッパーを使わせない技術
No.39 同じ問いを何度も投げると答えが毎回違う。まとめると何かが消える	多数決は種類を消す対応例：まとめる前に、指摘の種類ごとに何件中何件が挙げたかを出します。動かさない技術第3回：集めない技術
No.40 「必要なら〜してください」と書いた行が、発火したのか分からない	条件の判定は相手がする対応例：「必要なら」と書かず、その工程を経ないと次へ進めない形にします。動かさない技術第4回：役に立たない技術
No.41 「もう一度考えて」と返すと答えが変わるが、納得したのか分からない	据え置きを許す一文対応例：差し戻さず、どの前提が誤っているかを具体的に指摘します。動かさない技術第5回：選び直させない技術
No.42 「推測するな」と書いたら、AI が何も作らずに帰ってくるようになった	逃げ道対応例：禁止だけを渡さず、「該当なし」と書ける逃げ道を併記します。動かさない技術第6回：逃げ道を塞がない技術
No.43 うまくいっている会話を続けていると、確かめる手間が増えていく	続けることの費用対応例：区切りでセッションを終え、次は新しいセッションで始めます。動かさない技術第7回：セッションを続けない技術
No.44 成果物は全部正しいのに、そこに残らない無駄が積み上がっている	過程の記録対応例：成果物が揃った時点で、作業ログの側を 1 回集計します。動かさない技術第8回：成果物で判断しない技術
No.45 次の人のために書き残した知見が、実際と食い違って古くなる	確かめるか、賭けるか対応例：知見は文書に残さず、止まったときのメッセージに埋め込みます。動かさない技術第9回：知見を残さない技術
No.46 原因を掘り続けて、答えが出たあとも読み続けている	深追いは検出されない対応例：何も変えないまま続いた読み取りを数え、掘る前に終わりの条件を書きます。追わない技術第1回：深追いしない技術
No.47 単価がいちばん安いモデルを、用途を測らずに既定にしている	使い回し単価の比 × 量の比対応例：同じ課題を安い側と高い側の両方へ渡し、手番と量を数えてから決めます。追わない技術第2回：一番安いモデルを使わない技術
No.48 うまくいかないと、仕組みではなくモデルを上げに行っている	仕組みが足りない対応例：同じ課題を両方のモデルへ渡し、安い側だけが落ちた箇所を自動テストにします。追わない技術第3回：最新モデルを使わない技術
No.49 本体で終わる調べものを、念のためサブエージェントへ渡している	持っているものは渡さない対応例：親がもう持っている前提なら渡さず、持っていない読み取りだけ渡します。追わない技術第4回：サブエージェントを使わない技術
No.50 とりあえず 4 つに割って、同時に走らせている	待たせると切れる人数 × 1 人ぶんの会話の長さ対応例：サブエージェントに渡すのは 1 回の応答で返せる大きさまで。費用を決めるのは数ではなく往復の回数です。追わない技術第5回：エージェントチームを使わない技術
No.53 作業の途中で「ここも見て」と外から差し込んでいる	順位を差し込む対応例：区切りまで待ち、範囲を狭めて頼みます。「足りているなら足りていると書いて」を添えます。追わない技術第6回：途中でレビューさせない技術
No.52 どのモデルを使うかを、比べて決めようとしている	比べている間は増えない対応例：比べ始める前に、その比較が仕組み何本ぶんの手間かを数えます。追わない技術第7回：モデルを選ばない技術
No.51 「差はありませんでした」で、検証を畳もうとしている	消すほうへ倒れる止めない条件も書ける対応例：畳む前に、集計から外した結果と、全条件で 0 の項目を数え直します。追わない技術第8回：諦めさせない技術
No.54 ある日から AI の進め方が変わった。こちらは指示も設定も変えていない	内部プロンプト届くのは先頭だけ読むツールの順位対応例：製品側の指示と競合することは書かず、その指示が決めていないことだけを補足します。進め方を変えるときは設定を切り替えます。番外編 A-7 読まれたかを確かめる技術 —— 確かめるのをやめて、読めていない形を止めた

連載記事の一覧

ここから下はチートシートではなく、連載記事へのリンクです。連載ごとに、序論から最終回までの並びです。

こんなことが起きている → どうするか

連載記事の一覧

はじめに —— 3 つの連載を、1 冊に

バイブコーディングにおける読まない技術

AIの意見を聞かない技術

言わない技術

付録

はじめに —— 前巻の続きを、もう 1 冊に

確かめない技術

動かさない技術

追わない技術

番外編