boma/docs/reviews
sjat 64f1e821d8 docs(review): 2026-06-14 repo audit — M4a doc drift + Traefik→Caddy lag
11 safe auto-fixes (docs/comments only): reverse_proxy meta stale DNS-01
description, base/playbooks/scripts/terraform/public_dns README build-state,
CAPABILITIES reverse-proxy Traefik→Caddy, README ADR list → 024, TF cax11→cx23
stamps, public_dns wildcard DNS-01→HTTP-01 comment. 29 open findings reported.
make lint green. No stale-deferred (ADR-011 open questions still open).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-14 18:37:54 +02:00
..
2026-05-30-findings.json review-repo: harden scanner, apply safe fixes, record first review 2026-05-30 19:10:58 +02:00
2026-05-30-review.md review-repo: harden scanner, apply safe fixes, record first review 2026-05-30 19:10:58 +02:00
2026-06-05-findings.json review-repo: 2026-06-05 report (4 auto-fixed, 12 open) 2026-06-05 18:24:39 +02:00
2026-06-05-review.md review-repo: 2026-06-05 report (4 auto-fixed, 12 open) 2026-06-05 18:24:39 +02:00
2026-06-11-findings.json docs(review): 2026-06-11 repo audit — fix build-wave doc drift 2026-06-11 14:48:00 +02:00
2026-06-11-review.md docs(review): 2026-06-11 repo audit — fix build-wave doc drift 2026-06-11 14:48:00 +02:00
2026-06-14-findings.json docs(review): 2026-06-14 repo audit — M4a doc drift + Traefik→Caddy lag 2026-06-14 18:37:54 +02:00
2026-06-14-review.md docs(review): 2026-06-14 repo audit — M4a doc drift + Traefik→Caddy lag 2026-06-14 18:37:54 +02:00
latest.md docs(review): 2026-06-14 repo audit — M4a doc drift + Traefik→Caddy lag 2026-06-14 18:37:54 +02:00
README.md Add /review-repo command with deterministic pre-scan and reviews store 2026-05-30 18:56:01 +02:00

docs/reviews/

Tracked output of the /review-repo command (one set of files per run). This is an audit trail — committed, not hand-edited. The command writes these files; don't edit them yourself.

Files per run

File Purpose
<YYYY-MM-DD>-review.md Human-readable report
<YYYY-MM-DD>-findings.json Machine-readable findings — used to diff new/recurring/resolved on the next run, and as the cron email payload
latest.md A copy of the most recent report (stable path for quick reference / email)

What a report contains

  • Run metadata — date and the commit SHA reviewed.
  • Summary — finding counts by dimension and severity.
  • Auto-fixes applied — what the run fixed (safe/obvious only), with a file list.
  • Open findings — prioritised, grouped by dimension; each with a location, a suggested fix, and a new / recurring / resolved tag (vs the previous run).
  • Follow-up prompt — a copy-pasteable prompt to act on the open findings.

The four review dimensions and the auto-fix safety rules live in .claude/commands/review-repo.md.