code-quality-lens

What problem does it solve?

Helps developers and review orchestrators identify maintainability barriers in code by assessing readability, complexity, error handling, and testability so future maintainers can work with confidence.

Core Features & Use Cases

• Complexity & Readability Assessment: Flags high cyclomatic/cognitive complexity, deep nesting, long methods, unclear naming, and opportunities for guard clauses or refactoring.
• Design Principle Evaluation: Checks for SOLID, SRP, DRY, KISS, YAGNI adherence and whether abstractions and composition are appropriate.
• Error Handling & Observability Review: Identifies swallowed exceptions, poor error categorization, missing context in logs, and gaps in observability.
• Testability Focus: Evaluates whether components support isolated testing (dependency injection, interfaces) and highlights coupling that impedes tests.
• Usage: Intended for integration into review orchestrators and automated review pipelines; not invoked directly by end users.

Quick Start

Ask the review orchestrator to run the code-quality-lens against the target files or repository path to produce a maintainability-focused report with confidence-rated findings.