# Phase 8: Screenshot Profiles - 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:** 08-screenshot-profiles
**Areas discussed:** Profile Storage, Profile Contents, Tool Interface Design, Profile Resolution

---

## Gray Area Selection

| Option | Description | Selected |
|--------|-------------|----------|
| Profile storage | Where profiles are persisted, file discovery, overwrite behavior | |
| Profile contents | What fields a profile stores, metadata | |
| Tool interface design | MCP tool shapes, naming, error behavior | |
| Profile resolution | How start_capture resolves profiles, merge behavior | |

**User's choice:** Free-text delegation — user specified one Phase 11 requirement (frame subset query modes: start+end time, start time+length, frame index+count) and granted full creative discretion for all v1.2 phases.

**Notes:** User explicitly stated: "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." All Phase 8 decisions were made by Claude under this delegation.

---

## Claude's Discretion

All gray areas were delegated to Claude's discretion. Key design rationale:

- **Project-local storage** over global: agents working in different directories get independent profile sets
- **Single JSON file** for both screenshot and timing profiles: simplicity over separation
- **Silent overwrite** on name collision: agents don't need confirmation flows
- **Title-based resolution** over handle: handles are ephemeral, titles persist across sessions
- **Merge semantics** for profile + inline params: maximum flexibility without profile proliferation
- **`capture_from_current` mode**: reduces friction — agents save what they just configured
- **Liveness check in list output**: agents can verify targets before starting captures

## Deferred Ideas

- Profile import/export between projects
- Profile groups/tags for organization