…rcer

Implements Karpathy's 4 coding principles (Think Before Coding, Simplicity
First, Surgical Changes, Goal-Driven Execution) as an active enforcement
plugin, not just passive guidelines. Derived from Karpathy's X post on LLM
coding pitfalls but goes far beyond the source material with automated
detection tools, a review agent, and CI integration patterns.

Differentiator vs forrestchang/andrej-karpathy-skills (prompt-only, single
SKILL.md): this version ships real tooling that DETECTS violations instead
of just documenting principles.

Plugin contents (engineering/karpathy-coder/):
- SKILL.md with `context: fork` for skill chaining
- 4 Python tools (stdlib only):
  - complexity_checker.py — cyclomatic complexity, class density, nesting
    depth, function length, premature abstractions (Principle #2)
  - diff_surgeon.py — diff noise ratio: comment-only changes, whitespace,
    style drift, drive-by refactors, quote-style swaps (Principle #3)
  - assumption_linter.py — detects "just", "obviously", "should work",
    vague actions, unscoped users, missing format specs (Principle #1)
  - goal_verifier.py — scores plan steps 0-3 for verification quality,
    flags vague criteria, checks for final verification (Principle #4)
- 1 sub-agent: karpathy-reviewer (runs all 4 principles against a diff)
- 1 slash command: /karpathy-check (dispatches the reviewer)
- 1 pre-commit hook: karpathy-gate.sh (non-blocking, warns on violations)
- 3 reference docs: karpathy-principles.md (full context + when to relax),
  anti-patterns.md (10+ before/after examples), enforcement-patterns.md
  (Husky, pre-commit framework, GitHub Actions CI integration)
- .claude-plugin/plugin.json manifest (v2.3.0)
- Cross-tool compatible: works with any AGENTS.md-based CLI

All 4 scripts verified: --help passes, smoke tests run correctly.
complexity_checker catches its own nesting depth. assumption_linter
correctly flags "just", "obviously", "should work". goal_verifier
correctly scores plans with/without verification steps.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>