structured-autonomy-plan

Overview

Structured Autonomy Plan is a skill that collaborates with users to design structured development plans for implementation as single pull requests. It researches the codebase, breaks down features into commit-sized steps, generates a complete plan document saved to plans/{feature-name}/plan.md, and iterates based on user feedback before any code is written.

Key Features

• Automated Codebase Research - Runs a sub-agent to autonomously gather project context including architecture, conventions, dependencies, and testing patterns before planning
• Commit-Level Decomposition - Breaks features into individual commits, using single commits for simple features and multiple sequential commits for complex ones, each representing a testable step
• Interactive Plan Refinement - Marks sections needing clarification with [NEEDS CLARIFICATION] tags and pauses for user feedback, iterating until the plan is approved
• Structured Output Format - Generates plans with branch name, goal description, implementation steps with affected files, and specific instructions for each commit
• No-Code Planning - Focuses entirely on analysis and planning without writing any implementation code, ensuring thorough understanding before development begins

Who is this for?

This skill is for development teams that want to plan features thoroughly before writing code, especially in AI-assisted or autonomous development workflows. It is particularly useful for teams practicing structured PR workflows where each pull request follows a well-defined plan with clear commit boundaries and testable milestones.