Menu
Use when executing implementation plans with independent tasks in the current session
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies
Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies
Guide the agent through iterative PR/MR refinement to ensure all CI checks, tests, linting, and validation passes before considering the work complete. Never declare success until all automated checks pass.
Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation
Use when completing tasks, implementing major features, or before merging to verify work meets requirements
Use when implementing any feature or bugfix, before writing implementation code
| name | subagent-driven-development |
| description | Use when executing implementation plans with independent tasks in the current session |
Execute plan by dispatching fresh subagent per task, with two-stage review after each: spec compliance review first, then code quality review.
Core principle: Fresh subagent per task + two-stage review (spec then quality) = high quality, fast iteration
flowchart LR
have_plan{"Have implementation plan?"}
tasks_independent{"Tasks mostly independent?"}
stay_session{"Stay in this session?"}
subagent["subagent-driven-development"]
executing["executing-plans"]
manual["Manual execution or brainstorm first"]
have_plan -->|yes| tasks_independent
have_plan -->|no| manual
tasks_independent -->|yes| stay_session
tasks_independent -->|"no - tightly coupled"| manual
stay_session -->|yes| subagent
stay_session -->|"no - parallel session"| executing
vs. Executing Plans (parallel session):
flowchart TB
subgraph cluster_per_task["Per Task"]
d_impl["Dispatch implementer subagent (./implementer-prompt.md)"]
q_impl{"Implementer subagent asks questions?"}
ans["Answer questions, provide context"]
impl["Implementer subagent implements, tests, commits, self-reviews"]
d_spec["Dispatch spec reviewer subagent (./spec-reviewer-prompt.md)"]
spec_ok{"Spec reviewer subagent confirms code matches spec?"}
fix_spec["Implementer subagent fixes spec gaps"]
d_quality["Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md)"]
quality_ok{"Code quality reviewer subagent approves?"}
fix_quality["Implementer subagent fixes quality issues"]
mark["Mark task complete in TodoWrite"]
end
read_plan["Read plan, extract all tasks with full text, note context, create TodoWrite"]
more_tasks{"More tasks remain?"}
final_review["Dispatch final code reviewer subagent for entire implementation"]
finish["Use superpowers:finishing-a-development-branch"]
read_plan --> d_impl
d_impl --> q_impl
q_impl -->|yes| ans
ans --> d_impl
q_impl -->|no| impl
impl --> d_spec
d_spec --> spec_ok
spec_ok -->|no| fix_spec
fix_spec --> d_spec
spec_ok -->|yes| d_quality
d_quality --> quality_ok
quality_ok -->|no| fix_quality
fix_quality --> d_quality
quality_ok -->|yes| mark
mark --> more_tasks
more_tasks -->|yes| d_impl
more_tasks -->|no| final_review
final_review --> finish
./implementer-prompt.md - Dispatch implementer subagent./spec-reviewer-prompt.md - Dispatch spec compliance reviewer subagent./code-quality-reviewer-prompt.md - Dispatch code quality reviewer subagentYou: I'm using Subagent-Driven Development to execute this plan.
[Read plan file once: docs/plans/feature-plan.md]
[Extract all 5 tasks with full text and context]
[Create TodoWrite with all tasks]
Task 1: Hook installation script
[Get Task 1 text and context (already extracted)]
[Dispatch implementation subagent with full task text + context]
Implementer: "Before I begin - should the hook be installed at user or system level?"
You: "User level (~/.config/superpowers/hooks/)"
Implementer: "Got it. Implementing now..."
[Later] Implementer:
- Implemented install-hook command
- Added tests, 5/5 passing
- Self-review: Found I missed --force flag, added it
- Committed
[Dispatch spec compliance reviewer]
Spec reviewer: ✅ Spec compliant - all requirements met, nothing extra
[Get git SHAs, dispatch code quality reviewer]
Code reviewer: Strengths: Good test coverage, clean. Issues: None. Approved.
[Mark Task 1 complete]
Task 2: Recovery modes
[Get Task 2 text and context (already extracted)]
[Dispatch implementation subagent with full task text + context]
Implementer: [No questions, proceeds]
Implementer:
- Added verify/repair modes
- 8/8 tests passing
- Self-review: All good
- Committed
[Dispatch spec compliance reviewer]
Spec reviewer: ❌ Issues:
- Missing: Progress reporting (spec says "report every 100 items")
- Extra: Added --json flag (not requested)
[Implementer fixes issues]
Implementer: Removed --json flag, added progress reporting
[Spec reviewer reviews again]
Spec reviewer: ✅ Spec compliant now
[Dispatch code quality reviewer]
Code reviewer: Strengths: Solid. Issues (Important): Magic number (100)
[Implementer fixes]
Implementer: Extracted PROGRESS_INTERVAL constant
[Code reviewer reviews again]
Code reviewer: ✅ Approved
[Mark Task 2 complete]
...
[After all tasks]
[Dispatch final code-reviewer]
Final reviewer: All requirements met, ready to merge
Done!
vs. Manual execution:
vs. Executing Plans:
Efficiency gains:
Quality gates:
Cost:
Never:
If subagent asks questions:
If reviewer finds issues:
If subagent fails task:
Required workflow skills:
Subagents should use:
Alternative workflow: