cavecrew

Cavecrew = caveman 出力を返す 3 つのサブエージェントプリセット。Anthropic デフォルト（Explore、編集スタイルエージェント、reviewer）と同じ仕事をします。違いは、返す tool-result が圧縮されているため、委譲ごとにメインコンテキストが縮小することです。

cavecrew と代替手段の使い分け

タスク	使用
「X はどこで定義されているか / Y を呼び出すものは何か / Z の使用箇所を列挙」	cavecrew-investigator
同上だが提案/アーキテクチャコメントも欲しい	Explore（バニラ）
正確な編集、≤2 ファイル、スコープが明確	cavecrew-builder
新機能 / 3+ ファイル / 横断的なリファクタ	メインスレッドまたは feature-dev:code-architect
差分、ブランチ、またはファイルのバグレビュー	cavecrew-reviewer
根拠と代替案を含む深いコードレビュー	Code Reviewer（バニラ）
既に知っている 1 行の回答	メインスレッド、サブエージェントなし

経験則：サブエージェント出力を 1/3 のトークンで欲しければ cavecrew を選択。散文を欲しければバニラを選択。

なぜこれが存在するのか（実際の利点）

サブエージェントの tool-result はメインコンテキストに逐語的に注入されます。2k トークンの散文を返すバニラ Explore は、毎回メインコンテキスト予算で 2k トークンをコストします。同じ検出結果が cavecrew-investigator から返される場合、~700 トークンです。1 セッション内で 20 回の委譲を行うと、それはコンテキスト枯渇とタスク完了の違いになります。

出力契約

メインスレッドがエージェントごとに依拠できるもの：

cavecrew-investigator

<Header>:
- path:line — `symbol` — short note
totals: <counts>.

または No match. 常にファイルパス第一、行番号付き、シンボルはバッククォート。path:\d+ で grep 可能。

cavecrew-builder

<path:line-range> — <change ≤10 words>.
verified: <re-read OK | mismatch @ path:line>.

または次のいずれか：too-big. / needs-confirm. / ambiguous. / regressed.（最初のトークンは確定）。

cavecrew-reviewer

path:line: <emoji> <severity>: <problem>. <fix>.
totals: N🔴 N🟡 N🔵 N❓

または No issues. 検出結果はファイル→行の昇順でソート。

チェーンパターン

位置特定 → 修正 → 検証（最も一般的）:

1. cavecrew-investigator がサイトリストを返す。
2. メインスレッドが 1-2 箇所を選び、パスを cavecrew-builder に渡す。
3. cavecrew-reviewer が差分を監査する。

並列スカウト（調査が広範な場合）: 1 つのメッセージで 2-3 の cavecrew-investigator 呼び出しを起動（異なる角度：定義 vs 呼び出し元 vs テスト）。メインスレッドで集約。

シングルショット編集（サイトが既に既知の場合）: investigator をスキップ。正確な path:line を cavecrew-builder に直接渡す。

やってはいけないこと

• ファイルが既に既知でない場合、cavecrew-builder を使用しないでください。investigator を起動するか、メインスレッドがコンテキストを渡すコストで消費します。
• 5 ファイルリファクタのために cavecrew-investigator → cavecrew-builder をチェーンしないでください。Builder は too-big. を返し、ターンを無駄にします。
• cavecrew-reviewer に「一般的なフィードバック」を求めないでください。検出結果のみを返し、アーキテクチャ意見は返しません。それには Code Reviewer を使用してください。
• 散文を期待しないでください。Cavecrew 出力は構造化されており、不可解な程度に簡潔な場合があります。人間が直接読む場合は言い換えてください。

自動明確化（継承）

サブエージェントはセキュリティ警告、不可逆的アクション確認、およびフラグメント曖昧性が誤読される可能性がある出力について、caveman から通常の英語に切り替えます。その後 caveman を再開します。