Skip to content

JordanGunn/nunchuck / skills/plan/plan-exec

plan-exec

Verified

Execute tasks in the active plan under `.plan/active/`. Writes concrete Output and Handoff for each task and archives the plan once terminal.

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
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall