prd-to-issues

Installation
SKILL.md

This skill is invoked when the user wants to break a PRD into implementation issues. The PRD lives at plans/<plan-name>/README.md. You produce numbered issue files under plans/<plan-name>/issues/ plus an index.json tracker.

  1. Locate the PRD. The PRD lives at plans/<plan-name>/README.md. If the user hasn't specified the plan name and there is more than one folder inside plans/, ask them which one to use. If there is only one, use it.

  2. Explore the codebase (optional). If you have not already explored the codebase, do so to understand the current state of the code.

  3. Draft vertical slices. Break the PRD into tracer-bullet issues. Each issue is a thin vertical slice that cuts through ALL integration layers end-to-end, NOT a horizontal slice of one layer.

    Slices may be HITL (require human interaction, such as an architectural decision or a design review) or AFK (can be implemented and merged without human interaction). Prefer AFK over HITL where possible.

    For each slice, assign an effort level from 1-5 using the rubric in REFERENCE.md. The level reflects how much reasoning and design judgement the issue requires, which downstream tooling uses to route the issue to an appropriately capable model.

  4. Quiz the user. Present the proposed breakdown as a numbered list. For each slice, show:

Related skills
Installs
7
First Seen
Apr 13, 2026