チートシート

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

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

この表は 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 が知見メモを保存するほど、以後の全セッションが読む量が増えていく	攻略対象負担保存したがる対応例：保存した直後に、書かれた差分を基準と並べて AI に読ませ、残すかどうかを決めさせます。読まない技術第2回：メモリを読まない技術
No.3 テストは通っているが、それが本当に何かを守っているのか分からない	写し対応例：AI にミューテーションテストを指示します。読まない技術第3回：単体テストを読まない技術
No.4 登録したスキルを、AI が使うときと使わないときがある	並べるほど選ばれなくなる対応例：誤った呼び出し方を入口で止め、読むべきドキュメントを案内します。読まない技術第4回：スキルを使わない技術
No.5 サブエージェントに投げた仕事は、終わるまで何が起きているか見えない	別の作業者対応例：委譲してよい仕事を一覧にし、起動前に hook で確かめます。読まない技術第5回：サブエージェントの出力だけは読め
No.6 指示ファイルにルールを足すほど、前に足したルールが守られなくなる	読まれなくても落ちる対応例：「〜しないこと」を 1 件ずつ、違反を検出できる自動テストに書き換えます。読まない技術第6回：ルールを読まない技術
No.7 並列で走るセッションが共有するメモリでは、別のセッションの書き込みが差分に混ざる	対応例：保存後の差分で自分の書き込みかを AI に確かめさせ、報告しないまま終わるのを 1 度だけ止めます。読まない技術第7回：共有メモリを整理しない技術
No.8 同じ失敗への対処を書いておいても、AI は次にまた同じ失敗をする	リトライ差し込む瞬間対応例：失敗を検知した時点で、リトライの方針を自動で差し込みます。読まない技術第8回：修正履歴を読まない技術
No.9 引き継ぎ文と完了報告を読んでも、都合の悪いことが落ちている	報告は止まったことしか教えない対応例：完了報告は読まず、これまでの症状が出ていないかを見て、問題がなくても AI に不足点を確認します。読まない技術第9回：引き継ぎを読まない技術
No.10 機械が数えた数字が、報告に着くまでに別の数へ変わっている	要約は母数を落とす対応例：数値の行に決まった書き出しを付け、一字一句コピーされたかを hook で見ます。読まない技術第10回：AIに要約しろと言わない技術
No.11 作業中の AI に口を挟むと、進めていた作業が後回しになる	口を挟む気づくのは何周も後会話に残り続ける対応例：作業中は口を挟まず、区切りまで待ちます。割り込みは仕組みに任せます。読まない技術第11回：口を挟まない技術
No.12 完了報告に書かれていない作業の不足が、そのまま次の作業に持ち越される	外から問われたときにだけ出る対応例：完了報告は読まず、作業を終えたあとに、毎回同じ一言で、不足点がないかをAIに問います。読まない技術第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 断った判断の一覧が増え続けて、いつか読まれなくなりそう	対応例：禁止事項の一覧は、必要なときだけ開かれる 1 枚に置き、件数を減らすための整理はしません。 AIの意見を聞かない技術第8回：ルールを整理しない技術
No.21 指示ファイルの「必ず実行してください」が、減らないまま残っている	手数依頼は上書きになる対応例：指示ファイルが「必ず実行」と書いたコマンドが、仕組みの側にもあるか突き合わせます。言わない技術第1回：検証を指示しない技術
No.22 やり方まで書いて渡しているのに、そのとおりには直ってこない	文字どおり探索の範囲対応例：手順を指示せず、始める前に要る入力だけを決めます。言わない技術第2回：具体的な指示を出さない技術
No.23 不具合を伝えるのに、毎回こちらがURLやエラーの文言を書き写している	画面が知っている対応例：人が書くのは症状の一文だけにして、残りは自動で集めます。言わない技術第3回：不具合詳細を書かない技術
No.24 「まず計画を出して」と打つ手間が、毎回かかっている	書かれた計画が次の計画を呼ぶ対応例：計画を頼まずに依頼だけを渡し、書かれた計画書はそのまま置いておきます。言わない技術第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 複数の AI に分担させたレビューで、見つかっていた重要な不具合が、まとめた結果に入っていない	多数決は種類を消す対応例：まとめる前の答えを残し、種類ごとに何回挙がったかを数えます。動かさない技術第3回：集めない技術
No.40 「必要なら〜してください」と書いた行のとおりに、AI が動いたのか分からない	条件の判定は相手がする対応例：条件に当たるかを AI が判定する行は、AI が動いたかを成果物と報告から確かめることができないので、書きません。動かさない技術第4回：役に立たない技術
No.41 「もう一度考えて」と返すと答えが変わるが、納得したのか分からない	据え置きを許す一文対応例：差し戻さず、どの前提が誤っているかを具体的に指摘します。動かさない技術第5回：選び直させない技術
No.42 「推測するな」と書いたら、AI が何も作らずに帰ってくるようになった	逃げ道対応例：禁止だけを渡さず、「該当なし」と書ける逃げ道を併記します。動かさない技術第6回：逃げ道を塞がない技術
No.43 うまくいっている会話を続けていると、確かめる手間が増えていく	続けることの費用対応例：区切りでセッションを終え、次は新しいセッションで始めます。動かさない技術第7回：セッションを続けない技術
No.44 成果物は全部正しいのに、そこに残らない無駄が積み上がっている	過程の記録対応例：成果物と報告だけでなく、作業ログも読んで、無駄な作業を探します。動かさない技術第8回：成果物で判断しない技術
No.45 次の人のために書き残した知見が、実際と食い違って古くなる	確かめるか、確かめずに使うか対応例：知見は文書に残さず、止まったときのメッセージに埋め込みます。動かさない技術第9回：知見を残さない技術
No.46 短い問いを頼んだのに、途中で見つけた別の問題を調べ続け、その問題の選択肢を持って返ってくる	深追いは外から問い直して抜ける対応例：選択肢から選ばずに、最初に聞いた問いに答えるよう、その問題の外から問い直します。追わない技術第1回：深追いしない技術
No.47 単価がいちばん安いモデルを、用途を測らずに既定にしている	プロンプトキャッシュ単価の比 × 量の比対応例：同じ課題を安い側と高い側の両方へ渡し、手番と量を数えてから決めます。追わない技術第2回：一番安いモデルを使わない技術
No.48 片方のモデルが失敗すると、何が違うのかを見ずに強いモデルへ乗り換えている	何が違うのかを確かめる対応例：両方のモデルへ同じものを渡し、原因がモデルの差か、渡していない決まりかを見てから選びます。追わない技術第3回：最新モデルを使わない技術
No.49 本体で終わる調べものを、念のためサブエージェントへ渡している	持っているものは渡さない対応例：親がもう持っている前提なら渡さず、持っていない読み取りだけ渡します。追わない技術第4回：サブエージェントを使わない技術
No.53 渡した仕事の途中で、別の目にレビューさせている	対応例：区切りまで待ち、仕事をした AI に不足点を洗い出させてから、レビューさせます。追わない技術第6回：途中でレビューさせない技術
No.52 どのモデルを使うかを、比べて決めようとしている	比べている間は増えない対応例：比べ始める前に、その比較が仕組み何本ぶんの手間かを数えます。追わない技術第7回：モデルを選ばない技術
No.51 「差はありませんでした」で、検証を畳もうとしている	対応例：受け取る前に、測れなかったぶんが無いかを確かめさせ、あれば測り直させます。追わない技術第8回：諦めさせない技術
No.54 ある日から AI の進め方が変わった。こちらは指示も設定も変えていない	内部プロンプト届くのは先頭だけ読むツールの順位対応例：製品側の指示と競合することは書かず、その指示が決めていないことだけを補足します。進め方を変えるときは設定を切り替えます。番外編 A-7 読まれたかを確かめる技術 —— 確かめるのをやめて、読めていない形を止めた

連載記事の一覧

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

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

連載記事の一覧

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

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

AIの意見を聞かない技術

言わない技術

付録

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

確かめない技術

動かさない技術

追わない技術

番外編