aw-create-walkthrough

Solid

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.

AI & Automation 8 stars 2 forks Updated 2 days ago MIT

Install

View on GitHub

Quality Score: 84/100

Stars 20%
32
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# 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...

Details

Author
mthines
Repository
mthines/agent-skills
Created
3 months ago
Last Updated
2 days ago
Language
TypeScript
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category