This repository is intended to work well with coding agents.
- Read
docs/project-spec.md. - Read
.github/copilot-instructions.md. - Follow any scoped instructions in
.github/instructions/that apply to the files being edited.
- Prefer small, reviewable changes.
- Keep architecture modular.
- Preserve a clear separation between:
- media/audio preparation
- matching/refinement
- alignment map construction
- subtitle retiming
- reporting
- Do not implement out-of-scope features from v1 unless explicitly requested.
A task is not complete unless:
- code changes are coherent and minimal
- tests were added or updated where relevant
- docs were updated if behavior changed
- outputs remain inspectable and debuggable
- implement data models first
- implement pure logic second
- implement side-effecting media/CLI integration last
- hiding mapping behavior inside one large function
- hardcoding one global offset model
- silently discarding uncertain subtitle cues