-
Notifications
You must be signed in to change notification settings - Fork 1.6k
Structured Autonomy Workflow #469
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
aaronpowell
merged 5 commits into
github:main
from
burkeholland:burkeholland-stuctured-autonomy
Dec 8, 2025
+319
−0
Merged
Changes from all commits
Commits
Show all changes
5 commits
Select commit
Hold shift + click to select a range
a762e98
Adding structured autonomy workflow
burkeholland ce50665
Update README
burkeholland e49f5e9
Apply suggestions from code review
burkeholland 1dde30e
Add structured autonomy implementation and planning prompts
burkeholland afbe4ce
Merge branch 'main' into burkeholland-stuctured-autonomy
burkeholland File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,15 @@ | ||
| id: structured-autonomy | ||
| name: Structured Autonomy | ||
| description: "Premium planning, thrifty implementation" | ||
| tags: [prompt-engineering, planning, agents] | ||
| items: | ||
| - path: prompts/structured-autonomy-plan.prompt.md | ||
| kind: prompt | ||
| - path: prompts/structured-autonomy-generate.prompt.md | ||
| kind: prompt | ||
| - path: prompts/structured-autonomy-implement.prompt.md | ||
| kind: prompt | ||
| display: | ||
| ordering: manual # or "manual" to preserve the order above | ||
| show_badge: true # set to true to show collection badge on items | ||
| featured: false | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,70 @@ | ||
| # Structured Autonomy | ||
|
|
||
| Prompts for autonomous project planning and implementation with GitHub Copilot, enabling collaborative development workflows through structured planning and code generation. | ||
|
|
||
| **Tags:** github-copilot, autonomous-workflows, project-planning, code-generation, structured-autonomy | ||
|
|
||
| ## Items in this Collection | ||
|
|
||
| | Title | Type | Description | MCP Servers | | ||
| | ----- | ---- | ----------- | ----------- | | ||
| | [Structured Autonomy Plan](../prompts/structured-autonomy-plan.prompt.md)<br />[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fstructured-autonomy-plan.prompt.md)<br />[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fstructured-autonomy-plan.prompt.md) | Prompt | Research-driven planning agent that breaks down feature requests into testable implementation steps with clear commit boundaries for pull requests. | [context7](https://github.com/upstash/context7)<br />[](https://aka.ms/awesome-copilot/install/mcp-vscode?name=context7&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22--package%22%2C%22%2540upstash%252Fcontext7%22%2C%22--%22%2C%22mcp%22%5D%2C%22env%22%3A%7B%7D%7D)<br />[](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=context7&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22--package%22%2C%22%2540upstash%252Fcontext7%22%2C%22--%22%2C%22mcp%22%5D%2C%22env%22%3A%7B%7D%7D)<br />[](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22--package%22%2C%22%2540upstash%252Fcontext7%22%2C%22--%22%2C%22mcp%22%5D%2C%22env%22%3A%7B%7D%7D) | | ||
| | [Structured Autonomy Generate](../prompts/structured-autonomy-generate.prompt.md)<br />[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fstructured-autonomy-generate.prompt.md)<br />[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fstructured-autonomy-generate.prompt.md) | Prompt | Implementation generator that converts structured plans into copy-paste ready code with complete verification checklists and step-by-step instructions. | [context7](https://github.com/upstash/context7)<br />[](https://aka.ms/awesome-copilot/install/mcp-vscode?name=context7&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22--package%22%2C%22%2540upstash%252Fcontext7%22%2C%22--%22%2C%22mcp%22%5D%2C%22env%22%3A%7B%7D%7D)<br />[](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=context7&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22--package%22%2C%22%2540upstash%252Fcontext7%22%2C%22--%22%2C%22mcp%22%5D%2C%22env%22%3A%7B%7D%7D)<br />[](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22--package%22%2C%22%2540upstash%252Fcontext7%22%2C%22--%22%2C%22mcp%22%5D%2C%22env%22%3A%7B%7D%7D) | | ||
| | [Structured Autonomy Implement](../prompts/structured-autonomy-implement.prompt.md)<br />[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fstructured-autonomy-implement.prompt.md)<br />[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fstructured-autonomy-implement.prompt.md) | Prompt | Implementation agent that executes step by step instructions, validating each action and stopping for user verification before proceeding. | [context7](https://github.com/upstash/context7)<br />[](https://aka.ms/awesome-copilot/install/mcp-vscode?name=context7&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22--package%22%2C%22%2540upstash%252Fcontext7%22%2C%22--%22%2C%22mcp%22%5D%2C%22env%22%3A%7B%7D%7D)<br />[](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=context7&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22--package%22%2C%22%2540upstash%252Fcontext7%22%2C%22--%22%2C%22mcp%22%5D%2C%22env%22%3A%7B%7D%7D)<br />[](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22--package%22%2C%22%2540upstash%252Fcontext7%22%2C%22--%22%2C%22mcp%22%5D%2C%22env%22%3A%7B%7D%7D) | | ||
|
|
||
| --- | ||
|
|
||
| ## How It Works | ||
|
|
||
| Structured Autonomy is a three-phase workflow designed to maximize the value you get from AI-assisted development while keeping premium requests low. The system follows a simple principle: **use premium models sparingly for thinking, use cheap models liberally for doing**. | ||
|
|
||
| ### The Workflow | ||
|
|
||
| ``` | ||
| ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ | ||
| │ sa-plan │ ──▶ │ sa-generate │ ──▶ │ sa-implement │ | ||
| │ (1 request) │ │ (1 request) │ │ (many requests)│ | ||
| │ Premium Model │ │ Premium Model │ │ Cheap Model │ | ||
| └─────────────────┘ └─────────────────┘ └─────────────────┘ | ||
| ``` | ||
|
|
||
| **Phase 1: Plan** — You describe what you want to build. The planning agent researches your codebase, reads documentation, and breaks your feature into logical commits. Output: `plans/{feature-name}/plan.md` | ||
|
|
||
|
|
||
| ``` | ||
| /plan Add a user profile page to this application that allows the user to view and edit their profile information. | ||
| ``` | ||
|
|
||
| **Phase 2: Generate** — The generator takes your plan and produces complete, copy-paste ready implementation instructions with full code blocks. No placeholders, no TODOs—just working code based on your actual codebase patterns. Output: `plans/{feature-name}/implementation.md` | ||
|
|
||
| ``` | ||
| /generate #plan.md | ||
| ``` | ||
|
|
||
| **Phase 3: Implement** — The implementation agent follows the generated instructions step-by-step, checking off items as it goes and stopping at defined commit boundaries for you to verify and commit. | ||
|
|
||
| ``` | ||
| /implement #implementation.md | ||
| ``` | ||
|
|
||
| The implementation will stop after it completes a commit, allowing you to verify the changes and then proceed. It will automatically resume from the next step. | ||
|
|
||
| ### One Branch, One PR | ||
|
|
||
| Each workflow operates on a single feature branch targeting a single pull request. Implementation steps map directly to commits, giving you: | ||
|
|
||
| - **Clean git history** with logical, reviewable commits | ||
| - **Natural checkpoints** where you verify the code works before moving on | ||
| - **Easy rollback** if something goes wrong—just reset to the last good commit | ||
|
|
||
| ### Why This Approach Works | ||
|
|
||
| **Cost Efficiency** — Premium models (Claude Opus, GPT-5.1-Codex) are expensive but excel at reasoning and planning. You use them exactly twice: once to understand your request and once to generate the implementation. The actual coding work uses free models that can iterate as many times as needed. | ||
|
|
||
| **Better Code Quality** — Because the planning phase researches your codebase first, the generated code follows your existing patterns, naming conventions, and architecture. You're not fighting against AI suggestions that don't fit your project. | ||
|
|
||
| **Developer Engagement** — The step-by-step implementation with manual commit points keeps you in the loop. You're reviewing and testing real changes at each step, not staring at a massive diff at the end wondering what happened. | ||
|
|
||
| **Familiar Workflow** — This isn't a new way of working—it's your existing git workflow with AI assistance. Feature branches, incremental commits, PR reviews. The AI handles the tedious parts while you stay in control of the process. | ||
|
|
||
|
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.