раздел 04
Пример: CLAUDE.md по Карпатому
Хороший файл инструкций короткий и бьёт по типичным ошибкам ИИ. Известный пример - компактный CLAUDE.md по наблюдениям Андрея Карпатого о том, где агенты чаще всего ошибаются в коде. Всего четыре правила.
1
Think before coding
Проговаривай допущения явно. При неуверенности - спрашивай. Не принимай молча решение, когда есть несколько трактовок.
2
Simplicity first
Минимум кода, решающего задачу. Ничего спекулятивного - без лишних абстракций и преждевременной гибкости.
3
Surgical changes
Трогай только то, что нужно. Убирай только тот код, который устарел из-за ТВОИХ изменений. Сохраняй существующий стиль.
4
Goal-driven execution
Определи критерии успеха. Крутись в цикле до проверки. Превращай размытые запросы в проверяемые цели.
Как это выглядит файлом
# Правила
## 1. Think before coding
State your assumptions explicitly. If uncertain, ask.
## 2. Simplicity first
Minimum code that solves the problem. Nothing speculative.
## 3. Surgical changes
Touch only what you must. Clean up only your own mess.
## 4. Goal-driven execution
Define success criteria. Loop until verified.
Признак, что правила работают: в диффах меньше лишних правок, меньше переписываний из-за переусложнения, а уточняющие вопросы идут ДО реализации, а не после ошибок.
Почему это сильный пример
Он не про конкретный проект, а про поведение агента вообще - поэтому годится почти в любой репозиторий как база. Дальше к нему добавляют проектные команды, стиль и ограничения (раздел 02).