git:20260317.f491515 to git:20260527.75bf518

4 added, 0 removed. Audit A to A.

# Project: YouTube Transcriber

Next.js 15 app — local YouTube transcription via Whisper + yt-dlp. Runs at `localhost:19720`.

+ ## Visual rules

+ Before generating any UI, components, or CSS, read `docs/VISUAL-RULES.md`. Edge tokens replace 1px borders (`shadow-[var(--edge)]` not `border`); hover via translucent overlay, not color swap. Append corrections to that file with the "update so this never happens again" pattern when output looks cheap.

## Session continuity

Before ending a session or when context usage exceeds ~75%, update these two files and alert user when doing this so they know we have reached 75%:

1. **`HANDOVER.md`** — Write a fresh handover so the next session can pick up immediately. Include:

- What was done this session (numbered list, concise)

- Key files touched

- Current state (branch, last commit, build status, uncommitted changes)

- Any open issues or next steps discussed

2. **`CHANGELOG.md`** — Append entries for any user-facing changes made this session under a dated heading (`## YYYY-MM-DD`). Use Keep a Changelog categories (Added, Changed, Fixed, Removed).

Do not wait to be asked — update these proactively when context is getting full.

## Git Rules

- **Commit/Push/Merge**: Each requires explicit user permission

- Use feature branches for new tickets; hotfixes on main are OK

- No Claude attribution in commits

## Code Quality

- Use eslint/prettier for formatting (not Claude)

- ESM imports: use `.js` extension for `.ts` files

- Follow existing patterns in the codebase

## Bug Fix Protocol

When a bug is reported or agent extraction fails:

1. **Write a reproducing test first** - Capture the failure as a test case

2. **Fix the bug** - Make the minimal change needed

3. **Verify test passes** - Prove the fix works

4. **Check for regressions**