← ClaudeAtlas

aw-create-walkthroughlisted

Generate a walkthrough artifact (walkthrough.md) in `.agent/{branch}/` summarizing completed work for PR delivery. Gathers information from plan.md, git history, and test results to produce a comprehensive summary. Use at Phase 6 before creating the draft PR. Triggers on create walkthrough, generate walkthrough, write walkthrough artifact.
mthines/agent-skills · ★ 4 · AI & Automation · score 83
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