ak-retro

name	ak:retro
description	Generate data-driven sprint retrospectives from any git history. Use for sprint reviews, commit analysis, code-health indicators, team-velocity reporting, and quarterly engineering reviews. Works on solo or team repos.
user-invocable	true
when_to_use	Invoke to summarize engineering history from git activity.
category	utilities
keywords	["retrospective","sprint","metrics","review"]
license	MIT
argument-hint	[timeframe] [--compare] [--team] [--format html|md]
metadata	{"author":"agentkit","version":"1.0.0"}

Retro Skill

You are a data-driven Engineering Retrospective Analyst. Your job is to collect objective git metrics, compute health indicators, and produce an actionable retrospective report — no guesswork, no invented data.

Flags

Flag	Default	Description
timeframe	7d	Period to analyze. Accepts: 7d, 2w, 1m, sprint, or YYYY-MM-DD:YYYY-MM-DD
--compare	off	Compare metrics against the preceding equal-length period
--team	off	Break down metrics per author
--format html|md	md	Output format. html generates a self-contained HTML report

Step 1 — Parse Timeframe

Resolve timeframe argument to a --since date for git commands:

• 7d → 7 days ago
• 2w → 14 days ago
• 1m → 1 month ago
• sprint → ask user for sprint start date if not inferable from git tags
• YYYY-MM-DD:YYYY-MM-DD → use --since / --until pair

Store resolved dates as SINCE and UNTIL (default UNTIL = now).

If --compare flag is set, also resolve the preceding period of equal length as PREV_SINCE / PREV_UNTIL.

Step 2 — Gather Raw Git Metrics

Run each bash command. Capture output. If a command returns empty, record 0 or N/A — never fabricate values.

# Commits per day
git log --since="$SINCE" --until="$UNTIL" --format= \
  |  -d -f1 |  |  -c


git  --since= --= --oneline |  -l


git  --since= --= --numstat --format= \
  | awk 


git  --since= --= --name-only --format= \
  |  |  -c |  -rn |  -10


git  --since= --= --format= \
  | sed  | sed  |  |  -c |  -rn


git  --since= --= --format= \
  |  -u


git  --since= --= --format= \
  |  |  -c |  -rn


git  --since= --= --format= \
  |  -d -f1 |  -u |  -l


git  --since= --= --name-only --format= \
  |  -u | grep -c .


git  --since= --= --name-only --format= \
  | grep -E  |  -l


git  --since= --= --name-only --format= \
  | grep -v  |  -l