subagent-driven-development

Executes implementation plans by dispatching fresh subagents per task with two-stage review.

115|9|Updated Aug 5, 2026
One-click install
npx skills add https://github.com/AtlasOmnia/donna-starter --skill subagent-driven-development-atlasomnia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: subagent-driven-development
Source: https://github.com/AtlasOmnia/donna-starter/tree/main/skills/software-development/subagent-driven-development
Command: npx skills add https://github.com/AtlasOmnia/donna-starter --skill subagent-driven-development-atlasomnia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Executing a multi-task implementation plan in a single session causes context pollution, inconsistent quality, and missed spec requirements. This Skill orchestrates plan execution by delegating each task to a fresh subagent and enforcing systematic review between tasks. ## Core Features & Use Cases - Per-Task Subagent Dispatch: Reads the plan once, extracts all tasks into a todo list, and dispatches an implementer subagent per task with full context and TDD instructions via delegate_task. - Two-Stage Review: Runs a spec compliance reviewer first, then a code quality reviewer, looping fixes until both pass before marking a task complete. - Failure Recovery Playbook: Handles subagent timeouts, context compaction, nested background tasks, and partial dirty trees with bounded retry and fresh narrow transactions. - Use Case: Given a plan file like docs/plans/auth-feature.md with five tasks, the controller dispatches implementer and reviewer subagents per task, verifies tests and diffs itself, and finishes with a final integration review and commit. ## Quick Start Ask the agent to execute the implementation plan in docs/plans/feature-plan.md using subagent-driven development with per-task 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?

Read the plan once, extract every task into a todo list, then dispatch a fresh implementer subagent per task using delegate_task with the full task text and TDD instructions. After each implementation, run a spec compliance review and then a code quality review before marking the task complete.

What is the two-stage review process for subagent code?

The first stage checks spec compliance against the original task requirements, and the second stage reviews code quality such as style, error handling, and test coverage. Spec review must pass before quality review starts, and any issues trigger a fix-and-re-review loop.

When should I use subagent-driven development instead of manual implementation?

Use it when you have a written implementation plan with mostly independent tasks and quality matters. Fresh subagents per task avoid context pollution, and automated reviews catch issues early, though it costs more subagent invocations than manual execution.

What should I do when a subagent times out or fails a task?

Inspect the live working tree before redispatching, since timeouts often leave valid partial edits. Preserve good work, resume the session once if useful, and otherwise start a fresh narrower worker with only the remaining invariant rather than restarting blindly.

How granular should tasks be for subagent dispatch?

Each task should represent roughly two to five minutes of focused work, such as creating one model or one endpoint. Large items like implementing an entire authentication system should be split into smaller tasks that can each be tested and reviewed independently.