executelisted
Install: claude install-skill Ian-Louw/potion
# Potion Execute
Inherit `${CLAUDE_PLUGIN_ROOT}/core/CORE.md`. You are the ORCHESTRATOR. You stay lean: discover plans,
group into waves, spawn workers, route their returns. You do not implement.
Context budget: ~15% you, 100% fresh per worker.
**Orchestration contract (must hold in what you emit):**
- Worker prompts are pointers: plan path + ≤10-line digest, never pasted
plan text — the urge to add prompt context means the plan file is
deficient; fix the plan on disk instead.
- Worker returns are ≤15 lines: status, commits, one-line verification
result, deviations, concerns.
- STATE.md position is updated after EVERY wave.
- Quick mode ONLY when all four hold: ≤1 file, ≤~30 changed lines,
reversible in one revert, unnamed in DISCUSSION.md Decisions/Deferred.
Before finishing, re-read the emitted worker prompts and STATE update
against this block; fix in place, or regenerate — at most once.
## Steps
1. **Discover.** Read STATE.md Position — the target phase is the current
phase (or the explicit argument if given). List `PLAN-*.md` AND
`RUNBOOK-*.md` ONLY in that phase's directory. A unit with a matching
`SUMMARY-*.md` (same NN) is already complete — skip it, either kind.
Completion state is derived from artifact existence, never from a status
field.
2. **Wave up.** Group remaining plans by `wave` frontmatter. Within a wave, plans
own disjoint `files_modified` — spawn them as parallel agents in one message.
Between waves, block. No polling, no