From f14e9bbc63d8c33660934e1eacef974dbc0f158f Mon Sep 17 00:00:00 2001 From: jester Date: Thu, 16 Apr 2026 19:07:09 +0000 Subject: [PATCH] Add Codex repo-specific tracking structure --- Codex/README.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 Codex/README.md diff --git a/Codex/README.md b/Codex/README.md new file mode 100644 index 0000000..0622718 --- /dev/null +++ b/Codex/README.md @@ -0,0 +1,25 @@ +# 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