CLAUDE.md · diff
git:20260222.3da134a to git:20260317.f491515
22 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`.
## 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**
+
+