How do I create a timeline snapshot?
Relies on compass timeline snapshot (in the temporal command
coherence investigation), 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.
Question
How do I create a 20-minute timeline snapshot of recent agile activity?
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).
Script
compass_timeline.py — _cmd_snapshot / _write_snapshot.
Tested by
Manual smoke test: compass timeline snapshot --since 20m writes a
file, compass timeline show renders it.
See also
- agile-add-timeline-snapshot — the skill that orchestrates this recipe.