Maintainability & Understandability Fitness Review

Analyze the codebase for maintainability and understandability fitness. Maintainability is a core quality attribute (ISO 25010); simplicity and understandability are means to achieve it. This skill evaluates structural complexity, comprehensibility, technical debt, and code smells with concrete metrics where observable.

Reference: Fundamentals of Maintainability — see also Fundamentals

Domain Knowledge

• references/rubric.md is the scoring source: the single threshold table, severity definitions, 1-10 anchors per dimension, the N/A rule, and the overall-score formula. Read it first; it is short.
• references/checklist.md is what to inspect during the workflow steps. Its numbers match the rubric's threshold table.
• references/wisdom.md is optional background, auto-generated from Fundamentals of Maintainability. It holds no rubric. Grep it by heading for a specific question (e.g. Mistake 3: Copy-Paste); never read it whole.
• scripts/metrics.py measures what the rubric thresholds need, so the Metrics Summary is measured rather than estimated.

Configuration

Invoke the resolver CLI to obtain effective weights and thresholds for the review target. Never load fitness-config.json directly.