lecture-to-notes

# Lecture-to-Notes Turn a lecture recording (video or audio-only) into structured notes. Every heavy stage runs locally at 0 Claude tokens; Claude only does the final synthesis. This page is the map; detail lives in `reference/`, one topic per file. | File | What is in it | |---|---| | `reference/pipeline.md` | Per-stage flags, thresholds, JSON schemas, timeouts, observability | | `reference/note-spec.md` | Note quality spec, tier scoring, width table, synthesis prompt requirements | | `reference/segmented-mode.md` | Multi-talk workshop folders → per-segment L2/L3 + Hub + web viewer | | `reference/multi-camera.md` | One long recording + many phone clips/photos → one timeline | | `reference/decisions.md` | Post-mortems, benchmarks, wrong turns, VRAM measurements | ## HARD RULES 1. ==ASK the user what language the speaker(s) used== (English / Mandarin / bilingual code-switching) before transcribing. There is no default and `transcribe_video.py` exits without `--lang`. A wrong guess makes Whisper hallucinate Chinese from accented English and the transcript is unusable. 2. ==Never skip Stage D (VLM) or Stage E (grounding)== for speed or for a deadline. ==The user has not set a deadline; do not invent one.== If a stage really is too slow (>2 h ETA), report the ETA and ask. 3. ==Never auto-correct the transcript.== Flag suspects, let synthesis resolve them. Both auto-correction passes ever built were measured and retired — see `reference/decisions.md#asr-au...