z-prd-to-openspec
Installation
SKILL.md
PRD to OpenSpec
Decompose a PRD into OpenSpec change proposals, one per vertical slice. Each slice is a tracer bullet: a thin path through every layer, independently verifiable when done.
Confirm the OpenSpec surface
openspec/must exist; if not, the user initializes it (openspec init).- Discover the installed CLI's verbs via
openspec --helpor the project's task runner before writing — don't assume command names. - Change layout:
openspec/changes/<change-id>/holdingproposal.md,design.md,tasks.md, andspecs/deltas per touched capability.
Slice the PRD
- Vertical, not horizontal: each slice cuts schema → API → UI → tests end-to-end. "All the endpoints" is a layer, not a slice.
- A finished slice is demoable or verifiable on its own.
- Prefactoring that makes later slices easy goes in its own first slice — make the change easy, then make the easy change.
- Use the existing OpenSpec glossary and decisions. Fall back to the project's CONTEXT/ADR convention only when it is the authoritative record.