jiayuan_jy — Karpathy-Inspired Claude Code Guidelines

13 окт. 2026 г. · время чтения ~2 мин.

Вид: README репозитория (инструкция для Claude Code)

Коротко

Вопрос: Как уменьшить типичные ошибки языковой модели при написании кода с Claude Code?
Ответ: Один файл CLAUDE.md из четырёх принципов, по замыслу README, должен уменьшать типичные ошибки Claude Code при написании кода, сдвигая его к осторожности, простоте и проверяемым целям.

Тезисы

Т1. Заявлено правило: перед кодом модель должна называть свои допущения и спрашивать, если не уверена

  • Аргумент: README выводит принцип из наблюдения Карпати, что модели делают неверные допущения и бегут дальше без проверки; правило велит называть допущения явно.
  • Цитата: «State your assumptions explicitly. If uncertain, ask.» (раздел “CLAUDE.md”, “1. Think Before Coding”)
  • Понятия: CLAUDE.md

Т2. Заявлено: код должен быть минимальным, без лишних абстракций и спекулятивных возможностей

  • Аргумент: README связывает принцип с замечанием, что модели любят усложнять код; критерий — вопрос, назвал бы это слишком сложным старший инженер.
  • Цитата: «If you write 200 lines and it could be 50, rewrite it.» (раздел “CLAUDE.md”, “2. Simplicity First”)
  • Понятия: CLAUDE.md

Т3. Заявлено: каждая изменённая строка должна прослеживаться до запроса пользователя

  • Аргумент: правило запрещает «улучшать» соседний код и удалять существовавший ранее мёртвый код без просьбы; убирать нужно только то, что стало лишним из-за собственных правок.
  • Цитата: «The test: Every changed line should trace directly to the user’s request.» (раздел “CLAUDE.md”, “3. Surgical Changes”)
  • Понятия: CLAUDE.md

Т4. Заявлено: чёткие критерии успеха позволяют модели работать в цикле самостоятельно

  • Аргумент: задача превращается в проверяемую цель (сначала тест, потом решение); README ссылается на слова Карпати о том, что модели хорошо работают в цикле до достижения цели.
  • Цитата: «Strong success criteria let you loop independently. Weak criteria (“make it work”) require constant clarification.» (раздел “CLAUDE.md”, “4. Goal-Driven Execution”)
  • Понятия: CLAUDE.md

Связи

  • Из карточки: CLAUDE.md → jiayuan_jy: файл поведенческих инструкций, который объединяет четыре принципа и добавляется к проектным правилам (Т1–Т4)

Оригинал