prosperious's picture
Add 1000 files (OCR_INDRA/.gitignore ...)
f9bc0c1 verified
|
Raw History Blame Contribute Delete
2 kB
# 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`.