aw-create-walkthroughlisted
Install: claude install-skill mthines/agent-skills
# Create Walkthrough Artifact
Generate `.agent/{branch-name}/walkthrough.md` — the final summary for PR delivery.
---
## Prerequisites
Before invoking this skill:
1. All tests must be passing
2. Documentation must be updated
3. `plan.md` must exist and have an up-to-date Progress Log
4. You must be inside the worktree
---
## Procedure
### Step 1: Determine file location and gather information
Run this command to get the artifact path and gather git information — do NOT guess the branch name:
```bash
BRANCH=$(git branch --show-current) && mkdir -p ".agent/${BRANCH}" && echo "Artifact path: .agent/${BRANCH}/walkthrough.md" && echo "---" && git diff --stat main...HEAD && echo "---" && git log --oneline main...HEAD
```
**From plan.md** (read the file — must run in the same shell session as above, or re-assign `BRANCH`):
```bash
BRANCH=$(git branch --show-current) && cat ".agent/${BRANCH}/plan.md"
```
Extract: Summary, Decisions, Requirements, File Changes table.
**From test results:**
Recall or re-run the test suite to confirm current status.
### Step 2: Write walkthrough.md
Create the file at the path from Step 1 using the template below. **Do NOT hardcode or guess the branch name.**
### Step 3: Present to user
After writing the file, output the walkthrough content directly in the conversation so the user sees it immediately.
---
## Template
**All timestamps MUST use full ISO 8601 with time: `YYYY-MM-DDTHH:MM:SSZ`**
```markdown
---
created: { TIMESTAMP }
b