Как написать CLAUDE.md который реально работает

— это файл в корне проекта который Opus читает при каждой сессии. Звучит просто, но большинство пишут его неправильно и потом удивляются почему Opus всё равно делает не то.

Что писать:

Конкретику, не абстракции. «Используй TypeScript строгий режим» работает. «Пиши хороший код» — нет.

Стек и версии. Opus должен знать с чем работает: React 19, Node 22, PostgreSQL 16 — конкретные версии важны, у разных версий разный API.

Архитектурные решения и почему они такие. «Используем Zustand, не Redux — потому что команда решила избежать бойлерплейта». Когда Opus понимает почему — он меньше предлагает альтернативы.

Что запрещено. «Не используй any в TypeScript», «не добавляй console.log в продакшн код», «не трогай файлы в папке legacy без явного запроса».

Что не писать:

Длинные истории о проекте. Opus читает в каждой сессии — делай его кратким, максимум 200-300 строк.

Очевидные вещи. «Пиши чистый код» — это ни о чём.

Шаблон который работает у меня:

Обновляй файл когда проект меняется. Устаревший хуже чем отсутствующий.