--- name: subagent-driven-development-33a23679d7a7 description: Execute implementation plan by dispatching fresh subagent for each task, with code review between tasks when_to_use: when executing implementation plans with independent tasks in the current session, using fresh subagents with review gates version: 1.1.0 --- # Subagent-Driven Development Execute plan by dispatching fresh subagent per task, with code review after each. **Core principle:** Fresh subagent per task + review between tasks = high quality, fast iteration ## Overview **vs. Executing Plans (parallel session):** - Same session (no context switch) - Fresh subagent per task (no context pollution) - Code review after each task (catch issues early) - Faster iteration (no human-in-loop between tasks) **When to use:** - Staying in this session - Tasks are mostly independent - Want continuous progress with quality gates **When NOT to use:** - Need to review plan first (use executing-plans) - Tasks are tightly coupled (manual execution better) - Plan needs revision (brainstorm first) ## The Process ### 1. Load Plan Read plan file, create TodoWrite with all tasks. ### 2. Execute Task with Subagent For each task: **Dispatch fresh subagent:** ``` Task tool (general-purpose): description: "Implement Task N: [task name]" prompt: | You are implementing Task N from [plan-file]. Read that task carefully. Your job is to: 1. Implement exactly what the task specifies 2. Write tests (following TDD if task says to) 3. Verify implementation works 4. Commit your work 5. Report back Work from: [directory] Report: What you implemented, what you tested, test results, files changed, any issues ``` **Subagent reports back** with summary of work. ### 3. Review Subagent's Work **Dispatch code-reviewer subagent:** ``` Task tool (code-reviewer): Use template at skills/collaboration/requesting-code-review/code-reviewer.md WHAT_WAS_IMPLEMENTED: [from subagent's report] PLAN_OR_REQUIREMENTS: Task N from [plan-file] BASE_SHA: [commit before task] HEAD_SHA: [current commit] DESCRIPTION: [task summary] ``` **Code reviewer returns:** Strengths, Issues (Critical/Important/Minor), Assessment ### 4. Apply Review Feedback **If issues found:** - Fix Critical issues immediately - Fix Important issues before next task - Note Minor issues **Dispatch follow-up subagent if needed:** ``` "Fix issues from code review: [list issues]" ``` ### 5. Mark Complete, Next Task - Mark task as completed in TodoWrite - Move to next task - Repeat steps 2-5 ### 6. Final Review After all tasks complete, dispatch final code-reviewer: - Reviews entire implementation - Checks all plan requirements met - Validates overall architecture ### 7. Complete Development After final review passes: - Announce: "I'm using the Finishing a Development Branch skill to complete this work." - Switch to skills/collaboration/finishing-a-development-branch - Follow that skill to verify tests, present options, execute choice ## Example Workflow ``` You: I'm using Subagent-Driven Development to execute this plan. [Load plan, create TodoWrite] Task 1: Hook installation script [Dispatch implementation subagent] Subagent: Implemented install-hook with tests, 5/5 passing [Get git SHAs, dispatch code-reviewer] Reviewer: Strengths: Good test coverage. Issues: None. Ready. [Mark Task 1 complete] Task 2: Recovery modes [Dispatch implementation subagent] Subagent: Added verify/repair, 8/8 tests passing [Dispatch code-reviewer] Reviewer: Strengths: Solid. Issues (Important): Missing progress reporting [Dispatch fix subagent] Fix subagent: Added progress every 100 conversations [Verify fix, mark Task 2 complete] ... [After all tasks] [Dispatch final code-reviewer] Final reviewer: All requirements met, ready to merge Done! ``` ## Advantages **vs. Manual execution:** - Subagents follow TDD naturally - Fresh context per task (no confusion) - Parallel-safe (subagents don't interfere) **vs. Executing Plans:** - Same session (no handoff) - Continuous progress (no waiting) - Review checkpoints automatic **Cost:** - More subagent invocations - But catches issues early (cheaper than debugging later) ## Red Flags **Never:** - Skip code review between tasks - Proceed with unfixed Critical issues - Dispatch multiple implementation subagents in parallel (conflicts) - Implement without reading plan task **If subagent fails task:** - Dispatch fix subagent with specific instructions - Don't try to fix manually (context pollution) ## Integration **Pairs with:** - skills/collaboration/writing-plans (creates the plan) - skills/collaboration/requesting-code-review (review template) - skills/testing/test-driven-development (subagents follow this) **Alternative to:** - skills/collaboration/executing-plans (parallel session) See code-reviewer template: skills/collaboration/requesting-code-review/code-reviewer.md --- Source attribution: BbgnsurfTech Original project: https://github.com/BbgnsurfTech/claude-skills-collection/blob/01d3fafeca1133f841956b8b90b939fee92d71e7/community/superpowers-skills/skills/collaboration/subagent-driven-development/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice MIT License Copyright (c) 2025 Jesse Vincent Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Mega AI Hub resource metadata Creator / publisher: BbgnsurfTech Original project: https://github.com/BbgnsurfTech/claude-skills-collection/blob/01d3fafeca1133f841956b8b90b939fee92d71e7/community/superpowers-skills/skills/collaboration/subagent-driven-development/SKILL.md Attribution basis: Source repository record Fields of work: Product Management, Project & Program Management, Sales Roles: Growth Product Manager, Product Manager, Project Manager, Sales Development Rep (SDR), Technical Product Manager Specialties: API Tools: Todowrite Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: a0846ed0c55503b1681c7ef26c1ddab134bc88cfa9e959ecb788f3f71e66878f