break-into-issues

Installation
SKILL.md

Break Into Issues

Decompose a reviewed technical design into implementation issues. Each issue is scoped for a single AI agent context window — all file paths, patterns, types, and acceptance criteria are front-loaded so the implementing agent can work autonomously without extensive codebase exploration.

Output is numbered markdown files in ./issues/<plan-name>/, not GitHub issues.

Pipeline Position

This skill sits at the end of the planning pipeline:

plan-feature → write-a-prd → review-prd → glossary → design-feature → review-plan → break-into-issues → agent implementation

By this point, all design decisions should be resolved. If they aren't, the input isn't ready.

Process

1. Locate and validate the plan

Ask the user for the plan file path. If not provided, list ./plans/*.md and ask which one to decompose.

Installs
3
First Seen
Mar 24, 2026
break-into-issues — michaelmerrill/skills