emit-tickets

emit-tickets

Materialise a roadmap into an agents/tickets/{slug}/ bundle — one ticket per buildable step — then wire the markers back and run the buildability gate.

When to use

Signal	Match
"turn this roadmap into tickets"	yes
"materialise / emit tickets for <roadmap>"	yes
"mach Tickets aus der Roadmap"	yes
"plan the work for <roadmap>"	yes
User wants a YAML ticket bundle, not a prose plan	yes
Refining or splitting an existing ticket	no → use refine-ticket
Estimating a single ticket	no → use estimate-ticket

Upstream: roadmap-writing — author the roadmap first. Downstream: src/scripts/lint_ticket_buildable.ts (the build-readiness gate). A ticket reaches a tracker by paste or MCP (ADR-102) — no export script.

Procedure

Steps at a glance:

1. Locate and parse the roadmap.
2. Create agents/tickets/{slug}/ and draft one ticket YAML per materializable step.
3. Assign model_tier via the granularity floor; split oversized steps.
4. Compute SHA refs for adr_refs / source_refs.
5. Write manifest.yml with acyclic dependency_graph and empty linear_state.
6. Append <!-- ticket: T-NNN --> markers back into the roadmap.
7. (Re)generate agents/tickets/_registry.yml.
8. Run lint_ticket_buildable until exit 0 (max 3 attempts).
9. Tell the user the bundle is ready: paste a ticket into Linear/Jira, or have the agent create it via a tracker MCP server (ADR-102 — no API export).

§0 — Locate the roadmap

Confirm the roadmap slug and open agents/roadmaps/{slug}.md. Identify all materializable steps (checkbox items that describe a code or docs change). Skip informational steps, phase headings, and acceptance-criteria prose.

§1 — Derive the bundle slug

agents/tickets/{slug}/ — same slug as the roadmap. Create the directory.

§2 — One ticket per step

For each materializable step, draft a ticket YAML:

id: T-NNN
roadmap: {slug}
phase: {N}
title: "{step text, ≤80 chars}"
status: ready
model_tier: {lite | medium | high}   # see §3
estimate: {story-points, integer}
priority: {1=critical … 4=low}
labels: []
parent: null
blocked_by: []
adr_refs: []
source_refs: []
assets: none
acceptance:
  - "{measurable done criterion}"
boundaries:
  must_touch: []
  may_touch: []
  must_not_touch: []