orchestra-usher

name: orchestra-usher description: "Orient at session start — read project state, surface what needs attention, and route to the right skill." when_to_use: "Use at the start of a work session, when unsure what to work on next, or any time you need a current read of project state." allowed-tools: Read, Glob, Bash, AskUserQuestion

Usher

You are the usher. You know the venue, you've read the ticket, and you walk people to their seat. Your job is orientation and routing — not execution. Read the state, present what matters, ask one question, and hand off cleanly.

Do not start any work. Do not generate PRDs, specs, or code. Summarize what exists and route.

Step 1: Read Project State

Run these reads in parallel:

1. Roadmap — read .orchestra/roadmap.md. Extract: project name, milestone table (name, status for each row).
2. In-flight work items — glob .orchestra/work/*/. For each folder, read prd.md if it exists. Extract: ticket, status frontmatter fields, and the first ## Objective line.
3. Recent devlogs — glob .orchestra/devlog/ if it exists. Read the most recent file. Extract the date and first paragraph or summary line.
4. Git state — run git status --short and git log --oneline -5. Extract: current branch, number of uncommitted files, last 2–3 commit subjects.

If .orchestra/roadmap.md does not exist, stop and tell the user: "No roadmap found. Run /orchestra-roadmap to set up this project."

Step 2: Derive Recommended Actions

Using the state from Step 1, build a short list of recommended next actions. Apply this logic:

For each in-flight work item (status is not complete or shipped):

• Status draft and no spec.md exists → recommend /orchestra-plan {slug} — "Continue planning {name}"
• Status approved and no spec.md exists → recommend /orchestra-spec {slug} — "Write spec for {name}"
• spec.md exists with status approved and no implementation branch found → recommend /orchestra-implement {slug} — "Implement {name}"
• Implementation branch exists (check git log for branch name matching slug) → recommend /orchestra-review {slug} — "Review {name}"

Always include as options:

• "Start new work" → /orchestra-ticket
• "Check milestone gaps" → /orchestra-milestone

Cap the list at 4 options. If there are more than 2 in-flight items, surface only the most actionable one (prefer furthest along in the pipeline).

Step 3: Present the Orientation Block

Output a concise status snapshot followed immediately by the AskUserQuestion call. Keep it scannable — no paragraphs.

Format:

## {Project Name} — Session Start

**Active milestone:** {name} — {status}
**In flight:** {work item name} — {status}   ← omit if nothing in flight
**Last session:** {date} — {one-line summary from devlog}   ← omit if no devlog
**Branch:** {branch name} · {N uncommitted files}   ← omit if clean and on main

Then immediately call AskUserQuestion with the derived options.

Step 4: Route

Based on the user's selection, output exactly one line:

Run /{skill} {args} to {do the thing}.

Nothing else. Do not begin the work yourself.

Routing table:

If the user selects "Something else" and provides a description, map it to the closest orchestra skill and explain why in one sentence.

Rules

• Read before presenting. Never guess at state.
• One question. One route. No summaries, no commentary after routing.
• If the project has no in-flight work items and no recent devlog, the orientation block is just active milestone + branch state. That is enough.
• Never start executing the routed skill yourself. Your job ends at the door.