AIに全部覚えさせるのをやめた：20ファイル制限から「正典+深掘り+相互監査」へ

Claude等のAIでコード修正を何度依頼しても治らない場合、既存仕様の維持に優先度を置くAIの特性が原因である可能性がある。バグ原因が仕様にある場合、「仕様変更の候補を列挙させてから修正を依頼する」2段階プロンプトにより、問題解決が進みやすくなる。

AI への指示で形式を指定する方法は 2 種類に分かれる。システムプロンプトやお願いは訓練に依存する「確率上げ」だが、構造化出力は候補単語を事前削除して「物理的に強制」する。ただし強制が厳しいと思考が必要なタスクでは精度低下するため、欄の順番設計が重要。

Claude などの LLM に「禁止」「良い例」「資料」を与えても、期待通りに動かない。個人 Bot 開発の 6 ヶ月運用ログから、whack-a-mole（回避の繰り返し）、few-shot overfitting（実例への過学習）、model collapse、context rot など 4 つの既知現象を日本語で実測データ付きで解説。ホワイトリスト方式への切り替えや意味レベルの検知が対策になる。

CLAUDE.md に20項目を超える指示を1枚に詰め込むと、無視される指示が出たり別プロジェクトを汚染したり原因特定できなくなる。これは「書き方」の問題ではなく「置き場所」の問題。グローバル（~/.claude/CLAUDE.md）にはプロジェクト横断的な好み、プロジェクト直下には個別の手順を分離する3層構成により、指示が安定して通るようになる。筆者の実運用ファイルを実例公開。