Task: Add LLM snapshot summarisation skill and sprint timeline storage
This page documents a task in the Agile timeline: bucketed summaries of recent activity story. It captures the goal, current status, acceptance, and any notes or results.
Goal
Add a compass timeline snapshot command and an agile-add-timeline-snapshot
skill so the LLM can produce structured 20-minute activity buckets and store
them in the sprint's timeline/ folder. Each snapshot is a scan-first org
file with Stories, Tasks, Captures, PRs, Problems/suspicious-decisions, and
an Audit section. A companion recipe documents the workflow.
Status
| Field | Value |
|---|---|
| State | DONE |
| Parent story | Agile timeline: bucketed summaries of recent activity |
| Now | Nothing. |
| Waiting on | Nothing. |
| Next | Nothing. |
| Last touched | 2026-06-07 |
Acceptance
- Snapshots are scan-first: bullet points and tables, not prose. We have too much information already — the snapshot must be readable in seconds.
- Buckets: stories raised, tasks raised, stories/tasks worked on (per environment), problems, suspicious LLM decisions.
- Every row links to the document by id so detail is one click away.
- An audit section per snapshot: window-scoped bookkeeping drift (states not updated, missing environment stamps, merged PRs with open tasks), reusing the sprint audit checks.
- Stored under the sprint's timeline/ folder as <ISO-from>-<ISO-to>.org.
- Bucket size is tunable and treated as an experiment: start around 20 minutes, adjust against real activity. A bucket with too many events to scan quickly is a failure — prefer splitting busy windows (event-count cap) over letting buckets grow.
Plan
(Implementation strategy. Written when work starts; key decisions
are distilled into the parent story's * Decisions at close, but the
plan itself stays — it is the historical record of what we did.)
Notes
PRs
| PR | Title |
|---|---|
| #1227 | [agile] Agile timeline: environment stamp, snapshot skill, storage |
Review
| Comment summary | File | Decision | Notes |
|---|---|---|---|
Result
- Added
_cmd_snapshot,_write_snapshot,_find_sprint_timeline_dir,_snapshot_filename,_doc_link,_event_desctocompass_timeline.py. Thesnapshotsubcommand resolves a window, fetches origin/main, buckets doc and PR events, auto-detects the current sprint'stimeline/dir, generates a UUID per snapshot, and writes the structured org file. - Event-count cap of 20 per bucket enforced with a warning on overflow.
- Audit section auto-flags items closed without
#+environment:stamp. - Created
doc/llm/skills/agile-add-timeline-snapshot/SKILL.organd deployed viacompass build skills. - Created
doc/recipes/compass/how_do_i_create_a_timeline_snapshot.org. - Added skill to
doc/llm/skills/claude_code_skills.org.