v
vibecode
Все скиллы
01Скилл
Шаблоны
адапт. из multica-ai/andrej-karpathy-skills
karpathy-guidelines

CLAUDE.md по принципам Карпати

Универсальный CLAUDE.md который ловит типичные ошибки LLM-кодинга. Адаптирован из наблюдений Андрея Карпати про то где AI ошибается в коде.


01aКогда брать

Кладёшь в корень любого проекта. Особенно полезно когда AI пишет код «правильно но странно». Эти правила ловят: лишние абстракции, выдуманные API, undermotivated комплексность.

02Куда положить
<project>/CLAUDE.md (или дополнение к существующему)

Создай эту папку и файл (если их нет), вставь содержимое ниже. Затем в Claude Code: /exit и запусти claude заново — команда появится.

03Содержимое

Скопируй всё что внутри блока и вставь в файл по пути выше.

CLAUDE.md (или дополнение к существующему)
1# Правила работы с AI-помощником2 3## Базовое поведение4 5- **Делай минимум** что просили. Не предлагай рефактор существующего кода если не просили.6- **Не выдумывай API.** Если не уверен в названии функции/метода библиотеки — спроси или проверь документацию.7- **Не добавляй "на всякий случай"** — никаких abstractions, configs, fallbacks для проблем которых нет.8- **Не пиши защитный код** для условий которые не возникнут (валидация внутренних вызовов между твоими функциями).9 10## Комментарии и документация11 12- Минимум комментариев. Только где **почему** непонятно, не **что**.13- Никаких docstrings на самоочевидные функции.14- Никаких "Note: this function does X" — это уже видно из кода.15- Документация — `README.md`, не в коде.16 17## Стиль18 19- Если в проекте есть стиль — следуй ему. Не переписывай под себя.20- Не предлагай переименовать переменные если они уже понятны.21- Не вводи новые библиотеки если можно решить стандартом языка.22 23## Ошибки и edge cases24 25- Не оборачивай всё в try/catch. Обрабатывай ошибки только где это **осмысленно**.26- Не валидируй ввод от **внутренних функций** — только от пользователя и внешних API.27- Если задача сложная и есть много краевых случаев — **спроси меня** какие из них реально важны.28 29## Качество vs производительность30 31- **Сначала работает**, потом красиво, потом быстро. В таком порядке.32- Преждевременная оптимизация запрещена.33- Если оптимизируешь — покажи **до/после** с измерениями.34 35## Что точно делать36 37- Перед сложным изменением — **опиши план в 2-3 строки**, жди подтверждения.38- После завершения — **запусти тесты**, если они есть.39- При коммите — точный commit message в формате существующих коммитов проекта.40 41## Когда сомневаешься42 43- **Не угадывай**. Скажи "не уверен — нужно проверить".44- Если задача неоднозначная — спроси уточнение, не решай за меня.
04Как использовать

Примеры команд

  • 01Положить в начало CLAUDE.md любого проекта