devravik/engineering-intelligence / .claude/skills/engineering-intelligence
engineering-intelligence
UnverifiedEngineering quality control for Claude Code (detect, attribute, prioritize, repair, verify).
Engineering Intelligence (Claude Code Skill)
name: engineering-intelligence description: Review and improve AI-generated software for architecture, security, APIs, databases, testing, complexity, UI quality, and AI slop. Uses evidence, project context, and verification.
Engineering Intelligence (EI)
Engineering Intelligence provides engineering quality control for AI coding agents.
Rather than relying on unbounded prompt prose or intuition, EI operates on a firm foundation: Deterministic evidence + Project context + LLM reasoning + Baseline attribution + Regression tests.
Installation and Trust
Engineering Intelligence uses the ei CLI from the official @devravik/engineering-intelligence npm package.
Installation
npm install -g @devravik/engineering-intelligence
Verification
Verify the installation and binary provenance:
ei --version
which ei
The CLI source and release history are maintained in:
- GitHub Repository: https://github.com/devravik/engineering-intelligence
- Official npm Package: https://www.npmjs.com/package/@devravik/engineering-intelligence
Do not install an unrelated executable named ei or execute an unverified ei binary from an untrusted source.
Self-Verifying CLI Protocol
Before executing commands, the agent verifies the ei CLI binary:
- Locate
eiusingwhich ei(orwhere eion Windows). - Verify provenance with
ei --version. The output must declare@devravik/engineering-intelligenceor theei <version>release. - If
eicannot be established as the authentic Engineering Intelligence CLI, stop and prompt the user to install@devravik/engineering-intelligence(or execute vianpx -y @devravik/engineering-intelligence <command>). - Always run the
eiexecutable provided by@devravik/engineering-intelligence.
The Staff Engineer Protocol
When modifying, reviewing, or verifying code:
1. Grounding (Context)
└── Read .ei/PROJECT.md and .ei/ARCHITECTURE.md. Honor established boundaries.
2. Deterministic Detection
└── Run the `ei` executable provided by `@devravik/engineering-intelligence`:
Execute `ei detect --changed` (or `ei detect <target>`).
└── Obtain exact, machine-verified findings with evidence hashes.
3. Baseline Attribution
└── Distinguish legacy debt (BASELINE) from newly introduced debt (NEW).
└── Never blame the current session for existing codebase debt.
4. Matrix Review & Disposition
└── Derive the terminal disposition mechanically from evidence:
- BLOCKERS > 0 ➔ BLOCK
- UNKNOWN > 0 ➔ BLOCK (UNKNOWN != PASS)
- FIX > 0 ➔ FIX
- Zero issues ➔ SHIP
5. Actionable Simplification & Repair
└── Eliminate single-use abstractions, pass-through factories, and echo comments.
└── Re-run verified `ei detect` to verify behavioral invariance and clean disposition.
Command Routing
When the user invokes slash commands or asks for quality control, run the verified ei executable provided by @devravik/engineering-intelligence (or reference local manuals):
/review(orei review): Generates the structured discipline finding matrix and derived disposition. (See references/commands.md)/simplify(orei simplify): Executes the 8-step anti-entropy simplification loop. (See references/commands.md)/impact(orei impact <symbol>): Traverses call graphs and generates the change risk dependency graph. (See references/commands.md)/ship(orei ship): Enforces the 10-point production readiness release gate. (See references/commands.md)/ui(orei ui [surface]): UI Intelligence Engine — runs rendered-interface inspection, 5-pass critique, anti-slop distillation, and multi-viewport verification. (See references/commands.md)
Core Invariants
- Evidence Before Judgment: A finding requires physical evidence (file, line, code snippet, evidence hash).
- UNKNOWN != PASS: An unverified critical path or un-run test is a blocker, not a pass.
- No Unjustified Waivers: Waivers in
.ei/ignores.jsonor inline comments require an explicit--reason. - Behavior Belongs in Tests: Behavioral contracts live in the regression test suite (
npm test), not endlessly growing instruction files.
Active Deterministic Rules
- SEC-001 (Security): Detects hardcoded secrets, private keys, and high-entropy authentication tokens with confidence tiering.
- SEC-002 (Security): Detects raw SQL queries constructed using direct string interpolation with data-flow risk classification.
- ARCH-001 (Architecture): Detects single-implementation interfaces that add indirection without supporting polymorphism or architectural inversion.
- ARCH-002 (Architecture): Detects multiple services or modules with overlapping responsibilities and duplicated public methods.
- ARCH-003 (Architecture): Detects direct circular dependencies between modules.
- ARCH-004 (Architecture): Detects architectural boundary violations such as direct database persistence calls in client UI components.
- ARCH-005 (Architecture): Detects module-level request-specific mutable state in server routes mutated across concurrent requests.
- CODE-001 (CodeQuality): Detects identical multi-line code blocks duplicated across multiple files.
- CODE-002 (CodeQuality): Detects exported functions or classes that are never referenced across the codebase.
- CODE-003 (CodeQuality): Detects pass-through wrapper functions that merely delegate calls 1:1 without value-add.
- CODE-004 (CodeQuality): Detects production dependencies declared in package.json that are never imported anywhere in the project.
- CODE-005 (CodeQuality): Detects redundant optional chaining or null assertions immediately inside non-null guard blocks.
- CODE-006 (CodeQuality): Detects compiler suppression directives (@ts-ignore, @ts-nocheck) and gratuitous "as any" type casts in application code.
- CODE-007 (CodeQuality): Detects floating, unawaited asynchronous promises on known async APIs in mutating handlers.
- API-001 (Security): Detects mutating API endpoints or server actions that modify state without authorization checks.
- API-002 (CodeQuality): Detects swallowed exceptions in empty or unhandled catch blocks that destroy stack traces.
- API-003 (Security): Detects breaking modifications to public API route signatures or contract definitions.
- API-004 (CodeQuality): Detects redundant validation checks performed immediately after schema parser validation.
- API-005 (Architecture): Detects outgoing raw HTTP requests executed without an explicit timeout, AbortSignal, or configured client wrapper.
- DB-001 (Database): Detects foreign key relation columns declared in SQL or schemas without accompanying indexes.
- DB-002 (Database): Detects database or ORM queries invoked synchronously inside iteration loops.
- DB-003 (Database): Detects table-locking migrations that add NOT NULL columns without DEFAULT values.
- DB-004 (Database): Detects irreversible schema operations such as DROP TABLE or DROP COLUMN without explicit waivers.
- DB-005 (Database): Detects potential multi-mutation consistency boundaries across entities executed without an atomic transaction.
- TEST-001 (Testing): Detects source files modified in changes without corresponding test updates.
- TEST-002 (Testing): Detects weak or tautological test assertions that simulate test coverage without verifying behavior.
- TEST-003 (Testing): Detects services with critical error throws whose test files test only happy paths.
- TEST-004 (Testing): Detects committed disabled or focused test cases (.skip, .only, xit, fit) that bypass or silence test suites.
- SLOP-001 (Slop): Detects pass-through Factory classes that merely wrap single concrete class instantiations.
- SLOP-002 (Slop): Detects tautological echo comments that restate the code line verbatim without domain context.
- SLOP-003 (Slop): Detects extensible plugin or strategy registries that maintain exactly one registered implementation.
- SLOP-004 (Slop): Detects phantom environment variables used in code that are missing from .env.example documentation.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 467k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |