thermo-nuclear-code-quality-review

Audit pull request implementations for maintainability and structural regressions.

Updated May 22, 2026
One-click install
npx skills add https://github.com/paulbrittain/claude-team-kit --skill thermo-nuclear-code-quality-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: thermo-nuclear-code-quality-review
Source: https://github.com/paulbrittain/claude-team-kit/tree/main/skills/thermo-nuclear-code-quality-review
Command: npx skills add https://github.com/paulbrittain/claude-team-kit --skill thermo-nuclear-code-quality-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents maintainability regressions by forcing an unusually strict review of abstraction quality, giant-file growth, and spaghetti-condition creep in a PR’s implementation.

Core Features & Use Cases

  • Ambitious structural simplification: Pushes beyond cleanup into “code-judo” restructurings that delete complexity while preserving behavior.
  • Spaghetti and boundary enforcement: Flags ad-hoc conditionals, feature logic leakage into shared flows, and unclear type/contract boundaries.
  • File-size and modularity guardrails: Treats 1k+ line crossings and missing decomposition as a high-severity maintainability smell.

Quick Start

Use thermo-nuclear-code-quality-review to audit the current branch changes and demand a restructuring plan if the PR introduces spaghetti branching, leaks feature logic across boundaries, or grows files past healthy size limits.

Frequently Asked Questions about thermo-nuclear-code-quality-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prevent spaghetti code and maintainability regressions in a pull request?

To prevent spaghetti code and maintainability regressions, you need a rigorous code review that flags ad-hoc conditionals, feature logic leakage, and unclear type boundaries. It enforces structural simplification by prioritizing code-judo opportunities that delete complexity while preserving behavior.

What is the best way to enforce file decomposition and modularity guardrails during code review?

Enforcing file decomposition and modularity guardrails requires treating 1k+ line crossings and missing decomposition as high-severity maintainability smells. A strict audit blocks structural regressions and demands an explicit restructuring plan for architectural correction.

How do I audit abstraction quality and boundary cleanliness in my codebase?

Auditing abstraction quality and boundary cleanliness involves evaluating a PR's implementation for structural simplification and feature logic leakage into shared flows. It requires direct review that blocks unclear contract boundaries and enforces explicit guidance for architectural correction.

Can I use a strict code review process to demand structural simplification for giant files?

Yes, a strict code review process can demand structural simplification for giant files by applying file-size hygiene guardrails. It treats files growing past healthy size limits as a high-severity maintainability smell and blocks the PR until decomposition is applied.

When should I demand a code-judo restructuring plan instead of basic code cleanup?

You should demand a code-judo restructuring plan instead of basic cleanup when a PR introduces spaghetti branching or leaks feature logic across boundaries. It pushes beyond standard cleanup into restructurings that eliminate complexity while preserving behavior.