Documentation

eslint-plugin-ai-guardrails

ESLint guardrails for AI-assisted codebases. Stop AI-generated code from becoming long-term tech debt.

Quick Start

The fastest way to get started is with the CLI initializer:

npx eslint-plugin-ai-guardrails init

This creates or updates your ESLint config, tsconfig, and package.json scripts automatically.

⚙️

Configuration

All configuration options, ESLint v8/v9 setup, and team presets.

🔌

Integrations

Framework-specific setup guides for Vite, Next.js, NestJS, Express, and more.

🔧

Troubleshooting

Common issues and solutions for parser errors, config problems, and CI setup.

🤝

Contributing

How to contribute: local setup, architecture overview, rule authoring checklist.

📋

Changelog

Release history and notable changes for every version.

🏷️

Versioning & Release

Semantic versioning policy, release checklist, and pre-publish verification.

4 rules that target the specific patterns AI coding assistants produce.

max-file-lines

Prevent files from exceeding 300 lines

→

max-function-lines

Prevent functions/methods from exceeding 50 lines

→

no-orphan-todos

Require TODO/FIXME/HACK to include a tracking reference

→

no-ai-obvious-comments

Detect comments that just repeat the following code

→