subagent-driven-development

Executes implementation plans by dispatching fresh subagents per task with unified spec and quality reviews.

1|Updated Feb 10, 2026
One-click install
npx skills add https://github.com/stefanfaur/roach-marketplace --skill subagent-driven-development-stefanfaur
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: subagent-driven-development
Source: https://github.com/stefanfaur/roach-marketplace/tree/main/roach/skills/subagent-driven-development
Command: npx skills add https://github.com/stefanfaur/roach-marketplace --skill subagent-driven-development-stefanfaur

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Executing a multi-task implementation plan in one session often pollutes context, skips review, and lets errors compound across tasks. This Skill orchestrates plan execution by giving each task an isolated subagent, a combined spec-compliance and code-quality review, and a final whole-implementation review. ## Core Features & Use Cases - Fresh subagent per task: Each task gets an implementer subagent with a scoped brief written to thoughts/.sdd/, never the whole plan or session history. - Unified per-task review: One reviewer returns both a spec-compliance verdict and a code-quality verdict, with fix-and-re-review loops for Critical/Important findings. - Model selection and file handoffs: Explicit per-dispatch model tiers by task complexity, and bulk artifacts (briefs, reports, diffs) move as files to preserve controller context. - Use Case: Given a written plan with five independent tasks, the controller dispatches implementers sequentially, reviews each diff, syncs a .tasks.json ledger for crash recovery, and finishes with a typed final code review. ## Quick Start Use subagent-driven development to execute the implementation plan at thoughts/shared/plans/my-domain/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, create a task per item, then dispatch a fresh implementer subagent per task with a scoped brief file. After each task, write the diff to a review file and dispatch a unified reviewer before marking the task 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 review checkpoints. Executing plans runs in a parallel session with human-in-the-loop handoffs between tasks.

How do I choose which model for each subagent task?▼

Always specify the model explicitly when dispatching. Use cheap models for mechanical single-file tasks with complete specs, standard models for multi-file integration, and the most capable model for architecture and final review work.

What happens when an implementer subagent gets blocked?▼

A BLOCKED status means the controller must change something before retrying: provide missing context, re-dispatch with a more capable model, split the task, or escalate plan errors to the human. Never force the same model to retry unchanged.

How does task progress survive context compaction?▼

The .tasks.json ledger co-located with the plan records each completed task's status and commit range. On resume, reconcile it against git log and never re-dispatch tasks already marked completed.

When should I not use subagent-driven development?▼

Avoid it when tasks are tightly coupled and cannot be delegated independently, when no written implementation plan exists, or when a parallel-session workflow with human review between tasks is preferred.