What problem does it solve?
Provides a focused, high-bar Python code-review persona that detects missing type information, non-Pythonic structure, regression risks, and resource/exception handling issues in diffs touching Python code, helping maintainers avoid subtle regressions and long-term maintenance debt.
Core Features & Use Cases
- Type and shape scrutiny: Flags public code paths that lack meaningful annotations or abuse loose typing like dict[str, Any].
- Structural and readability checks: Identifies unnecessary ceremony, poor responsibilities, and name/boundary issues that reduce clarity.
- Regression and safety focus: Highlights changed exception handling, removed branches, or resource management regressions with confidence calibration and actionable remediation suggestions.
- Use Case: Run on a pull request that modifies several Python modules to produce a JSON-formatted review highlighting missing annotations, risky refactors, and test gaps.
Quick Start
Review the provided Python diff and return a JSON findings report that lists issues, confidence levels, residual risks, and testing gaps.