概要
Claude Codeで11体のサブエージェントを使い分ける中、プロンプトの工夫よりも、過去の失敗を「症状・誤った直感・正しい打ち手」として記録・再利用する「team-lessons」の仕組みが最も成果に繋がったという実践報告。
詳細内容
この記事では、Claude Codeを用いた個人開発において、役割の異なる11体のサブエージェントを効率的に運用する手法が紹介されています。特に注目すべきは、洗練されたプロンプトを書くことよりも、「失敗のカタログ化（team-lessons）」を重視している点です。
### 運用の核心：team-lessons
「症状 → 誤った直感 → 正しい打ち手」という形式で過去の失敗を記録し、それを次回の委任プロンプトに機械的に組み込むことで、同じミスを別のエージェントやコンテキストで繰り返さない仕組みを構築しています。これにより、エージェントが「裏取りをせずに作業を進める」といったリスクを大幅に軽減しています。
### チーム構成とオーケストレーション
* **役割分担**: 設計（Architect/Opus）、実装（Builder/Sonnet）、検証（QA-Reviewer/Opus）など、タスクの性質に応じてモデル（Opus/Sonnet）と役割を分離。
* **active-team.md**: 誰がどの順序で作業するかという「Orchestration rules」を明文化し、自律的なワークフローを実現。
* **SessionStartフック**: `check-in.sh` を通じて、セッション開始時に「使える資産」や「遵守ルール」を自動的にコンテキストへ流し込み、資産の使い漏れを防止。
著者は、OSSの「ccteams」を土台にこれらの設定を構築しており、技術的な賢さよりも「自分のプロジェクト固有の失敗を拾い上げる工程」こそがエージェント運用の本体であると強調しています。