governance: keep repository root clean; remove marker file; implement repo detection via structure heuristic; update tests and system prompts/templates

README.md

@@ -1,3 +1,18 @@
-# ChatGPTScaffolding
+# ChatGPTScaffolding / CodexHelper
 
-Scaffolding (prompts/personas/modes/rules etc) around codex-cli. Tuned for @ReachableCEO needs as a solo entrepreneur. Developed from scratch in an afternoon after three weeks of intense AI usage across multiple providers/systems.
+Scaffolding (prompts/personas/modes/rules etc) around codex-cli. Tuned for @ReachableCEO needs as a solo entrepreneur.
+
+CodexHelper adds:
+- Modes (global/mode/project prompts)
+- Project scaffolding
+- Prompt composition and safe defaults
+- Governance: TDD, zero technical debt, plan-first via Questions → Proposal → Plan
+
+Status: Phase 1 in progress — `new-mode` implemented; `new-project` and `run` coming next.
+
+Quickstart (dev)
+- Run tests: `scripts/test.sh` (uses bats if available)
+- Show help: `./CodexHelper --help`
+- Create a demo mode (in this repo): `./CodexHelper new-mode --name Demo`
+
+See `docs/wrapper.md` and `prompts/global/` for details and governance rules.