ticket-breakdown

Decompose approved specifications into prioritized, dependency-ordered implementation tickets with acceptance criteria.

3|Updated Feb 18, 2026
One-click install
npx skills add https://github.com/gener8v/gener8v.claude-skills --skill ticket-breakdown-gener8v
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ticket-breakdown
Source: https://github.com/gener8v/gener8v.claude-skills/tree/main/skills/ticket-breakdown
Command: npx skills add https://github.com/gener8v/gener8v.claude-skills --skill ticket-breakdown-gener8v

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve? Turning an approved specification into actionable work items is error-prone: requirements get dropped, acceptance criteria stay vague, and implementers build on stale assumptions. This Skill decomposes one capability area's requirements for one change into self-contained, implementable tickets with traceable requirement coverage. ## Core Features & Use Cases - Ticket Generation: Produces one TICKET-NNN.md file per ticket with Priority, Value, Requirements Covered, Prior Art, Acceptance Criteria, Output contracts, Known Hazards, dependencies, and relative sizing. - Backlog Overview: Writes a backlog.md with dependency chain, suggested ordering, and a summary table showing which tickets are ready to start. - Traceability & Coverage: Verifies every in-scope REQ and NFR from the change brief appears in at least one ticket, with NFR verification methods stated as criteria. - Use Case: After a search specification is approved, run the breakdown to get four ordered tickets — query interface and index setup in parallel, then ranking, then attribution — each with testable acceptance criteria and front-loaded hazards. ## Quick Start Break the search-and-retrieval specification into tickets for the support-search change.

Frequently Asked Questions about ticket-breakdown

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I break a specification into implementation tickets?▼

Provide the capability area and change slug; the Skill reads the change brief, specification, constraints, dependency map, and technical design, then writes one TICKET-NNN.md per ticket plus a backlog.md with ordering and a summary table.

What inputs does ticket breakdown require before running?▼

At minimum it needs a change brief and a specification with numbered REQ and NFR IDs. Constraints, dependency map, and technical design are optional; if missing, the gap is noted in the backlog's Source Context and breakdown proceeds.

What makes a good acceptance criterion for a ticket?▼

Acceptance criteria must be observable and verifiable, not aspirational. For example, 'search returns results ranked by relevance score, highest first' is testable, while 'search works well' is not. NFRs must name their verification method.

Can I re-run ticket breakdown after the specification changes?▼

Yes. Re-running loads the existing ticket directory, keeps all IDs append-only, adds new tickets above the current maximum, marks obsolete undelivered tickets as Withdrawn, and regenerates backlog.md. Delivered ticket files are never rewritten.

Why is a ticket still blocked after its dependency was delivered?▼

The Depends On field resolves ticket IDs only within the same change and area directory. A qualified reference to another area's ticket is misread as a local ticket number. Express cross-area predecessors through the dependency map's DEP- ID and Prior Art instead.

When should I not use ticket breakdown?▼

Do not use it to implement a ticket (that is delivery) or to order whole capability areas against each other (that is dependency mapping). It also cannot run without an approved specification and an open change brief.