2026-10-11 17:12 UTC

Karpathy's four CLAUDE.md rules will spread as a recognizable harness pattern for reducing assumptions, unnecessary abstractions, and unrelated edits by coding agents.

state: resolvedheat: lowuncertainty: mediumknownscott: mediumcoding-agents agent-harnesses claude-codeAndrej KarpathyAnthropic

What is this?

A set of four project-level CLAUDE.md instructions attributed to Andrej Karpathy tells Claude Code to surface assumptions, avoid unrequested abstractions, make only necessary edits, and define clear success criteria. Community posts and a GitHub adaptation describe the rules as a lightweight harness for recurring coding-agent failure modes, with some reports claiming substantial error reductions and viral adoption. The supplied results do not include Karpathy’s original post or reliable validation of the performance and adoption claims, and one snippet cautions that the rules may not cover multi-step agent loops.

Why it matters to Scott

Scott already holds this position in “CLAUDE.md Pattern” and “Your AI Can Code. You Just Don’t Know How to Drive It.”: slim persistent instructions can encode lessons, surface assumptions, constrain scope, and discourage premature abstraction. The emerging four-rule packaging is a publishing opportunity around his broader doctrine, but he would need to distinguish lightweight policy from the plan/test/verification loops he considers necessary for reliable delivery; the supplied adoption and performance claims remain unvalidated.
ip:concept.claude-md-patternip:source.your-ai-can-code-you-just-don-t-know-how-to-drive-it-ebookip:concept.fat-agents-md-anti-patternip:concept.plan-mode-disciplineip:concept.test-first-agent-workflowradar:concept.coding-agentsradar:concept.agent-harnessradar:concept.claude-coderadar:karpathy-llm-wiki-adoption
queries asked of Scott's wikis
  • coding-agent harness constraints and guardrails
  • minimal diffs and unrelated-edit prevention
  • assumption surfacing before agent execution
  • project instruction files as persistent agent policy
  • anti-abstraction rules for generated code
  • single-shot coding rules versus multi-step agent loops

Measured heat

no measured readings yet — the hourly heat pass fills this in

How the heat travelled

no chain yet — the hourly chain pass fills this in

Evidence (8) — ⭐ canonical anchor

sourceobjectauthorscorecomments
🟠 reddit ⭐I added a clause to Andrej Karpathy's 4 CLAUDE.MD clauses for Claude Code. It has been a game changer for me.
ClaudeAI
Osi322581116
🟠 redditI keep CLAUDE.md and the agent junk one level above the repo (git can't see it, Claude still reads it). What's your setup?
ClaudeAI
oreopowered27
🟠 redditI have found this indispensable.
ClaudeAI
BullfrogRoyal7422258
🟠 redditDay 3 of building a browser Path of Exile clone with Claude Code, league starts tomorrow
ClaudeAI
IT-BAER2722
🟠 redditHow Do We Stop Vibe Coding? Spoiler: we don't - we fix the trust problem instead.
ClaudeAI
butt_flexer011
🟠 redditI turned my design system into a single Markdown file you can point Claude at: it stopped generating "AI-looking" UIs ( ~18 KB )
ClaudeAI
petitpoid02
🟧 hnShow HN: A monorepo where AI agents can safely build and maintain applicationsbrulenaudet10
🟧 hnHow Do We Stop Vibe Coding?prohobo2925

Interpretation history

Decision trace