CLAUDE.md: не README, а директива для ИИ-джуниора
Большинство пишет CLAUDE.md как визитку проекта, а надо — как промпт для стажёра с доступом к клавиатуре.
Заметили, как многие разработчики относятся к CLAUDE.md? Как к очередному README — сухо перечисляют стек, пару предпочтений и надеются на чудо. Но на деле это не документация, а прямая директива для ИИ-ассистента. Представьте, что вы наняли джуниора, который может читать весь код, но понятия не имеет о ваших привычках. CLAUDE.md — это его инструкция на первый день.
Что обычно кладут в такой файл? "Мы используем React, Next.js, PostgreSQL". И всё. А потом удивляются, почему ИИ предлагает решения, от которых дёргается глаз. Правильный подход — писать в духе: "Никогда не используй any, тесты пиши через Vitest, а компоненты — только функциональные". Да, это больше похоже на code-style guide, но именно так ИИ поймёт, что вы не любите лишнюю абстракцию.
Как использовать по-настоящему
- Правила вместо фактов: не "стек: X", а "всегда делай Y".
- Примеры боли: "Если видишь запрос к БД в цикле — остановись и перепиши через JOIN".
- Тон: пишите как для разумного, но неопытного коллеги. Без сленга, но с чёткими границами.
И да, CLAUDE.md не заменит код-ревью, но сократит количество правок в пулл-реквестах. А если ваш ИИ всё равно предлагает велосипеды — может, стоит проверить, не забыли ли вы добавить правило "не изобретай велосипед"?
Комментарий студии METABYTE: Наши разработчики тоже сначала писали CLAUDE.md как README, пока не поняли, что ИИ — это не Google Docs, а скорее стажёр, которому нужен чёткий список "можно/нельзя". Теперь у нас в каждом проекте такой файл — и баги стали находить быстрее, чем мы успеваем сказать "о, это снова any".