← Back to list
01Issue
FeatureClosedExtensionsPublic
AssigneesNone
#2800 gatorwalk-factory: a breakdown stage files child issues and their dependencies
Opened by skunk-ape · 9/30/2026
Part of the tracker-seam decision (https://claude.ai/artifact/TDidgyVjxKXU7JsNH1baNy). Needs #2795 and #2796, and #2767 (for examples/).
Seth's call: breaking an epic down is an optional stage some lifecycles include, as they include a plan stage.
Change
- A stage's
trackerblock gainsbreakdown: { product: <name>, on: { approve: <gate> } }. - The product's schema is
{ children: [{ ref, title, body, type?, blockedBy?: [ref] }] }, validated by the engine like any product and approved by a gate. - On approval,
publish(or an explicitfile_breakdownmethod):- creates each child through the tracker, in dependency order;
- records
parent_offrom the work item's issue to each child, andblocked_byfor each edge; - writes
breakdown-<key>mapping each ref to its issue id.
- Every write is ledgered with the child's ref in the key, so a failure part-way resumes and a re-run files nothing twice.
- Children are never started automatically. Each is claimed like any other issue (claim warns while blocked).
- An example lifecycle with a breakdown stage in
examples/, validated by the examples test.
Done when
- Against the built-in tracker and the Lab fake: approving a breakdown files children and edges once; a failure after the second child and a re-run files the rest; unknown refs in
blockedByand cycles fail product validation. - The design page shows the breakdown stage.
02Bog Flow
Closed
No activity in this phase yet.
03Sludge Pulse
Editable. Press Enter to edit.
skunk-ape commented 10/5/2026, 7:08:06 PM
Closing with stagecraft's first release (@swamp/stagecraft 2026.10.02.1). This was a design gap recorded before launch and nothing in use has asked for it. If it matters in practice it will resurface from actual use, and this issue can be reopened or refiled with the case that needs it.
Sign in to post a ripple.