manga-recap-pipeline/caveats/CLAUDE.md

caveats/

One entry per known breakage, deferral, or trap. An entry names what fails, who pays for it, and the concrete trigger that makes fixing it worth the time.

A caveat that gets resolved moves to decisions/ or gets deleted. A caveat with no revisit trigger is a complaint, so give it one or drop it.

Rules for this directory

• One file per source, one ## section per limit.
• State the limit as what fails, not as a topic. "Reconcile deletes the losing character" beats "Reconcile".
• Delete an entry the moment its trigger fires and the work lands.

Index

caveat	source
Reconcile deletes the losing character irreversibly	AUDIT.md
Clearing a stage does not undo what it wrote	AUDIT.md
ComfyUI uses the GPU outside the session mutex	AUDIT.md
The JSON repair pass can fabricate dialogue	AUDIT.md
/review/preview pins a solo clip into the final video	AUDIT.md
Stored embeddings carry no model or pooling version	AUDIT.md
Worker endpoints block the event loop	AUDIT.md
SQLite has no busy timeout, so parallelism will surface as lock errors	AUDIT.md
layers runs after tts, so pipelined solo beats lose parallax	AUDIT.md
completed means something different in each stage	AUDIT.md
Identity worker caches characters the orchestrator has deleted	AUDIT.md
A character seen once gets no assignment at all	AUDIT.md
MinIO credentials are hardcoded in committed source	AUDIT.md
Assemble marks a job completed with no clips	AUDIT.md
Reviewer timestamps drift against the crossfaded video	AUDIT.md
speaker_method="tail" never reads a tail	2026-08-11 run
One character id covers two different women	2026-08-11 run
The character registry carries five weeks of wrong names	2026-08-11 run
A multi-word character name always fails the script verifier	2026-08-11 run