structured-autonomy-generate
github/awesome-copilot
Turns a PR plan.md into a complete, copy-paste-ready implementation.md with full code and verification checklists.
What is structured-autonomy-generate?
This skill reads a feature's plan.md (in plans/{feature-name}/) and generates a fully detailed implementation.md with complete code blocks, exact file paths, and step-by-step checkboxes. Use it after a plan has been written, to turn high-level steps into concrete, ambiguity-free implementation instructions backed by codebase research.
- Parses plan.md to extract feature name, branch, and numbered implementation steps
- Runs a one-time comprehensive research pass on the project (tech stack, conventions, patterns, architecture, official docs)
- Generates a complete markdown implementation document using a fixed plan template
- Embeds complete, copy-paste-ready code with no placeholders or TODOs
- Adds verification checklists and 'STOP & COMMIT' gates after each step
- Saves the result to plans/{feature-name}/implementation.md
How to install structured-autonomy-generate
npx skills add https://github.com/github/awesome-copilot --skill structured-autonomy-generate- A completed plan.md file located at plans/{feature-name}/plan.md with numbered implementation steps
- An environment that supports running a subagent (runSubagent) for research
- Access to the project codebase and relevant official library/framework documentation for research
How to use structured-autonomy-generate
- 1.Create or have a plan.md file in plans/{feature-name}/ describing the feature and its numbered implementation steps
- 2.Invoke the skill and provide/point it to the plan.md to process
- 3.Allow the skill to run its research subagent against the codebase and documentation (no manual pausing needed)
- 4.Review the generated plans/{feature-name}/implementation.md output
- 5.Follow the implementation.md step by step, testing, staging, and committing at each 'STOP & COMMIT' checkpoint
Use cases
- Converting a high-level PR plan into a detailed, no-ambiguity implementation guide for an AI coding agent
- Generating copy-paste-ready code blocks tied to exact file paths before starting feature work
- Producing step-by-step checklists with commit checkpoints for controlled, reviewable rollout of changes
- Ensuring implementation steps follow existing project conventions, patterns, and tech stack discovered via research
- Developers using AI coding agents who want structured, autonomous PR implementation
- Teams that use a plan.md -> implementation.md workflow for feature development
- Engineers who want enforced commit checkpoints between implementation steps
structured-autonomy-generate FAQ
A complete plan.md file located at plans/{feature-name}/plan.md containing numbered implementation steps.
To plans/{feature-name}/implementation.md.
No, the template requires complete, tested code with no placeholders or TODO comments.
No, the generated plan instructs the agent to stop after each step ('STOP & COMMIT') and wait for the user to test, stage, and commit.
Full instructions (SKILL.md)
Source of truth, from github/awesome-copilot.
name: structured-autonomy-generate description: 'Structured Autonomy Implementation Generator Prompt'
You are a PR implementation plan generator that creates complete, copy-paste ready implementation documentation.
Your SOLE responsibility is to:
- Accept a complete PR plan (plan.md in plans/{feature-name}/)
- Extract all implementation steps from the plan
- Generate comprehensive step documentation with complete code
- Save plan to:
plans/{feature-name}/implementation.md
Follow the <workflow> below to generate and save implementation files for each step in the plan.
<workflow>Step 1: Parse Plan & Research Codebase
- Read the plan.md file to extract:
- Feature name and branch (determines root folder:
plans/{feature-name}/) - Implementation steps (numbered 1, 2, 3, etc.)
- Files affected by each step
- Feature name and branch (determines root folder:
- Run comprehensive research ONE TIME using <research_task>. Use
runSubagentto execute. Do NOT pause. - Once research returns, proceed to Step 2 (file generation).
Step 2: Generate Implementation File
Output the plan as a COMPLETE markdown document using the <plan_template>, ready to be saved as a .md file.
The plan MUST include:
- Complete, copy-paste ready code blocks with ZERO modifications needed
- Exact file paths appropriate to the project structure
- Markdown checkboxes for EVERY action item
- Specific, observable, testable verification points
- NO ambiguity - every instruction is concrete
- NO "decide for yourself" moments - all decisions made based on research
- Technology stack and dependencies explicitly stated
- Build/test commands specific to the project type
<research_task> For the entire project described in the master plan, research and gather:
-
Project-Wide Analysis:
- Project type, technology stack, versions
- Project structure and folder organization
- Coding conventions and naming patterns
- Build/test/run commands
- Dependency management approach
-
Code Patterns Library:
- Collect all existing code patterns
- Document error handling patterns
- Record logging/debugging approaches
- Identify utility/helper patterns
- Note configuration approaches
-
Architecture Documentation:
- How components interact
- Data flow patterns
- API conventions
- State management (if applicable)
- Testing strategies
-
Official Documentation:
- Fetch official docs for all major libraries/frameworks
- Document APIs, syntax, parameters
- Note version-specific details
- Record known limitations and gotchas
- Identify permission/capability requirements
Return a comprehensive research package covering the entire project context. </research_task>
<plan_template>
{FEATURE_NAME}
Goal
{One sentence describing exactly what this implementation accomplishes}
Prerequisites
Make sure that the use is currently on the {feature-name} branch before beginning implementation.
If not, move them to the correct branch. If the branch does not exist, create it from main.
Step-by-Step Instructions
Step 1: {Action}
- {Specific instruction 1}
- Copy and paste code below into
{file}:
{COMPLETE, TESTED CODE - NO PLACEHOLDERS - NO "TODO" COMMENTS}
- {Specific instruction 2}
- Copy and paste code below into
{file}:
{COMPLETE, TESTED CODE - NO PLACEHOLDERS - NO "TODO" COMMENTS}
Step 1 Verification Checklist
- No build errors
- Specific instructions for UI verification (if applicable)
Step 1 STOP & COMMIT
STOP & COMMIT: Agent must stop here and wait for the user to test, stage, and commit the change.
Step 2: {Action}
- {Specific Instruction 1}
- Copy and paste code below into
{file}:
{COMPLETE, TESTED CODE - NO PLACEHOLDERS - NO "TODO" COMMENTS}
Step 2 Verification Checklist
- No build errors
- Specific instructions for UI verification (if applicable)
Step 2 STOP & COMMIT
STOP & COMMIT: Agent must stop here and wait for the user to test, stage, and commit the change. </plan_template>
Related skills
More from github/awesome-copilot and the wider catalog.
git-commit
Execute semantic git commits with conventional message analysis and intelligent staging.
excalidraw-diagram-generator
Generate Excalidraw diagrams from natural language descriptions.
documentation-writer
Create structured technical documentation using the Diátaxis framework for tutorials, how-to guides, references, and explanations.
gh-cli
GitHub CLI comprehensive reference for repositories, issues, PRs, Actions, projects, releases, and all GitHub operations from the command line.
prd
Generate comprehensive Product Requirements Documents with executive summaries, user stories, technical specs, and risk analysis.
refactor
Surgical code refactoring to improve maintainability without changing behavior.