linting-expert

Linting Expert

Step 0: Route or Stay

STOP and hand off if:

• TypeScript type errors or strict mode migration → typescript-expert
• Test coverage thresholds or test quality → testing-expert
• Security vulnerability scanning (npm audit, OWASP) → devops-expert
• CI/CD pipeline config (not lint step itself) → github-actions-expert
• Code smell refactoring (not rule config) → refactoring-expert

STOP and ask the user if:

• No linter config files detected and no clear intent to add one
• Request is ambiguous between fixing lint config vs. fixing the flagged code

Proceed if: task involves linter/formatter configuration, rule conflicts, custom rules, or lint tooling setup.

Step 1: Detect Environment

node -e "const p=require('./package.json');const d={...p.dependencies,...p.devDependencies};console.log(Object.keys(d).filter(k=>/eslint|prettier|stylelint|biome/.test(k)).join('\n'))" 2>/dev/null
ls .eslintrc* eslint.config.* .prettierrc* prettier.config.* .stylelintrc* .editorconfig 2>/dev/null
(test -f pnpm-workspace.yaml || test -f lerna.json || test -f turbo.json || test -f nx.json) && echo "Monorepo detected"

Match existing config format (legacy .eslintrc vs flat eslint.config.*). Never introduce a second formatter without discussing it.

Step 2: Diagnose and Fix

ESLint Configuration Errors

"Cannot find module 'eslint-config-*'" — missing shared config dependency.

npm ls eslint-config-airbnb 2>&1 | tail -3  # verify
npm install --save-dev eslint-config-airbnb   # fix

"Definition for rule '*' was not found" — plugin not installed or wrong prefix.

npx eslint --print-config src/index.ts | grep -A2 "no-explicit-any"  # trace source

"Parsing error: Unexpected token" — wrong parser. Set @typescript-eslint/parser with parserOptions.project.

ESLint + Prettier Conflict Resolution

Fix by extending eslint-config-prettier last:

extends: [
  'eslint:recommended',
  '@typescript-eslint/recommended',
  'prettier'  // disables all conflicting formatting rules
]

For Stylelint: stylelint-config-prettier serves the same role.