Давно не было постов, с помощью для новичков. И вот решил наконец-то - обьяснить логичное.
Karpathy давно подметил, что LLM в коде часто ошибаются по одним и тем же паттернам: оверинжирят простые задачи, игнорируют готовый код, ставят лишние зависимости, трогают соседние файлы и пишут “done”, хотя ничего нормально не проверили.
Если вы только начали кодить через Cursor / Claude Code / Codex, скорее всего уже ловили это. Просишь маленькую правку, а агент начинает перестраивать полпроекта и делать архитектуру там, где нужна была одна функция.
Тут легко подумать, что модель тупая. Но часть этих косяков можно заранее прибить обычным файлом с правилами:
AGENTS.md или CLAUDE.md.Это не секретный промпт и не магия. Это просто инструкция для агента внутри проекта: что можно трогать, что нельзя, как запускать проект, где лежит важная логика и что проверять перед тем, как считать задачу готовой.
Самый популярный пример под эту идею — andrej-karpathy-skills. Там по сути один
CLAUDE.md, собранный вокруг типичных ошибок LLM при кодинге: лишние изменения, оверинжиринг, молчаливые предположения и попытки делать больше, чем просили.Минимально я бы начинал с такого файла:
# AGENTS.md
## Rules
1. Think before coding
- сначала прочитай существующий код
- если задача неоднозначная — спроси, а не угадывай
- перед правками коротко сформулируй, что именно будешь менять
2. Simplicity first
- делай самое простое решение, которое закрывает задачу
- не добавляй новые абстракции “на будущее”
- не ставь новые библиотеки без явной причины
3. Surgical changes only
- меняй только файлы, связанные с задачей
- не рефактори соседний код просто потому что увидел его
- не трогай .env, prod config, auth/payment без разрешения
4. Verify before done
- перед “готово” запусти тесты или хотя бы проверку
- если тестов нет — явно напиши, как проверил
- не называй задачу завершённой без проверки
Это уже не просто список запретов, а нормальные правила работы для агента: сначала понять проект, потом сделать минимальное изменение, потом проверить результат.
Дальше файл докручивается по мере ошибок. Агент полез не туда — добавил правило. Поставил лишнюю либу — добавил правило. Сломал конфиг — добавил в запреты.
➡️ Готовые примеры:
• andrej-karpathy-skills — готовый
CLAUDE.md на базе принципов Karpathy • agents.md — общий формат
• реальные AGENTS.md на GitHub — можно подсмотреть структуру
• доки Anthropic по CLAUDE.md — если сидите на Claude Code
Если только заходите в AI-кодинг, я бы начинал не с поиска “идеального промпта”, а с файла правил для проекта.
Скучная штука, но именно она часто превращает агента из рандомного джуна в более-менее адекватного помощника.
Всё давай, не забывай про реакцию 😯
❤️ Vimol: Канал | Чатик | Вся альфа тут