governance: zero technical debt, production-ready always; safety first across system prompts, AGENTS templates, proposal, and plan
This commit is contained in:
@@ -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).
|
||||
|
Reference in New Issue
Block a user