Andrei Karpathy's CLAUDE.md is a project-level instruction file that guides AI coding agents like Claude Code to behave as disciplined engineering partners rather than unpredictable code generators. It encodes key principles such as planning before editing, making minimal surgical changes, preferring simple solutions, and verifying all output through tests and code review. The core argument is that as AI coding agents grow more capable, structured guidance becomes increasingly critical — and the developers who thrive will be those who combine AI leverage with strong engineering judgment.
