Agent Change Walkthrough Skill

Purpose

Generate a single-story walkthrough of AI-authored code changes explaining implementation from trigger to final behavior.

Core Method

Follow six steps:

1. Capture intent — Restate the change in plain language with scope and non-goals
2. Build evidence — Collect git diffs using git status, git diff, git show
3. Build story stack — Order steps dependency-first (contracts/types before usage, definitions before invocations)
4. Write narrative — Each step: clear title, CHANGED/UNCHANGED marker, filename with line number, code snippet, prose explanation
5. Integrate analysis — Add trade-offs, alternatives, performance notes, and risks inline at relevant steps
6. Close out — Summarize what changed, why behavior differs, what to monitor

Key Principles