Files
transcription/docs/reviews

Review Reports

Dated architecture and code review reports generated by .github/skills/python-code-reviewer/skill.md.

These files are not canonical authority. Everything in docs/reviews/** is a point-in-time observation, not a contract. Canonical intent lives in docs/index.md, docs/architecture.md, docs/requirements.md, docs/schema.md, docs/error_handling.md, and docs/invariant/**. When a report and a canonical document disagree, the canonical document wins until it is deliberately updated.

Naming: <YYYY-MM-DD>-code-review.md for review reports, and <YYYY-MM-DD>-remediation-handoff.md for the implementation plan derived from one.

Current

  • 2026-08-23-code-review.md — full review. 0 critical, 4 high, 5 medium, 11 low. All findings remediated. Retained as a record of the reasoning, not as a list of open work. Note that a few of its recommendations were wrong on contact and were corrected during implementation; the code and the guard tests are authoritative over the report text.