Шаблон CLAUDE.md: файл, который делает Claude Code вдвое полезнее

CLAUDE.md — файл, который Claude Code читает перед каждой сессией: инструкция о вашем проекте, его правилах и особенностях. В правилах инженера мы разбирали принципы — кратко, конкретно, с объяснением «почему». Здесь — готовая структура, которую можно скопировать и заполнить.

Файл должен быть кратким, техническим и живым. Помните про лимит: модель надёжно держит порядка 150–200 инструкций, и часть уже занята системными.

Шаблон для проекта с кодом

# Руководство для Claude (Имя Проекта)

## Основные команды
Запускать из корня проекта. Используй эти алиасы, а не гадай.

- Запуск: `npm run dev` (сервер на порту 3000)
- Билд: `npm run build` (строгий режим, падает при ворнингах)
- Тесты: `npm test -- -u` (Jest, обновляет снэпшоты)
- Линтинг: `npm run lint:fix` (обязательно перед коммитом)
- База данных: `docker-compose up -d db` (Postgres, креды в .env.example)

## Стек и стиль
Не объясняй мне, что такое React. Объясняй, как МЫ его используем.

- Стек: Next.js 14 (App Router), Tailwind, Prisma, PostgreSQL.
- Типизация: strict TypeScript. Почему: ловили баги в проде из-за `any`.
  Не используй `any` — используй `unknown` или пиши тип.
- Стили: Tailwind, без кастомных CSS-классов.
- Ошибки: серверные экшены возвращают { success, data?, error? }.
  Почему: чтобы фронт единообразно показывал тосты.

## Архитектура (только неочевидное)
- src/app/api: используем редко, предпочитаем Server Actions.
- src/lib/db.ts: синглтон Prisma-клиента.
- src/components/ui: UI-кит — не менять логику, только стили.
- prisma/schema.prisma: источник правды; после изменений — `npx prisma generate`.

## Процесс
1. Маленькие атомарные правки.
2. Меняешь логику вычислений — добавь юнит-тест.
3. camelCase для переменных, PascalCase для компонентов, kebab-case для файлов.
4. Секреты только через process.env, никакого хардкода.

## Живые заметки
<!-- сюда добавляются правила по ходу работы -->
- Всегда date-fns, не moment.js.

Почему эта структура работает

Команды. Ассистент не должен гадать, как запускается ваш проект. Специфические флаги, порядок запуска («сначала Docker, потом сервер») — всё сюда.

«Почему» рядом с правилом. «Используй строгую типизацию» — нормально. «…потому что ловили баги в проде» — лучше: зная причину, модель принимает микро-решения, которые вы не успели описать, но которые соответствуют цели.

Только неочевидное. «Компоненты лежат в папке components» — мусор, съедающий лимит инструкций. «Мы используем Server Actions вместо API-роутов» — то, что нужно.

Живые заметки. Ассистент дважды ошибся в одном месте — правило отправляется в файл (в Claude Code для этого есть клавиша #). Через месяц CLAUDE.md станет честным документом о том, как на самом деле устроен проект.

Версия для маркетингового проекта

От себя: тот же принцип работает без единой строки кода. Вот структура, которую я использую в контент-проектах:

# Руководство для Claude (Проект/Бренд)

## Кто мы и для кого
- Продукт: [что продаём, одной строкой]
- Аудитория: [кто покупает, их главная боль]
- Позиционирование: [чем отличаемся]

## Голос и стиль
- Обращение на «вы», без канцелярита и слова «уникальный».
- Почему: аудитория — владельцы бизнеса, они чуют продающий пластик.
- Запрещённые слова: [список штампов вашей ниши]
- Термины пишем так: [глоссарий: как называем продукт, фичи, тарифы]

## Факты (источник правды)
- Цифры и кейсы берём ТОЛЬКО из facts.md. Нет в файле — не выдумывай, спроси.
- Цены и сроки: [актуальные, с датой обновления]

## Форматы
- Пост в Telegram: до 800 знаков, крючок в первой строке, один CTA.
- Статья: лид без воды, подзаголовки каждые 3–4 абзаца, вывод + CTA.

## Живые заметки
- Не обещать «результат за неделю» — юристы против.

Разница с «просто промптом»: это пишется один раз, читается при каждом запуске и накапливает ваши исправления вместо того, чтобы терять их с каждым новым чатом. По сути, это младший брат базы знаний из методологии 4 слоёв — первый шаг к цифровому двойнику, который делается за вечер.

Хотите, чтобы такой файл — и вся система вокруг него — были собраны под ваш бизнес? Напишите «система» в Telegram, разберём за 15 минут.