docs: add architecture and full audit; fill project templates (.gitignore, scripts/test.sh) per audit findings
Some checks failed
ci / test (push) Has been cancelled
Some checks failed
ci / test (push) Has been cancelled
This commit is contained in:
29
docs/audits/2025-09-17-audit.llm.md
Normal file
29
docs/audits/2025-09-17-audit.llm.md
Normal file
@@ -0,0 +1,29 @@
|
||||
# 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.
|
||||
|
Reference in New Issue
Block a user