Skip to content

Project Catch-Up

Summarize what landed on main plus quick quality signals. Keep execution deterministic by collecting commit data with the bundled script, then produce the report from that dataset.

1) Gate - Scope Before Git (Mandatory)

Never assume scope. Require one explicit scope before running history commands:

  • Last 3 days
  • Last 10 days
  • Last 30 days
  • Since date YYYY-MM-DD
  • Last N commits

When interactive option tools are available, use them first. Otherwise ask in plain chat and wait for an explicit choice.

2) Collect Facts with Script (Deterministic Path)

Use scripts/collect-history.sh so commit extraction and size stats are captured in one pass.

Examples:

# Last N commits
bash scripts/collect-history.sh --repo . --branch main --count 30

# Date window
bash scripts/collect-history.sh --repo . --branch main --since "10 days ago"

# Specific output file
bash scripts/collect-history.sh --repo . --since "2026-05-01" --output /tmp/project-catchup.tsv

Rules:

  • Do not run this script until scope is confirmed.
  • Pass explicit flags only (--count, --since, or --after).
  • Do not silently substitute defaults.
  • If the script errors, report the error and ask to revise scope.

3) Report Shape (Required)

Return sections in this order:

  1. ### 👓 Summary
  2. ### 📶 Review signals
  3. ## Per-Commit Detail with the five-column table

Use the detailed scoring/table enums from:

  • references/report-spec.md

Use the sample shape from:

  • examples.md

4) Deep Pass (Optional)

Only include deep-pass artifacts when explicitly requested:

  • file-level blob links
  • author rollup
  • filtered history by author/path/window

5) Output Checklist

  • [ ] Scope explicitly confirmed
  • [ ] Deterministic collector script used for facts
  • [ ] Section order is 👓 then 📶 then table
  • [ ] Summary threads use the borderless row-list layout (Thread · What landed, --- separators, no pipe table)
  • [ ] Review signals use the borderless row-list layout (Signal · Notes, all five rows, no pipe table)
  • [ ] Per-commit table uses exactly five required columns
  • [ ] Enum-only values used for Msg vs files and App vs Tests
  • [ ] Deep pass included only on request