Claude Code でAIチームを設計する ─ 増やしても破綻させない5層モデルと3原則

• URL: https://zenn.dev/takna/articles/claude-code-ai-team-design
• 日付: 2026-06-24
• Tier: Tier 3
• 要旨: Claude Code のサブエージェント・スキル・コマンドは5層（役職・スタッフ・マニュアル・起動ボタン・協働）で整理でき、役職は軽く地図は仕組みで守り起動は絞る3原則で破綻しない設計が可能。実装では PostToolUse hook で地図と実装の齟齬を自動検出し、保有数の上限を実質消すことができます。

詳細

Claude Code の機能を役職（部門・組織図）・スタッフ（サブエージェント）・マニュアル（スキル）・起動ボタン（コマンド）・協働（エージェントチーム・loop・hook）の5層に位置づけることで、何をどの層に配置すべきかが明確になります。設計上の3原則は、役職を実装で軽く保つこと・地図と実装の齟齬を仕組みで自動化して守ること・起動は規律して並行化のコストを抑えることです。重要なのは、役職の軽さとコンテキスト隔離の価値、そして PostToolUse hook で地図ファイル（roles/_index.md 等）を編集するたびに死リンク・孤立を自動検出する具体的な bash 実装まで示されている点で、スタッフ追加の標準化手順（作らない判断→最小権限・適正モデル・明確な description の3点確認→組織図に登録→lint で確認）に従うことで、保有数の上限がほぼ消えます。サブエージェントは並列化ではなくコンテキスト隔離が第一の価値であり、tools 最小権限・model 適正・description の Do NOT 明記で責務の曖昧さを防げます。