chore: update docs to reflect new rules

Author: iamzjohn

README.md

@@ -153,12 +153,19 @@ export default config
 
 ### Plugin system (rules)
 
-Pickier supports an ESLint-style plugin system for lint rules. You can load plugins, configure their rules per severity, and mark experimental rules as WIP to surface errors early.
-
-Concepts:
-- Plugin: `{ name: string, rules: Record<string, RuleModule> }`
-- RuleModule: `{ meta?: { docs?: string; recommended?: boolean; wip?: boolean }, check(content, context) => LintIssue[] }`
-- Configure rules via `pluginRules: { 'pluginName/ruleId': 'off' | 'warn' | 'error' | ['warn', options] }`
+Pickier supports an ESLint-style plugin system for lint rules organized into focused categories:
+
+**Available Plugins:**
+- `eslint/` - Legacy compatibility layer for ESLint rule names
+- `general/` - Error detection and possible problems (35+ rules)
+- `quality/` - Best practices and code quality (40+ rules)
+- `pickier/` - Sorting and import organization (17 rules)
+- `style/` - Code style enforcement (7 rules)
+- `ts/` - TypeScript-specific rules (9 rules)
+- `regexp/` - Regular expression safety (3 rules)
+- `markdown/` - Markdown documentation linting (53+ rules)
+
+Configure rules via `pluginRules: { 'pluginName/ruleId': 'off' | 'warn' | 'error' | ['warn', options] }`
 
 Define a plugin (example):
 

docs/README.md

@@ -109,14 +109,19 @@ Sometimes you need to break a rule temporarily. Use disable comments to suppress
 
 ### Plugin Architecture
 
-Pickier's rules are organized into plugins:
-- **Core** - Built-in rules always available (quotes, indent, etc.)
-- **Pickier** - General code quality rules (no-unused-vars, prefer-const, etc.)
-- **Sort** - Organize imports, objects, and other structures
-- **RegExp** - Catch problematic regular expressions
-- **Markdown** - Format markdown files consistently
-
-Each plugin can be configured independently, giving you fine-grained control.
+Pickier's rules are organized into plugins for better organization and discoverability:
+
+- **Core** - Built-in rules always available (quotes, indent, debugger, console)
+- **ESLint** (`eslint/`) - Legacy compatibility layer for ESLint rule names
+- **General** (`general/`) - Error detection and possible problems (no-undef, no-const-assign, array-callback-return, etc.)
+- **Quality** (`quality/`) - Best practices and code quality (eqeqeq, no-eval, no-var, prefer-arrow-callback, etc.)
+- **Pickier** (`pickier/`) - Sorting and import organization (sort-imports, sort-objects, import-dedupe, etc.)
+- **Style** (`style/`) - Code style enforcement (brace-style, curly, max-statements-per-line, etc.)
+- **TypeScript** (`ts/`) - TypeScript-specific rules (no-explicit-any, prefer-optional-chain, no-floating-promises, etc.)
+- **RegExp** (`regexp/`) - Regular expression safety (no-super-linear-backtracking, no-unused-capturing-group, etc.)
+- **Markdown** (`markdown/`) - Markdown documentation linting with 53+ rules
+
+Each plugin can be configured independently through the `pluginRules` configuration, giving you fine-grained control over your linting experience.
 
 ## Best Practices
 

docs/rules/general.md

@@ -0,0 +1,93 @@
+# general (built-in plugin)
+
+The `general` plugin provides error detection and possible problems rules. These rules catch common programming errors and potential bugs before they cause issues in production.
+
+## Available Rules
+
+All rules can be configured using either the `general/` or `eslint/` prefix (for backward compatibility).
+
+### Error Detection
+
+**Variable & Scope:**
+- `no-const-assign` - Disallow reassigning const variables
+- `no-redeclare` - Disallow variable redeclaration
+- `no-undef` - Disallow undeclared variables
+- `no-unused-vars` - Disallow unused variables ([docs](/rules/no-unused-vars))
+- `no-shadow` - Disallow variable declarations from shadowing outer scope
+- `no-use-before-define` - Disallow use of variables before they are defined
+
+**Functions & Callbacks:**
+- `array-callback-return` - Enforce return statements in array callbacks
+- `getter-return` - Enforce return statements in getters
+- `constructor-super` - Require super() calls in constructors
+- `no-constructor-return` - Disallow returning value from constructor
+
+**Control Flow:**
+- `for-direction` - Enforce "for" loop update clause moving counter in the right direction
+- `no-fallthrough` - Disallow fallthrough of case statements
+- `no-unreachable` - Disallow unreachable code after return, throw, continue, and break
+- `no-constant-condition` - Disallow constant expressions in conditions
+
+**Objects & Classes:**
+- `no-dupe-keys` - Disallow duplicate keys in object literals
+- `no-dupe-class-members` - Disallow duplicate class members
+- `no-duplicate-case` - Disallow duplicate case labels
+
+**Async & Promises:**
+- `no-async-promise-executor` - Disallow async promise executor
+- `no-promise-executor-return` - Disallow returning values from Promise executor
+
+**Comparisons:**
+- `no-compare-neg-zero` - Disallow comparing against -0
+- `no-self-assign` - Disallow assignments where both sides are exactly the same
+- `no-self-compare` - Disallow comparisons where both sides are exactly the same
+- `use-isnan` - Require calls to isNaN() when checking for NaN
+- `valid-typeof` - Enforce comparing typeof expressions against valid strings
+
+**Patterns & Syntax:**
+- `no-empty-pattern` - Disallow empty destructuring patterns
+- `no-sparse-arrays` - Disallow sparse arrays
+- `no-irregular-whitespace` - Disallow irregular whitespace
+- `no-loss-of-precision` - Disallow number literals that lose precision
+- `no-unsafe-negation` - Disallow negating the left operand of relational operators
+- `no-useless-catch` - Disallow unnecessary catch clauses
+
+**Modern JavaScript:**
+- `prefer-const` - Require const declarations for variables that are never reassigned ([docs](/rules/prefer-const))
+- `prefer-object-spread` - Prefer object spread over Object.assign
+- `prefer-template` - Require template literals instead of string concatenation
+
+## Configuration
+
+Configure rules in your `pickier.config.ts`:
+
+```ts
+import type { PickierConfig } from 'pickier'
+
+const config: PickierConfig = {
+  pluginRules: {
+    // Use general/ prefix (recommended)
+    'general/no-undef': 'error',
+    'general/no-unused-vars': 'error',
+    'general/prefer-const': 'error',
+
+    // Or use eslint/ prefix for compatibility
+    'eslint/no-undef': 'error',
+  },
+}
+
+export default config
+```
+
+## Best Practices
+
+- Keep error detection rules at `'error'` severity to catch bugs early
+- Use `prefer-const` to enforce immutability by default
+- Enable `no-unused-vars` to keep code clean and catch typos
+- Most of these rules don't have auto-fix, so they require manual correction
+
+## See Also
+
+- [Quality Plugin](/rules/quality.md) - Best practices and code quality rules
+- [Rules Index](/rules/index.md) - Complete rule catalog
+- [Plugin System](/advanced/plugin-system.md) - Plugin configuration guide