| name | orchestrator-designer |
| description | Design AGENTS.md Orchestrator configurations with WHEN/DO routing patterns, phase gates, urgency triage, and multi-skill workflow coordination. Use when setting up a new multi-skill workflow, designing phase transitions, creating task classification trees, or generating AGENTS.md files for suites.
|
| metadata | {"author":"coreclaw","version":"2.0"} |
Orchestrator Designer
Design AGENTS.md Orchestrator files with WHEN/DO routing for multi-skill suites.
設計手順
-
ワークフロー要件を整理:
- 利用可能なスキル一覧を収集
- 各スキルの
description と起動条件を確認
- ワークフローのフェーズ数と順序を決定
-
Phase 設計:
- 各 Phase に割り当てるスキルを決定
- Phase 間の遷移条件（完了条件）を定義
- 承認ポイント（⏸️）を設置する箇所を決定
-
WHEN/DO ルーティングルールを作成:
- ユーザー入力のキーワードパターンを定義
- 各パターンに対応するワークフローを紐付け
- 緊急度に応じた分岐を設計
-
タスク分類ツリーを作成:
- 判定条件を2〜3段階のツリーで定義
- 各末端ノードに対応するスキル/ワークフローを紐付け
-
禁止事項を明示:
- Phase スキップの禁止
- 承認ポイントの省略禁止
- その他プロジェクト固有の禁止事項
出力テンプレート
# <Project Name> Workflow Orchestrator
## ワークフロー
| Phase | スキル | 完了条件 |
|-------|--------|---------|
| 0 | <skill-name> | <condition> |
| 1 | <skill-name> | <condition> |
| 2 | <skill-name> | <condition> |
## ルール
### パターン1: <タスク種別>
WHEN: <起動キーワード/条件>
DO:
1. Phase 0 → <skill> で <action>
2. <承認ポイントの有無>
3. Phase 1 → <skill> で <action>
### パターン2: <タスク種別>
WHEN: <起動キーワード/条件>
DO:
1. <skill> で <action>
2. <skill> で <action>
## Phase 遷移ルール
Phase 0 → Phase 1: <条件> ⏸️（承認必要）
Phase 1 → Phase 2: <条件>（自動遷移）
Phase 2 → 完了: <条件> ⏸️（承認必要）
## タスク分類
1. <判定条件1>？
- YES → <ワークフローA>
- NO → 次へ
2. <判定条件2>？
- YES → <ワークフローB>
- NO → <デフォルト動作>
## トリアージ
| 緊急度 | キーワード | ワークフロー |
|--------|-----------|------------|
| 通常 | （デフォルト） | フル実行 |
| 急ぎ | 「急ぎ」「ASAP」 | Phase スキップあり |
| 至急 | 「至急」「今すぐ」 | 概要のみ |
## 禁止事項
- <禁止事項1>
- <禁止事項2>
- <禁止事項3>
設計原則
ルーティング精度を上げる5つのテクニック
- description の棲み分け: スキル間でキーワードが重複しない
- ゲート条件: 重要な Phase 遷移にはユーザー承認を設ける
- 緊急度分岐: トリアージテーブルでワークフローを分岐
- 禁止事項の明示: エージェントが「やってはいけないこと」を明確に
- 判定ツリー: タスク分類の明示的なフローチャートを提供
承認ポイントの配置基準
- 設ける場面: 計画立案後、最終成果物生成後、セキュリティ関連操作前
- 設けない場面: Phase 間の自動遷移（中間処理）、情報収集フェーズ
Gotchas
- AGENTS.md はスイートパッケージのルートに配置する。デプロイ時に
.github/AGENTS.md にコピーされる
- WHEN/DO ルールが多すぎると（10パターン以上）、エージェントの判断が不安定になる。5〜7パターンが適切
- Phase 設計で全フェーズにユーザー承認を入れると、ワークフローが遅くなりすぎる。重要ポイントのみに絞る
- 緊急度トリアージを設計する場合、「至急」でもスキップしてはならない Phase（目的確認、セキュリティチェック等）を明示する
- Custom Agent と組み合わせる場合、Agent のツール制限と WHEN/DO ルールが矛盾しないよう注意する
- AGENTS.md の
description フロントマターはスイート全体の起動条件を記述する。個別スキルの起動条件ではない
検証ループ
- AGENTS.md を生成
- チェック:
- 全スキルが Phase に割り当てられているか
- WHEN/DO パターンが 5〜7 個以内か
- 承認ポイントが最低1箇所あるか
- 禁止事項が明示されているか
- タスク分類ツリーがすべてのケースをカバーしているか
- 不合格なら修正して再チェック
- 合格後のみ完了とする
