Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Search & research

retro

Weekly engineering retrospective with persistent metrics covering commit patterns, sessions, quality trends. Triggers "retro", "weekly review", "how was my week", "what did I ship", "show me my stats".

darkroomengineering · Static checks on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add darkroomengineering/cc-settings --skill retro

About this skill


name: retro description: Weekly engineering retrospective with persistent metrics covering commit patterns, sessions, quality trends. Triggers "retro", "weekly review", "how was my week", "what did I ship", "show me my stats". context: fork allowed-tools:

  • Bash
  • Read
  • Write
  • Glob

Engineering Retrospective

Product-aware helper

# Claude Code
ESCALATE_STATS_RUNNER="$HOME/.claude/src/scripts/escalate-stats.ts"
CC_STATE_ROOT="$HOME/.claude"

# Standalone Codex would resolve the helper as:
# ESCALATE_STATS_RUNNER="${CODEX_HOME:-$HOME/.codex}/darkroom/source/src/scripts/escalate-stats.ts"

Codex must skip this Claude escalation telemetry entirely because the plugin does not expose a reliable manual state path. Do not infer or report an act-rate in Codex.

This skill is self-contained. Do not read CLAUDE.md or agent definitions.

Arguments

  • /retro — last 7 days (default)
  • /retro 24h or /retro 14d or /retro 30d — custom window
  • /retro compare — current 7d vs prior 7d
  • /retro compare 14d — current 14d vs prior 14d

Validation: Only accept arguments matching \d+[dhw], compare, or compare \d+[dhw]. Reject anything else with usage instructions.


Step 1: Gather Raw Data

Fetch latest from remote, then run 5 parallel git commands:

# Fetch latest
git fetch origin main 2>/dev/null

# 1. Commits with timestamps, subject, hash, and stats
git log origin/main --since="WINDOW_START" --format="%H|%aI|%s" --shortstat

# 2. Per-commit numstat for test vs production LOC breakdown
# Test files: paths matching test/|spec/|__tests__|*.test.|*.spec.
git log origin/main --since="WINDOW_START" --format="%H" --numstat

# 3. Sorted commit timestamps for session detection (local timezone)
git log origin/main --since="WINDOW_START" --format="%aI" | sort

# 4. Hotspot analysis (most frequently changed files)
git log origin/main --since="WINDOW_START" --format="" --name-only | sort | uniq -c | sort -rn | head -20

# 5. PR number extraction from commit messages (#NNN patterns)
git log origin/main --since="WINDOW_START" --format="%s" | grep -oE '#[0-9]+' | sort -u

Replace WINDOW_START with the appropriate --since value for the requested window.

In Claude only, also run the escalate-advisory telemetry if present:

CC_SETTINGS_HOME="$CC_STATE_ROOT" bun "$ESCALATE_STATS_RUNNER" --days 7

If this prints stats (not "no telemetry yet"), include the act-rate in the report — see Step 13. Standalone Codex omits the telemetry and act-rate section.


Step 2: Compute Metrics

Build a summary table:

| Metric                | Value          |
|-----------------------|----------------|
| Commits to main       | N              |
| PRs merged            | N              |
| Total insertions      | +N lines       |
| Total deletions       | -N lines       |
| Net LOC               | +/-N           |
| Test LOC              | N lines        |
| Test ratio            | N%             |
| Active days           | N/7            |
| Detected sessions     | N              |
| Avg LOC/session-hour  | ~N             |

Step 3: Commit Time Distribution

Build an hourly histogram using local timezone. Identify:

  • Peak hours — when most commits land
  • Dead zones — hours with zero activity
  • Late-night clusters — commits after 10pm (flag for sustainability)
  • Bimodal patterns — morning + evening sessions
Hour  | Commits
------|---------
 8:00 | ###
 9:00 | ######
10:00 | ########
...

Step 4: Work Session Detection

Use a 45-minute gap threshold to detect session boundaries. Classify sessions:

TypeDurationDescription
Deep50+ minSustained focused work
Medium20-50 minModerate task work
Micro<20 minQuick fixes, reviews

Calculate:

  • Total active coding time
  • Average session length
  • LOC per hour (round to nearest 50)
  • Ratio of deep sessions to total

Step 5: Commit Type Breakdown

Categorize by conventional commit prefix:

feat:     N% (N commits)
fix:      N% (N commits)
refactor: N% (N commits)
test:     N% (N commits)
chore:    N% (N commits)
docs:     N% (N commits)
other:    N% (N commits)

Flag: Fix ratio > 50% may indicate a review gap or instability.


Step 6: Hotspot Analysis

Top 10 most-changed files. For each:

  • Change count
  • Whether it's a test or production file
  • Churn flag at 5+ changes — may indicate the file needs refactoring or splitting

Step 7: PR Size Distribution

Bucket PRs by total LOC changed:

SizeLOC RangeCountNotes
Small<100NIdeal for review
Medium100-500NAcceptable
Large500-1500NConsider splitting
XL1500+NFlag with file count

Step 8: Focus Score + Ship of the Week

Focus Score: Percentage of commits touching the single most-changed top-level directory. Higher = more focused work.

Ship of the Week: The highest-LOC PR with:

  • PR number and title (from commit message)
  • Total LOC changed
  • Inferred significance

Step 9: Week-over-Week Trends (if window >= 14d)

Split the window into weekly buckets. Track:

  • Commits per week
  • LOC per week
  • Test ratio per week
  • Fix ratio per week
  • Session count per week

Show as a compact table with trend arrows.


Step 10: Streak Tracking

Count consecutive days with at least 1 commit to origin/main, going back from today. Use full git history — no cutoff.

git log origin/main --format="%ad" --date=short | sort -u

Walk backward from today counting consecutive days.


Step 11: Load History & Compare

Check for prior retro snapshots:

ls .context/retros/*.json 2>/dev/null | sort | tail -1

If found, load the most recent and calculate deltas:

  • Test ratio change
  • Session count change
  • LOC/hour change
  • Fix ratio change
  • Commit count
Read the complete source ↗