Before beginning work in this repository:
- read and follow
AGENTS.md; - read §0, Linear Concept and Build Order, in
docs/plan.md; - read the relevant detailed architecture and product sections in
docs/plan.md; - locate the governing milestone and atomic task IDs in
TODOS.md; - inspect the current source and tests before assuming planned components exist.
AGENTS.md is the authoritative repository-wide agent instruction file. This file is intentionally a thin Claude Code compatibility entry point so the same rules are not duplicated and allowed to drift.
Everything a Claude Code session needs beyond that lives in AGENTS.md and is not repeated here: the branch model, the tracked configuration under .claude/, the subagents, and the vendored skills.
The coding discipline is partly informed by the community-maintained Karpathy-Inspired Claude Code Guidelines, vendored and pinned at that commit. It is not an official Andrej Karpathy repository, and AGENTS.md takes precedence over it.