Agile Add Timeline Snapshot
Table of Contents
When to use this skill
When the user asks to "snapshot the timeline", "create a timeline
bucket", or record what has happened in the last 20 minutes (or a
custom window) on the agile board. The snapshot is stored under the
current sprint's timeline/ folder as <ISO-from>-<ISO-to>.org and
read by the temporal grid's compass timeline show command.
How to use this skill
Generate the snapshot scaffold for the default 20-minute window:
./compass.sh timeline snapshot
For a custom window use
--since 1hor--from <ISO> --to <ISO>. If compass warns that the event count exceeds the cap (20), split the window before continuing — a busy bucket defeats the purpose.- Read the generated file — compass prints its path on success.
- Fill in
* Problems and suspicious decisionsbased on the events:- LLM co-authored commits that touch code without an open task.
- PRs merged while CI was still pending (look for force-merge patterns in the PR table).
- Tasks that went DONE rapidly with no
#+environment:stamp (may indicate incomplete bookkeeping). - Captures filed but no follow-up story opened yet.
- Fix the audit section if compass flagged bookkeeping drift (items closed without environment stamp). Correct the actual task/story docs; do not just edit the snapshot.
Commit the snapshot:
git add <file> && git commit -m "[agile] Timeline snapshot: <from>-<to>" && git push
Recipes
- How do I create a timeline snapshot? — step-by-step with examples.
Reference
- Agile timeline: bucketed summaries of recent activity — the story this skill delivers.
- Temporal command coherence investigation — design rationale for the consistent-substrate model the snapshot uses.