readability-review

Code readability evaluation applies neuroscience-based principles to identify cognitive bottlenecks in source code. It analyzes local changes or specific paths, generating actionable findings to reduce mental effort during code reviews.

Yes, you can run readability analysis on specific file paths and glob patterns. The tool supports flexible scoping, allowing you to target local changes, specific files, or commit ranges to guide focused readability improvements.

The best way to check code readability before a merge is applying cognitive psychology principles to touched files. This surfaces complexity and mental effort, outputting prioritized findings and practical recommendations suitable for review checklists.

No, this code readability review does not modify your source files. It requires no file modifications, using lightweight heuristics to evaluate code segments and generate actionable findings that can be fed into code reviews.

Neuroscience applies to static analysis for software quality by using cognitive psychology principles to evaluate code segments. This approach surfaces complexity and identifies cognitive burdens that slow comprehension without changing the codebase.