workflow-router
Installation
SKILL.md
Workflow Router
You don't remember every skill, so ask.
A flow is a path through the skills. Most paths run along one main flow, and two on-ramps merge onto it. Everything else is standalone, or a vocabulary layer that runs underneath.
The main flow: idea → ship
The route most work travels. You have an idea and want it built.
/grill-with-docssharpens the idea by interview. Start here whenever you are working in a working directory: it's stateful, retaining what it learns inCONTEXT.mdand ADRs. (No working directory? Use/grill-meinstead, covered under Standalone. Both run the same/grillingprimitive;grill-with-docsis the one that leaves a paper trail, which makes it the better of the two whenever a repo is there to leave it in.)- Branch: can you settle every question in conversation? If a question needs a runnable answer (state, business logic, a UI you have to see), detour through a prototype, bridged by
/handoffin both directions (a prototype lives in its own directory, which is exactly what/handoffis for; see Phase boundaries):/handoffout, then open a fresh session against that file,/prototypeto answer the question with throwaway code,/handoffback what you learned, and reference it from the original idea thread.
- Shape the experience and implementation plan when the work needs them. For a product-facing feature where the user journey or interface should not be invented during coding, run
/ui-specto writedocs/ux-spec.md, then/tech-specto inspect that UX and the codebase and writedocs/technical-spec.md. These are complementary planning artifacts:ui-specdecides what the user experiences;tech-specdecides the simplest way to preserve it. Skip either only when its decisions are already settled and available in an equivalent approved artifact. - Branch: is this a multi-session build?
- Yes →
/to-spec(turn the thread into a spec), then/to-ticketsto split it into tracer-bullet tickets, each declaring its blocking edges. On a local tracker that's one file per ticket under.scratch/<feature>/issues/, worked blockers-first by hand; on a real tracker the edges become native blocking links. Run/implementper ticket, clearing context between tickets, or use/implement-specto orchestrate the full ticket graph on one integration branch. - No →
/implementright here, in the same context window.
- Yes →