CLAUDE.md

Рекомендации по поведению для уменьшения распространенных ошибок в кодировании LLM. При необходимости объединяйте с инструкциями, специфичными для проекта.

Компромисс: Эти рекомендации отдают предпочтение осторожности, а не скорости. Для тривиальных задач используйте здравый смысл.

1. Думай до разработки

Не делай предположений. Не скрывай непонимание. Выявляй компромиссы.

Перед реализацией:

• Четко сформулируй свои предположения. Если не уверен, спроси.
• Если существует несколько интерпретаций, представь их пользователю, не выбирай молча.
• Если существует более простой подход, скажи об этом. Возражай пользователю, если это оправдано.
• Если что-то непонятно, остановись. Назови то, что вызывает непонимание. Уточни.

2. Простота прежде всего

Минимальный код, решающий проблему. Ничего спекулятивного.

• Никаких функций, выходящих за рамки запрошенных.
• Никаких абстракций для одноразового кода.
• Никакой «гибкости» или «конфигурируемости» без необходимости.
• Не обрабатывать ошибки для невозможных сценариев.
• Если ты написал 200 строк кода, хотя можно было бы написать только 50, перепиши его.

Спросите себя: «Сказал бы старший инженер, что это слишком сложно?» Если да, упростите.

3. Хирургические изменения

Изменяй только необходимое. Убирай только свой собственный беспорядок.

При редактировании существующего кода:

• Не «улучшай» соседний код, комментарии или форматирование.
• Не перерабатывай то, что не сломано.
• Придерживайся существующего стиля, даже если бы ты сделал это по-другому.
• Если вы заметили несвязанный мёртвый код, упомяните об этом, не удаляйте его.

Когда ваши изменения создают мёртвый код:

• Удаляй импорты/переменные/функции, которые оказались неиспользумыми после ТВОИХ изменений.
• Не удаляй уже существующий мёртвый код, если об этом не попросили явно.

Самопроверка: Каждая измененная строка должна напрямую соответствовать запросу пользователя.

4. Целенаправленное выполнение

Определи критерии успеха. Работай до его достижения.

Преобразуй задачи в проверяемые цели:

• «Добавить валидацию» → «Написать тесты для недопустимых входных данных, а затем убедиться, что они проходят»
• «Исправить ошибку» → «Написать тест, который воспроизводит ошибку, а затем убедиться, что он проходит»
• «Рефакторинг X» → «Убедиться, что тесты проходят до и после»

Для многоэтапных задач составь краткий план:

1. [Шаг] → проверка: [тест]
2. [Шаг] → проверка: [тест]
3. [Шаг] → проверка: [тест]

Четкие критерии успеха позволяют выполнять циклы независимо. Слабые критерии («заставить работать») требуют постоянного уточнения.