【要約】CLAUDE.mdに書いたのに守られない——その正体は「渡す場所」の設計だった（Zenn Book Vol.4「仕組みを渡すまで」） [Qiita_Trend] | Summary by TechDistill
> Source: Qiita_Trend
Execute Primary Source
// Problem
Claude Codeを利用する開発者が、指示が守られないという課題に直面している。CLAUDE.mdにルールを書いても、AIが意図通りに動かないケースがある。
- ・CLAUDE.mdに記述したルールが無視される。
- ・サブエージェントへの指示が機能しない。
- ・指示を増やしすぎて、AIの判断が鈍る。
// Approach
著者は、Claude Codeへの指示を7つのレイヤーに分ける設計手法を提示している。情報を適切な場所に配置し、過剰な情報を削る「引き算」を重視する。
- ・情報を7つのレイヤー（CLAUDE.md、サブエージェント、スキル、Playbook、メモリ、設定・権限、MCP）に分離する。
- ・各レイヤーの役割と、過剰な情報付与によるリスクを定義する。
- ・90個のPlaybookと21件の事故記録に基づき、実用的な設計指針を示す。
// Result
この設計思想を導入することで、AIエージェントの運用精度が向上する。開発者は、AIに対して「何を、どこに、どう渡すか」を構造的に管理できる。
- ・指示の精度向上と、AIの自律的な動作の安定化。
- ・コンテキスト圧迫によるパフォーマンス低下の回避。
- ・権限設定ミスによる、意図しない操作（記事の非公開化等）の防止。
Senior Engineer Insight
> AIエージェントの運用は、プロンプト管理ではなくコンテキスト管理のシステム設計である。情報の肥大化は、AIの判断精度やレイテンシに悪影響を及ぼす。各レイヤーの責務を明確にし、不要な情報を削る「引き算の設計」が、スケーラブルなAIチーム構築には不可欠である。