initial commit

2026-04-16 11:36:48 +02:00
commit 60710fab20
30 changed files with 1460 additions and 0 deletions
@@ -0,0 +1,39 @@
+---
+name: review
+description: Audit the full codebase as a software architect. Score on 5 KPIs (Maintainability, Extensibility, Testability, Robustness, Clarity) and produce docs/review.md.
+---
+
+# Review
+
+Audit the codebase, score each KPI 0–10, and produce `docs/review.md`.
+
+## Process
+
+1. Run the test suite to verify baseline health and gather coverage stats.
+2. Analyze the codebase against the 5 KPIs below.
+3. Produce `docs/review.md` using the template in `assets/template.md`.
+
+## KPIs
+
+1. **Maintainability** — How easily can the system be debugged, modified, or understood?
+   Metrics: modularity, cohesion, coupling, readability, simplicity.
+
+2. **Extensibility** — How easily can new features be added without major refactoring?
+   Metrics: separation of concerns, dependency injection, use of interfaces/protocols.
+
+3. **Testability** — How easily can components be tested in isolation and as a whole?
+   Metrics: pure functions, mockability, dependency inversion.
+
+4. **Robustness** — How well does the system handle edge cases, errors, and real-world conditions?
+   Metrics: state management, predictability, fault tolerance.
+
+5. **Clarity** — How quickly can a new developer understand the system's design and purpose?
+   Metrics: documentation, consistent naming, clear abstractions.
+
+## Rules
+
+- Be specific — cite `file:line` or `file:function` when pointing out issues.
+- No filler — every bullet must be actionable or informative.
+- Always include your model/version in the reviewer field.
+- Do not modify any code. This is a read-only review.
+- Keep the write-up concise.