issue-to-plan
Installation
SKILL.md
Issue to Plan
Overview
Turn a finalized issue into a draft PR plus a single marked plan comment, then stop. The draft PR and its plan comment are the durable boundary between planning and execution.
Core principle: planning and execution happen in separate contexts. This skill never runs SDD or dispatches Task 1.
The plan lives in a PR comment, never the description. The description stays a concise, reviewer-facing summary (Closes #N + change summary + test plan): the simplest merge path — squash-merging from the GitHub web UI, which prefills the commit message from the PR body — then produces a clean commit message instead of a multi-kilobyte plan.
Entry Gate (all 6 steps, in order)
- Run
gh issue view <N> --json number,title,body,state. - If the title starts with
[DRAFT], or the body's## Brainstorm statesection has aNext:line (a revision still in progress), stop and route tobrainstorming-to-issue #<N>. - If the
Size:value in## Brainstorm statestarts withquick taskorsmall change, stop: say "Implement # directly, no plan — follow the build steps in its## Brainstorm state." Do not claim, build, or plan here. - If the entire change is one file, one behavior, and one red-green-commit review pass, use
superpowers:test-driven-developmentdirectly. Uncertainty means it is not trivial. - Claim the issue per repository rules: assign it and add the
in-progresslabel. - Retain
Closes #<N>for the PR description.