docs: add architecture and full audit; fill project templates (.gitignore, scripts/test.sh) per audit findings

docs/audits/2025-09-17-audit.md

@@ -0,0 +1,34 @@
+# Audit — 2025-09-17
+
+Scope
+- Full audit of repository against governance rules, proposal/plan, and delivered code.
+
+Summary
+- Compliance is strong across governance (TDD, zero-debt, planning, clean root, CI/containers). Gaps are minor and fixable now.
+
+Findings
+- Governance compliance
+  - One-way Questions→Proposal→Plan process is followed; confirmations consolidated into the proposal.
+  - `.llm.md`-first reading and dual-write artifacts are present and used.
+  - TDD in effect (tests for CLI/guardrails/new-mode). Continue test-first for remaining milestones.
+  - Zero technical debt emphasized; architecture doc added to meet plan; docs kept current.
+  - Clean root enforced; marker removed; heuristic repo detection implemented and tested.
+  - Planning/architecture documented in `docs/architecture.md`; maintain ADRs if decisions change.
+  - CI/containers aligned with Gitea and local parity via Docker Compose; names explicit and cleanup performed.
+- Structure
+  - Root remains minimal. Subdirectories are coherent: `collab/`, `docs/`, `prompts/`, `modes/`, `templates/`, `scripts/`, `meta/`, `.gitea/`.
+- Templates
+  - Project templates include AGENTS.md and CI/Docker artifacts. Missing `.gitignore` and `scripts/test.sh` template — add now.
+- Tests
+  - Repo tests pass locally (internal runner). Docker-based runner available (`scripts/test.docker.sh`). CI workflow uses the same compose.
+- Open vs Plan
+  - Not yet implemented: `new-project`, `run`, YAML precedence (`yq`), project `.gitignore`, project scripts/test.sh, copying mode/global prompts.
+
+Recommendations (immediate)
+- Add `templates/project/_shared/.gitignore` with `runs/` and common ignores.
+- Add `templates/project/_shared/scripts/test.sh` mirroring repo test runner.
+- Proceed with TDD for remaining milestones; update docs/DevLogs at each step.
+
+Conclusion
+- The project is on track and adheres to governance. Address the small template gaps and continue TDD implementation.
+