prd-to-issues

Break PRDs into dependency-ordered GitHub issues with vertical slices.

12|Updated Dec 25, 2024
One-click install
npx skills add https://github.com/whyte25/reusables --skill prd-to-issues-whyte25
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prd-to-issues
Source: https://github.com/whyte25/reusables/tree/main/.agents/skills/prd-to-issues
Command: npx skills add https://github.com/whyte25/reusables --skill prd-to-issues-whyte25

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns a PRD into an end-to-end set of independently implementable GitHub issues, so teams can plan and execute without translating requirements into tickets manually.

Core Features & Use Cases

  • Vertical-slice issue breakdown: Creates thin tracer-bullet slices that cut across schema, API, UI, and tests rather than horizontal layers.
  • HITL vs AFK planning: Marks issues that require human interaction (HITL) versus those that can be implemented end-to-end without it (AFK).
  • Dependency-aware ticket creation: Orders issue creation so “Blocked by” references real issue numbers.
  • User-story mapping: Links each created issue back to the relevant user stories from the PRD.

Quick Start

Ask the Skill to convert your PRD GitHub issue (provide its issue number or URL) into a numbered, HITL/AFK-labeled set of vertical-slice issues and then create them in dependency order.

Frequently Asked Questions about prd-to-issues

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

FAQPage Schema
How do I convert a PRD into GitHub issues for implementation planning?

To convert a PRD into GitHub issues, the Skill fetches requirements from a GitHub issue and breaks them into independently implementable vertical-slice tickets. It creates these issues using gh issue create in dependency order with a provided template.

What are vertical slices in product execution and how do they structure tickets?

Vertical slices in product execution are thin tracer-bullet tickets that cut across schema, API, UI, and tests rather than horizontal layers. This structure ensures each GitHub issue delivers end-to-end functionality across all integration layers.

How do I map user stories from a PRD to GitHub issues with dependency ordering?

To map user stories to GitHub issues, the Skill links each created issue back to relevant PRD user stories and orders creation sequentially. This approach ensures that all "Blocked by" references point to real, already-created issue numbers.

Can I categorize implementation tickets as HITL or AFK for autonomous execution?

Yes, you can categorize implementation tickets as HITL (Human-in-the-Loop) or AFK (Away From Keyboard) during issue breakdown. This planning distinction marks which GitHub issues require human interaction versus those that can be implemented end-to-end autonomously.

Do I need a GitHub issue number to start breaking down a PRD into actionable tickets?

Yes, you need an existing GitHub issue number or URL containing your PRD details. The Skill fetches the PRD content directly from that GitHub issue to draft the vertical-slice implementation tickets.

What is the best way to plan tracer-bullet vertical slices across integration layers?

The best way to plan tracer-bullet vertical slices is to map dependencies first and then generate thin end-to-end tickets. The Skill drafts these slices with HITL/AFK labels and user-story mapping before creating them in dependency order.