weekly-review

Context

Options: $ARGUMENTS

Today: !date +%Y-%m-%d | Week start: !date -v-7d +%Y-%m-%d 2>/dev/null || date -d '7 days ago' +%Y-%m-%d

Commits this week (all branches):

!git log --all --since='7 days ago' --format=' %ad %h %s (%an)' --date=short 2>/dev/null | head -40

Pull requests touched this week:

!gh pr list --state all --search "updated:>=$(date -v-7d +%Y-%m-%d 2>/dev/null || date -d '7 days ago' +%Y-%m-%d)" --json number,title,state,mergedAt,author --jq '.[] | " #\(.number) [\(.state)] \(.title)"' 2>/dev/null | head -20

Issues closed this week:

!gh issue list --state closed --search "closed:>=$(date -v-7d +%Y-%m-%d 2>/dev/null || date -d '7 days ago' +%Y-%m-%d)" --json number,title --jq '.[] | " #\(.number) \(.title)"' 2>/dev/null | head -20

Decision log and research log entries this week:

!grep -h "^- $(date +%Y-%m)" DECISIONS.md docs/DECISIONS.md 2>/dev/null | tail -10; grep -c "^## $(date +%Y-%m)" RESEARCH_LOG.md 2>/dev/null | xargs -I{} echo "{} research log entries this month"

Previous review's plan:

!f=$(ls reviews/*.md docs/reviews/*.md 2>/dev/null | sort | tail -1); [ -n "$f" ] && awk '/^## Next week/{f=1;next} /^## /{f=0} f' "$f" | head -15 || echo "(no previous review)"

Task

Write reviews/<week-end-date>.md (or the existing reviews directory). Use --since to change the window and --author to filter commits to one person in a shared repo.

Structure

# Week ending 2026-09-21

## Done
- Shipped: PR #45 workflow-hooks (merged Tue). Evidence: link.
- ...
Grouped by theme, each with its evidence (commit, PR, issue, file). Nothing without evidence.

## Against last week's plan
| Planned | Outcome |
| Finish thesis chapter 2 outline | done (research/OUTLINE.md) |
| Run n=30 sweep | not started; blocked on GPU quota |

## Decisions
- From DECISIONS.md and meeting notes this week, one line each.

## Stalled or overdue
- Action items past due (from meeting notes, the research log's Open section, open PRs with no activity for 5+ days).

## Numbers
Commits, PRs merged, issues closed, notes written, words added to chapters (if a thesis is present, from git diff --shortstat on chapters/).

## Next week
- Three to five outcomes, each with a definition of done and, where useful, a day.