dotnet-eslint

ESLint for Frontend Assets in .NET Repositories

Trigger On

• the repo has package.json, eslint.config.*, .eslintrc*, tsconfig.json, or JS/TS/React frontend files
• the user asks for JavaScript or TypeScript linting, React rule enforcement, import hygiene, or unsafe frontend patterns
• CI should fail on frontend lint findings instead of relying on editor-only feedback

Do Not Use For

• CSS ownership by itself; route that to dotnet-stylelint
• HTML-only checks on static output; route that to dotnet-htmlhint
• repos that intentionally standardized on Biome as the only JS or TS formatter-linter, unless migration or comparison is explicitly requested

Inputs

• the nearest AGENTS.md
• package.json
• eslint.config.* or .eslintrc*
• tsconfig.json when TypeScript or type-aware rules are involved

Workflow

1. Detect ownership first:
   • existing ESLint config
   • package manager and workspace layout
   • framework packages such as React, Next.js, Vue, or plain TypeScript
2. Keep ESLint as the semantic lint owner for JS and TS files when the repo needs rich plugin ecosystems or framework-specific rules.
3. Prefer checked-in local devDependencies over global installs so CI and local runs match.
4. Add narrow scripts to package.json, for example:
   • lint: eslint .
   • lint:fix: eslint . --fix
5. Scope auto-fix runs before broad rewrites:
   • fix a bounded folder or glob first
   • rerun the linter
   • rerun the frontend build or tests if the repo has them
6. If the repo wants type-aware rules, verify the target files are covered by the intended tsconfig.json before enabling heavier rules.
7. Do not hide noise by mass-disabling rules. Fix code, narrow scope, or phase severity deliberately.

Bootstrap When Missing

1. Detect current state:
   • rg --files -g 'package.json' -g 'eslint.config.*' -g '.eslintrc*' -g 'tsconfig.json'
   • rg -n '"eslint"|"@typescript-eslint"|"eslint-plugin-" --glob 'package.json' .
2. Prefer a repo-local install:
   • npm install --save-dev eslint
3. Add framework-specific plugins only when the repo actually uses the framework.
4. Create or refine eslint.config.js or eslint.config.mjs instead of leaving setup implicit.
5. Add repeatable commands to AGENTS.md and package.json, then verify with:
   • npx eslint .
   • npx eslint . --fix
6. Return status: configured if the repo now has a working lint gate, or status: improved if existing setup was tightened.
7. Return status: not_applicable only when another documented tool already owns JS or TS linting and migration is not requested.