executing-plans
executing-plans
Use when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available
goGo phase. Reads the approved SPEC file, maps Requirements to tasks (plan), executes via TDD (build), and integrates results verifying all Acceptance Criteria.
Independent GitHub snapshot · Automated classification · Original documentation governs
CRITICAL: Run HARNESS_DIR=$(epic-harness path) first. NEVER use .harness/ in the project directory.
This skill has 3 internal modes that run sequentially:
Decompose the spec into an execution plan.
Load the spec:
ls -t $HARNESS_DIR/specs/SPEC-*.md | head -1
Read the file. Confirm frontmatter has status: approved. If not, invoke the spec skill first.
Survey the codebase: Identify relevant files, modules, patterns for each requirement.
Decompose: Map each Requirement → one or more Tasks. Every task must reference its source requirement:
Task 1: [description] — satisfies: R1 — depends on: none — modifies: [file list]
Task 2: [description] — satisfies: R2 — depends on: Task 1 — modifies: [file list]
Task 3: [description] — satisfies: R1,R2 (integration) — depends on: Task 1,2 — modifies: [file list]
Conflict analysis:
Show the plan. Get user confirmation (or auto-proceed if in /orbit).
Identify risks: For each task, list potential failure modes:
### Risks
- {risk}: {mitigation}
Create feature branch (standalone invocation only — /orbit handles this in Step 3):
git checkout -b feature/{goal_slug}
- Batch 1 (parallel): Task 1, Task 3
- Batch 2 (sequential): Task 2
For each task, follow this TDD cycle:
Launch sub-agents with these rules:
run_in_background: true for independent tasks (parallel execution)isolation: "worktree" if and only if parallel tasks modify overlapping files| Scenario | Parallel? | Same Files? | Isolation? |
|---|---|---|---|
| Task A, B sequential | No | Any | No |
| Task A, B parallel | Yes | No overlap | No |
| Task A, B parallel | Yes | Overlap exists | Yes |
| State | Meaning | Follow-up |
|---|---|---|
| DONE | Task completed, all tests pass | Proceed |
| DONE_WITH_CONCERNS | Completed but has warnings | Review. Escalate security/data/breaking issues. |
| NEEDS_CONTEXT | Cannot proceed without user input | Prompt user with specific questions |
| BLOCKED | Unresolvable error | Try one alternative. If still blocked, report. |
If stuck 3+ times → invoke agent-introspection skill.
## Status: [DONE|DONE_WITH_CONCERNS|NEEDS_CONTEXT|BLOCKED]
## Summary: [1-2 sentences]
## Evidence: [test output, file changes]
## Concerns: [only for DONE_WITH_CONCERNS]
## Questions: [only for NEEDS_CONTEXT]
## Blocker: [only for BLOCKED]
After all tasks complete:
## Go Report
- Spec: SPEC-{timestamp} ({goal_slug})
- Branch: {branch}
- Requirements satisfied: R1 ✅, R2 ✅, ...
- AC verified: AC1 ✅, AC2 ✅, ...
- Tests: X/Y passing
- Subagent states: X DONE, Y CONCERNS, Z BLOCKED
- Remaining issues: none / [list]
Tell the user: "Build complete. Run /audit to verify before shipping."
| Excuse | Rebuttal | What to do instead |
|---|---|---|
| "I'll just implement it all in one go" | No plan = no accountability | Plan tasks, map to requirements |
| "Tests slow me down" | Debugging takes longer than testing | Write test first, always |
| "I'll skip the plan, it's obvious" | "Obvious" hides assumptions | Plan even for simple changes |
| "I can modify files outside my task" | Scope creep introduces bugs | Stay within task boundaries |
status: approved spec