# Построй мне второй мозг компании

> **Как пользоваться (для человека):** открой Claude Code в пустой папке, приложи этот файл и напиши: «Сделай по этой инструкции». Дальше Claude всё построит сам, задавая тебе вопросы. Понадобится 30-60 минут твоего времени и документы о компании (презентации, финмодель, стратегия - что есть).

---

## Инструкция для Claude

Ты строишь «второй мозг» - операционную память компании в виде git-репозитория, с которой работают и люди, и ИИ. Схема проверена в эксплуатации (ИдаПроджект, proptech). Выполняй шаги по порядку, после каждого шага коротко показывай пользователю, что сделано.

### Жёсткие правила качества (действуют на всех шагах)

1. Не выдумывай факты и цифры о компании. Всё берёшь из ответов пользователя и его документов. Чего не знаешь - спроси или оставь пометку «✏️ ЗАПОЛНИТЬ».
2. Каждая созданная страница в тот же момент вносится строкой в индекс `brain/00_index.md`. Страница вне индекса не существует.
3. Каждая цифра в brain - со ссылкой на источник в `raw/`.
4. Всё, что устаревает (метрики, воронка, планы), несёт дату актуальности в шапке.
5. Пиши на языке команды пользователя.

### Шаг 0. Интервью

Задай пользователю вопросы (пачкой, не по одному):
1. Название компании и чем занимается (2-3 предложения)?
2. Какие продукты/услуги продаёте и кому?
3. Кто ключевые люди и их роли (5-10 человек: имя + должность)?
4. Какие документы есть под рукой (стратегия, финмодель, презентации, sales-материалы)? Попроси положить их в папку или прислать.
5. Топ-3-5 проблем компании прямо сейчас?
6. Есть ли GitHub-аккаунт (для приватного репозитория)?

### Шаг 1. Скелет репозитория

Создай структуру:

```
company-brain/
├── CLAUDE.md          ← правила для ИИ
├── brain/
│   ├── 00_index.md    ← карта всех страниц
│   ├── _dashboard.md  ← живые метрики на одной странице
│   ├── 01_company/    ├── 02_products/   ├── 03_clients/
│   ├── 04_sales/      ├── 05_finance/    ├── 06_team/
│   ├── 07_strategy/   ├── 08_cases/      └── 09_competitors/
├── raw/               ← неизменяемый архив исходников
├── changelog/         ← журнал событий, файл на месяц
├── decisions/         ← ADR: решения с альтернативами
├── playbooks/         ← протоколы «если A - делай Б»
├── agents/            ← роли: как думает CEO/CFO/продавец
└── evals/             ← эталонные вопросы-ответы для проверки
```

`CLAUDE.md` создай по этому шаблону (подставь название компании):

```markdown
# Brain компании <X> - инструкция для ИИ

Ты подключился ко второму мозгу компании. Правила:

1. Перед любым ответом прочитай brain/00_index.md и подгрузи
   ТОЛЬКО релевантные страницы. Не тяни всё в контекст.
2. НЕ ВЫДУМЫВАЙ ЦИФРЫ. Нет числа в brain/raw - скажи «не нашёл»
   и предложи добавить в changelog/.
3. Иерархия правды: raw/ - факты, не редактируются; brain/ - выводы,
   правятся со ссылками на raw; changelog/ - хронология, не
   переписывается задним числом; decisions/ - решения, отменяются
   только новым решением.
4. Конфликты между страницами помечай явно.
5. Конкретика со ссылками на файлы-источники > общие фразы.
6. Чувствительное (зарплаты, персональные данные) во внешние
   документы не выносить, абстрагировать.
7. Обновление мозга: найди файл, покажи дифф, после согласования
   запиши + добавь строку в changelog/YYYY-MM.md.
8. Если вопрос ролевой - открой agents/<роль>.md и отвечай от лица роли.
```

### Шаг 2. Первые страницы из документов пользователя

Каждый полученный документ: оригинал положи в `raw/` как есть, а в `brain/` напиши выжимку 30-80 строк по шаблону:

```markdown
# Название темы

> Источник: raw/<файл>, получено от <кого> <дата>.

## Главный факт
Одно-два предложения, ради которых страница существует.

## Детали
Списки и таблицы. Каждая цифра - со ссылкой на источник.

## Связано
- [смежная страница](../...)
```

Обязательный стартовый набор (чего не хватает - создай заготовку с «✏️ ЗАПОЛНИТЬ» и скажи пользователю):
- `01_company/`: миссия и цели, принципы, глоссарий терминов компании
- `02_products/`: страница на каждый продукт
- `03_clients/`: идеальный клиент (ICP), сегменты, кого не берём
- `04_sales/`: процесс продажи, главные возражения и ответы, квалификация
- `05_finance/`: факт прошлого года, план текущего
- `06_team/`: структура, реестр людей
- `07_strategy/`: план на 1-3 года, топ-проблемы (из интервью)
- `08_cases/`: 2-3 кейса; попроси у пользователя минимум один провал - антикейсы ценнее парадных историй
- `09_competitors/`: карта конкурентов

В `brain/_dashboard.md` собери 5-8 живых метрик (выручка, план, воронка, главные риски) таблицей: метрика, значение, источник. В шапке - дата обновления.

### Шаг 3. Агенты-роли

На каждого ключевого человека из интервью создай файл в `agents/`. Агенты - реальные люди компании, не абстракции:

```markdown
# <Роль> - <Имя Фамилия>

## Кто я
Одно предложение: что закрываю в компании.

## Горизонт
Квартал / год / 3-5 лет. Мой главный вопрос.

## Что читаю первым
3-5 конкретных страниц brain.

## Как я думаю
3-5 принципов принятия решений.

## Что меня беспокоит сейчас
Живой список (обновлять ежеквартально).

## Что я отказываюсь обсуждать
Границы роли - к кому переадресую.
```

Плюс два служебных агента:
- `agents/_orchestrator.md` - таблица «тип вопроса → роль» + правило консилиума: вопрос затрагивает 3+ функции - собери мнения 3-5 ролей и заверши синтезом от Critic;
- `agents/critic.md` - devil's advocate: ищет дыры, противоречия и необоснованные цифры в любом рассуждении.

### Шаг 4. Дисциплина: changelog, ADR, evals

1. `changelog/<текущий-месяц>.md` - первая запись: «мозг создан», что вошло, какие TODO остались.
2. `decisions/0001-second-brain-architecture.md` - первый ADR по шаблону: статус, дата, контекст, решение, **минимум 2 отвергнутые альтернативы с причинами** (например: Notion/Confluence - отвергнуто, потому что ИИ-агенту нужен git и plain-text; «просто папка на диске» - отвергнуто, нет истории и совместной работы), последствия, метрики успеха. Положи рядом `_template.md`.
3. `evals/cases/` - 3 эталонных кейса: реальный вопрос о компании + что обязано быть в ответе + чего быть не должно + ссылка на страницы-источники. Скажи пользователю: раз в месяц задавай ИИ эти вопросы и сверяй с эталоном.

### Шаг 5. Git и подключение

1. `git init`, первый коммит, приватный репозиторий на GitHub (через `gh repo create`, спроси название).
2. Добавь в глобальный `~/.claude/CLAUDE.md` пользователя блок: «при вопросах о компании <X> сначала читай <путь>/CLAUDE.md, перед ответом делай git pull».
3. Предложи (опционально) создать скилл с триггерами: названия компании и продуктов, имена команды, имена ключевых клиентов - чтобы мозг подгружался автоматически.

### Шаг 6. Веб-интерфейс для команды

Мозг наполняется людьми, а большинство команды не работает ни с git, ни с Claude Code. Поэтому собери и разверни простое веб-приложение (Flask или FastAPI + пара шаблонов), в котором команда через браузер может:

1. **Добавить саммари** - главная кнопка на главной странице: форма «заголовок + тип (встреча/решение/инсайт) + кто + текст», сохранение дописывает запись в `changelog/<текущий-месяц>.md`;
2. посмотреть список страниц brain (из индекса) и открыть любую;
3. отредактировать страницу или создать новую (страница сразу вносится в индекс).

**Ключевое требование:** каждое сохранение в вебе = git-коммит и push в репозиторий. Git остаётся единственным источником правды, веб - только удобная ручка для команды. Доступ закрой общим паролем.

Деплой: спроси пользователя, есть ли Railway/Render/свой сервер. Есть - разверни и отдай ссылку для команды. Нет - оставь запуск локально (`python app.py`) и пометь деплой как TODO.

Скажи пользователю: правило для команды - «после каждой важной встречи любой участник за 2 минуты кидает саммари через веб». Это главный источник жизни мозга.

### Шаг 7. Приёмка и онбординг

1. Ответь пользователю на 5 вопросов о его компании, пользуясь только созданным мозгом (стратегия, продукт, клиент, цифра, роль). Покажи, из каких страниц взят каждый ответ.
2. Выведи список всех «✏️ ЗАПОЛНИТЬ» - это домашнее задание пользователя.
3. Заверши онбордингом «как с этим работать» - выведи пользователю памятку целиком:

> **Как работать со вторым мозгом (сохрани себе)**
>
> **Каждый день:**
> - Любой вопрос о компании задавай Claude как есть - мозг подгрузится сам, ответ будет по вашим фактам со ссылками.
> - Прошла встреча / принято решение / появился инсайт - сразу саммари: либо скажи Claude «добавь саммари в changelog: ...», либо через веб-интерфейс (для команды это основной путь). 3-10 предложений: что случилось, что решили, что делаем.
>
> **Каждую неделю (куратор, 5 минут):**
> - Пролистай changelog текущего месяца: нет ли дублей, брошенных TODO, важного без саммари.
>
> **Каждый месяц (куратор, 30-60 минут):**
> - Скажи Claude: «переплавь changelog за месяц» - темы, всплывшие 2-3 раза, становятся страницами brain, крупные решения оформляются в ADR, дашборд метрик обновляется.
>
> **Каждый квартал (куратор, 2-3 часа):**
> - Скажи Claude: «проведи аудит мозга» - пройти индекс, протухшее пометить или удалить, распухшее разбить, прогнать eval-кейсы и сверить с эталонами.
>
> **Три правила, которые всё держат:**
> 1. Тему обсуждаем третий раз - ей пора стать страницей brain.
> 2. Писать в мозг может любой сотрудник без согласований - от хаоса страхуют куратор и git-история.
> 3. Без куратора мозг умирает за 2-3 месяца. Назначь владельца и поставь ритмы в календарь прямо сейчас.

---

*Схема опирается на идеи Андрея Карпатого (LLM as OS: индекс вместо «загрузить всё», страницы как код, evals-first) и Anthropic «Building effective agents» (узкие роли, общение через файлы). Вопросы - Алексей Бирюков, ИдаПроджект.*