subagent-driven-development

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

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/SleyiW/iWana-neXt --skill subagent-driven-development-sleyiw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: subagent-driven-development
Source: https://github.com/SleyiW/iWana-neXt/tree/main/.agents/skills/subagent-driven-development
Command: npx skills add https://github.com/SleyiW/iWana-neXt --skill subagent-driven-development-sleyiw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Executing a multi-task implementation plan in a single session often leads to context pollution, skipped reviews, and inconsistent quality. This Skill orchestrates plan execution by dispatching a fresh subagent for each task and enforcing a two-stage review (spec compliance, then code quality) after every task. ## Core Features & Use Cases - Fresh Subagent Per Task: Each task runs in an isolated subagent context with curated instructions, preventing context pollution and preserving the controller's context for coordination. - Two-Stage Review Gates: A spec compliance reviewer verifies the code matches requirements before a code quality reviewer assesses maintainability, with fix-and-re-review loops until approval. - Status Handling & Model Selection: Handles DONE, DONE_WITH_CONCERNS, NEEDS_CONTEXT, and BLOCKED statuses, and assigns cheaper models to mechanical tasks and capable models to design and review work. - Use Case: Given a written plan with five independent tasks, execute all of them continuously in the current session, with each task implemented, tested, spec-reviewed, and quality-reviewed before a final whole-implementation review. ## Quick Start Use subagent-driven development to execute the implementation plan in docs/plans/feature-plan.md task by task with reviews after each 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, extract all tasks with full text into a todo list, then dispatch a fresh implementer subagent per task with the complete task text and context. After each task, run a spec compliance review followed by a code quality review before marking it complete.

What is the difference between subagent-driven development and executing plans in a parallel session?

Subagent-driven development stays in the same session with no context switch, uses a fresh subagent per task, and iterates faster without human-in-the-loop between tasks. Executing plans in a parallel session involves a handoff to a separate session.

When should I not use subagent-driven development?

Avoid it when there is no implementation plan yet, when tasks are tightly coupled and cannot be delegated independently, or when you need a parallel session instead of same-session execution. In those cases, brainstorm or write a plan first.

How do I handle a BLOCKED subagent during task implementation?

Assess the blocker: provide more context and re-dispatch if it is a context problem, use a more capable model if it needs more reasoning, break the task into smaller pieces if too large, or escalate to the human if the plan itself is wrong. Never force the same model to retry unchanged.

Why must spec compliance review come before code quality review?

Spec compliance confirms the implementer built exactly what was requested, nothing missing or extra. Reviewing code quality first wastes effort on code that may need rework to meet the spec, so quality review only starts after spec compliance passes.

Which model should I use for implementer versus reviewer subagents?

Use a fast, cheap model for mechanical tasks touching one or two files with a complete spec, a standard model for multi-file integration work, and the most capable model for architecture, design, and review tasks.