Router
Use this skill to decide which agile skill is appropriate and get directed to the correct one.
Initial context received via slash: $ARGUMENTS
If
is filled, use as context to determine the right skill.
If empty, ask the user what they need help with.
Prompting
Follow the project-wide convention in
/
("Skill Prompting Conventions"). Use the harness's structured-question tool —
(Claude Code),
(Codex), or
(OpenCode) — for the decision points below.
| Decision point | Why structured | Suggested options |
|---|
| Suggested skill when ambiguous | Routes the work | list the 2–4 candidates with the recommendation flagged |
Free-form prompts (no structured tool):
- Problem description (so the router can decide)
No-pause mode: if the user has explicitly disabled mid-skill clarification, pick the highest-confidence recommendation and proceed; surface the decision and reasoning rather than asking.
Scope
This skill replaces both the planning router and the ceremonies router. It covers three areas:
| Area | Question | Skills |
|---|
| What to create | What planning artifact fits this work? | , , , |
| What ceremony to run | Where are we in the sprint cycle? | , , |
| What to track | How should I report progress? | (checkpoint, consolidation, closure) |
| What to improve in the process | Did real usage expose a skill/template gap or overlap? | |
Decision tree
Planning: What artifact do I need?
mermaid
flowchart TD
A[New problem or request] --> B{Is the problem clear?}
B -- No --> C["/agile-intake"]
B -- Yes --> D{Multi-phase trajectory<br/>with dependencies?}
D -- Yes --> I["/agile-roadmap"]
I --> G["/agile-epic"]
D -- "No, single initiative" --> E{What size?}
E -- "Small, localized" --> F["/agile-story"]
E -- "Medium/large, needs decomposition" --> G
C --> H{Intake recommends...}
H -- Multi-phase trajectory --> I
H -- Single initiative --> G
H -- Small/clear --> F
Note on : Roadmap is NOT defined by time horizon (e.g., "3-12 months"). It is defined by
trajectory complexity. Even a 4-week initiative benefits from a roadmap if it has multiple sequenced phases with dependencies between them.
Note on : Handles both the epic overview and story decomposition. There is no separate story skill. Medium work that needs richer acceptance criteria goes through
for structure, or directly to
if it's a single vertical delivery.
Ceremonies: Where am I in the cycle?
- Starting a sprint? →
- Sprint just ended? → (demo deliveries) then (reflect on process)
- Backlog items unclear? → (decompose) or run (validate)
- Need metrics? → (before review or retro)
- A skill/template caused friction or overlaps with another? →
Tracking: How do I report progress?
- Quick daily checkpoint? → (checkpoint mode)
- Period or milestone consolidation? → (consolidation mode)
- Delivery finished? → (closure mode)
- Skill library needs merge, split, deprecation, removal, or template refinement? →
Light sizing
Internal reference for AI agent — not exposed to users. Use plain language when communicating the recommendation.
| Size | Description | Artifact | Skill |
|---|
| Extra small | Localized adjustment, 1 file, low risk | Task | |
| Small | Small delivery, few files, simple validation | Task | |
| Medium | Vertical delivery, several files, moderate validation | Epic story file or Task | or |
| Large | Multiple coordinated stories, needs decomposition | Epic | |
| Extra large | Multi-story initiative, coordination needed | Epic | |
When to use roadmap vs epic
Sizing alone is not enough to decide between roadmap and epic. Use this checklist:
Use when 2+ apply (regardless of duration):
- Multiple initiatives need sequencing (can't all run in parallel)
- Decisions today affect future decisions (local optimization can become tech debt)
- Stakeholders need to see the whole journey before approving individual steps
- External dependencies (other teams, vendors, deadlines)
- Total complexity exceeds what fits in a single epic
- Single coordinated initiative with clear scope
- Can be broken into stories without needing a parent plan
- Fits on one delivery wave (no distinct phases with different goals)
Anti-pattern: Assume roadmap = "long-term strategic plan". A 4-week work with 5 phases and hard ordering also benefits from a roadmap. The criterion is trajectory complexity, not duration.
Process
- Listen to the user's context.
- Determine which area applies: planning, ceremony, or tracking.
- Apply the decision tree for that area.
- Recommend the specific skill with a brief explanation.
- Confirm with the user before they proceed.
Rules
- This is a router skill — it evaluates and directs, but does not produce artifacts.
- If the problem isn't clear, suggest before routing.
- Use plain language when explaining the recommendation. Do not reference size codes.
- Always confirm the recommendation with the user.
Available skills
| Skill | Purpose |
|---|
| Capture vague problems |
| Map multi-phase trajectories with dependencies (any duration) |
| Structure initiatives, decompose into stories |
| Execution plan for localized changes |
| Validate planning artifacts and review code |
| Track progress (checkpoint, consolidation, closure) |
| Sprint planning ceremony |
| Sprint review and demo |
| Quantitative sprint metrics |
| Retrospective with improvement actions |
| Interactive UI prototypes |
| New team member onboarding |
| Improve, merge, split, deprecate, or remove skills from real usage evidence |
| This skill — guidance on which skill to use |
Relationship with the flow
mermaid
flowchart LR
A["/agile-intake"] --> B["/agile-roadmap"]
B --> C["/agile-epic"]
C --> D["/agile-story"]
D --> E[execution]
E --> F["/agile-status"]
F --> G["/agile-retro"]
This skill is a router. It evaluates and directs, but does not produce the final artifact. For specific work, use the recommended skill directly.