subagent-driven-development

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

3|Updated Sep 18, 2025
One-click install
npx skills add https://github.com/KingMichaelPark/dotfiles --skill subagent-driven-development-kingmichaelpark
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: subagent-driven-development
Source: https://github.com/KingMichaelPark/dotfiles/tree/main/ai/.agents/skills/subagent-driven-development
Command: npx skills add https://github.com/KingMichaelPark/dotfiles --skill subagent-driven-development-kingmichaelpark

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, loses progress after compaction, and skips quality gates. This Skill orchestrates plan execution by delegating each task to an isolated subagent with curated context, enforcing review after every task. ## Core Features & Use Cases - Per-task subagent dispatch: Each task gets a fresh implementer subagent with a task brief file, explicit model selection, and a structured report contract (DONE, DONE_WITH_CONCERNS, BLOCKED, NEEDS_CONTEXT). - Two-stage review gates: A task reviewer checks spec compliance and code quality per task, followed by a broad whole-branch review at the end, with fix subagents for Critical and Important findings. - File-based handoffs and durable progress: Scripts generate task briefs and review packages as files, and a progress ledger survives context compaction so completed tasks are never re-dispatched. - Use Case: Given a written implementation plan with eight independent tasks, execute all of them in the current session with automatic per-task reviews and a final whole-branch code review before merge. ## Quick Start Use subagent-driven development to execute the implementation plan at 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 subagents?

Read the plan once, create todos for all tasks, then dispatch a fresh implementer subagent per task using the implementer prompt template. After each task, generate a review package and dispatch a task reviewer before marking the task complete.

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

Subagent-driven development runs in the same session with a fresh subagent per task and continuous execution without human check-ins. Executing plans uses a parallel session with a handoff, which suits tightly coupled tasks or when you want a separate context.

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

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

What happens when an implementer subagent reports BLOCKED?

Assess the blocker before re-dispatching: provide more context for context problems, use 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 retry the same model unchanged.

How does progress survive context compaction?

A progress ledger file at .superpowers/sdd/progress.md records each completed task with its commit range. After compaction, check the ledger and git log before dispatching anything, and resume at the first task not marked complete.

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 run git commands and bash scripts in the working environment.