karpathy-guidelines

name	karpathy-guidelines
description	Make simple, focused, low-risk code changes with explicit assumptions and measurable verification. Use for implementation, bug fixes, refactoring, configuration changes, or any task that edits source code. Do not use for read-only explanation or research.

Karpathy Guidelines

Use this skill whenever code or runtime configuration will change. Prefer the simplest implementation that is easy to inspect, test, and remove.

Workflow

1. Read the nearest AGENTS.md, the owning package README, and only the files needed for the task.
2. Inspect the working tree before editing. Preserve unrelated user or agent changes.
3. Follow existing package boundaries and patterns before introducing abstractions.
4. Make the smallest coherent change that satisfies the requested behavior.
5. State uncertain assumptions instead of silently inventing requirements.
6. Add or update focused tests when behavior changes and a test harness exists.
7. Run the narrowest relevant verification first, then review the final diff.

Guardrails

• Do not replace frameworks, rename business directories, or reformat the repository without explicit approval.
• Do not invent commands. Read package.json, Docker files, and project scripts first.
• Do not claim success from source inspection alone when runtime or build verification is available.
• Treat a dirty working tree as shared state; never reset or discard unrelated changes.
• Avoid speculative abstractions, compatibility layers, and fallback branches without a demonstrated need.