| name | transit |
| description | Route Transit tickets to the appropriate workflow based on task type. Use when a user mentions a T-[number] ticket reference and wants to work on it. Fetches task details and dispatches to the correct skill (fix-bug, creating-spec, planning mode, or asks for clarification). |
Transit Ticket Router
Route Transit tickets to the appropriate workflow based on their task type.
Workflow
1. Extract Ticket Reference
Parse the T-[number] reference from the user input. Extract the numeric display ID (e.g., T-42 -> display ID 42).
If no valid T-[number] reference is found, ask the user which ticket they want to work on.
2. Fetch Task Details
Query Transit for the task using mcp__transit__query_tasks. Match the task by its display ID from the results.
If task is not found: Stop and inform the user that the ticket could not be found in Transit. Do not proceed.
If task status is done or abandoned: Warn the user that the ticket is already marked as {status} and ask whether they still want to proceed. Stop if they decline.
3. Route by Task Type
Based on the task's type field, route to the appropriate workflow:
| Type | Action |
|---|
bug | Invoke /fix-bug and pass the ticket reference (T-{number}) and task context (name, description) |
feature | Invoke /starwave:creating-spec and pass the ticket reference (T-{number}) and task context (name, description) |
research | Enter planning mode with the research question from the task description |
chore | Invoke /starwave:smolspec and pass the ticket reference (T-{number}) and task context (name, description). Chores are typically refactors, cleanup, or maintenance — they fit the lightweight smolspec workflow. Follow the full chore pipeline: smolspec → implement → commit → pre-push review → pr-pilot |
documentation | Ask the user to clarify the scope, then route to the appropriate workflow |
4. Handoff
When routing to a skill, include:
- The Transit ticket reference (e.g.,
T-42)
- The task name and description from Transit as context
- Any relevant metadata from the task
The target skill is responsible for managing Transit status transitions from that point forward.
Edge Cases
- Ambiguous type: If the task type doesn't clearly map to a workflow, ask a single clarifying question before routing.
- Missing description: If the task has no description, ask the user to provide context about what needs to be done.
