subagent-driven-development

Executes implementation plans by dispatching fresh subagents per task with two-stage review.

Updated Dec 19, 2024
One-click install
npx skills add https://github.com/DNepovim/yadm --skill subagent-driven-development-dnepovim
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: subagent-driven-development
Source: https://github.com/DNepovim/yadm/tree/main/.claude/plugins/cache/claude-plugins-official/superpowers/5.0.6/skills/subagent-driven-development
Command: npx skills add https://github.com/DNepovim/yadm --skill subagent-driven-development-dnepovim

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Executing a multi-task implementation plan in a single session often leads to context pollution, skipped reviews, and inconsistent quality. This Skill orchestrates plan execution by delegating each task to a fresh subagent with curated context and enforcing spec compliance and code quality reviews after every task. ## Core Features & Use Cases - Fresh Subagent Per Task: Each task runs in an isolated subagent context with exactly the instructions and context the controller provides, preventing cross-task confusion. - Two-Stage Review Gates: A spec compliance reviewer verifies the code matches requirements before a code quality reviewer assesses maintainability, with fix-and-re-review loops until approval. - Status-Based Escalation Handling: Implementer subagents report DONE, DONE_WITH_CONCERNS, NEEDS_CONTEXT, or BLOCKED, and the controller responds with more context, a more capable model, or task decomposition. - Use Case: Given a written plan with five independent tasks, dispatch an implementer subagent for each task, run spec and quality reviews after each, then finish with a final whole-implementation review before merging the branch. ## Quick Start Use subagent-driven development to execute the implementation plan in docs/superpowers/plans/feature-plan.md task by task.

Frequently Asked Questions about subagent-driven-development

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I execute an implementation plan with subagents?▼

Read the plan once, extract all tasks with full text into a todo list, then dispatch a fresh implementer subagent per task with the complete task text and context. After each task, run a spec compliance review followed by a code quality review before marking it complete.

What is the difference between subagent-driven development and executing plans?▼

Subagent-driven development runs in the same session with a fresh subagent per task and automatic two-stage reviews, enabling faster iteration. Executing plans runs in a parallel session with human-in-the-loop handoffs between tasks.

Why should spec compliance review come before code quality review?▼

Spec compliance confirms the implementation matches requirements exactly, with nothing missing or extra. Reviewing code quality first wastes effort on code that may need rework once spec gaps are found, so quality review only starts after compliance passes.

What should I do when an implementer subagent reports BLOCKED?▼

Assess the blocker: provide more context and re-dispatch if it is a context problem, use a more capable model if it needs more reasoning, break the task into smaller pieces if too large, or escalate to the human if the plan itself is wrong.

Can I dispatch multiple implementer subagents in parallel?▼

No. Dispatching multiple implementation subagents in parallel causes conflicts between their changes. Tasks are executed sequentially, with each task completing both review stages before the next implementer is dispatched.

When should I not use subagent-driven development?▼

Avoid it when tasks are tightly coupled and cannot be delegated independently, when no implementation plan exists yet, or when you prefer a parallel session with human checkpoints, in which case the executing-plans workflow fits better.