Agent階層管理システム

📚 ナビゲーション

• ROLES.md - 各Agent（PO、Manager、Developer）の役割と責任
• WORKFLOWS.md - 実行順序とコンテキスト管理フロー
• PARALLEL-EXECUTION.md - 並列/段階的/順次実行パターン
• GUIDELINES.md - 判断基準、例外ケース、最適化

🎯 使用タイミング

• コード修正が必要な全タスク（小規模修正以外）
• 複雑なタスク分解が必要な時
• 並行開発が必要な時
• 戦略的な判断が必要な時

🚨 最重要ルール

小さな修正以外は、必ずPO→Manager→Developerの階層的Agentシステムを使用してください。

基本原則

1. PO Agent - 戦略決定とWorktree管理
2. Manager Agent - タスク配分とWorktree情報伝達
3. Developer Agents - 実装（並列実行）

Claude Code本体の責任

• 実装は絶対に行わない
• Agentシステムを起動して指示
• Developer起動時は並列実行を徹底

📂 Agent定義ファイルの場所

~/.claude/agents/
├── aramaki.md      # PO Agent定義
├── kusanagi.md     # Manager Agent定義
└── tachikoma.md    # Developer Agent定義

✅ 直接実装可能な例外

以下の場合のみ、Agentシステムを使わず直接実装可能：

• 単純なファイル読み込み（1-2ファイル）
• 1行程度の簡単な修正
• 単純な質問への回答
• ファイル一覧表示

❌ 必ずAgentを使用すべきケース

• 新機能実装
• 複数ファイルのバグ修正
• リファクタリング
• テスト実装
• ドキュメント作成（複数ファイル）
• 複雑な調査・分析

🚀 並列実行の鉄則

• Developer起動は必ず1つのメッセージで同時実行
• 独立タスクは絶対に並列化
• 段階的実行でも各段階内は並列化

詳細は PARALLEL-EXECUTION.md を参照してください。

📋 実行フロー概要

タスク受信
    ↓
コード修正が必要？
    ├─ No → 直接実行可能
    └─ Yes → Agentシステム使用
        ↓
        1. PO Agent起動（戦略決定＋Worktree管理）
        ↓
        2. Manager Agent起動（タスク配分＋Worktree情報伝達）
        ↓
        3. Developer Agents並列起動（実装）

詳細は WORKFLOWS.md を参照してください。

🔗 関連スキル

• managing-as-aramaki: PO Agentの詳細な使い方
• coordinating-as-kusanagi: Manager Agentの詳細な使い方
• implementing-as-tachikoma: Developer Agentの詳細な使い方
• managing-git-worktrees: Worktree管理の詳細

🎓 学習パス

1. このファイル（概要理解）
2. ROLES.md（各Agentの役割理解）
3. WORKFLOWS.md（実行フロー理解）
4. PARALLEL-EXECUTION.md（並列実行パターン）
5. GUIDELINES.md（判断基準と最適化）