jester/zlh-grind

History

jester b581ab2480 Update API Codex decisions		2026-04-29 18:22:23 +00:00
..
Agent	Track dev shell boundary and dev backup ownership direction in Agent open items	2026-04-19 22:04:50 +00:00
API	Update API Codex decisions	2026-04-29 18:22:23 +00:00
Portal	Update Portal Codex open items	2026-04-29 18:21:24 +00:00
README.md	Add Codex repo-specific tracking structure	2026-04-16 19:07:09 +00:00

README.md

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