35 lines
1.9 KiB
Markdown
35 lines
1.9 KiB
Markdown
# 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.
|
|
|