A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls. Its four principles are: think before coding, simplicity first, surgical changes, and goal-driven execution — a direct answer to models that make wrong assumptions, overcomplicate code, and bloat abstractions. Note this is a parallel republished copy of the same content as forrestchang/andrej-karpathy-skills, the original.单个 CLAUDE.md 文件，用于改善 Claude Code 的行为，源自 Andrej Karpathy 对大模型编码陷阱的观察。它的四条原则是：动手前先思考、简单优先、手术式修改、目标驱动执行——直接针对模型擅自假设、过度复杂化代码、膨胀抽象的问题。注意，这是与 forrestchang/andrej-karpathy-skills（原版）相同内容的平行转载。單個 CLAUDE.md 檔案，用於改善 Claude Code 的行為，源自 Andrej Karpathy 對大型模型編碼陷阱的觀察。它的四條原則是：動手前先思考、簡單優先、手術式修改、目標驅動執行——直接針對模型擅自假設、過度複雜化程式碼、膨脹抽象的問題。注意，這是與 forrestchang/andrej-karpathy-skills（原版）相同內容的平行轉載。Claude Code の振る舞いを改善する単一の CLAUDE.md ファイル。Andrej Karpathy による LLM コーディングの落とし穴の観察に基づく。4 つの原則は、コーディング前の思考、シンプルさ優先、外科的な変更、ゴール駆動の実行。勝手な前提を置き、コードを過度に複雑化し、抽象を肥大化させるモデルへの直接の答えである。これは forrestchang/andrej-karpathy-skills（オリジナル）と同一内容の並行再掲載であることに注意。
Quick start快速上手快速上手クイックスタート
What it does
A single CLAUDE.md file that improves Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls: models make wrong assumptions silently, overcomplicate code, and touch code they do not understand as a side effect. It answers with four principles instead of a toolset.
How it works
The four principles are: Think Before Coding (state assumptions, present multiple interpretations, push back when warranted, stop when confused); Simplicity First (minimum code that solves the problem, nothing speculative); Surgical Changes (touch only what you must, match existing style, mention unrelated dead code instead of deleting it); and Goal-Driven Execution (turn tasks into verifiable goals and loop until tests pass).
In Cursor, the repo includes a committed rule file so the same guidelines apply there.
Key points
Note: this repo is a parallel republished copy of the same content as forrestchang/andrej-karpathy-skills, the original. Its README install commands reference the original forrestchang repo.
This repo's own install path beyond its CLAUDE.md and CURSOR.md files is unverified, so use the commands above as written.
The guidelines bias toward caution over speed; for trivial tasks such as typo fixes, the README says to use judgment rather than the full rigor.
它是做什么的
只有一个 CLAUDE.md 文件，用于改善 Claude Code 的行为，源自 Andrej Karpathy 对大模型编码陷阱的观察：模型会默默做出错误假设、把代码复杂化，还会顺带改动它并不理解的代码。它给出的不是工具集，而是四条原则。
A complete software development methodology for coding agents, built on composable skills plus initial instructions that make sure the agent actually uses them. It covers the full workflow from brainstorming and planning through implementation, testing, and review, so agents follow a disciplined process instead of improvising. It works across Claude Code, Codex, Cursor, OpenCode, Gemini CLI, GitHub Copilot, and many more.一套面向编码智能体的完整软件开发方法论，由可组合的技能加上确保智能体真正使用这些技能的初始指令构成。它覆盖从头脑风暴、规划到实现、测试、评审的完整流程，让智能体遵循严谨的流程而不是即兴发挥。支持 Claude Code、Codex、Cursor、OpenCode、Gemini CLI、GitHub Copilot 等众多工具。一套面向編碼智慧體的完整軟體開發方法論，由可組合的技能加上確保智慧體真正使用這些技能的初始指令構成。它涵蓋從腦力激盪、規劃到實作、測試、審查的完整流程，讓智慧體遵循嚴謹的流程而不是即興發揮。支援 Claude Code、Codex、Cursor、OpenCode、Gemini CLI、GitHub Copilot 等眾多工具。コーディングエージェントのための完全なソフトウェア開発手法。組み合わせ可能なスキルと、エージェントがそれを確実に使うための初期指示で構成される。ブレインストーミングと計画から実装、テスト、レビューまで全工程をカバーし、エージェントが即興ではなく規律ある手順に従うようにする。Claude Code、Codex、Cursor、OpenCode、Gemini CLI、GitHub Copilotなど多数に対応する。
Skills for real engineers, straight from Matt Pocock's .agents directory — the skills he uses every day to do real engineering, not vibe coding. Unlike process-heavy frameworks such as GSD, BMAD, and Spec-Kit, which own the process and take away your control, these skills stay assistive so problems in the process stay easy to resolve. They cover everyday engineering work across planning, implementation, and review.面向真正工程师的技能，直接来自 Matt Pocock 的 .agents 目录——是他每天做真实工程用的技能，不是氛围编程。与 GSD、BMAD、Spec-Kit 这类接管流程的重型框架不同，这些技能只起辅助作用，流程出问题时也容易排查和解决。覆盖规划、实现、评审等日常工程工作。面向真正工程師的技能，直接來自 Matt Pocock 的 .agents 目錄——是他每天做真實工程用的技能，不是氛圍編程。與 GSD、BMAD、Spec-Kit 這類接管流程的重型框架不同，這些技能只起輔助作用，流程出問題時也容易排查和解決。涵蓋規劃、實作、審查等日常工程工作。本物のエンジニアのためのスキル。Matt Pocock の .agents ディレクトリからそのまま取り出した、彼が毎日実際のエンジニアリングで使うスキルで、バイブコーディング用ではない。GSD、BMAD、Spec-Kit のようなプロセスを掌握して制御を奪う重厚なフレームワークとは異なり、補助に徹するためプロセスの問題も解決しやすい。計画、実装、レビューといった日常のエンジニアリング作業をカバーする。
The agent harness performance optimization system: skills, instincts, memory, security, and research-first development for Claude Code, Codex, OpenCode, Cursor, and beyond. It bundles 71 agents and 311 skills with AgentShield security scanning and legacy command shims, aiming to make the whole harness faster and more capable rather than adding one-off prompts. Think of it as an operating system layer for your coding agent.智能体 harness 的性能优化系统，覆盖技能、本能、记忆、安全和研究优先的开发方式，适用于 Claude Code、Codex、OpenCode、Cursor 等工具。它打包了 71 个智能体和 311 个技能，附带 AgentShield 安全扫描和旧命令兼容垫片，目标是让整个 harness 更快、更强，而不是再加一堆一次性提示词。可以把它理解为编码智能体的一层操作系统。智慧體 harness 的效能最佳化系統，涵蓋技能、本能、記憶、安全和研究優先的開發方式，適用於 Claude Code、Codex、OpenCode、Cursor 等工具。它打包了 71 個智慧體和 311 個技能，附帶 AgentShield 安全掃描和舊指令相容墊片，目標是讓整個 harness 更快、更強，而不是再加一堆一次性提示詞。可以把它理解為編碼智慧體的一層作業系統。エージェントハーネスのパフォーマンス最適化システム。スキル、直感、記憶、セキュリティ、リサーチファーストの開発を Claude Code、Codex、OpenCode、Cursor などで実現する。71 のエージェントと 311 のスキルに AgentShield セキュリティスキャンとレガシーコマンドのシムを同梱し、使い捨てのプロンプトを増やすのではなくハーネス全体を高速かつ高機能にする。コーディングエージェントの OS 層と考えると分かりやすい。