JordanGunn/nunchuck / skills/plan/plan-exec
plan-exec
VerifiedExecute tasks in the active plan under `.plan/active/`. Writes concrete Output and Handoff for each task and archives the plan once terminal.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 820 B |
| assets/plan-archive-receipt-schema.json | config | 1.1 KB |
| assets/plan-root-schema.json | config | 1.8 KB |
| assets/plan-subplan-schema.json | config | 1.4 KB |
| assets/plan-task-schema.json | config | 3.0 KB |
| references/00_ROUTER.md | markdown | 528 B |
| references/01_SUMMARY.md | markdown | 476 B |
| references/02_TRIGGERS.md | markdown | 543 B |
| references/03_ALWAYS.md | markdown | 393 B |
| references/04_NEVER.md | markdown | 268 B |
| references/05_PROCEDURE.md | markdown | 989 B |
| references/06_FAILURES.md | markdown | 506 B |
| references/07_INSTRUCTIONS.md | markdown | 1.4 KB |
| references/08_PROCEDURE.md | markdown | 185 B |
| references/09_PROCEDURE.md | markdown | 1.8 KB |
| scripts/include/plan_exec_cli.py | script | 2.8 KB |
| scripts/include/plan_exec_parse.py | script | 15.1 KB |
| scripts/skill.ps1 | script | 1.7 KB |
| scripts/skill.shexecutable | script | 1.5 KB |
references/09_PROCEDURE.md
View on GitHub---
description: Reference file for Procedure.
index:
- Section Ownership
- Step 1: Find Active Task
- Step 2: Load and Validate
- Step 3: Execute
- Step 4: Advance
- Step 5: Wrap-up
---
# Procedure
## Section Ownership
`plan-exec` populates **Output** and **Handoff** only.
Focus, Inputs, and Work come from `plan-create`. If these contain placeholders, halt and notify the user.
## Step 1: Find Active Task
```bash
./skill.sh
```
This deterministically selects/ensures the single `in_progress` task.
## Step 2: Load and Validate
Read:
- Root: `.plan/active/plan.md`
- Sub-plan: `.plan/active/<letter>/index.md`
- Active: `.plan/active/<letter>/<roman>.md`
Verify Work section has actionable steps (not placeholders).
## Step 3: Execute
### Update Status
If a task is not already `in_progress`, `plan-exec` will select and set the next pending task to `in_progress`.
### Perform the Work
**This is the critical step.** For each item in Work:
1. Read the instruction
2. **Do it** — write code, create files, run commands
3. Verify the result exists on disk
### Record Output
Write concrete results:
```markdown
## Output
- Created `src/utils/parser.py` (47 lines)
- Updated `config.yaml` with new endpoint
- Ran tests: 12 passed, 0 failed
```
**Bad Output (failure mode):**
```markdown
## Output
Would create a parser module that handles...
```
### Write Handoff
Provide explicit next step for the following task.
### Update Status
Set `status: complete` in the task frontmatter.
## Step 4: Advance
Move to next task (i → ii → iii) or next sub-plan (a → b → c).
Repeat Steps 2-4 until all tasks complete.
## Step 5: Wrap-up
When all tasks are `complete` or `deferred`:
1. Re-run `./skill.sh` to archive `.plan/active/` into `.plan/archive/<id>/`
2. Check off success criteria with evidence
3. Append **Plan Summary** section
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |