MR
Mayur Rathi
@mayurrathi
⭐ 5 GitHub stars

Subagent Driven Development

Use when executing implementation plans with independent tasks in the current session

mkdir -p ./skills/subagent-driven-development && curl -sfL https://raw.githubusercontent.com/mayurrathi/awesome-agent-skills/main/skills/subagent-driven-development/SKILL.md -o ./skills/subagent-driven-development/SKILL.md

Run in terminal / PowerShell. Requires curl (Unix) or PowerShell 5+ (Windows).

Skill Content

# Subagent-Driven Development


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


When to Use


```dot

digraph when_to_use {

"Have implementation plan?" [shape=diamond];

"Tasks mostly independent?" [shape=diamond];

"Stay in this session?" [shape=diamond];

"subagent-driven-development" [shape=box];

"executing-plans" [shape=box];

"Manual execution or brainstorm first" [shape=box];


"Have implementation plan?" -> "Tasks mostly independent?" [label="yes"];

"Have implementation plan?" -> "Manual execution or brainstorm first" [label="no"];

"Tasks mostly independent?" -> "Stay in this session?" [label="yes"];

"Tasks mostly independent?" -> "Manual execution or brainstorm first" [label="no - tightly coupled"];

"Stay in this session?" -> "subagent-driven-development" [label="yes"];

"Stay in this session?" -> "executing-plans" [label="no - parallel session"];

}

```


**vs. Executing Plans (parallel session):**

- Same session (no context switch)

- Fresh subagent per task (no context pollution)

- Two-stage review after each task: spec compliance first, then code quality

- Faster iteration (no human-in-loop between tasks)


The Process


```dot

digraph process {

rankdir=TB;


subgraph cluster_per_task {

label="Per Task";

"Dispatch implementer subagent (./implementer-prompt.md)" [shape=box];

"Implementer subagent asks questions?" [shape=diamond];

"Answer questions, provide context" [shape=box];

"Implementer subagent implements, tests, commits, self-reviews" [shape=box];

"Dispatch spec reviewer subagent (./spec-reviewer-prompt.md)" [shape=box];

"Spec reviewer subagent confirms code matches spec?" [shape=diamond];

"Implementer subagent fixes spec gaps" [shape=box];

"Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md)" [shape=box];

"Code quality reviewer subagent approves?" [shape=diamond];

"Implementer subagent fixes quality issues" [shape=box];

"Mark task complete in TodoWrite" [shape=box];

}


"Read plan, extract all tasks with full text, note context, create TodoWrite" [shape=box];

"More tasks remain?" [shape=diamond];

"Dispatch final code reviewer subagent for entire implementation" [shape=box];

"Use superpowers:finishing-a-development-branch" [shape=box style=filled fillcolor=lightgreen];


"Read plan, extract all tasks with full text, note context, create TodoWrite" -> "Dispatch implementer subagent (./implementer-prompt.md)";

"Dispatch implementer subagent (./implementer-prompt.md)" -> "Implementer subagent asks questions?";

"Implementer subagent asks questions?" -> "Answer questions, provide context" [label="yes"];

"Answer questions, provide context" -> "Dispatch implementer subagent (./implementer-prompt.md)";

"Implementer subagent asks questions?" -> "Implementer subagent implements, tests, commits, self-reviews" [label="no"];

"Implementer subagent implements, tests, commits, self-reviews" -> "Dispatch spec reviewer subagent (./spec-reviewer-prompt.md)";

"Dispatch spec reviewer subagent (./spec-reviewer-prompt.md)" -> "Spec reviewer subagent confirms code matches spec?";

"Spec reviewer subagent confirms code matches spec?" -> "Implementer subagent fixes spec gaps" [label="no"];

"Implementer subagent fixes spec gaps" -> "Dispatch spec reviewer subagent (./spec-reviewer-prompt.md)" [label="re-review"];

"Spec reviewer subagent confirms code matches spec?" -> "Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md)" [label="yes"];

"Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md)" -> "Code quality reviewer subagent approves?";

"Code quality review

🎯 Best For

  • Claude users
  • Software engineers
  • Development teams
  • Tech leads

💡 Use Cases

  • Code quality improvement
  • Best practice enforcement

📖 How to Use This Skill

  1. 1

    Install the Skill

    Copy the install command from the Terminal tab and run it. The SKILL.md file downloads to your local skills directory.

  2. 2

    Load into Your AI Assistant

    Open Claude and reference the skill. Paste the SKILL.md content or use the system prompt tab.

  3. 3

    Apply Subagent Driven Development to Your Work

    Open your project in the AI assistant and ask it to apply the skill. Start with a small module to verify the output quality.

  4. 4

    Review and Refine

    Review AI suggestions before committing. Run tests, check for regressions, and iterate on the skill output.

❓ Frequently Asked Questions

Is Subagent Driven Development compatible with Cursor and VS Code?

Yes — this skill works with any AI coding assistant including Cursor, VS Code with Copilot, and JetBrains IDEs.

Do I need specific dependencies for Subagent Driven Development?

Check the install command and Works With section. Most code skills only require the AI assistant and your codebase.

How do I install Subagent Driven Development?

Copy the install command from the Terminal tab and run it. The skill downloads to ./skills/subagent-driven-development/SKILL.md, ready to use.

Can I customize this skill for my team?

Absolutely. Edit the SKILL.md file to add team-specific instructions, examples, or workflows.

⚠️ Common Mistakes to Avoid

Skipping validation

Always test AI-generated code changes, even for simple refactors.

Missing dependency updates

Check if the skill requires updated dependencies or new packages.

🔗 Related Skills