subagent-driven-development

Executes implementation plans by dispatching fresh implementer and reviewer subagents per task.

Updated Sep 16, 2022
One-click install
npx skills add https://github.com/ryuya-matsunawa/dotfiles --skill subagent-driven-development-ryuya-matsunawa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: subagent-driven-development
Source: https://github.com/ryuya-matsunawa/dotfiles/tree/main/agents/.agents/skills/subagent-driven-development
Command: npx skills add https://github.com/ryuya-matsunawa/dotfiles --skill subagent-driven-development-ryuya-matsunawa

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Executing a multi-task implementation plan in one session pollutes context, skips review gates, and loses progress after compaction. This Skill orchestrates plan execution by delegating each task to an isolated subagent with curated context, enforcing spec-compliance and code-quality reviews after every task. ## Core Features & Use Cases - Per-task subagent dispatch: Each task gets a fresh implementer subagent with a file-based task brief, followed by a task reviewer subagent that returns spec compliance and code quality verdicts. - File-based handoffs: Bundled scripts generate task briefs and review packages (commit list, diff stat, full diff) as files so bulk artifacts never enter the controller's context. - Durable progress ledger: A git-stored ledger tracks completed tasks so work resumes correctly after context compaction, plus model-selection guidance to match subagent cost to task complexity. - Use Case: Given a written implementation plan with eight independent tasks, execute all of them in the current session with automatic review loops, fix dispatches, and a final whole-branch review before merge. ## Quick Start Use subagent-driven development to execute the implementation plan in docs/plans/feature-plan.md task by task with reviews.

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 AI subagents?▼

Dispatch a fresh implementer subagent per task with a file-based task brief, then dispatch a task reviewer subagent against the generated diff package. After all tasks pass review, run a final whole-branch review before merging.

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, gives each task a fresh subagent, and iterates faster without human-in-the-loop between tasks. Parallel-session plan execution hands off the whole plan to a separate session instead.

How do I choose which model to use for each subagent?▼

Match model capability to task complexity: cheap models for mechanical single-file tasks with complete specs, standard models for multi-file integration, and the most capable model for architecture work and the final whole-branch review. Always specify the model explicitly when dispatching.

What happens when an implementer subagent reports BLOCKED status?▼

Assess the blocker before retrying: provide missing context and re-dispatch, escalate to a more capable model for reasoning-heavy tasks, break oversized tasks into smaller pieces, or escalate to the human if the plan itself is wrong. Never force the same model to retry unchanged.

How does progress survive context compaction during long plan execution?▼

A progress ledger stored in the git directory records each completed task with its commit range. After compaction, the controller reads the ledger and git log to resume at the first incomplete task instead of re-dispatching finished work.

When should I not use subagent-driven development?▼

Avoid it when tasks are tightly coupled and cannot be implemented independently, when no written implementation plan exists yet, or when you cannot stay in the current session. Brainstorm or write the plan first in those cases.