thermo-nuclear-code-review
Thermo-Nuclear Code Quality Review
An unusually strict review focused on structural quality, architectural health, abstraction cleanliness, and codebase maintainability. This is not a correctness review — it asks whether the code is making the codebase better or worse.
The guiding principle is code judo: actively search for restructurings that preserve behavior while making the implementation dramatically simpler, smaller, more direct, and more elegant. Do not stop at "this could be a bit cleaner." Look for moves where whole branches, helpers, modes, conditionals, or layers disappear entirely. Prefer the solution that feels inevitable in hindsight.
Scope — What This Review IS and IS NOT
| This review covers | This review does NOT cover |
|---|---|
| Structural quality and architectural health | Correctness bugs (use a dedicated correctness-focused review) |
| Abstraction quality and decomposition | Style nits and formatting |
| Complexity growth and spaghetti detection | Test coverage gaps |
| Layer violations and architectural drift | Security vulnerabilities |
| File size and modularity | Performance micro-optimizations |
| Type boundary and contract cleanliness | Linting violations |
If a correctness review or repo-specific rule enforcement is needed, run that separately. This skill is the architectural conscience.