master-orchestrator

Master Orchestrator

Purpose

Inspect project state and route to the correct skill. This skill NEVER implements, debugs, or designs. It only routes.

Agent Protocol

Trigger

Exact user phrases: "start", "help me build", "initialize", "I want to build X", "where do I start", "what skill", "what should I do next", "begin", "let's start".

Input Context

• Working directory must be set to the project root.
• If no project root is detectable, ask the user: "Where is your project directory?"

Output Artifact

None. This skill produces no files. It emits a routing decision as text.

Response Format

The agent MUST output exactly one of the following templates. No preamble. No postamble. No explanations. No filler/hedging/transitions. Compress output — why use many token when few do trick. No explanations.

Template A — Route to a single skill:

Next skill: **{skill-name}**
Reason: {one sentence exactly}
Context: {key facts the next skill needs}

Template B — Route to multiple skills (sequential):

Next skills:
1. **{skill-name}** — {reason}
2. **{skill-name}** — {reason}

Template C — Need more information:

Need: {what you need from the user}
Options:
- {option 1}
- {option 2}

Completion Criteria

This skill is complete when:

• Project state has been checked (docs/, README, package manifests)
• Stack/language detected or asked
• A single next skill has been identified
• Output follows exactly one of the three templates above
• No implementation, debugging, or advice has been given

Max Response Length

3 lines maximum for routing. 6 lines maximum for "need more information."

Workflow

Step 1: Check Filesystem

Run these checks in order. Stop at the first match.

1. Test-Path -LiteralPath docs/brief*.md — brief exists
2. Test-Path -LiteralPath docs/prd*.md — PRD exists
3. Test-Path -LiteralPath docs/decisions/ — ADRs exist
4. Test-Path -LiteralPath docs/specs/ — tech specs exist
5. Test-Path -LiteralPath package.json — Node project
6. Test-Path -LiteralPath Cargo.toml — Rust project
7. Test-Path -LiteralPath go.mod — Go project
8. Test-Path -LiteralPath requirements.txt or pyproject.toml — Python project
9. Test-Path -LiteralPath pom.xml or build.gradle — Java project