Files
Brian f033e70a2c feat(method): add bmad-preview-ticketing skill and tickets.py runtime (#2884)
* feat(method): add bmad-preview-ticketing skill and tickets.py runtime

Ticketing at every altitude: an initiative sliced into epics, an epic
incepted into a Breakdown of stories, spikes, and bugs, and tickets
written, refined, published, and moved on a git-backed store or a tracker
(GitHub, Jira, Linear, Notion, Trello).

- Container tickets are the spec at their altitude: Requirements with
  stable ids, Outcome, Done when, Boundaries, Breakdown.
- Thin tickets carry contribution and verification; full criteria are
  written when pulled (`refined: false` until approved).
- scripts/tickets.py derives ready, blocked, and to-create views from the
  files; scripts/read_toml.py reads the store config; tests beside them.
- Store configs per tracker under config/, templates per type under
  assets/, customization surface in customize.toml.
- Listed in the bmad help catalog as a preview alternative to
  bmad-create-epics-and-stories plus bmad-sprint-planning.

* fix(method): address review findings in bmad-preview-ticketing

- tickets.py: a dropped blocker still blocks its dependents; mark clears
  blocked_at and blocked_reason on a status change and takes the assignee
  literally; --project-root finds the store config when tickets live
  outside the project; a numeric blocker falls back to the ticket id;
  duplicate Breakdown numbers and blockers naming no entry are errors.
- read_toml.py: read local files only.
- board.md: mark is the leaf-level write, a container's status is a file
  edit, and a dropped ticket is removed or repointed in its dependents.
- SKILL.md: tickets are drafted under tickets.root; persistent facts load
  file: entries.
- gh config: read children with `gh issue view --json subIssues`.
- help catalog: the breakdown includes bugs.

* docs: add a guide to testing v7 previews

A new page under Plan Larger Work for trying proposed v7 planning
changes: setting up an initiative store, configuring where tickets are
tracked, and using bmad-preview-ticketing. It states early that preview
stories are not wired into sprint planning, sprint-status.yaml, or
status updates from bmad-build, and that a story must be refined before
it is built.

- Sidebar entry and a pointer from the stories-and-tracking page.
- Locale coverage baseline records the new English-only page.
2026-09-18 14:51:57 +08:00
..