30 lines
1.5 KiB
Markdown
30 lines
1.5 KiB
Markdown
# Audit — 2025-09-17
|
|
|
|
Summary
|
|
- Scope: Repo structure, governance compliance, plan alignment, CI/containers, TDD, zero-debt.
|
|
- Status: Mostly compliant; a few gaps noted with fixes proposed or applied.
|
|
|
|
Findings
|
|
- Governance
|
|
- One-way Q→P→Plan: compliant.
|
|
- Read `.llm.md`/write both: compliant in artifacts; continue practice.
|
|
- TDD: present; tests for CLI/guardrails/new-mode exist; proceed to cover remaining milestones.
|
|
- Zero debt: generally compliant; architecture doc added now to satisfy plan; keep docs/tests in lockstep.
|
|
- Clean root: compliant; marker removed; heuristic detection in place.
|
|
- Planning/architecture: docs/architecture.md added; maintain ADRs if decisions evolve.
|
|
- CI/containers: Gitea workflow + Docker Compose present; local parity script present.
|
|
- Repo Structure
|
|
- Organized under `collab/`, `docs/`, `prompts/`, `modes/`, `templates/`, `scripts/`, `meta/`, `.gitea/` — clean.
|
|
- Scaffolding Templates
|
|
- Added project CI/Docker templates and AGENTS.md. Missing: project `.gitignore` and `scripts/test.sh` template (recommended; add).
|
|
- Tests
|
|
- Repo tests pass (internal runner). Add Docker test run to CI already configured.
|
|
- Open Work vs Plan
|
|
- Pending: `new-project`, `run`, config precedence (`yq`), copying templates, `.gitignore` template, project scripts/test.sh.
|
|
|
|
Actions
|
|
- Add templates/project/_shared/{.gitignore,scripts/test.sh} [recommended ASAP].
|
|
- Implement remaining milestones via TDD; expand tests accordingly.
|
|
- Keep DevLogs updated for each change.
|
|
|