概要
Claude Codeは強力なAIコーディングツールですが、性能を維持するには「コンテキスト（文脈）管理」が不可欠です。本ガイドでは、開発現場の経験則から導き出された、ファイル構成の方針、タスク分割、およびコンポーネント設計のベストプラクティスを紹介します。
"CLAUDE.mdは150行以内、タスクはコンテキストの5%未満で完結させよ"
150
行以内
CLAUDE.mdの上限
CLAUDE.mdの上限
5%
未満
タスク完結の目安
タスク完結の目安
50%
到達時
/compact実行タイミング
/compact実行タイミング
3
三位一体
Skills+Agents+Hooks
Skills+Agents+Hooks
運用黄金律
成功するClaude Code運用の鍵は、コンテキスト管理にあります。以下の黄金律を守ることで、安定した性能と高い生産性を維持できます。
📜 CLAUDE.mdは150行以内
プロジェクトの基本設定とガードレール的な重要ルールに絞って記述。情報過多はコンテキストを浪費し、性能低下を招きます。
🎯 タスクは5%未満で完結
タスクはコンテキストの5%未満で完結させる。大きなタスクはPLAN MODEから小さな単位に分割し、こまめにコミットします。
🔁 50%到達時に/compact
コンテキスト使用量が50%前後に達したら、手動で/compactを実行してコンテキストを圧縮。性能劣化を未然に防ぎます。
拡張アーキテクチャ ― 三位一体運用
壊れない運用のための「Skills + Agents + Hooks」三位一体アーキテクチャ。基幹をSkillsに、実行をAgentに、監視をHooksに分担させることで、堅牢かつ柔軟な拡張を実現します。
📚 Skills
技術メソッドの集積。再利用可能な手順やパターンをパッケージ化
🤖 Agents
ワークフローの実行主体。タスクの自律的な遂行を担当
🔌 Hooks
監視とトリガー。イベント検知時に自動でアクションを起動
💡 段階的開示（Progressive Disclosure）
- 必要な情報だけを段階的にロード（メインのSkillsロード → サブコンポーネント）
- コンテキストの無駄遣いを防ぎ、効率的な運用を実現
- 大規模プロジェクトでもコンテキスト枯渇を回避
構成要素の役割分担
💬 Command
ユーザーとの橋・入口。インタラクションの起点として機能し、適切なAgentやSkillsへ処理を委譲
🤖 Agent
ワークフローの実行主体。Commandから受けたタスクを自律的に処理し、必要に応じてSkillsを呼び出す
📚 Skills
技術メソッドの集積（API仕様等）。再利用可能な専門知識と手順をパッケージ化
"汎用QAではなく「機能特化型サブエージェント」を設計せよ"
参考リンク
スライド資料 (全15ページ)
