subagent-driven-development

Subagent-Driven Development

This skill activates when executing implementation plans, handling multi-task work, or when parallel execution would be beneficial. Triggers on phrases like "implement the plan", "execute tasks", "dispatch agents", or when more than 3 independent tasks exist.

---

Core Concept

Execute implementation plans by dispatching independent subagents for each task, with mandatory two-stage reviews: spec compliance first, then code quality.

Fresh agent per task + BOS-aware reviews = high quality, fast iteration

---

When to Use

Apply this approach when you have:

• A completed implementation plan (see: writing-plans skill)
• Tasks that are mostly independent
• Intent to work in parallel within one session

Decision Tree:

Have an implementation plan?
├── No  → Use writing-plans skill first
└── Yes → Are tasks independent?
    ├── No  → Execute sequentially
    └── Yes → Use subagent-driven development ✓

---

Process Flow

1. Preparation

Extract all tasks from plan into a tracking list:

## Task List

- [ ] Task 1: Create component skeleton
- [ ] Task 2: Implement core logic
- [ ] Task 3: Add styling with BOS tokens
- [ ] Task 4: Write integration tests

2. Per-Task Cycle

For each task:

┌─────────────────────────────────────────────────────────────────┐
│  DISPATCH IMPLEMENTER                                           │
│  → Use implementer-prompt with full task context                │
│  → Include BOS design system requirements                       │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│  ANSWER QUESTIONS                                               │
│  → Clarify requirements before work begins                      │
│  → Provide BOS pattern references if needed                     │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│  SPEC COMPLIANCE REVIEW                                         │
│  → Did they build exactly what was requested?                   │
│  → Missing requirements? Extra features?                        │
│  → BOS tokens used correctly?                                   │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│  CODE QUALITY REVIEW                                            │
│  → Clean, tested, maintainable?                                 │
│  → React Aria patterns followed?                                │
│  → Design system compliance verified?                           │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│  ITERATE IF ISSUES                                              │
│  → Fix flagged issues                                           │
│  → Re-review until approved                                     │
└─────────────────────────────────────────────────────────────────┘
                              ↓
           Mark task complete, proceed to next