aw-create-planlisted
Install: claude install-skill mthines/agent-skills
# Create Plan Artifact
Generate `.agent/{branch-name}/plan.md` — the single source of truth for autonomous execution — alongside an immutable `plan.vN.md` snapshot of the same content.
**A new Claude session MUST be able to execute from `plan.md` alone without the original conversation.**
**Every plan iteration produces a new `plan.vN.md` snapshot.** `plan.md` always points at the latest version; `plan.v1.md`, `plan.v2.md`, … are immutable history.
---
## Prerequisites
Before invoking this skill:
1. Phase 0 (Validation) must be complete — requirements confirmed with user
2. Phase 1 (Planning) must be complete — codebase analyzed, decisions made
3. Confidence gate should have passed (90%+ on plan mode)
4. A worktree must exist — plan.md is created INSIDE the worktree, never on main
---
## Procedure
### Step 1: Determine target paths and next version
Run this command to compute the artifact directory, the next version number,
and the two files this skill will write — do NOT guess the branch name or the
version:
```bash
BRANCH=$(git branch --show-current)
DIR=".agent/${BRANCH}"
mkdir -p "${DIR}"
NEXT=$(ls "${DIR}" 2>/dev/null \
| sed -n 's/^plan\.v\([0-9][0-9]*\)\.md$/\1/p' \
| sort -n | tail -1)
NEXT=$(( ${NEXT:-0} + 1 ))
echo "DIR=${DIR}"
echo "VERSION=${NEXT}"
echo "VERSIONED=${DIR}/plan.v${NEXT}.md"
echo "LATEST=${DIR}/plan.md"
```
Three things are determined here:
| Output | Meaning |
| ------------