What problem does it solve?
It prevents inconsistent code quality by documenting and enforcing exactly when linting runs, which rules are safe to auto-fix, and how to handle project gaps without masking real issues.
Core Features & Use Cases
- Lint on file write: Auto-fixes formatting and safe lint issues per language (Biome for JS/TS/JSON/CSS, Ruff for Python, rustfmt for Rust formatting, gofmt for Go formatting).
- Commit-time gates: Fast staged-only validation to block bad commits early while pushing heavier checks to task boundaries.
- Clear guidance for disables: A decision tree for when to inline-disable rules vs updating tool config vs changing code patterns.
- Diagnostics recipes: Check-only commands to investigate failures without modifying files.
Quick Start
Use the lint policy to apply the correct hook behavior for your language (on-write auto-fix vs staged commit checks vs task-completed heavy validators) and follow the disable decision tree with justification.