🎉 Initial Release
First stable version of the Enhanced Karpathy Coding Guidelines.
What's Included
- 10 engineering discipline rules — enhanced from Karpathy's original 4 behavioral guidelines
- Tool-agnostic — works with Claude Code, Cursor, Codex, WorkBuddy, and any LLM coding assistant
- Three installation methods — Claude Code Plugin, CLAUDE.md, Cursor rules
- Bilingual documentation — English + 简体中文
- Before/After examples — real code comparisons showing rules in action
The 10 Rules
| # | Rule | Core Principle |
|---|---|---|
| 1 | Think Before Coding | Plan first, code second |
| 2 | Simplicity First | Fewest concepts, not fewest lines |
| 3 | Surgical Changes | Touch only what needs touching |
| 4 | Goal-Driven Execution | Accept the input, deliver the output |
| 5 | Verify Before Reporting | Never claim success without verification |
| 6 | Systematic Debugging | Find the gap, fix the gap |
| 7 | Dependency Awareness | Pin versions, know the chain |
| 8 | Clear Communication | Speak plainly, flag concerns |
| 9 | Self-Audit Before Done | Review your own work first |
| 10 | Respect the User's Time | Be proactive, not reactive |
Installation
See README.md for installation instructions.