governance: zero technical debt, production-ready always; safety first across system prompts, AGENTS templates, proposal, and plan

collab/plan/01-codexhelper.llm.md

@@ -17,6 +17,7 @@
   - One-way workflow; minimal chat; read `.llm.md`, write both.
   - Governance/propagation: update prompts/global and seed/project AGENTS when norms change.
   - Safety: `--force` for overwrite; never `git push`; runs under `<project>/runs/<ts>/`.
+  - Zero Technical Debt: production-ready always; no deferring docs/tests/refactors.
 
 - Deliverables:
   - `CodexHelper` bash script
@@ -41,6 +42,7 @@
   - Precedence: CLI > env > project > mode > global.
   - `prompts/global/` used in composition.
   - Tests: all features covered by unit/integration tests (bats); TDD observed (tests committed alongside implementation); CI/local test script present.
+  - Zero Debt: docs updated; no pending TODOs/deferrals; production-ready criteria met.
 
 - Open choices (defaulting now):
   - Include empty `prompts/style.md`: Yes.
@@ -50,13 +52,13 @@
 
 - Next: Implement per milestones; add concise README quickstart.
  
- - Accelerated Timeline (8 hours today):
+- Accelerated Timeline (8 hours today):
    - H0–1: test harness + failing smoke tests (CLI, guardrails)
    - H1–2: CLI skeleton + guardrails (make tests pass)
    - H2–3: binary detection + pass-through (tests first)
    - H3–4: new-mode scaffolder (tests first)
    - H4–6: new-project scaffolder (tests first)
    - H6–7: run: compose + invoke (tests first)
-   - H7–8: config precedence (tests first) + minimal docs
+  - H7–8: config precedence (tests first) + minimal docs
  
- - Defer if needed: expand docs; polish templates.
+ - No deferral: docs must be completed; templates polished sufficiently for production.

collab/plan/01-codexhelper.md

@@ -31,9 +31,10 @@ Purpose: Deliver Phase 1 (Crawl) MVP of CodexHelper: subcommands, scaffolding, p
 - Write tests covering precedence: global < mode < project < env < CLI.
 - Implement merging with `yq` and apply overrides.
 
-7) Docs
+7) Docs (no deferral)
 - Add `docs/wrapper.md` with usage examples and config reference.
 - Update `README.md` quickstart: installation, basic flows.
+- Ensure docs updated in the same commit as features.
 
 ## Safety & Policies
 - Never overwrite without `--force`.
@@ -41,7 +42,8 @@ Purpose: Deliver Phase 1 (Crawl) MVP of CodexHelper: subcommands, scaffolding, p
 - Write outputs to `<project>/runs/<timestamp>/...`.
 - Minimal chat; read `.llm.md`, write both `.md` and `.llm.md` for collab artifacts.
 - Governance/Propagation: reflect future non-project-specific norms into `prompts/global/` and AGENTS templates; log in DevLog.
- - TDD default: write failing tests before implementing features; require unit/integration tests for all new functionality in this repo and generated projects.
+- TDD default: write failing tests before implementing features; require unit/integration tests for all new functionality in this repo and generated projects.
+ - Zero Technical Debt: safety first; no technical debt; always production-ready; do not defer tests/docs/refactors; use sub-agents as needed to maintain quality and speed.
 
 ## Acceptance Criteria
 - Inside this repo: `CodexHelper new-mode --name Demo` creates `modes/Demo/{mode.md,defaults.yaml}` (and optional `system.md`) and refuses overwrites without `--force`.
@@ -65,8 +67,5 @@ Accelerated (8 hours today):
 - Hour 3–4: Milestone 3 — new-mode scaffolder (tests first)
 - Hour 4–6: Milestone 4 — new-project scaffolder (tests first)
 - Hour 6–7: Milestone 5 — run: compose + invoke (tests first)
-- Hour 7–8: Milestone 6 — Config precedence (tests first); write quickstart docs
-
-Notes:
-- If behind schedule, defer non-essential docs to a follow-up commit and prioritize tested functionality.
+- Hour 7–8: Milestone 6 — Config precedence (tests first); finalize quickstart docs
  - Ongoing: Maintain/expand tests with each feature change (TDD).