Skill Tracer
Skills › BMAD Method › bmad-agent-po › ticket-template.md

ticket-template.md

75 lines · skills/bmad-agent-po/assets/ticket-template.md at bd70c64

Open on GitHub

Most marks come from matching words in the file, so treat them as pointers.

1---
2tracker_id: "" # with remote (url): set at publish on a tracker, on a story by `tickets.py mirror`; cut on the repo store
3id: [story: its tickets.toml entry id, or the folder's `next_id` if none; cut on a container]
4type: [initiative | epic | story]
5title: "[Container: its outcome. Story: what works when done]"
6parent: [the parent container's folder name; none for an initiative or a backlog/ story]
7covers: [epic: parent ids it owns; story: epic ids it serves; cut on an initiative. Constraints go in References, not here]
8sources: [] # every input SPEC derived Requirements from, paths from {project-root}; each is re-read on update; never the memlog
9companions: [] # files downstream reads beside this ticket, written or adopted by SPEC, paths from {project-root}
10after: [] # container: epics it waits on; epic order is in tickets.toml. Story: prerequisites only: sibling id, "<epic id>.<entry id>", or epic-<slug>
11assignee: "" # story: only a tracker's, via `tickets.py mirror`; cut on a container
12# container: add status: in-progress | done | dropped when its first ticket starts
13# a story's status, assignee, blocked_at, blocked_reason live in the plan beside this file, not here; tracker_status from tracker sync
14refined: false # story: true once the user approves its criteria; on a pulled story only if its entry has `refine = true`. Epic: false only when slicing writes it thin, until refined; else cut. Cut on an initiative
15hitl: false # true when a person does part of the work; story only, cut on a container
16risk: [low|medium|high; container: a best guess until sliced, then its children's highest]
17---
19<!-- At create a container gets all but Requirements and Constraints, which SPEC writes from an input. An epic written at slicing gets Description, Outcome, Boundaries, Done when as far as known, and References to the parent; Requirements and Constraints come when it is refined. A pulled or reviewed story: Description, Verify: line, References, local Notes; refining adds numbered criteria and Boundaries. Done and dropped tickets stay as written. An initiative is the business outcome its epics serve, usually spanning quarters and more than one boundary; for a solo developer or small team a whole product is a fine initiative. -->
21# [Title]

<!-- At create a container gets all but Requirements and Constraints, which SPEC writes from an input. An epic written at slicing gets Description, Outcome, Boundaries, Done when as far as known, and References to the parent; Requirements and Constraints come when it is refined. A pulled or reviewed story: Description, Verify: line, References, local Notes; refining adds numbered criteria and Boundaries. Done and dropped tickets stay as written. An initiative is the business outcome its epics serve, usually spanning quarters and more than one boundary; for a solo developer or small team a whole product is a fine initiative. -->

[Title]

Raw lines 1 to 22
Involves a person once the user approves :14
23## Description
25[Container: a paragraph, what is true when done and why, pointing at the inputs or parent. Story: one sentence; with numbered criteria, 2–4 on how it advances the epic, not restating them.]

Description

[Container: a paragraph, what is true when done and why, pointing at the inputs or parent. Story: one sentence; with numbered criteria, 2–4 on how it advances the epic, not restating them.]

Raw lines 23 to 26
27## Outcome
29[Container: one sentence: for whom, what changes, the source's success signal named not restated. Story: cut.]

Outcome

[Container: one sentence: for whom, what changes, the source's success signal named not restated. Story: cut.]

Raw lines 27 to 30
31## Requirements
33[Container: SPEC writes this from the ticket's `.memlog.md`; slicing never touches it. Initiative: `R<n> (<source ids>): <checkable result>`, ids prefixed with the source's References type when ambiguous (`prd FR-2`), its section when it has none. Epic: its owned parent lines, `R<n> (parent R<m>): <the line>`, deepened only as inputs require; split or added lines name a parent id or source section, all lines a source section when `covers` is empty. Story: only `Verify: how it will be checked`. No epic, `refine = true`, or on request: numbered criteria, each naming the epic ids it proves; a criterion states a rule, not an instance, with its failure path.]
351. **[Behavior name]** (R<m>)
36 **Given** [state before]
37 **When** [the one action]
38 **Then** [what is observable]
39 **And** [another observation, if any]

Requirements

[Container: SPEC writes this from the ticket's .memlog.md; slicing never touches it. Initiative: R<n> (<source ids>): <checkable result>, ids prefixed with the source's References type when ambiguous (prd FR-2), its section when it has none. Epic: its owned parent lines, R<n> (parent R<m>): <the line>, deepened only as inputs require; split or added lines name a parent id or source section, all lines a source section when covers is empty. Story: only Verify: how it will be checked. No epic, refine = true, or on request: numbered criteria, each naming the epic ids it proves; a criterion states a rule, not an instance, with its failure path.]

  1. [Behavior name] (R<m>) Given [state before] When [the one action] Then [what is observable] And [another observation, if any]
Raw lines 31 to 40
41## Constraints
43[SPEC writes this. Initiative: each design-bending non-negotiable, citing its source id or section. Epic: the parent's that bind it. Story: only ones beyond its epic's; behavior to keep goes under Boundaries.]

Constraints

[SPEC writes this. Initiative: each design-bending non-negotiable, citing its source id or section. Epic: the parent's that bind it. Story: only ones beyond its epic's; behavior to keep goes under Boundaries.]

Raw lines 41 to 44
45## Done when
47[Container: three to six end checks from the source's measures and limits: an initiative's business outcomes, an epic's deliverables at its Requirements' altitude, production delivery among them. Story: cut.]

Done when

[Container: three to six end checks from the source's measures and limits: an initiative's business outcomes, an epic's deliverables at its Requirements' altitude, production delivery among them. Story: cut.]

Raw lines 45 to 48
49## Boundaries
51[Container: its boundary and what it is not, from the source's non-goals. Initiative: plus a line per touched unit with no epic, and a one-sentence tracer path across epics. Epic: what belongs to siblings. Story: with numbered criteria, adjacent behavior an implementation could break, not files; else cut.]
53- Touch point: [unit] — [what is used there]; owner: epic-[slug]
54- Must not change: [behavior]

Boundaries

[Container: its boundary and what it is not, from the source's non-goals. Initiative: plus a line per touched unit with no epic, and a one-sentence tracer path across epics. Epic: what belongs to siblings. Story: with numbered criteria, adjacent behavior an implementation could break, not files; else cut.]

  • Touch point: [unit] — [what is used there]; owner: epic-[slug]
  • Must not change: [behavior]
Raw lines 49 to 55
56## References
58[`type — location, section`, location a path from {project-root} or a url. A line per companion SPEC writes or adopts, typed by content (glossary, design, architecture, prd). Initiative: section pointers into its sources and companions. Epic: the parent's Requirements, then the architecture spine section and design it adopts. Story: the parent, plus what the epic's lack.]
60- parent — [path or url, section Requirements]
61- [companion — a file beside this one, named for its content]
62- [design — an adopted companion, such as DESIGN.md in the ux-<slug>/ run beside this file, or a url]

References

[type — location, section, location a path from {project-root} or a url. A line per companion SPEC writes or adopts, typed by content (glossary, design, architecture, prd). Initiative: section pointers into its sources and companions. Epic: the parent's Requirements, then the architecture spine section and design it adopts. Story: the parent, plus what the epic's lack.]

  • parent — [path or url, section Requirements]
  • [companion — a file beside this one, named for its content]
  • [design — an adopted companion, such as DESIGN.md in the ux-<slug>/ run beside this file, or a url]
Raw lines 56 to 63
64## Notes
66[Only what is unsettled here and not in the repo or source, one marked line each; cut if empty. SPEC writes Assumption: and Open question: from the memlog; slicing and refining, the rest.]
68- Assumption: [an unconfirmed choice; once confirmed, a dated Decision]
69- Open question: [container: what the source leaves open, and who waits; story: only its own, answered in its work]
70- Unknown: [the gap and the entries waiting on it; gates an entry only once copied to its `unknown` key]
71- Parked: [an unplaced requirement id, why, with the user's knowledge]
72- Decision: [the user's choice, dated; a declined suggestion too]
73- Source conflict: [id or section — source vs code or another source]
74- Waits on [epic] because: [reason, one per after entry]
75- Dropped: [why, before status goes to dropped]

Notes

[Only what is unsettled here and not in the repo or source, one marked line each; cut if empty. SPEC writes Assumption: and Open question: from the memlog; slicing and refining, the rest.]

  • Assumption: [an unconfirmed choice; once confirmed, a dated Decision]
  • Open question: [container: what the source leaves open, and who waits; story: only its own, answered in its work]
  • Unknown: [the gap and the entries waiting on it; gates an entry only once copied to its unknown key]
  • Parked: [an unplaced requirement id, why, with the user's knowledge]
  • Decision: [the user's choice, dated; a declined suggestion too]
  • Source conflict: [id or section — source vs code or another source]
  • Waits on [epic] because: [reason, one per after entry]
  • Dropped: [why, before status goes to dropped]
Raw lines 64 to 75