# Orchestrator Designer

> 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.

- Skill: `nahisaho/orchestrator-designer` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add nahisaho/orchestrator-designer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nahisaho/orchestrator-designer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: nahisaho (https://skillmd.com/u/nahisaho)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/nahisaho/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 スキップの禁止
   - 承認ポイントの省略禁止
   - その他プロジェクト固有の禁止事項

## 出力テンプレート

```markdown
# <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. 合格後のみ完了とする