# Phase 11: Frame Repository and Subset Grid Compilation - Discussion Log

> **Audit trail only.** Do not use as input to planning, research, or execution agents.
> Decisions are captured in CONTEXT.md — this log preserves the alternatives considered.

**Date:** 2026-04-13
**Phase:** 11-frame-repository-and-subset-grid-compilation
**Areas discussed:** Repository storage, Capture lifecycle, Query & filtering, Grid compilation

---

## All Areas (User-Directed)

User provided comprehensive direction covering all four areas in a single message rather than individual Q&A:

**User's input:**

> The main thing I care about is that for the phase 11 featureset, the agent should be able to select and query a subset of frames using several determining factors:
> - by start + end time (relative to capture start)
> - by start time + length
> - by starting frame + ending frame indices
> - by starting frame index + length-as-frame-count
> - for all of the above, optionally setting a "max frames" ceiling. evenly distributes the max returned frames across the given range
>
> Secondarily, I want you to ensure that screenshot collections are not long-lived. They should stick around long enough to be referenced during a lengthy working session (24h?), but not be permitted to fill up disk space endlessly.
>
> For all features and phases of this milestone, you are free to ideate, decide, plan, and introduce any additional elements or feature extensions that improve the tool's power and flexibility in agents' proverbial hands.

**Decisions derived:**
- Five query modes with uniform-sampling max_frames ceiling
- 24h retention with auto-purge
- Full creative discretion for agent-power features

---

## Claude's Discretion

Claude ideated the following additional features under creative discretion:
- Session naming (D-23) — meaningful names instead of opaque UUIDs
- Grid labels (D-21) — title overlays for comparison grids
- Change summary (D-22) — session dynamics overview before querying
- Frame change metrics (D-19) — per-frame change detection in listings
- Compilation metadata (D-25) — full provenance returned with every grid

## Deferred Ideas

- Cross-session frame comparison (mixing frames from different sessions in one grid)
- Frame annotation (agent-applied text labels on individual frames)
- Streaming grid updates (live-refreshing grid as new frames arrive)