ReviewToolkits/code-review-toolkit

ReviewToolkits/code-review-toolkit

Agent

Use this agent to review the public API surface of a Python project — naming consistency, parameter conventions, return type patterns, and whether the API is predictable and learnable from a user's perspective. Especially valuable for tools and libraries that have both a CLI interface and a programmatic API. This…

ReviewToolkits/code-review-toolkit

Agent

Use this agent to map the structure, dependencies, and module boundaries of a Python codebase. This is the foundational analysis agent — its output feeds into other agents as context for richer analysis. Use it when exploring an unfamiliar codebase, before running other code-review-toolkit agents, or when you need to…

ReviewToolkits/code-review-toolkit

Agent

Use this agent to find the most complex code in a Python codebase and suggest simplifications. This agent combines hotspot detection (finding where complexity concentrates) with simplification analysis (how to reduce it). It measures multiple dimensions of complexity — nesting depth, function length, parameter count…

ReviewToolkits/code-review-toolkit

Agent

Use this agent to scan a Python codebase for inconsistencies in coding patterns, style, and conventions. Unlike a PR code-reviewer that checks changes against rules, this agent compares how different parts of the codebase handle the same concerns and identifies divergence. It works both inductively (discovering…

ReviewToolkits/code-review-toolkit

Agent

Use this agent to find unused code in a Python codebase — unused imports, unreferenced functions, orphan files, unreachable branches, and stale feature flags. Dead code creates noise, increases maintenance burden, and can confuse developers into thinking unused code paths are important. This agent uses static analysis…

ReviewToolkits/code-review-toolkit

Agent

Use this agent to audit documentation quality across a Python codebase — docstrings, inline comments, module-level documentation, and README accuracy. It checks for stale comments, undocumented public APIs, misleading documentation, and comment rot. Unlike the PR-focused comment-analyzer, this agent surveys…

ReviewToolkits/code-review-toolkit

Agent

Use this agent to perform deep temporal analysis of a codebase. It runs LAST in the explore pipeline and uses output from all other agents alongside git history to perform fix completeness review, similar bug detection, new feature review, churn×quality risk matrix, historical context annotation of other agents'…

ReviewToolkits/code-review-toolkit

Agent

Use this agent to provide temporal context for all other agents by analyzing git history. It runs the analysis script and produces churn metrics, recent change classifications, co-change clusters, and per-module stability ratings. This is the temporal counterpart to architecture-mapper — it runs first in the explore…

ReviewToolkits/code-review-toolkit

Agent

Use this agent to extract the defect-grade signal from a linter run and turn it into review findings — and, more valuably, into new bug shapes. Backed by runlintrules.py, which runs a pinned, explicitly-tiered ruff selection (tier 1 = "the code is wrong", tier 2 = "likely a defect") rather than a style pass. It merges…

ReviewToolkits/code-review-toolkit

Agent

Use this agent to find places where a Python codebase solves the same problem in different ways. While the consistency-auditor focuses on style and convention divergence, this agent focuses on behavioral pattern divergence — where the same concern (configuration loading, resource cleanup, serialization, CLI argument…

ReviewToolkits/code-review-toolkit

Agent

Use this agent to audit out-of-code documentation (README, CLAUDE.md, CONTRIBUTING.md, configuration files) for accuracy against the actual codebase. Unlike the documentation-auditor (which covers in-code docstrings and comments), this agent focuses on external-facing documentation. It has three concrete, verifiable…

ReviewToolkits/code-review-toolkit

Agent

Use this agent to find concrete correctness defects in Python code — the pitfalls that silently produce wrong results rather than raising. Covers mutable default arguments, late-binding closures in loops, unreachable except ordering, return inside finally, eq without hash, mutation during iteration, the asyncio family…

ReviewToolkits/code-review-toolkit

Agent

Use this agent to scan a Python codebase for silent failures, inadequate error handling, and inappropriate fallback behavior. Unlike the PR-focused version, this agent traverses all error handling in scope rather than just reviewing a diff. It systematically finds every try/except, bare except, swallowed exception…

ReviewToolkits/code-review-toolkit

Agent

Use this agent to catalog technical debt in a Python codebase — TODOs, FIXMEs, HACKs, deprecated API usage, pinned workarounds, and deferred decisions. It collects, categorizes, and ages debt items using git blame to distinguish fresh debt from ancient debt. Produces an actionable inventory for sprint planning or…

ReviewToolkits/code-review-toolkit

Agent

Use this agent to analyze test coverage quality and completeness across an existing Python codebase. Unlike a PR test reviewer that checks whether new changes are tested, this agent correlates source modules with test files, identifies undertested modules, and assesses behavioral coverage without running tests. It…

ReviewToolkits/code-review-toolkit

Agent

Use this agent to find bugs by treating tests as invariant specifications. It reads existing tests to extract what developers believe should be true, maps those beliefs to the code under test AND structurally similar code, then checks whether the invariants hold on untested paths and analogous functions. Unlike…

ReviewToolkits/code-review-toolkit

Agent

Use this agent to analyze type design quality in a Python codebase — type hint coverage, dataclass/TypedDict/NamedTuple design, Protocol usage, Any overuse, and invariant enforcement. Adapted for Python's gradual typing system where not everything needs annotations and the trade-offs between typing approaches differ…

ReviewToolkits/code-review-toolkit

Agent

Use this agent to find defects that a type checker can prove — and, more importantly, to find annotations that have silently stopped checking anything. Backed by checktyping.py, which runs mypy with the project's own config plus a labelled --disallow-any-unimported second pass. Its signature finding is the phantom…