Add superpowers dev workflow plugin with planning/execution/verification gates#1220
Add superpowers dev workflow plugin with planning/execution/verification gates#1220Mihir-Null wants to merge 2 commits intogithub:stagedfrom
Conversation
There was a problem hiding this comment.
Pull request overview
Adds a new “superpowers” workflow plugin package to the awesome-copilot marketplace, providing reusable planning/execution/verification gates plus associated agent + instructions, and updates repo indexes/marketplace metadata accordingly.
Changes:
- Added
superpowers-dev-workflowplugin with plugin metadata + README. - Added four new skills (planning/execution/verification gates + execution prompt templates) and a new code reviewer agent.
- Added repo/user instruction files and regenerated docs/marketplace indexes.
Reviewed changes
Copilot reviewed 19 out of 19 changed files in this pull request and generated 7 comments.
Show a summary per file
| File | Description |
|---|---|
| skills/superpowers-verification-gate/SKILL.md | New verification gate skill content + metadata |
| skills/superpowers-planning-gate/SKILL.md | New planning gate skill content + metadata |
| skills/superpowers-execution-gate/SKILL.md | New execution gate skill content + metadata |
| skills/superpowers-execution-prompt-pack/SKILL.md | Skill wrapper for prompt templates + usage pattern |
| skills/superpowers-execution-prompt-pack/templates/implementer.md | Implementer handoff template |
| skills/superpowers-execution-prompt-pack/templates/spec-reviewer.md | Spec compliance review template |
| skills/superpowers-execution-prompt-pack/templates/quality-reviewer.md | Quality review template (currently malformed) |
| plugins/superpowers-dev-workflow/.github/plugin/plugin.json | Plugin manifest wiring agent + skills |
| plugins/superpowers-dev-workflow/README.md | Plugin documentation and install instructions |
| plugins/superpowers-dev-workflow/instructions/user/superpowers-user-workflow.instructions.md | Plugin-scoped user instruction placeholder (currently not a real instruction file) |
| plugins/superpowers-dev-workflow/instructions/repo/superpowers-repo-workflow.instructions.md | Plugin-scoped repo instruction placeholder (currently not a real instruction file) |
| instructions/superpowers-user-workflow.instructions.md | New top-level user baseline instruction |
| instructions/superpowers-repo-workflow.instructions.md | New top-level repo guardrails instruction |
| agents/superpowers-code-reviewer.agent.md | New agent definition for severity-based review gating |
| docs/README.skills.md | Adds the new skills to the skills index |
| docs/README.plugins.md | Adds the new plugin to the plugins index |
| docs/README.instructions.md | Adds the new instructions to the instructions index |
| docs/README.agents.md | Adds the new agent to the agents index |
| .github/plugin/marketplace.json | Registers the new plugin in the marketplace output |
Comments suppressed due to low confidence (1)
skills/superpowers-execution-prompt-pack/templates/quality-reviewer.md:30
quality-reviewer.mdlooks unintentionally corrupted: the “Output Format” / “Severity” guidance is concatenated onto one line and the numbered “Review Areas” list stops at 3 with item 4 appended at the end. Please reformat this template into proper headings/lists so it’s usable as a prompt handoff.
- Final assessment: blocked or ready- Issues by severity with actionable fixes- Strengths## Output Format- Minor- Important- Critical## Severity4. Error handling and safety
| @@ -0,0 +1,33 @@ | |||
| --- | |||
| name: superpowers-verification-gate | |||
| description: Use before declaring work done. Validate behavior with reproducible evidence, identify residual risk, and classify unresolved issues by severity. | |||
There was a problem hiding this comment.
Most SKILL.md frontmatter in this repo wraps description in single quotes to avoid YAML edge cases (colons, punctuation, etc.). Consider quoting this description for consistency and safer parsing.
| description: Use before declaring work done. Validate behavior with reproducible evidence, identify residual risk, and classify unresolved issues by severity. | |
| description: 'Use before declaring work done. Validate behavior with reproducible evidence, identify residual risk, and classify unresolved issues by severity.' |
| @@ -0,0 +1,32 @@ | |||
| --- | |||
| name: superpowers-execution-prompt-pack | |||
| description: Use when you need consistent prompt templates for plan execution. Provides reusable templates for task implementer, spec reviewer, and code quality reviewer handoffs. | |||
There was a problem hiding this comment.
Most SKILL.md frontmatter in this repo wraps description in single quotes to avoid YAML edge cases (colons, punctuation, etc.). Consider quoting this description for consistency and safer parsing.
| description: Use when you need consistent prompt templates for plan execution. Provides reusable templates for task implementer, spec reviewer, and code quality reviewer handoffs. | |
| description: 'Use when you need consistent prompt templates for plan execution. Provides reusable templates for task implementer, spec reviewer, and code quality reviewer handoffs.' |
| - `superpowers-code-reviewer` | ||
| - Skills: | ||
| - `superpowers-planning-gate` | ||
| - `superpowers-execution-gate` |
There was a problem hiding this comment.
The plugin README’s “Included Assets” skill list is missing superpowers-execution-prompt-pack, but the plugin actually ships it (and docs list 4 superpowers skills). Please update the README so the documented included skills match the plugin contents.
| - `superpowers-execution-gate` | |
| - `superpowers-execution-gate` | |
| - `superpowers-execution-prompt-pack` |
| @@ -0,0 +1 @@ | |||
| See top-level instruction: instructions/superpowers-user-workflow.instructions.md | |||
There was a problem hiding this comment.
This file is named *.instructions.md but it isn’t a valid instruction (no YAML frontmatter like description/applyTo, and no actual instruction content). If this is intended to be installable as part of the plugin, include full frontmatter + content (or remove/rename it so it’s not treated as an instruction file).
| @@ -0,0 +1 @@ | |||
| See top-level instruction: instructions/superpowers-repo-workflow.instructions.md | |||
There was a problem hiding this comment.
This file is named *.instructions.md but it isn’t a valid instruction (no YAML frontmatter like description/applyTo, and no actual instruction content). If this is intended to be installable as part of the plugin, include full frontmatter + content (or remove/rename it so it’s not treated as an instruction file).
| @@ -0,0 +1,32 @@ | |||
| --- | |||
| name: superpowers-planning-gate | |||
| description: Use when a feature or fix is requested and implementation has not started yet. Build a concise approved plan with explicit files, tests, and acceptance criteria before coding. | |||
There was a problem hiding this comment.
Most SKILL.md frontmatter in this repo wraps description in single quotes to avoid YAML edge cases (colons, punctuation, etc.). Consider quoting this description for consistency and safer parsing.
| description: Use when a feature or fix is requested and implementation has not started yet. Build a concise approved plan with explicit files, tests, and acceptance criteria before coding. | |
| description: 'Use when a feature or fix is requested and implementation has not started yet. Build a concise approved plan with explicit files, tests, and acceptance criteria before coding.' |
| @@ -0,0 +1,29 @@ | |||
| --- | |||
| name: superpowers-execution-gate | |||
| description: Use when an approved implementation plan exists. Execute tasks in order, keep scope tight, and report progress with concrete evidence after each task. | |||
There was a problem hiding this comment.
Most SKILL.md frontmatter in this repo wraps description in single quotes to avoid YAML edge cases (colons, punctuation, etc.). Consider quoting this description for consistency and safer parsing.
| description: Use when an approved implementation plan exists. Execute tasks in order, keep scope tight, and report progress with concrete evidence after each task. | |
| description: 'Use when an approved implementation plan exists. Execute tasks in order, keep scope tight, and report progress with concrete evidence after each task.' |
aaronpowell
left a comment
aaronpowell
left a comment
There was a problem hiding this comment.
It looks like you've incorrectly branched from the main branch not staged, and the PR is targeting main when it should target staged. When the target changes all the materialised plugins are going to be included in this PR.
You can attempt to fix this with a rebase:
git fetch origin staged
git rebase --onto origin/staged origin/main <branch name>
git push --force-with-lease
If that does not resolve it, you can run npm run plugin:clean which will delete the materialised plugins and you can commit that change.
Also, instruction files aren't supported in plugins, so those files should be removed.
|
@copilot apply changes based on the comments in this thread |
Summary
superpowers-dev-workflowsuperpowers-planning-gatesuperpowers-execution-gatesuperpowers-verification-gatesuperpowers-execution-prompt-pack(implementer/spec/quality templates)superpowers-code-reviewerValidation
npm run skill:validatepassed (all skills valid)npm run buildpassed and includessuperpowers-dev-workflowin.github/plugin/marketplace.jsonnpm run plugin:validatecurrently reports repo-wide path-format issues across many pre-existing plugins (not introduced by this change)Why
This introduces a portable, model-agnostic workflow package aligned to awesome-copilot conventions for plan-first implementation, verification-before-done, and severity-based review gates.