v5.5.0
Added — Karpathy editing-discipline guidelines (inline + skill)
Adopts the four behavioral principles from
forrestchang/andrej-karpathy-skills,
grounded in Andrej Karpathy's
observations on LLM coding pitfalls.
Two delivery surfaces:
- Inlined in generated
CLAUDE.mdandAGENTS.md. New
"Editing discipline (Karpathy-inspired)" section in
templates/core/CLAUDE_MD_v2.mdand
templates/core/AGENTS_LEAN.md. Every project that runs
rulebook initorrulebook updatefrom 5.5.0 onward gets the
four principles in both files; the AGENTS.md projection
propagates to Cursor / Windsurf / Cline / Copilot / Codex /
Gemini through their existing references. - New skill
templates/skills/core/karpathy-guidelines/SKILL.md
— a dedicated invocable surface (/karpathy-guidelinesor
"follow karpathy discipline"). Added toINVOCABLE_CORE_SKILLS
soinstallSkillsFromSourcecopies it to.claude/skills/on
init/update. Skill body kept ≤80 lines; total context cost
< 1KB per session.
The four principles:
- Think before coding — surface assumptions, present
interpretations, ask when unclear. - Simplicity first — minimum code, no speculative abstractions
or unrequested flexibility. - Surgical changes — touch only what the request requires; no
opportunistic refactors of adjacent code. - Goal-driven execution — define verifiable success criteria
upfront so multi-step tasks loop independently.
Targets gaps not covered by existing Tier 1 prohibitions —
particularly surgical changes (no rule today forbids
opportunistic refactor) and simplicity first
(no-shortcuts.md forbids stubs but not bloat). Test counts
updated: agent-delegation.test.ts skill-dir count 19→20.