subagent-driven-development

Executes implementation plans by dispatching fresh implementer subagents per task with per-task and final code reviews.

Updated Jul 22, 2026
One-click install
npx skills add https://github.com/johnstegeman/pi-packages --skill subagent-driven-development-johnstegeman
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: subagent-driven-development
Source: https://github.com/johnstegeman/pi-packages/tree/main/packages/pi-superpowers-plus/skills/subagent-driven-development
Command: npx skills add https://github.com/johnstegeman/pi-packages --skill subagent-driven-development-johnstegeman

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Executing a multi-task implementation plan in one session pollutes context and skips quality gates; this Skill orchestrates fresh subagents per task with mandatory reviews so each task is implemented, tested, and verified without context contamination. ## Core Features & Use Cases - Per-task subagent dispatch: Each plan task gets a fresh implementer subagent with only its task bead, relevant interfaces, and global constraints, keeping the controller's context clean for coordination. - Layered review gates: Every task passes a spec-compliance and code-quality review, a bounded five-round fix loop with scoped re-reviews, and a final whole-branch review before completion. - Ledger-based recovery: A per-plan workspace ledger tracks task completions, commits, and fix rounds so work resumes correctly after context compaction. - Use Case: Given an approved implementation plan with several mostly independent tasks, run this Skill to implement each task via subagents, review each diff, and finish with a whole-branch review before merging. ## Quick Start Ask the AI to execute the approved implementation plan using subagent-driven development, dispatching an implementer subagent for each task and reviewing each one before the final whole-branch review.

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?

Dispatch a fresh implementer subagent per task, handing it only its task bead id and relevant context. After each task, generate a review package from the recorded base commit and dispatch a task reviewer before moving to the next task.

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 reviews after each task, while executing-plans runs in a parallel session. Choose subagent-driven development when tasks are mostly independent and you want faster iteration without a human in the loop between tasks.

How does the fix loop work when a task review finds issues?

The loop allows up to five fix rounds per task: rounds 1-3 resume the original implementer, rounds 4-5 dispatch a fresh one. If round 5 still leaves findings open, the controller adjudicates each finding as parked with a ruling or reports the task as blocked.

Can I dispatch multiple implementer subagents in parallel?

No, parallel implementation dispatches are forbidden because they cause conflicts. Wave-parallel execution is only allowed through the SubagentWorkflow script with pairwise-disjoint file sets; otherwise tasks run sequentially.

What happens if the session context is compacted mid-plan?

Progress is tracked in a per-plan ledger file under the git-ignored workspace, not in conversation memory. After compaction, the controller trusts the ledger and git log to resume at the first incomplete task instead of re-dispatching completed work.

When should I not use subagent-driven development?

Avoid it when there is no approved implementation plan, when tasks are tightly coupled and cannot be delegated independently, or when working on the main branch without explicit user consent. In those cases, write a plan first or execute manually.