Orchestrator Designer

Orchestrator Designer

Design AGENTS.md Orchestrator files with WHEN/DO routing for multi-skill suites.

設計手順

1. ワークフロー要件を整理:

   • 利用可能なスキル一覧を収集
   • 各スキルの description と起動条件を確認
   • ワークフローのフェーズ数と順序を決定

2. Phase 設計:

   • 各 Phase に割り当てるスキルを決定
   • Phase 間の遷移条件（完了条件）を定義
   • 承認ポイント（⏸️）を設置する箇所を決定

3. WHEN/DO ルーティングルールを作成:

   • ユーザー入力のキーワードパターンを定義
   • 各パターンに対応するワークフローを紐付け
   • 緊急度に応じた分岐を設計

4. タスク分類ツリーを作成:

   • 判定条件を2〜3段階のツリーで定義
   • 各末端ノードに対応するスキル/ワークフローを紐付け

5. 禁止事項を明示:

   • 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つのテクニック

1. description の棲み分け: スキル間でキーワードが重複しない
2. ゲート条件: 重要な Phase 遷移にはユーザー承認を設ける
3. 緊急度分岐: トリアージテーブルでワークフローを分岐
4. 禁止事項の明示: エージェントが「やってはいけないこと」を明確に
5. 判定ツリー: タスク分類の明示的なフローチャートを提供

承認ポイントの配置基準

• 設ける場面: 計画立案後、最終成果物生成後、セキュリティ関連操作前
• 設けない場面: Phase 間の自動遷移（中間処理）、情報収集フェーズ

Gotchas

• AGENTS.md はスイートパッケージのルートに配置する。デプロイ時に .github/AGENTS.md にコピーされる
• WHEN/DO ルールが多すぎると（10パターン以上）、エージェントの判断が不安定になる。5〜7パターンが適切
• Phase 設計で全フェーズにユーザー承認を入れると、ワークフローが遅くなりすぎる。重要ポイントのみに絞る
• 緊急度トリアージを設計する場合、「至急」でもスキップしてはならない Phase（目的確認、セキュリティチェック等）を明示する
• Custom Agent と組み合わせる場合、Agent のツール制限と WHEN/DO ルールが矛盾しないよう注意する
• AGENTS.md の description フロントマターはスイート全体の起動条件を記述する。個別スキルの起動条件ではない

検証ループ

1. AGENTS.md を生成
2. チェック:
   • 全スキルが Phase に割り当てられているか
   • WHEN/DO パターンが 5〜7 個以内か
   • 承認ポイントが最低1箇所あるか
   • 禁止事項が明示されているか
   • タスク分類ツリーがすべてのケースをカバーしているか
3. 不合格なら修正して再チェック
4. 合格後のみ完了とする