How do I create a timeline snapshot?

1. Question
2. Answer
3. Script
4. Tested by
5. See also

Relies on compass timeline snapshot, which mines origin/main and the GitHub PR record for the given window and writes a structured org file to the current sprint's timeline/ folder.

1. Question

How do I create a 20-minute timeline snapshot of recent agile activity?

2. Answer

./compass.sh timeline snapshot            # default: last 20 minutes
./compass.sh timeline snapshot --since 1h # last hour
./compass.sh timeline snapshot --from 2026-06-10T08:00 --to 2026-06-10T10:00

Compass prints the file path on success. If it warns that the event count exceeds 20, split the window with --from/--to — an over-full bucket defeats the scan-first goal.

After generating, open the file and fill in * Problems and suspicious decisions with any patterns that stand out (LLM co-authored commits without a task, force-merged PRs, bookkeeping drift).

3. Script

compass_timeline.py — _cmd_snapshot / _write_snapshot.

4. Tested by

Manual smoke test: compass timeline snapshot --since 20m writes a file, compass timeline show renders it.

5. See also

compass-agile-add-timeline-snapshot — the skill that orchestrates this recipe.