change-walkthrough

name	change-walkthrough
description	Create detailed markdown walkthroughs of code changes. Use when the user asks to "create a walkthrough", "explain the changes", "review recent commits", "document what changed", "walk me through the diff", "summarize my changes", or similar requests for change documentation.

Change Walkthrough

Generate a detailed, well-formatted markdown walkthrough of code changes with automatic HTML conversion and browser preview.

Workflow

1. Understand What Changes to Review

Ask or determine what changes the user wants documented:

• Uncommitted changes (default): All changes in working directory
• Staged changes: Only changes added to staging area
• Recent commits: Last N commits
• Commit range: Specific range (e.g., "abc123..def456")
• Branch comparison: Diff between branches
• Specific files: Only certain files or directories

If not specified, default to uncommitted changes.

2. Gather Change Information

Based on the scope, run appropriate git commands:

# Uncommitted changes
git diff --stat && git diff

# Staged changes
git diff --staged --stat && git diff --staged

# Last N commits
git log --oneline -n N && git diff HEAD~N..HEAD

# Branch comparison
git diff main..HEAD --stat && git diff main..HEAD

Also gather context by reading changed files to understand the full picture.

3. Generate the Walkthrough Document

Create a comprehensive markdown document: