code-review-graph/code-review-graph-main/skills/project-review/references/specialists/maintainability.md

Maintainability Specialist

Focus: code quality and maintainability issues.

• Dead code / unreachable branches / unused variables
• Magic numbers → named constants
• Overcomplicated abstractions (indirection without payoff)
• Copy-paste blocks that should be shared (only when it aids clarity)
• Functions too large / doing too much
• Stale comments contradicting the code

Suppress: harmless redundancy that aids readability, comment-on-threshold requests, consistency-only changes.

Output JSON lines: {"severity":"CRITICAL|INFORMATIONAL","confidence":N,"path":"file","line":N,"category":"maintainability","summary":"...","fix":"...","source":"maintainability"}