Claude Code 設計原理
AI agent 環境を設計する14の原則
Claude Code を「設定」していないか。
本書は治具の4機能 (ハーネス、トークン効率、シフトレフト、ガードレール) と4実装形態 (CLI、linter、MCP サーバー、.claude/ 宣言) で環境設計の原理を提供する。3層モデル (chezmoi × Claude Code × contextmap)、契約駆動、コンテキスト階層――原則が先にあれば、ツールが変わっても環境は壊れない。
430+ の治具ファイルを実運用してきた実践知を体系化。各章は一貫した流れで構成される: 問題の特定 → 設計原則 → Claude Code に治具を作らせる → dogfooding で検証 → フィードバックから改善。
同じ原則は Agent SDK に移行しても有効。hooks は tool_use callbacks に、skills は custom tools に、rules は system prompt に、MCP がポータビリティ層として両方をつなぐ。
目次
- Part 1: Foundation — AI agent との協働と dogfooding ループ
- Part 2: 環境基盤 — chezmoi による再現性
- Part 3: Claude Code 治具設計 — コンテキスト階層、Profile、Hook、Skill、Checklist、Registry、パイプライン
- Part 4: ナレッジ基盤 — ドキュメントが腐らない仕組み、日英ペア戦略
- Part 5: Agent SDK と MCP — 宣言的治具からプログラマティックな agent へ
- Part 6: 実践と保守 — 段階的構築と治具の進化