goap-agent

GOAP Agent Skill

インテリジェントな計画立案とマルチエージェント連携により、複雑な複数ステップのタスクを実行する目標指向型アクションプランニングです。

クイックリファレンス

• 方法論 - GOAP の中核となる計画サイクルとフェーズ
• 実行戦略 - 並列、逐次、スウォーム、ハイブリッドのパターン
• スキルリファレンス - カテゴリ別の利用可能なスキル
• エージェントリファレンス - 利用可能なタスクエージェントとその機能
• パターン - 一般的な GOAP 実行パターン
• 例 - GOAP ワークフローの全例
• ADR-022 - アーキテクチャ決定記録

使用する場面

• 複雑な複数ステップのタスク（個別のステップが5つ以上）
• 複数の領域にまたがる問題（ストレージ、API、テスト、ドキュメント）
• 並列または逐次実行が必要なタスク
• 検証チェックポイントを設ける品質重視の作業
• 大規模なリファクタリングやアーキテクチャ変更

重要：スキルとタスクエージェントの違い

スキル（Skill ツール経由）：Claude に直接指示する命令セット
エージェント（Task ツール経由）：タスクを実行する自律的なサブプロセス

例：

• 誤り：Task(subagent_type="code-quality", ...) → エラー！
• 正しい：Skill(command="code-quality") → 成功！

スキルの全一覧は skills.md を、エージェントの機能は agents.md を参照してください。

中核プロセス

1. 分析 → 目標、制約、リソースを把握します
   • ADR を確認：計画を立てる前に、plans/adr/ から関連する ADR を読みます
2. 分解 → 依存関係を考慮して、タスクを原子的な単位に分割します
   • タスクの分解：成功基準を含む目標階層を作成します（patterns.md を参照）
   • 依存関係の種類：逐次（A→B）、並列（A─┐B─┐）、収束（A─┐B─┼─>D）
3. 戦略の策定 → 実行パターンを選択します
4. 調整 → 専門エージェントに割り当てます
5. 実行 → 監視と品質ゲートを設けて実行します
6. 統合 → 結果を集約し、成功を検証します

PR 監視のガードレール

• PR 作業の実行／統合中は、最新の head SHA の statusCheckRollup を必ず確認してください。
• 必須チェックのロールアップが空の場合はブロッカーとして扱い、plans/STATUS/VALIDATION_LATEST.md に記録してください。
• 修正確認用のチェックが追加されるまでは、計画のみのフォローアップコミットを追加しないでください。

フェーズごとの詳細なガイダンスは methodology.md を、一般的な実行パターンは patterns.md を参照してください。

ADR 統合ワークフロー

必須：実行計画を作成する前に、必ず plans/adr/ の ADR を確認してください。

ステップ 1：ADR の確認

# List all ADRs to identify relevant ones
ls plans/adr/ADR-*.md

ステップ 2：関連する ADR を読む

• タスクの領域に関連する ADR を検索します
• アーキテクチャ上の決定と制約を記録します
• ADR のステータス（Accepted/Implemented または Deprecated）を確認します

ステップ 3：計画に反映する

• タスクを分解する際に ADR の制約を適用します
• 実行計画で ADR を参照します
• アーキテクチャ上の決定に準拠していることを確認します

ステップ 4：plans/ の進捗を更新する

• plans/ に実行計画ファイルを作成または更新します
• 進捗、ブロッカー、決定事項を記録します
• 計画ファイルで関連する ADR へのリンクを記載します