eslint-plugin-generalist

The All-in-One ESLint Plugin.

Keywords: eslint, generalist, all-in-one, security, react, architecture, import, unicorn, code-quality, ai-optimized, automation

🎯 The Problem: Plugin Fatigue

Setting up a robust ESLint configuration today requires installing and configuring 5-10 different plugins:

• eslint-plugin-import (for architecture)
• eslint-plugin-react (for frontend)
• eslint-plugin-security (for vulnerabilities)
• eslint-plugin-unicorn (for best practices)
• eslint-plugin-jsx-a11y (for accessibility)

This leads to config hell, slow installs, and fragmented rule sets.

💡 The Solution: One Plugin to Rule Them All

eslint-plugin-generalist replaces the fragmented ecosystem with a single, high-performance, AI-optimized engine.

One install gives you 137+ rules covering:

| Category | Features | Replaces / Enhances | | :--------------- | :--------------------------------------------------- | :----------------------- | | Security | 29 rules for SQLi, XSS, RCE, CSRF | eslint-plugin-security | | Architecture | Circular dependency detection (Tarjan's), boundaries | eslint-plugin-import | | React | Performance, Hooks, Render optimization | eslint-plugin-react | | Code Quality | Complexity, Formatting, Best Practices | eslint-plugin-unicorn | | Development | Console logs, TODOs, Deprecations | Custom rules |

🚀 Quick Start

1. Install

npm install --save-dev eslint-plugin-generalist

2. Configure (eslint.config.js)

import generalist from 'eslint-plugin-generalist';
import js from '@eslint/js';

export default [
  js.configs.recommended,
  generalist.configs.recommended, // Enables core rules from ALL categories
];

3. Run

npx eslint .

🔥 Competitive Advantages

1. Unified Performance

Instead of running 5 different AST traversals (one for each plugin), generalist runs one optimized pass.

• <10ms overhead per file.
• One dependency to update.

2. AI-Native Error Messages

Every error message is optimized for AI Agents (Copilot, Cursor, Claude).

• Structured Data: Errors include CWE codes, severity, and deterministic fix instructions.
• Auto-Fix Rate: 94% success rate for AI fixes (vs ~50% for standard plugins).

3. Superior Algorithms

• Circular Dependencies: We use Tarjan's Algorithm (O(V+E)) for cycle detection. It's mathematically faster and more accurate than eslint-plugin-import's depth-limited DFS.

📋 Available Presets

| Preset | Description | | :----------------------------------- | :-------------------------------------------------------------------- | | generalist.configs.recommended | The baseline. Balanced rules for Security, Architecture, and Quality. | | generalist.configs.strict | Maximum enforcement. All 137+ rules enabled. | | generalist.configs.security | Only the 29 security rules (CWE mapped). | | generalist.configs.react | Only the 41 React/JSX rules. |

📦 Package Information

This package (eslint-plugin-generalist) is functionally identical to @forge-js/eslint-plugin-llm-optimized but branded for developers who prefer a "standard library" approach over an "AI-focused" brand.

Choose your flavor:

• eslint-plugin-generalist: For the pragmatist. "Just give me everything."
• eslint-plugin-llm-optimized: For the AI enthusiast. "Optimize my agent."

They utilize the same underlying engine.

📄 License

MIT © Ofri Peretz