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

  1. 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 to docs/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.
  2. 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.
  3. 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.
  4. 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-ideas when 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 /spike first. A companion skill that isn't installed is done as its inline equivalent instead.
  5. 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-up gates 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-review where the harness ships one, a deliberate self-review pass elsewhere) so /wrap-up proposes ticks against reviewed work.
  6. Never tick. When work lands, /wrap-up proposes the ticks with evidence; a kickoff changes no checkboxes.
Installs
3
First Seen
6 days ago
epic — oxmonty/product-engineering-skills