AIへの指示を増やしたら、コードレビューが壊れた

AIへの指示（プロンプト）肥大化によるコードレビューの失敗事例。AIに読ませる指示ファイルがコンテキスト上限に達し、機能しなくなった問題と、知識の再構築による解決策を解説。

• AIへの指示ファイルが肥大化し、コンテキスト上限に達したことでGitHub Copilotのコードレビューが失敗しました。
• 知識の置き場所（AGENTS.md、CLAUDE.mdなど）に構造がなく、規約、設計、運用手順などを一元管理していたことが原因です。
• リポジトリ内の知識を「入口」「共通ガイド（索引）」「詳細資料」の3層に再構成し、各役割を明確化しました。
• CIで指示のサイズやリンク切れを検査する設定を導入し、知識の肥大化を防止する仕組みを構築しました。