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

  1. Generate the snapshot scaffold for the default 20-minute window:

    ./compass.sh timeline snapshot
    

    For a custom window use --since 1h or --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.

  2. Read the generated file — compass prints its path on success.
  3. Fill in * Problems and suspicious decisions based 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.
  4. 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.
  5. Commit the snapshot:

    git add <file> && git commit -m "[agile] Timeline snapshot: <from>-<to>" && git push
    

Recipes

Reference

Emacs 29.1 (Org mode 9.6.6)