subagent-driven-development

Executes implementation plans by dispatching isolated subagents per task with a final whole-branch review.

Updated May 21, 2026
One-click install
npx skills add https://github.com/CagesThrottleUs/private-ai-harness --skill subagent-driven-development-cagesthrottleus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: subagent-driven-development
Source: https://github.com/CagesThrottleUs/private-ai-harness/tree/main/skills/subagent-driven-development
Command: npx skills add https://github.com/CagesThrottleUs/private-ai-harness --skill subagent-driven-development-cagesthrottleus

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Executing a multi-task implementation plan in a single AI session pollutes the context window, loses progress after compaction, and skips verification between tasks. This Skill coordinates plan execution by dispatching a fresh, isolated subagent per task and tracking durable progress on disk. ## Core Features & Use Cases - Per-task subagent dispatch: Each plan task runs in a fresh implementer subagent with a file-based task brief, explicit model selection, and a structured status contract (DONE, DONE_WITH_CONCERNS, BLOCKED, NEEDS_CONTEXT). - Durable progress ledger: A git-ignored per-plan workspace (.ai/sdd/<plan>/) stores briefs, reports, review packages, and a progress ledger so sessions resume correctly after compaction. - Final whole-branch review: After all tasks complete, a reviewer subagent audits the full commit range, with one fix wave and one scoped re-review. - Use Case: Given a 12-task implementation plan, the controller extracts each task brief with scripts/task-brief, dispatches implementers sequentially, records completions in the ledger, and finishes with a whole-branch code review before merge. ## Quick Start Use the subagent-driven-development skill to execute the implementation plan at .ai/plans/feature-plan.md task by 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 AI subagents?

Dispatch one fresh implementer subagent per task using a file-based task brief extracted by scripts/task-brief, then mark completion in a progress ledger. After all tasks finish, dispatch a final whole-branch code reviewer over the full commit range.

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

Subagent-driven development stays in the current session, dispatching fresh subagents per task with no context pollution and no human check-ins between tasks. The executing-plans alternative runs in a separate parallel session with human-in-the-loop checkpoints.

How does the progress ledger survive context compaction?

The ledger lives in a git-ignored per-plan workspace at .ai/sdd/<plan>/progress.md, recording each completed task with its commit range. After compaction, the controller trusts the ledger and git log instead of conversation memory to resume at the first incomplete task.

Which model should I use when dispatching implementer subagents?

Always specify the model explicitly: cheap models for mechanical single-file tasks with complete specs, standard models for multi-file integration work, and the most capable model for architecture and the final whole-branch review. Omitting the model silently inherits the session's most expensive one.

When should tasks not be batched into one subagent dispatch?

Never batch tightly coupled or judgment-heavy tasks. Batching is only safe when consecutive tasks share the same shape, each is independently a cheap-model task, none depends on another's output, and their plan Interfaces blocks do not collide.

What happens when an implementer subagent reports BLOCKED?

Assess the blocker: provide more context and re-dispatch for context problems, re-dispatch with a more capable model for reasoning-heavy tasks, split oversized tasks, or escalate to the human if the plan itself is wrong. Never force the same model to retry unchanged.