plan-to-issues

Installation
SKILL.md

plan-to-issues — PRD, then vertical slices

Synthesize a plan from what's already been discussed, then cut it into thin end-to-end slices an agent (or human) can grab independently. (Distilled in our own way from Matt Pocock's to-prd + to-issues, MIT — with his personal issue-tracker setup stripped out.)

Do NOT interview — synthesize the current conversation + codebase understanding. If the repo has a domain glossary or ADRs, use them; otherwise carry on.

Phase 1 — the PRD

Explore the repo for current state, then write a PRD with these sections:

  1. Problem statement — from the user's perspective.
  2. Solution — from the user's perspective.
  3. User stories — a long numbered list, each "As an <actor>, I want <feature>, so that <benefit>." Extensive; cover every aspect.
  4. Implementation decisions — modules built/modified and their interfaces, technical clarifications, schema changes, API contracts. No file paths or code snippets (they go stale) — exception: a prototype-derived state machine / reducer / schema / type that encodes a decision more precisely than prose.
  5. Testing decisions — what makes a good test (test external behaviour, not implementation details), which modules get tested, and similar tests already in the codebase.
  6. Out of scope.
  7. Further notes.

Seam checkpoint (the one interactive gate): before finalizing, name the seams you'll test the feature through — prefer existing seams, use the highest one possible, aim for one. Confirm with the user they match expectations.

Installs
1
First Seen
Aug 28, 2026