skill-subagent-driven-development

Executes approved implementation plans through sequential fresh subagents with per-task spec and quality reviews.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/longdang193/project-OS-starter --skill skill-subagent-driven-development-longdang193
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-subagent-driven-development
Source: https://github.com/longdang193/project-OS-starter/tree/main/generated_agents/claude/skills/skill-subagent-driven-development
Command: npx skills add https://github.com/longdang193/project-OS-starter --skill skill-subagent-driven-development-longdang193

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Executing a multi-task implementation plan in one long session pollutes context, lets defects slip through, and loses progress after compaction. This Skill coordinates a lead controller that dispatches a fresh implementer subagent per task, reviews each task for spec compliance and code quality, and keeps durable progress in the plan ledger and Git. ## Core Features & Use Cases - Fresh subagent per task: Dispatch isolated implementer subagents with curated briefs extracted by the task-brief script, so workers never inherit session history. - Two-gate task review: A reviewer subagent returns separate spec-compliance and code-quality verdicts against a scoped diff package generated by the review-package script, with fix-and-re-review loops for Critical and Important findings. - Durable coordination: The lead controller owns plan ledger updates and checkpoint commits, reconciles Git state before dispatch, and runs a final whole-branch review before verification and branch finishing. - Use Case: Given an approved plan with eight tasks, the controller extracts each task brief, dispatches implementers sequentially, reviews each diff, fixes findings, and finishes with one broad whole-branch review. ## Quick Start Use subagent-driven development to execute the approved plan in docs/plans/feature-plan.md task by task with per-task reviews.

Frequently Asked Questions about skill-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 approved plan once, extract each task with the task-brief script, and dispatch a fresh implementer subagent per task. After each task, generate a scoped diff with review-package and dispatch a task reviewer before marking the task complete.

What is the difference between subagent-driven development and executing plans directly?▼

Subagent-driven development gives every task a fresh implementer and reviewer context with automatic review checkpoints in one coordinating session. Direct plan execution suits tightly coupled tasks, handoffs to another session, or work without commit authorization.

When should I use parallel agent dispatch instead of sequential subagents?▼

Use parallel dispatch only when independent lanes can run concurrently with disjoint write ownership. Inside this skill, implementers always run sequentially in one workspace to avoid conflicts.

How do I handle a BLOCKED implementer subagent?▼

Assess the blocker: provide missing context and re-dispatch, escalate to a more capable profile for harder reasoning, split oversized tasks, or reconcile plan drift. Never force the same model to retry without changes.

Why should task briefs and reports be handed off as files instead of pasted text?▼

Pasted content stays resident in the controller's context and is re-read every turn, bloating later dispatches. File handoffs via task-brief, report files, and review packages keep each subagent's context limited to its own task.

What are the limitations of subagent-driven development?▼

It costs more subagent invocations and controller preparation than direct execution, and it requires tasks separable enough for isolated briefs. It must not be used as the top-level topology while plan-bound conditions of satisfaction are active.