# Codex

Codex is the repo-specific execution layer for active work.

Purpose:
- keep `zlh-grind` root focused on platform-wide context
- track API, Portal, and Agent work separately
- make it easier to remove completed items instead of letting them linger in one shared backlog

Use this structure:
- `Codex/API/*` for `jester/zpack-api`
- `Codex/Portal/*` for `jester/zpack-portal`
- `Codex/Agent/*` for `jester/zlh-agent`

File roles:
- `README.md` — front door for that repo track
- `CURRENT_STATE.md` — what is actually implemented now
- `OPEN_ITEMS.md` — only unfinished work
- `DECISIONS.md` — important settled choices / do-not-re-litigate notes

Operational rules:
- remove completed items from `OPEN_ITEMS.md` promptly
- move durable context into `CURRENT_STATE.md` or `DECISIONS.md`
- keep root `OPEN_THREADS.md` for cross-repo / platform items only
- if `Codex/*` conflicts with older historical notes elsewhere in `zlh-grind`, prefer the newer Codex entry unless there is stronger evidence in the source repo