epic
Installation
SKILL.md
Epic kickoff
Start an epic from its spec, never by re-interviewing. The PRD section the epic links to is the design; this skill's job is to verify it still holds, turn it into an execution plan, and get building. It never asks what the section already answers.
Steps
- Locate and read. Find the epic in
ROADMAP.md. In the single-file layout its stories are inline; in the split layout follow the epic's link todocs/epics/E<nn>-<slug>.md. Read the epic's stories, its linked PRD section in full, the roadmap index (dependencies and the MVP line are context), and the write-ups (docs/write-ups/) of completed epics this one builds on — in a fresh session those are the only memory of past decisions and surprises. If earlier epics it depends on are unticked, surface that before anything else. - Verify the spec is decision-complete — and still true. For every story the section must answer: what exactly, how it is verified, and what it depends on. List the gaps precisely — a gap is a missing decision, not a missing implementation detail. Check also what the section overlooks, not only what it leaves blank: name its riskiest decision and confirm an alternative was genuinely weighed. Where the spec rests on external facts that age (APIs, versions, prices), verify them before building — a quick research pass, delegated where the harness supports it — and fold corrections into the PRD non-accretively, like any answer.
- Grill only the gaps. One decision per turn through the structured question tool (plain-text lettered fallback elsewhere), a recommendation every time. Fold each answer into the PRD section non-accretively — rewrite as if it were always the decision — before building on it.
- Kick off. Produce the execution plan:
- stories ordered by dependency;
- the artifact this epic exits with — above the MVP line something shippable (pushed repo, published package, live URL, cut release), below it the feedback loop it opens (who uses it, what signal);
- the demo that proves the epic done (hand to
/demo-ideaswhen it ships); - the benchmarks, when the epic's feature touches a metric the PRD's validation strategy names: the command, the metric, and its budget — run at epic completion so numbers land early and become the baseline later epics regress against (omit when nothing measurable ships);
- the regression checks the epic exits with — automated tests written as part of the epic, in the framework most appropriate to the task: one layer per sub-section of the feature covering its edge cases, then the feature end-to-end as a whole, so added features can't silently regress it. If the right framework isn't installed, don't settle — ask permission to install it so the tests can be completed. The suite is built with
/regression, composing with a TDD skill where one drives development; - which stories are well-specified enough to hand to
/delegate, and which are really questions — a story whose true output is a decision goes to/spikefirst. A companion skill that isn't installed is done as its inline equivalent instead.
- Confirm the plan with the user, record it, then build. In the split layout, write the confirmed plan's exit criteria into the epic's file under
## Exit criteria— the artifact, the regression command, the demo, and the benchmark command with its budget where one applies — so/wrap-upgates the tick against a written contract, not a remembered one. Build in small commits, one story's worth per commit where possible. Present the plan — and narrate work as it completes — so a junior and a senior engineer both follow it: lead with what each piece enables for the developer and the end user, not its mechanics. When the build lands, review the diff before closing (/code-reviewwhere the harness ships one, a deliberate self-review pass elsewhere) so/wrap-upproposes ticks against reviewed work. - Never tick. When work lands,
/wrap-upproposes the ticks with evidence; a kickoff changes no checkboxes.