File size: 1,999 Bytes
f9bc0c1 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 | # ocr-tech — agent instructions
## Drive documents
- `RESEARCH.md` is the research state and drive document. Read it first every
session; keep it current when results land.
- End goal: OCR covering the whole Nepal language pack, **Limbu first, Newar
(Nepal Bhasa) second** (steer 2026-07-04).
## Model delegation policy (steer 2026-07-04)
- **Fable (lead session model)**: orchestration, the hardest reasoning, design
decisions, and final verification of all delegated work. Best model available —
do not delegate judgment calls.
- **Codex**: treat as a peer, not a subordinate. It has good independent ways of
figuring things out. Hand it substantial, well-scoped build/diagnosis/research
tasks (new tools, refactors, root-cause hunts) with verified file paths and
acceptance criteria; always verify its output independently (run its tests,
spot-check its data).
- **Opus**: near-par with the lead model but slightly weaker; usable for hard
tasks and second opinions when a peer-level check is wanted.
- **Sonnet**: tasks that require no big thought — mechanical edits, bulk file
wrangling, running known command recipes, simple searches and summaries.
## Working rules
- Never assume file paths, schemas, or endpoint behavior — verify on disk / live
before coding against them (this repo's history has multiple wrong-assumption
scars; see RESEARCH.md "Mistakes To Avoid").
- Real CER comes from `tools/eval_metrics.py` (micro CER, codepoint + grapheme).
Never report Paddle `norm_edit_dis` as CER.
- Silver labels are machine-converted; they are training/diagnostic substrate,
not claim-grade ground truth. Claim-grade numbers need frozen, human-reviewed
eval packs.
- Long downloads/runs: launch detached (`nohup`), not under tool timeouts; watch
with polling loops. `ocrtech audit-gorkhapatra-language-pages` has no resume.
- Python runtime for Paddle work is 3.11 (`uv run --python 3.11`); silver tooling
needs `--with pymupdf --with npttf2utf`.
|