---
name: windows-runtime
description: Maintain Windows-native PDFtoMD runtime behavior. Use when Codex needs guidance for repo-local venv, CUDA/OOM handling, Korean paths, long paths, model cache, offline operation, stderr logs, or resume cache behavior.
---

# Windows Runtime

## Workflow

1. Read `AGENTS.md`, `docs/TOOLCHAIN.md`, `docs/ARCHITECTURE.md`, and `docs/CONVERSION_POLICY.md`.
2. Verify environment health with:
   - `.\venv\python.exe -m pip check`
   - CUDA smoke test
   - `.\venv\Scripts\nougat.exe --help`
3. Use `pathlib` for path design and tests.
4. Include Korean filenames, spaces, and long Windows paths in test plans.
5. Keep model cache and offline behavior explicit.

## Guardrails

- Do not silently fall back to CPU when the user explicitly requested CUDA.
- Do not choose batch sizes that assume more than 8 GB VRAM.
- Do not delete local environments or sample PDFs without explicit approval.
