groove-utilities-memory-retrospective

week

month

all

Outcome

Acceptance Criteria

• Session ratings trend shown (if

  learned/signals.md

  has data)
• Mistake patterns summarised (from resolved incidents in task backend)
• Top learnings listed by topic (from

  learned/*.md

  dated entries)
• Workflow health summary: one sentence on overall trend
• All output goes to conversation only

Steps

1. Read

   memory:

   from

   .groove/index.md

   (default:

   .groove/memory/

   )
2. Determine date range from $ARGUMENTS:

   • week

     : last 7 days (today - 7)

   • month

     : last 30 days

   • all

     : all available data
   • Default if absent:

     week

3. Session ratings — read

   <memory>/learned/signals.md

   if it exists:
   • Parse table rows matching the date range:

     | YYYY-MM-DD | N/5 | context |

   • Compute: count, average rating, trend (last 3 vs first 3 if enough data)
   • If no data: note "No session ratings recorded yet"
4. Mistakes — query the task backend for resolved incidents under "Groove Memory" → "Mistakes":

   • beans list --parent <mistakes-epic-id> -t bug -s completed

     for resolved;

     -s in-progress

     for open
   • Group by title keywords to identify recurring patterns
   • Count total resolved vs open incidents
   • If no task backend or no data: note "No incidents recorded yet"
5. Learnings — glob

   <memory>/learned/*.md

   (exclude

   signals.md

   ):
   • For each file: read and collect dated entries (

     ## YYYY-MM-DD

     headings) within the date range
   • Group by topic (filename stem)
   • Count entries per topic; show the most recent bullet per topic as a sample
   • If no files: note "No learnings captured yet"
6. Git activity — run

   git log --oneline --since="<start-date>"

   to count commits in the period as a proxy for work volume
7. Output retrospective to conversation in this format:

## Groove Retrospective — <period> (<start-date> to <today>)

### Session Ratings
<count> sessions rated | avg: <N>/5 | trend: <up/down/flat or n/a>
<sparkline of ratings if ≥3 data points, e.g. ▂▄█▆▇>

### Mistakes
<N> incidents resolved | <N> open
Top patterns:
- <root cause pattern> (N occurrences)
- ...
(No recurring patterns) if all unique

### Learnings
<N total entries across <M> topics>
- patterns (<N> entries): <most recent bullet>
- anti-patterns (<N> entries): <most recent bullet>
- ...

### Workflow Health
<git commits in period> commits | <1-sentence summary of overall trend>
e.g. "Stable week — ratings above 4, one incident (resolved), 3 new patterns captured."

Sparkline generation

• 1/5 → ▁, 2/5 → ▂, 3/5 → ▄, 4/5 → ▆, 5/5 → █
• Only show if ≥ 3 ratings in the period

Constraints

• Read only — do not write to any file
• If a data source file is absent, skip that section gracefully with a one-line note
• Parse table rows defensively: skip malformed rows rather than erroring
• Date filtering: match rows where the

  YYYY-MM-DD

  date falls within the range; skip rows without a valid date
• Output to conversation only — never write to AGENTS.md or memory files