Skip to content

Conversation

@burkeholland
Copy link
Contributor

Pull Request Checklist

  • I have read and followed the CONTRIBUTING.md guidelines.
  • My contribution adds a new instruction, prompt, or chat mode file in the correct directory.
  • The file follows the required naming convention.
  • The content is clearly structured and follows the example format.
  • I have tested my instructions, prompt, or chat mode with GitHub Copilot.
  • I have run npm start and verified that README.md is up to date.

Description

Structured Autonomy Workflow Addition

  • Added structured-autonomy collection configuration (collections/structured-autonomy-collection.yml) describing the workflow and listing its prompt files.
  • Created comprehensive documentation for the workflow, detailing its phases, cost-efficiency, and developer benefits (collections/structured-autonomy.md).

Prompt Templates

Documentation and Catalog Updates

  • Updated docs/README.prompts.md to list the new "Structured Autonomy" prompts (sa-plan, sa-generate, sa-implement) in the ready-to-use prompt templates section.

Type of Contribution

  • New instruction file.
  • New prompt file.
  • New chat mode file.
  • New collection file.
  • Update to existing instruction, prompt, chat mode, or collection.
  • Other (please specify):

Additional Notes


By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.

Copilot AI review requested due to automatic review settings December 7, 2025 22:22
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR introduces a "Structured Autonomy Workflow" - a three-phase AI-assisted development workflow that uses premium models sparingly for planning and generation, then switches to cheaper models for implementation. The workflow breaks down feature requests into manageable commits within a single PR/branch.

Key Changes:

  • Three new prompt templates for plan, generate, and implement phases
  • Collection configuration and documentation describing the workflow
  • Documentation updates in README listing the new prompts

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 12 comments.

Show a summary per file
File Description
prompts/structured-autonomy-plan.prompt.md Planning agent prompt that researches codebase and breaks features into commit-based steps
prompts/structured-autonomy-generate.prompt.md Generator prompt that converts plans into complete, copy-paste ready implementation documentation
prompts/structure-autonomy-implement.prompt.md Implementation agent that executes step-by-step instructions with verification checkpoints
docs/README.prompts.md Updated prompt catalog to include the three new structured autonomy prompts
collections/structured-autonomy.md Comprehensive documentation explaining the three-phase workflow, cost efficiency, and developer benefits
collections/structured-autonomy-collection.yml Collection configuration linking the three prompts together

Copy link
Contributor

@aaronpowell aaronpowell left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Few spelling mistakes and the link from Copilot in there for actioning @burkeholland

@burkeholland
Copy link
Contributor Author

Thank you, @aaronpowell! I think we're good now.

@aaronpowell aaronpowell merged commit dfb9d33 into github:main Dec 8, 2025
6 checks passed
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 6 out of 6 changed files in this pull request and generated 2 comments.

Comment on lines +2 to +5
name: sa-plan
description: Structured Autonomy Planning Prompt
model: Claude Sonnet 4.5 (copilot)]
agent: agent
Copy link

Copilot AI Dec 8, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Missing required description field in the front matter. According to the prompt file guide, all prompt files must have a description field that is not empty and wrapped in single quotes. For example: description: 'Structured Autonomy Planning Prompt'

Copilot generated this review using guidance from repository custom instructions.
@@ -0,0 +1,127 @@
---
name: sa-generate
description: Structured Autonomy Implementation Generator Prompt
Copy link

Copilot AI Dec 8, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The description field value must be wrapped in single quotes according to the prompt file guide. Change description: Structured Autonomy Implementation Generator Prompt to description: 'Structured Autonomy Implementation Generator Prompt'

Copilot generated this review using guidance from repository custom instructions.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants