138 lines
3.9 KiB
Markdown
138 lines
3.9 KiB
Markdown
---
|
|
name: executing-plans
|
|
description: Use when partner provides a complete implementation plan to execute in controlled batches with review checkpoints - loads plan, reviews critically, executes tasks in batches, reports for review between batches
|
|
---
|
|
|
|
# Executing Plans
|
|
|
|
## Overview
|
|
|
|
Load plan, review critically, execute tasks in batches, report for review between batches.
|
|
|
|
**Core principle:** Batch execution with checkpoints for architect review.
|
|
|
|
**Announce at start:** "I'm using the executing-plans skill to implement this plan."
|
|
|
|
## Execution Strategy
|
|
|
|
This skill checks for decomposition and chooses execution method:
|
|
|
|
### Detection
|
|
|
|
Check for manifest file before choosing execution:
|
|
|
|
```bash
|
|
if [[ -f "docs/plans/tasks/YYYY-MM-DD-<feature>/manifest.json" ]]; then
|
|
# Manifest exists → Use parallel execution
|
|
EXECUTION_MODE="parallel"
|
|
else
|
|
# No manifest → Use sequential execution
|
|
EXECUTION_MODE="sequential"
|
|
fi
|
|
```
|
|
|
|
### Parallel Execution (manifest exists)
|
|
|
|
**When:** `manifest.json` found in tasks directory
|
|
|
|
**Process:**
|
|
1. Load plan manifest from `docs/plans/tasks/YYYY-MM-DD-<feature>/manifest.json`
|
|
2. Invoke `parallel-subagent-driven-development` skill with manifest
|
|
3. Execute tasks in parallel batches (up to 2 concurrent subagents)
|
|
4. Code review gate after each batch
|
|
5. Continue until all tasks complete
|
|
|
|
**Benefits:**
|
|
- Up to 2 tasks run concurrently per batch
|
|
- ~40% faster for parallelizable plans
|
|
- 90% context reduction per task
|
|
|
|
### Sequential Execution (no manifest)
|
|
|
|
**When:** No `manifest.json` found
|
|
|
|
**Process:**
|
|
1. Load monolithic plan from `docs/plans/YYYY-MM-DD-<feature>.md`
|
|
2. Invoke `subagent-driven-development` skill
|
|
3. Execute tasks sequentially (one at a time)
|
|
4. Code review gate after each task
|
|
5. Continue until all tasks complete
|
|
|
|
**Use case:**
|
|
- Simple plans (1-3 tasks)
|
|
- Sequential work that can't parallelize
|
|
- Prefer simplicity over speed
|
|
|
|
### CRITICAL Constraint
|
|
|
|
⚠️ **Cannot use parallel-subagent-driven-development without manifest.json**
|
|
|
|
If manifest does not exist → MUST use sequential mode (subagent-driven-development)
|
|
|
|
### Recommendation
|
|
|
|
Always decompose plans with 4+ tasks to enable parallel execution.
|
|
Run `/cc:parse-plan` to create manifest before execution.
|
|
|
|
## The Process
|
|
|
|
### Step 1: Load and Review Plan
|
|
1. Read plan file
|
|
2. Review critically - identify any questions or concerns about the plan
|
|
3. If concerns: Raise them with your human partner before starting
|
|
4. If no concerns: Create TodoWrite and proceed
|
|
|
|
### Step 2: Execute Batch
|
|
**Default: First 3 tasks**
|
|
|
|
For each task:
|
|
1. Mark as in_progress
|
|
2. Follow each step exactly (plan has bite-sized steps)
|
|
3. Run verifications as specified
|
|
4. Mark as completed
|
|
|
|
### Step 3: Report
|
|
When batch complete:
|
|
- Show what was implemented
|
|
- Show verification output
|
|
- Say: "Ready for feedback."
|
|
|
|
### Step 4: Continue
|
|
Based on feedback:
|
|
- Apply changes if needed
|
|
- Execute next batch
|
|
- Repeat until complete
|
|
|
|
### Step 5: Complete Development
|
|
|
|
After all tasks complete and verified:
|
|
- Announce: "I'm using the finishing-a-development-branch skill to complete this work."
|
|
- **REQUIRED SUB-SKILL:** Use superpowers:finishing-a-development-branch
|
|
- Follow that skill to verify tests, present options, execute choice
|
|
|
|
## When to Stop and Ask for Help
|
|
|
|
**STOP executing immediately when:**
|
|
- Hit a blocker mid-batch (missing dependency, test fails, instruction unclear)
|
|
- Plan has critical gaps preventing starting
|
|
- You don't understand an instruction
|
|
- Verification fails repeatedly
|
|
|
|
**Ask for clarification rather than guessing.**
|
|
|
|
## When to Revisit Earlier Steps
|
|
|
|
**Return to Review (Step 1) when:**
|
|
- Partner updates the plan based on your feedback
|
|
- Fundamental approach needs rethinking
|
|
|
|
**Don't force through blockers** - stop and ask.
|
|
|
|
## Remember
|
|
- Review plan critically first
|
|
- Follow plan steps exactly
|
|
- Don't skip verifications
|
|
- Reference skills when plan says to
|
|
- Between batches: just report and wait
|
|
- Stop when blocked, don't guess
|