subagent-driven-development

Execute implementation plans via fresh subagents per task with mandatory TDD, spec, and quality review gates.

1|Updated Jun 21, 2026
One-click install
npx skills add https://github.com/tapway/shogun-os --skill subagent-driven-development-tapway
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: subagent-driven-development
Source: https://github.com/tapway/shogun-os/tree/main/skills/software-development/subagent-driven-development
Command: npx skills add https://github.com/tapway/shogun-os --skill subagent-driven-development-tapway

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Executing a multi-task implementation plan in a single agent session leads to context pollution, skipped tests, and unchecked spec drift. This Skill orchestrates plan execution by dispatching a fresh subagent per task and enforcing three mandatory review gates so defects are caught before they compound across tasks. ## Core Features & Use Cases - Fresh subagent per task: Each plan task runs in an isolated delegate_task subagent with full task text and project context, preventing accumulated-state confusion. - Three-gate review pipeline: A TDD gate verifies RED-GREEN evidence in the git log, a spec reviewer checks compliance against the original task spec, and a quality reviewer approves code before the task is marked complete. - Failure recovery loops: Failed gates trigger re-dispatch of the implementer with stricter instructions rather than manual patching in the controller session. - Use Case: Given a 5-task authentication feature plan, the orchestrator dispatches implementer subagents task by task, rejects a combined test-plus-code commit at the TDD gate, forces a proper RED-GREEN redo, and finishes with a final integration review and full test suite run. ## Quick Start Execute the implementation plan in docs/plans/auth-feature.md using subagent-driven development with TDD, spec, and quality review gates for every 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 into a todo list, then dispatch a fresh delegate_task subagent per task with the full task text and project context inline. After each implementation, run the TDD gate, spec review, and quality review in that order before marking the task complete.

How does the TDD gate verify test-driven development?

The TDD gate inspects the git log for test commits preceding feat commits as RED-GREEN evidence, runs the full test suite to confirm no regressions, and checks that tests exercise real behavior. A TDD_FAIL verdict invalidates the implementation and triggers a re-dispatch with stricter TDD instructions.

When should I not use subagent-driven development?

Avoid it for single-file fixes, tasks that share files due to conflict risk between parallel subagents, and exploratory prototyping without a written plan. It is designed for decomposed multi-task plans where independent tasks benefit from isolated context and automated review.

What happens when a review gate finds issues?

The implementer subagent or a new fix subagent addresses the specific feedback, then the same reviewer re-runs. The loop repeats until the gate passes, and the workflow never advances to the next task or next gate with open critical or important issues.

Why use a fresh subagent for each task instead of one session?

Fresh subagents prevent context pollution from accumulated state, giving each task clean focused context without confusion from prior tasks' code or reasoning. The trade-off is more subagent invocations, but early issue detection is cheaper than debugging compounded problems later.