jester/zlh-grind

History

jester aecc641a0f Record Portal Codex decisions from Node 24 and cleanup pass		2026-04-19 21:26:03 +00:00
..
Agent	Clarify agent cleanup priorities and behavior-preserving folding plan	2026-04-18 23:43:50 +00:00
API	Record API Codex decisions from Node 24 modernization and hardening pass	2026-04-19 21:17:12 +00:00
Portal	Record Portal Codex decisions from Node 24 and cleanup pass	2026-04-19 21:26:03 +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