Disk State Schema

All pipeline state lives on disk in the .ui-convert/ directory at the project root. State is never stored in chat context, environment variables, or memory. This enables resumability, idempotency, and parallel extraction safety.

Non-negotiable Rules

1. State directory is .ui-convert/ at the project root being converted.
2. JSON files only — no YAML, no TOML, no binary formats.
3. Atomic writes — write to a .tmp file, then rename (prevents corruption on crash).
4. Schema versioning — every state file has a _v key indicating schema version.
5. No state in chat — skills read from disk, process, write back to disk.
6. Append-only logs — the logs/ dir is append-only; never delete log entries.

Directory Structure