retro

Overview

Analyzes git history and project data to produce a structured engineering retrospective. Focuses on what shipped, code quality trends, hotspots, and shipping velocity.

Step 1: Determine Time Window

Parse the argument for the time window:

Argument	Window	git log --since
24h	Last 24 hours	--since="24 hours ago"
7d (default)	Last 7 days	--since="7 days ago"
14d	Last 14 days	--since="14 days ago"
30d	Last 30 days	--since="30 days ago"
compare	Compare current vs previous period	Two git log ranges

Step 2: Gather Data

Run these commands in parallel:

Commit Analysis

# Commit count and authors
git log --since="7 days ago" --oneline | wc -l
git log --since="7 days ago" --format="%an" | sort | uniq -c | sort -rn

# Commit types (conventional commits — macOS-compatible)
git log --since="7 days ago" --oneline | sed -E 's/^[a-f0-9]+ //' | grep -oE '^(feat|fix|refactor|chore|docs|test|perf|ci|style)' | sort | uniq -c | sort -rn

# Files changed
git log --since="7 days ago" --name-only --format="" | sort | uniq -c | sort -rn | head -20

Code Churn

# Lines added/removed
git log --since="7 days ago" --numstat --format="" | awk '{add+=$1; del+=$2} END {print "+"add, "-"del}'

# Churn by directory
git log --since="7 days ago" --numstat --format="" | awk '{split($3,a,"/"); dir=a[1]"/"a[2]; add[dir]+=$1; del[dir]+=$2} END {for(d in add) print add[d]+del[d], d}' | sort -rn | head -10

Hotspots (High Churn Files)

# Files changed most frequently (potential complexity hotspots)
git log --since="7 days ago" --name-only --format="" | sort | uniq -c | sort -rn | head -10

PR Activity (if GitHub)

# Merged PRs
gh pr list --state merged --search "merged:>=$(date -v-7d +%Y-%m-%d 2>/dev/null || date -d '7 days ago' +%Y-%m-%d)" --json number,title,author,mergedAt --limit 50

# Open PRs
gh pr list --state open --json number,title,author,createdAt --limit 20