Каркас проекта для Claude Code: с чего начинать

# [НАЗВАНИЕ ПРОЕКТА] — карта проекта

Этот файл читается агентом в начале каждой сессии. Он объясняет,
что это за проект, где что лежит и по каким правилам мы работаем.
Держи его коротким: до 150 строк. Это оглавление, а не книга.

## Что это за проект

**[НАЗВАНИЕ]** — [одно предложение: что это и для кого].
[Ещё 1-2 предложения: какую задачу решает и как именно].

Бизнес-контекст — в business/INDEX.md.

## Стек

[Языки, фреймворки, база, ключевые библиотеки.]
[Если не уверен — не навязывай. Опиши задачу и попроси агента
предложить лучшее решение под развитие проекта.]

## Структура проекта

[НАЗВАНИЕ]/
├── CLAUDE.md      ← этот файл, карта и правила
├── business/      ← зачем делаем: цели, аудитория, продукт, экономика
│   └── INDEX.md   ← входная точка, оглавление business/
├── plans/         ← как делаем: один план = одна функция
└── (код проекта)

## Правила работы (соблюдать всегда)

1. Один чат — одна задача. Закончил → новый чат. Чужую работу
   из других чатов агент не видит, контекст путается.
2. Контекст до 50%. Перевалило — новый чат или /clear.
3. Перед правкой существующего файла или живой базы — сначала
   прочитай реальный текст, не правь по памяти (show-before-write).
4. Ничего не делаю руками. Папки, файлы, команды — через агента.
5. git add только поимённо. Никогда git add . — попадёт лишнее.
   Код и документация — разными коммитами.
6. Каждая функция оформляется планом в plans/ (см. ниже).
7. В конце сессии — короткая рефлексия (см. ниже).

## План для каждой функции

Любая функция = план в plans/.

1. Один план = одна функция. Есть план — работаем с ним.
2. Имя файла: YYYY-MM-DD-название-функции.md.
3. План делится на фазы. У каждой статус [ ] или [x].
4. В конце плана — итог: реализовано целиком или нет, что осталось.
5. Агент актуализирует план после каждой сессии.

## Завершение чата

В конце сессии записывай рефлексию в business/история/YYYY-MM-DD-кратко.md:

1. Какая задача стояла.
2. Как решал.
3. Решил или нет (да / нет / частично).
4. Что можно было лучше.
5. Как было и как стало.

## Проверка перед тем как считать готовым

Перед «готово» агент обязан доказать, что решение реально
закрывает задачу, а не раздувает код ради объёма. Спрашивай:
«докажи, что это решает проблему, а не код ради кода».

## Язык

Всегда отвечай на русском.

business/
├── INDEX.md        ← оглавление, входная точка. С него агент начинает
├── company/        ← о проекте, ценности, команда
├── products/       ← продукт, тарифы, цены
├── audience/       ← портрет пользователя, боли, возражения
├── goals/          ← цели на год/квартал/месяц, метрики
├── economics/      ← юнит-экономика, доходы, расходы
└── история/        ← рефлексии по чатам, YYYY-MM-DD-кратко.md

Прочитай CLAUDE.md и business/INDEX.md.
Задача: [опиши задачу].
Разбей её на фазы. У каждой фазы статус [ ] или [x].
По каждой фазе проверь: решает ли это задачу, не усложнение ли
сверх MVP, не код ли ради кода. Собери план в plans/.
В конце докажи, что это лучшее решение, а не первая попавшаяся идея.

Прочитай план в plans/[файл] и business/INDEX.md.
Посмотри на него со стороны. По каждой фазе:
кто уже решал похожую задачу и как, какие риски,
нет ли конфликтов между фазами, что с безопасностью,
бьётся ли с бизнес-целями. Собери правки списком.
Жди моего ответа какие принять, потом обнови файл плана.

Прошёл год. Этот проект провалился.
Твоя задача понять почему. Думай так, будто уже проиграл,
найди настоящие причины провала, не щади.
В конце дай список что исправить сейчас, пока не поздно.