
Structured Autonomy Generate
Turn an approved feature plan.md into a copy-paste-ready implementation.md with researched steps, code blocks, and checkboxes.
Overview
structured-autonomy-generate is an agent skill most often used in Build (also Ship review prep) that turns plan.md in plans/{feature-name}/ into comprehensive implementation.md with researched, checkbox-driven steps and
Install
npx skills add https://github.com/github/awesome-copilot --skill structured-autonomy-generateWhat is this skill?
- Two-step workflow: parse plan.md then one-shot codebase research via runSubagent
- Output saved to plans/{feature-name}/implementation.md with full plan_template
- Requires complete copy-paste code blocks with zero modification
- Markdown checkboxes for every action item plus testable verification points
- Extracts numbered implementation steps and affected files from the source plan
- 2-step workflow: parse plan then generate implementation file
- Output path: plans/{feature-name}/implementation.md
Adoption & trust: 8.5k installs on skills.sh; 34.6k GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
You have plan.md with feature steps but no single implementation doc agents can execute without guessing paths, code, or verification.
Who is it for?
Solo builders using plans/{feature-name}/plan.md who want zero-ambiguity implementation packs before agent-driven PR work.
Skip if: Greenfield ideas with no plan.md yet, or one-off edits that do not warrant a full implementation document.
When should I use this skill?
You have a complete PR plan in plans/{feature-name}/plan.md and need comprehensive implementation.md documentation.
What do I get? / Deliverables
A saved implementation.md under the feature plan folder with complete code, checkboxes, and verification points ready for the coding agent to run step by step.
- plans/{feature-name}/implementation.md with full template and code blocks
- Per-step verification criteria and markdown checkboxes
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Canonical shelf is Build PM because output is implementation documentation derived from an existing PR/feature plan before or during coding. Structured autonomy generation is planning-to-execution handoff: parse plan steps, research once, emit implementation.md under plans/{feature-name}/.
Where it fits
After scoping a prototype in plan.md, generate implementation.md so the agent knows exact files and checks before you build the spike.
Feature branch plan.md is approved; run the skill once to produce implementation.md for the coding session.
Large PR planned in advance—implementation.md gives reviewers observable verification points aligned to each step.
How it compares
Implementation doc generator from an existing plan—not a brainstorming or ad-hoc chat planner.
Common Questions / FAQ
Who is structured-autonomy-generate for?
Indie developers and small teams practicing plan-first development who already wrote plan.md and need agents to materialize a full implementation playbook.
When should I use structured-autonomy-generate?
Use it in Build PM after plan.md exists; also useful in Ship when you want a verified step list before a large PR, or in Validate when a scoped prototype plan needs an execution doc before you code.
Is structured-autonomy-generate safe to install?
It instructs subagent research and filesystem writes under your plans folder; check the Security Audits panel on this page and review runSubagent and write paths in SKILL.md before use.
SKILL.md
READMESKILL.md - Structured Autonomy Generate
You are a PR implementation plan generator that creates complete, copy-paste ready implementation documentation. Your SOLE responsibility is to: 1. Accept a complete PR plan (plan.md in plans/{feature-name}/) 2. Extract all implementation steps from the plan 3. Generate comprehensive step documentation with complete code 4. 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 1. 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 2. Run comprehensive research ONE TIME using <research_task>. Use `runSubagent` to execute. Do NOT pause. 3. 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 </workflow> <research_task> For the entire project described in the master plan, research and gather: 1. **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 2. **Code Patterns Library:** - Collect all existing code patterns - Document error handling patterns - Record logging/debugging approaches - Identify utility/helper patterns - Note configuration approaches 3. **Architecture Documentation:** - How components interact - Data flow patterns - API conventions - State management (if applicable) - Testing strategies 4. **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}`: ```{language} {COMPLETE, TESTED CODE - NO PLACEHOLDERS - NO "TODO" COMMENTS} ``` - [ ] {Specific instruction 2} - [ ] Copy and paste code below into `{file}`: ```{language} {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}`: ```{language} {COMPLETE, TESTED CODE - NO PLACEHOLDERS - NO "TODO" COMMENTS} ``` ##### Step 2 Verification Checklist - [ ] No build errors - [ ] Specific instructions for UI verification (if applicable) #### Step 2 STO