subagent-driven-development
starsforks
How to install subagent-driven-development?
aaddrick/claude-pipeline/subagent-driven-development
$npx -y skills add aaddrick/claude-pipeline --skill subagent-driven-developmentUse when executing implementation plans with independent tasks in the current session
SKILL.md
| 1 | # Subagent-Driven Development |
| 2 | |
| 3 | Execute plan by dispatching fresh subagent per task, with two-stage review after each: spec compliance review first, then code quality review. |
| 4 | |
| 5 | **Core principle:** Fresh subagent per task + two-stage review (spec then quality) = high quality, fast iteration |
| 6 | |
| 7 | **Headless mode:** When called from implement-issue, run fully autonomously. Answer subagent questions based on plan/issue context. Track all decisions for PR comments. Never prompt user. |
| 8 | |
| 9 | ## When to Use |
| 10 | |
| 11 | ```dot |
| 12 | digraph when_to_use { |
| 13 | "Have implementation plan?" [shape=diamond]; |
| 14 | "Tasks mostly independent?" [shape=diamond]; |
| 15 | "Stay in this session?" [shape=diamond]; |
| 16 | "subagent-driven-development" [shape=box]; |
| 17 | "executing-plans" [shape=box]; |
| 18 | "Manual execution or brainstorm first" [shape=box]; |
| 19 | |
| 20 | "Have implementation plan?" -> "Tasks mostly independent?" [label="yes"]; |
| 21 | "Have implementation plan?" -> "Manual execution or brainstorm first" [label="no"]; |
| 22 | "Tasks mostly independent?" -> "Stay in this session?" [label="yes"]; |
| 23 | "Tasks mostly independent?" -> "Manual execution or brainstorm first" [label="no - tightly coupled"]; |
| 24 | "Stay in this session?" -> "subagent-driven-development" [label="yes"]; |
| 25 | "Stay in this session?" -> "executing-plans" [label="no - parallel session"]; |
| 26 | } |
| 27 | ``` |
| 28 | |
| 29 | **vs. Executing Plans (parallel session):** |
| 30 | - Same session (no context switch) |
| 31 | - Fresh subagent per task (no context pollution) |
| 32 | - Two-stage review after each task: spec compliance first, then code quality |
| 33 | - Faster iteration (no human-in-loop between tasks) |
| 34 | |
| 35 | ## The Process |
| 36 | |
| 37 | **CRITICAL: Track the feature branch name.** Subagents have no memory of branch context. You must include the branch name in every implementer dispatch. |
| 38 | |
| 39 | ```dot |
| 40 | digraph process { |
| 41 | rankdir=TB; |
| 42 | |
| 43 | subgraph cluster_per_task { |
| 44 | label="Per Task"; |
| 45 | "Verify on feature branch" [shape=box style=filled fillcolor=yellow]; |
| 46 | "Dispatch implementer subagent (./implementer-prompt.md)" [shape=box]; |
| 47 | "Implementer subagent asks questions?" [shape=diamond]; |
| 48 | "Answer questions, provide context" [shape=box]; |
| 49 | "Implementer subagent implements, tests, commits, self-reviews" [shape=box]; |
| 50 | "Verify commit on correct branch" [shape=box style=filled fillcolor=yellow]; |
| 51 | "Dispatch spec reviewer subagent (./spec-reviewer-prompt.md)" [shape=box]; |
| 52 | "Spec reviewer subagent confirms code matches spec?" [shape=diamond]; |
| 53 | "Implementer subagent fixes spec gaps" [shape=box]; |
| 54 | "Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md)" [shape=box]; |
| 55 | "Code quality reviewer subagent approves?" [shape=diamond]; |
| 56 | "Implementer subagent fixes quality issues" [shape=box]; |
| 57 | "Mark task complete in TodoWrite" [shape=box]; |
| 58 | } |
| 59 | |
| 60 | "Note feature branch name from plan or git" [shape=box style=filled fillcolor=yellow]; |
| 61 | "Read plan, extract all tasks with full text, note context, create TodoWrite" [shape=box]; |
| 62 | "More tasks remain?" [shape=diamond]; |
| 63 | "Dispatch final code reviewer subagent for entire implementation" [shape=box]; |
| 64 | "Use finishing-a-development-branch" [shape=box style=filled fillcolor=lightgreen]; |
| 65 | |
| 66 | "Read plan, extract all tasks with full text, note context, create TodoWrite" -> "Dispatch implementer subagent (./implementer-prompt.md)"; |
| 67 | "Dispatch implementer subagent (./implementer-prompt.md)" -> "Implementer subagent asks questions?"; |
| 68 | "Implementer subagent asks questions?" -> "Answer questions, provide context" [label="yes"]; |
| 69 | "Answer questions, provide context" -> "Dispatch implementer subagent (./implementer-prompt.md)"; |
| 70 | "Implementer subagent asks questions?" -> "Implementer subagent implements, tests, commits, self-reviews" [label="no"]; |
| 71 | "Implementer subagent implements, tests, commits, self-reviews" -> "Dispatch spec reviewer subagent (./spec-reviewer-prompt.md)"; |
| 72 | "Dispatch spec reviewer subagent (./spec-reviewer-prompt.md)" -> "Spec reviewer subagent confirms code matches spec?"; |
| 73 | "Spec reviewer subagent confirms code matches spec?" -> "Implementer subagent fixes spec gaps" [label="no"]; |
| 74 | "Implementer subagent fixes spec gaps" -> "Dispatch spec reviewer subagent (./spec-reviewer-prompt.md)" [label="re-review"]; |
| 75 | "Spec reviewer subagent confirms code matches spec?" -> "Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md)" [label="yes"]; |
| 76 | "Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md)" -> "Code quality reviewer subagent approves?"; |
| 77 | "Code quality reviewer subagent approves?" -> "Implementer subagent fixes quality issues" [label="no"]; |
| 78 | "Implementer subagent fixes quality issues" -> "Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md)" [label="re-review"]; |
| 79 | "Code quality reviewer subagent app |
People who liked this also viewed
6 picksType
- paperclip-create-agentCreate new agents in Paperclip with governance-aware hiring. Use when you need to inspect adapter configuration options, compare existing agent configs, draft a new agent prompt/config, and submit a hSkillsJul 2026
- subagent-driven-developmentUse when executing implementation plans with independent tasks in the current sessionSkillsJul 2026
- dispatching-parallel-agentsUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesSkillsJul 2026
- browser-act-skill-forgeForges reusable Skill packages (SKILL.md + scripts) from website exploration via browser-act — no re-exploration later. Use when: user wants a reusable Skill for any website, needs to understand a sitSkillsJul 2026
- wizardGenerate an interactive bash wizard that walks a human through a manual procedure — third-party setup, a one-off migration, an A→B state transition — opening URLs, capturing values, confirming each stSkillsJul 2026
- wonda-cliUsing the Wonda CLI to generate images, videos, music, and audio from the terminal — plus LinkedIn, Reddit, and X/Twitter research and automationSkillsJul 2026
