Epic Tracker
Manages the delivery lifecycle in an external tracker. Plan epics, track stories, report bugs, and file tasks — every artifact lives in Linear or GitHub, which is the single source of truth.
Triggers
- Plan / decompose ("create roadmap", "plan the roadmap", "organize epics", "roadmap the PRD", "decompose", "break down the roadmap", "break this epic into stories", "materialize the epics") → decompose.md
- Epic ("create epic", "new epic", "edit epic") → epic.md
- Story ("create story", "new story", "add story", "edit story", "update story", "change story") → story.md
- Bug ("create bug", "report bug", "bug report", "edit bug") → bug.md
- Task / Chore ("create task", "new task", "add task", "create chore", "edit task") → task.md
- Status / overview ("mark done", "cancel this", "won't fix", "list epics", "what's in progress", "update status") → sync.md
- Reparent ("move this to epic X", "reparent this story", "change the parent epic") → sync.md
- Dependencies ("block this on X", "unblock this", "this depends on X") → sync.md
- Configure tracker ("configure tracker") → sync.md
Workflow
create ref → tracker → the tracker every artifact takes this path
↑
├ user brings the plan the usual input
└ decompose (optional): derives the plan from a PRD, feeds the ref
Every artifact takes the same path: a create ref drafts it and dispatches it to the tracker. The plan usually comes from the user directly. decompose is the optional ceremony in front — it derives the plan from a PRD, records it in the roadmap, and confirms before materializing; a declined checkpoint leaves the roadmap written and nothing created. A tracker is required: without one configured, the bootstrap runs first and nothing is created until it completes.
1---2name: epic-tracker3description: Roadmap and delivery artifact management in Linear or GitHub. Use when creating, editing, decomposing, moving, or updating roadmaps, epics, stories, bugs, or tasks. Not for implementing a named story, feature status in a spec, project overviews, or quick fixes.4---56# Epic Tracker78Manages the delivery lifecycle in an external tracker. Plan epics, track stories, report bugs, and file tasks — every artifact lives in Linear or GitHub, which is the single source of truth.910## Triggers1112- **Plan / decompose** ("create roadmap", "plan the roadmap", "organize epics", "roadmap the PRD", "decompose", "break down the roadmap", "break this epic into stories", "materialize the epics") → [decompose.md](instructions/decompose.md)13- **Epic** ("create epic", "new epic", "edit epic") → [epic.md](instructions/epic.md)14- **Story** ("create story", "new story", "add story", "edit story", "update story", "change story") → [story.md](instructions/story.md)15- **Bug** ("create bug", "report bug", "bug report", "edit bug") → [bug.md](instructions/bug.md)16- **Task / Chore** ("create task", "new task", "add task", "create chore", "edit task") → [task.md](instructions/task.md)17- **Status / overview** ("mark done", "cancel this", "won't fix", "list epics", "what's in progress", "update status") → [sync.md](instructions/sync.md)18- **Reparent** ("move this to epic X", "reparent this story", "change the parent epic") → [sync.md](instructions/sync.md)19- **Dependencies** ("block this on X", "unblock this", "this depends on X") → [sync.md](instructions/sync.md)20- **Configure tracker** ("configure tracker") → [sync.md](instructions/sync.md)2122## Workflow2324```text25create ref → tracker → the tracker every artifact takes this path26 ↑27 ├ user brings the plan the usual input28 └ decompose (optional): derives the plan from a PRD, feeds the ref29```3031Every artifact takes the same path: a create ref drafts it and dispatches it to the tracker. The plan usually comes from the user directly. `decompose` is the optional ceremony in front — it derives the plan from a PRD, records it in the roadmap, and confirms before materializing; a declined checkpoint leaves the roadmap written and nothing created. A tracker is required: without one configured, the bootstrap runs first and nothing is created until it completes.
adeonir