pilot-shell vs ESLint

Analyzes user intent via the /spec command, automatically classifies tasks as features or bugfixes, and generates structured implementation plans using a state machine dispatcher that routes to feature or bugfix workflows. The planning phase uses Claude to decompose requirements into atomic steps with estimated complexity, then presents a human-reviewable plan before implementation begins. This enforces upfront design thinking and prevents Claude Code from diverging into ad-hoc implementations.

Unique: Uses a dispatcher-based state machine that routes feature and bugfix tasks through separate workflows (feature: plan → implement → verify; bugfix: plan → implement → regression test), with mandatory human approval gates between planning and implementation phases. This architectural pattern prevents Claude from skipping the planning phase entirely.

vs alternatives: Unlike Claude Code alone (which implements immediately) or generic AI agents (which lack project context), Pilot Shell enforces structured planning with automatic task classification and blocks implementation until a human approves the plan.

During the implementation phase of /spec workflows, generates test cases before code is written, then validates that all generated code passes those tests before marking tasks complete. The system uses a verification agent that runs test suites and blocks code merges if coverage or assertions are insufficient. This is enforced via hooks that intercept code changes and validate test presence before allowing commits.

Unique: Integrates test generation into the implementation phase via a hooks pipeline that intercepts code changes and validates test presence before allowing progression. Uses a verification agent that runs test suites and blocks code merges if tests fail or coverage is insufficient, making TDD non-optional rather than optional.

vs alternatives: Standard Claude Code has no built-in test enforcement; Pilot Shell's hooks pipeline and verification agent make test-first development automatic and mandatory, preventing developers from skipping tests even if they wanted to.

Pilot Shell injects project-specific context into Claude's system prompt at session start, including extracted conventions, relevant code patterns, and project rules from the semantic index. The context injection is selective and respects Claude's token budget — only the most relevant patterns are injected based on the current task, preventing context window overflow. The system uses a context monitor to track which files are most relevant to the current task and prioritizes injection of related patterns.

Unique: Uses a context monitor to selectively inject the most relevant project patterns into Claude's system prompt based on task scope, respecting token budgets by prioritizing high-impact patterns. This enables codebase awareness without exceeding context window limits, making large-codebase support practical.

vs alternatives: Unlike RAG systems that inject all matching documents (risking token overflow) or manual context setup (which is tedious), Pilot Shell's selective context injection uses task-aware heuristics to inject only the most relevant patterns, balancing context richness with token efficiency.

The verification phase includes an automated code review agent that checks for style violations, architectural inconsistencies, and deviations from project conventions. The agent uses the extracted project rules and conventions to validate that generated code follows established patterns. Code that violates style or architectural rules is flagged and can block merges, providing automated enforcement of code quality standards without requiring manual review.

Unique: Implements an automated code review agent that validates generated code against extracted project rules and conventions, providing architectural and style enforcement without manual review. The agent uses the same rules extracted by /sync and /learn, making reviews consistent with project standards.

vs alternatives: Unlike manual code review (which is slow and subjective) or linting tools alone (which only check syntax), Pilot Shell's code review agent understands project conventions and architectural patterns, providing semantic-level code quality assurance.

Pilot Shell persists session state (current task, implementation progress, test results, verification status) to disk, enabling recovery if a session crashes or is interrupted. The worker service maintains a session state file that tracks the current /spec task, implementation phase, and verification results. If a session is interrupted, the next session can resume from the last checkpoint, preventing loss of work and enabling recovery from failures.

Unique: Persists session state to disk via the worker service, enabling recovery from crashes and interruptions. Session state includes current task, implementation progress, test results, and verification status, allowing seamless resumption from the last checkpoint.

vs alternatives: Unlike Claude Code alone (which has no session persistence) or manual checkpointing (which is error-prone), Pilot Shell's automatic session persistence enables recovery from crashes without user intervention, making long-running tasks more reliable.

The /sync command builds a semantic search index of the entire codebase using embeddings, then stores project-specific context (architecture patterns, naming conventions, dependencies, test patterns) in a persistent memory store that survives across sessions. This context is automatically injected into Claude's context window at the start of each session, enabling Claude to understand project conventions without requiring manual context setup. The context monitor continuously tracks changes to key files and updates the index incrementally.

Unique: Uses a context monitor hook that tracks file changes and incrementally updates the semantic index, combined with a memory & console system that persists extracted conventions across sessions. The index is injected into Claude's context at session start, eliminating the need for manual context setup while staying within token budgets via selective injection of relevant patterns.

vs alternatives: Unlike Claude Code alone (which has no persistent memory between sessions) or generic RAG systems (which require manual indexing), Pilot Shell's /sync command automatically indexes the codebase and injects relevant context at session start, making project knowledge persistent without manual effort.

The /learn command captures non-obvious discoveries from the current session (e.g., 'this project uses a custom logger instead of console.log', 'all async functions must have timeout handling') and converts them into reusable skill files stored in ~/.pilot/skills/. These skills are automatically loaded into Claude's context for future sessions on the same project, and can be shared across teams via the /vault command. The system uses Claude to extract generalizable patterns from session interactions and format them as structured rules.

Unique: Converts session discoveries into structured skill files that are automatically loaded into Claude's context for future sessions, with a /vault integration for team-wide sharing. Unlike generic documentation, skills are machine-readable and directly injected into Claude's reasoning, making them immediately actionable.

vs alternatives: Standard Claude Code has no mechanism to capture and reuse project-specific patterns; Pilot Shell's /learn command converts ephemeral session insights into persistent, shareable skills that improve Claude's performance on future tasks in the same project.

The /vault command shares rules, commands, skills, hooks, and agents across a team by syncing them to a private Git repository. Each team member's local ~/.pilot/ and ~/.claude/ directories can be configured to pull from a shared vault repository, enabling centralized management of project conventions, custom hooks, and reusable agents. The system uses Git as the backing store and provides conflict resolution via simple merge strategies (last-write-wins or manual resolution).

Unique: Uses Git as the backing store for team knowledge, enabling decentralized sync with version history and audit trails. Rules, skills, hooks, and agents are stored as files in the vault repository and pulled into each team member's local ~/.pilot/ directory, making team knowledge portable and version-controlled.

vs alternatives: Unlike centralized knowledge bases (which require a server) or manual documentation (which gets out of sync), Pilot Shell's /vault uses Git for decentralized, version-controlled sharing of project-specific rules and agents, making team knowledge portable and auditable.

Executes ESLint rules against the active editor file as the user types or on file save, rendering violations as colored squiggles and inline decorations directly in the editor gutter. The extension hooks into VS Code's diagnostic API to push linting results from the ESLint library (installed locally or globally) into the editor's rendering pipeline, enabling immediate visual feedback without requiring manual linting commands.

Unique: Integrates directly with VS Code's native diagnostic API and editor rendering pipeline, allowing ESLint violations to appear as native squiggles and gutter decorations rather than as separate panel output; uses the ESLint library's rule engine directly without wrapping or re-implementing linting logic.

vs alternatives: Tighter VS Code integration than generic linting tools because it leverages VS Code's built-in diagnostic system and respects editor theme colors for error/warning rendering, whereas standalone linters require separate output parsing.

Automatically applies ESLint's `--fix` capability to the active file when saved, modifying the file in-place to correct fixable violations (e.g., formatting, semicolon insertion, import sorting). The extension triggers the ESLint library's fix mode on the save event, applies the corrected code back to the editor buffer, and updates diagnostics to reflect the post-fix state.

Unique: Leverages ESLint's native `--fix` API rather than implementing a separate formatting engine; integrates the fix operation into VS Code's save event lifecycle, allowing fixes to be applied transparently without user interaction or separate command invocation.

vs alternatives: More reliable than Prettier-only solutions because it respects ESLint rule configuration and can fix non-formatting issues (e.g., import sorting, variable naming); more integrated than running ESLint as a separate task because fixes are applied synchronously on save.

Caches linting results for files that have not changed, avoiding redundant ESLint execution and improving performance for large codebases. The extension tracks file modifications and only re-runs ESLint for changed files, reducing computational overhead and latency for real-time linting feedback.

Unique: Implements file-level caching to avoid redundant ESLint execution, tracking file modifications and only re-linting changed files; caching strategy is transparent to users and requires no configuration.

vs alternatives: More performant than re-linting all files on every change because it only processes modified files; more transparent than manual cache management because caching is automatic and invisible to users.

Maps ESLint rule severity levels (error, warning, off) to VS Code diagnostic severity levels (Error, Warning, Information), rendering violations with appropriate colors and icons in the editor. The extension translates ESLint's severity classification into VS Code's diagnostic system, enabling consistent visual representation across the editor and Problems panel.

Unique: Maps ESLint severity levels directly to VS Code's diagnostic API, enabling native severity rendering without custom UI; respects VS Code's theme and editor settings for diagnostic colors and icons.

vs alternatives: More integrated than custom severity rendering because it uses VS Code's native diagnostic system; more consistent than separate severity indicators because it leverages the editor's built-in visual language.

Aggregates all linting violations from the active file and workspace into VS Code's built-in Problems panel, displaying violations with severity levels (error, warning, info) and allowing filtering by severity. The extension pushes diagnostic data into VS Code's diagnostic collection, which automatically populates the Problems panel and respects the `eslint.quiet` setting to suppress info-level messages.

Unique: Uses VS Code's native diagnostic collection API to push ESLint violations into the Problems panel, allowing seamless integration with VS Code's built-in error aggregation and navigation UI rather than implementing a custom panel.

vs alternatives: More discoverable than inline-only linting because violations are visible in a dedicated panel even when the file is not in focus; more integrated than external linting tools because it uses VS Code's native UI rather than requiring a separate output window.

Automatically detects and loads ESLint configuration from either flat config format (`eslint.config.js`, `.mjs`, `.cjs`, `.ts`, `.mts`) or legacy format (`.eslintrc.*` in JSON, JS, YAML) based on what exists in the workspace. The extension respects the `eslint.useFlatConfig` setting to force flat config mode for ESLint 8.57.0+, and falls back to legacy config detection for older versions.

Unique: Implements automatic detection of both flat and legacy config formats without requiring explicit user configuration; uses the `eslint.useFlatConfig` setting to allow users to force flat config mode for ESLint 8.57+, enabling gradual migration from legacy to flat config.

vs alternatives: More flexible than tools that only support one config format because it handles both legacy and flat configs transparently; more user-friendly than requiring manual config path specification because it automatically discovers configs in standard locations.

Allows users to specify which file types should be linted by configuring the `eslint.validate` setting with an array of VS Code language identifiers (e.g., `["javascript", "typescript", "javascriptreact"]`). The extension checks each file's language identifier against the configured list before running ESLint, skipping linting for files not in the list.

Unique: Uses VS Code's language identifier system to filter files before linting, allowing granular control over which file types are processed; integrates with VS Code's language detection rather than implementing custom file type detection.

vs alternatives: More precise than file extension-based filtering because it respects VS Code's language detection (e.g., distinguishing between JavaScript and JSX); more flexible than ESLint's built-in ignore patterns because it operates at the extension level before ESLint is invoked.

Provides a `eslint.quiet` boolean setting that, when enabled, suppresses ESLint info-level diagnostic messages while preserving error and warning messages. The extension filters diagnostics before pushing them to VS Code's diagnostic collection, removing entries with severity below warning level.

Unique: Implements message filtering at the extension level after ESLint execution, allowing users to suppress info-level messages without modifying ESLint configuration or rules; provides a simple boolean toggle rather than complex filtering logic.

vs alternatives: Simpler than configuring ESLint rules to disable info-level messages because it requires only a single setting change; more effective than ESLint's built-in severity configuration because it applies uniformly across all rules.