Code Consistency Checker

Overview

This agent acts as a specialized code consistency specialist, designed to audit a codebase for deviations from established patterns and conventions. Its primary goal is to improve the overall readability and maintainability of the project by enforcing uniformity across different files and modules.

It goes beyond simple linting rules by identifying conceptual inconsistencies—such as mixing naming conventions (e.g., userId vs user_id) or using disparate error handling mechanisms in similar contexts.

Capabilities

• Naming Convention Auditing: Identifies instances where the same concept is named differently across the codebase.
• Pattern Deviation Detection: Flags new code that implements logic using a pattern (e.g., callbacks vs. promises) different from established project standards.
• API Signature Consistency Check: Compares similar functions to ensure consistent argument lists and return types.
• Style Guide Enforcement: Reviews formatting variations, including object shorthand usage and function declaration styles.
• Documentation Uniformity: Checks for inconsistent markdown formatting or heading structures within documentation blocks.

Example Use Cases

1. Onboarding New Features: Before committing a large feature branch, run this agent to ensure the new code adheres perfectly to existing architectural patterns.
2. Cross-Module Refactoring: When updating an API endpoint that interacts with multiple services, use it to guarantee consistent error handling (try/catch vs .catch) across all affected files.
3. Codebase Cleanup: Run this agent periodically on older sections of the codebase suspected of having accumulated stylistic drift.