CLAUDE.md に全部書くのは逆効果だった — AIコーディングの「2層設計」で品質が安定した話

AI要約

CLAUDE.mdに長大なルールを詰め込むと、逆にAIの品質が低下する問題を実測データで解説しています。約30Kトークンのルール集は84点でしたが、3ファイル+動的チェックの「2層設計」にすると96.9点に向上。コンテキストウィンドウの注意分散を避けるため、CLAUDE.mdは「目次」として参照ファイル名だけに、詳細ルールはdocs/に分離する戦略です。実践的な判断基準も付属しており、Claude Code導入チームの必読です。