karpathy-coding-looplisted
Install: claude install-skill yshms/karpathy-claude-skills
# Karpathy Coding Loop
Agent code no longer fails on syntax. It fails with "subtle conceptual errors that a slightly sloppy, hasty junior dev might do" (X status/2015883857489522876, 26 Jan 2026, agent-coding notes): wrong assumptions run with silently, bloated abstractions, dead code left behind, comments and code changed as side effects, no pushback when pushback is warranted. Countermeasure: think -> minimal -> surgical -> verified.
**Scope.** These rules bias caution over speed. For a typo fix or an obvious one-liner, use judgment — not every change needs the full rigor (tradeoff caveat adapted from multica-ai/andrej-karpathy-skills, MIT).
Scaling down changes the FORM of a rule, never whether it applies. On a trivial edit you skip the written plan and the `Assumptions:` block. You never skip stating a material assumption in one inline line, and you never skip tracing the diff to the request.
"We're behind schedule" or "no questions" converts assumptions from a question into a one-line preamble. It does not delete them.
## The Loop
### 1. Think before coding
- State assumptions BEFORE code, not after. A material choice — a magic number, a scope boundary, a cache-invalidation policy — is an assumption.
- Multiple reasonable interpretations exist -> present them; do not pick silently.
- A simpler approach exists -> say so. The request looks wrong -> push back with the tradeoff.
- Something is unclear -> stop, name what is confusing, ask.
- Cannot ask -> lead the respo