Как прописать лучший Claude.md

Как прописать лучший Claude.md

Для тех, кто работает с Claude Code, одна из самых полезных штук это файл Claude.md.

Суть простая. Текстовый файл, который Claude Code читает в начале каждой сессии. Записываете один раз всё, что модель должна знать о проекте, и дальше это подгружается само.

Открыли чат, а Claude уже в курсе ваших правил и особенностей. Не надо каждый раз объяснять одно и то же.

Чем больше контекста даёшь ИИ заранее, тем умнее он работает.

Claude.md это буквально весь контекст, собранный в одном месте.

Недавно Борис Черный, создатель Claude Code, поделился своим набором.

Вот что у него внутри:

Оркестрация рабочего процесса

Режим планирования. Входи в режим планирования для любой нетривиальной задачи. Если что-то идёт не так, остановись и перепланируй, не продолжай давить.

Составляй подробные спецификации заранее.

Субагенты. Используй субагентов, чтобы сохранять основное контекстное окно чистым. Передавай им исследования и параллельный анализ. Одна задача на субагента.

Цикл самосовершенствования. После любого замечания обновляй tasks/lessons.md с описанием паттерна.

Пиши правила, предотвращающие повторение ошибки. Просматривай уроки в начале сессии.

Проверка перед завершением. Никогда не отмечай задачу выполненной, не доказав, что она работает. Запускай тесты, проверяй логи.

Спроси себя: одобрил бы это ведущий инженер?

Требуй элегантности. Для нетривиальных изменений остановись и спроси, есть ли способ лучше.

Если исправление выглядит костылём, реализуй элегантное решение.

Для простых фиксов не переусложняй.

Автономное исправление багов.

Получил баг-репорт, просто исправь. Не проси вести за ручку. Укажи на логи, ошибки, падающие тесты, затем устрани.

Ноль переключений контекста для пользователя.

Управление задачами

Сначала план в tasks/todo.md. Согласуй перед реализацией. Отмечай прогресс по ходу.

Краткое резюме на каждом этапе.

Фиксируй уроки в tasks/lessons.md после исправлений.

Ключевые принципы

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

минимальное воздействие на код. Никакой лени: ищи корневые причины, никаких временных заплаток. Изменения затрагивают только то, что необходимо.

Обо мне | Обучение | Отзывы