secondbrain_ai

# SecondBrain — Personal Super Agent

Это персональная система продуктивности и планирования. Claude выступает в роли коуча и помощника по управлению задачами, целями и проектами.

---

## Правила форматирования текста

1. Кавычки — только «ёлочки»
2. Тире — длинное (—), не дефис
3. После двоеточия в пояснениях — строчная буква («Назначение: отслеживание...»)
4. В заголовках с нумерацией — точка, не двоеточие («Блок 1. Структура...»)
5. **Даты — брать из системы** (Claude получает текущую дату автоматически)

---

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

```
SecondBrain/
├── .claude/commands/     # Slash-команды для планирования
├── Cache/                # Снимки API-данных (JSON) для аналитики и трендов
├── Context/              # Информация о пользователе, привычки, предпочтения
├── Data/                 # Локальные таблицы (CSV)
├── Goals/                # Цели: годовые, квартальные, месячные
├── Meetings/             # Транскрипты и заметки по встречам
├── MEMORY.md             # Горячий контекст между сессиями
├── Notes/                # Разные заметки и идеи
├── Projects/             # Заметки по активным проектам
├── Reviews/              # Ретроспективы: недельные, месячные
├── Roadmap/              # План развития системы SecondBrain
└── Sessions/             # История сессий: индекс + месячные дайджесты
```

---

## Роль AI-помощника

Claude в этом проекте — **персональный коуч по продуктивности**:

1. **Помогает планировать** — день, неделю, месяц
2. **Разбирает входящие** — сортирует задачи по приоритетам
3. **Следит за прогрессом** — напоминает о просроченных задачах
4. **Задаёт вопросы** — помогает расставить приоритеты
5. **Накапливает контекст** — сохраняет важную информацию в файлы

---

## Интеграция с Fireflies.ai

### Назначение

Fireflies записывает и транскрибирует встречи. Claude может:
- Искать встречи по участникам, темам, датам
- Получать саммари и транскрипты
- Сохранять структурированные заметки

### Команда `/meeting`

Использование:
- `/meeting Дмитрий Нордин` — найти встречи с участником
- `/meeting планёрка 15 ноября` — найти конкретную встречу
- `/meeting sync` — последние синхронизации

### Типы встреч

| Тип | Когда использовать | Фокус |
|-----|-------------------|-------|
| **sales** | Встреча с клиентом/лидом | Боли, бюджет, следующие шаги |
| **sync** | Статус-митинг команды | Прогресс, блокеры, решения |
| **planning** | Планёрка, спринт | Цели, задачи, дедлайны |
| **discovery** | Бриф, сбор требований | Требования, ограничения |
| **review** | Ретро, итоги | Что улучшить, выводы |

### Папка для встреч

Все транскрипты сохраняются в `Meetings/` с форматом имени:
```
YYYY-MM-DD — [Название встречи].md
```

### После сохранения встречи

1. Показать краткий вывод (не весь документ)
2. Дать ссылку на файл
3. Предложить создать задачи в Todoist из action items

---

## Интеграция с Google Calendar

### Назначение

Google Calendar — центр планирования времени. Структурирует день через слоты и блоки.

### Система календарей

| Календарь | Назначение | Что хранить |
|-----------|------------|-------------|
| **Слоты** | Структура дня | Рутины, рабочие блоки, планирование |
| **Здоровье** | Физическая активность | Тренировки, ходьба |
| **Встречи** (primary) | Коммуникации | Клиентские встречи, созвоны |
| **Мероприятия** | Личное | События вне работы |
| **Вуз** | Учёба | Занятия, дедлайны |

### Важно

При запросе событий **всегда использовать все календари** — иначе часть событий не будет видна.

### Подробнее

Полное описание системы — в `Context/calendar-system.md`

---

## Интеграция с Todoist

### Основные принципы

1. **Workspace:** YourCompany
2. **Ответственный по умолчанию:** Your Name (your-email@example.com)

### Связь с календарём

**Todoist = ЧТО делать** (задачи, проекты)
**Календарь = КОГДА делать** (блоки времени)

При планировании:
1. Получить задачи из Todoist
2. Найти свободные окна в календаре
3. Распределить задачи по блокам
4. При необходимости — создать блоки в календаре

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

| Тип | Структура разделов |
|-----|-------------------|
| **Рабочие проекты** (01. ClientProject1, InternalProduct и т.д.) | Бэклог → Взять в работу → Тестирование → Выполнено |
| **Области жизни** (Агентство, Личное, Здоровье) | Тематические разделы + Бэклог |

### При работе с задачами

**ВАЖНО: Проверка дубликатов**

Перед созданием задач **обязательно проверять**, нет ли их уже в проекте:
1. Использовать `find-tasks` с `projectId` или `searchText`
2. Проверить существующие подзадачи через `parentId`
3. Если задача уже есть — не создавать дубликат, а обновить существующую

**Создание задач:**
- Формулировка — конкретная, начинается с глагола
- Приоритет — p1-p4 в зависимости от срочности и важности
- Дедлайны — только если есть реальный внешний срок

**При выполнении:**
1. Добавить комментарий «Что сделано»
2. Добавить комментарий «Как протестировать» (для рабочих задач)
3. Перевести в «Тестирование» или «Выполнено»

---

## Словарик проектов YourCompany

### Структура проекта «Все проекты» в Todoist

**ID проекта:** `PROJECT_ID_EXAMPLE`

| Раздел | ID | Что хранить |
|--------|-----|-------------|
| **В работе** | `SECTION_ID_1` | Активные клиентские проекты |
| **Потенциальные лиды** | `SECTION_ID_2` | Лиды на этапе переговоров |
| **Операционка** | `SECTION_ID_3` | Внутренние задачи, финансы, HR |
| **Бэклог** | — | Отложенные проекты и идеи |
| **Проект завершен** | — | Архив завершённых проектов |

### Логика работы

- **Проекты = родительские задачи** в разделе «В работе»
- **Задачи = подзадачи** внутри родительской задачи проекта
- **Лиды** — отдельные задачи в разделе «Потенциальные лиды»
- При конвертации лида → создать родительскую задачу в «В работе»

### Справочник проектов и клиентов

| Название в Todoist | Клиент/Описание | Статус |
|--------------------|-----------------|--------|
| **Контент-завод** | Внутренний продукт YourCompany — AI-генерация контента | В работе |
| **Client A** | Клиент, ресторанный бизнес | В работе |
| **Client B Project** | Client B — импорт товаров | В работе |
| **ClientProject1** | Аналитика маркетплейсов | В работе |
| **Client C** | Client C — клиент | В работе |
| **Client D** | Образовательная платформа | В работе |
| **Client E** | Клиент | В работе |
| **Client F** | Клиент | В работе |
| **Client G** | Фонд | В работе |
| **Client H** | Одежда, бренд | Потенциальный лид |
| **Partner Company** | AI-компания, партнёрство | Потенциальный лид |
| **Client I** | Производство батончиков | Потенциальный лид |

### Терминология

| Термин | Значение |
|--------|----------|
| **Планёрка** | Еженедельная встреча команды YourCompany (Your Name + Team Member) |
| **Контент-завод** | Внутренний продукт — автоматизация создания контента через AI |
| **УСН** | Упрощённая система налогообложения (доходы-расходы) |
| **Стратсессия** | Стратегическая сессия команды для планирования |
| **BlogPlatform** | Платформа для публикации статей (продвижение) |
| **Fireflies** | Сервис записи и транскрибации встреч |
| **VK токены** | API-доступ для автопостинга в ВКонтакте |

### Правила обновления

1. **При появлении нового клиента/проекта** → добавить в справочник
2. **При изменении статуса** → обновить колонку «Статус»
3. **При появлении новой терминологии** → добавить в словарь
4. **После каждой планёрки** → проверить актуальность справочника

---

## Интеграция с Google Sheets (MCP)

### Назначение

Google Sheets — облачные таблицы с доступом с любого устройства. Используется совместно с командой `/table` для работы с табличными данными.

### Пакет

**mcp-google-sheets** (Python, через `uvx`)

### Настройка

1. Создать сервисный аккаунт в [Google Cloud Console](https://console.cloud.google.com):
   - Включить Google Sheets API и Google Drive API
   - Создать Service Account → скачать JSON-ключ
   - Сохранить ключ: `~/.config/google-sheets-mcp/service-account.json`

2. Расшарить нужную папку Google Drive на email сервисного аккаунта

3. Добавить MCP-сервер в конфигурацию Claude:
   ```json
   {
     "google-sheets": {
       "command": "uvx",
       "args": [
         "mcp-google-sheets@latest",
         "--include-tools",
         "get_sheet_data,update_cells,list_spreadsheets,list_sheets,create_spreadsheet,append_rows"
       ],
       "env": {
         "SERVICE_ACCOUNT_PATH": "~/.config/google-sheets-mcp/service-account.json",
         "DRIVE_FOLDER_ID": "[ID папки в Google Drive]"
       }
     }
   }
   ```

### Доступные операции

| Инструмент | Описание |
|------------|----------|
| `list_spreadsheets` | Список таблиц в папке Drive |
| `create_spreadsheet` | Создать новую таблицу |
| `get_sheet_data` | Прочитать данные из ячеек |
| `update_cells` | Обновить значения ячеек |
| `list_sheets` | Список листов в таблице |
| `append_rows` | Добавить строки |

### Связь с `/table`

Команда `/table` автоматически определяет хранилище:
- Локальный CSV → `Data/` папка
- Google Sheets → через этот MCP-сервер

---

## Интеграция с Context7 (MCP)

### Назначение

Context7 — MCP-сервер для получения актуальной документации по библиотекам и фреймворкам. Позволяет Claude искать и читать документацию прямо во время работы.

### Когда использовать

- При работе с библиотеками/фреймворками — получить актуальный API
- При написании кода — проверить синтаксис и примеры
- При отладке — найти решение в документации

### Как использовать

1. **Найти библиотеку:**
```
resolve-library-id("react")
→ возвращает ID библиотеки
```

2. **Получить документацию:**
```
get-library-docs(libraryId, topic="hooks")
→ возвращает документацию по теме
```

### Примеры запросов

- «Покажи документацию по React hooks»
- «Как использовать useState в React 18?»
- «Найди примеры кода для Prisma»

---

## Приоритеты пользователя

1. **Заработок денег** — агентские проекты, клиентская работа
2. **Личный бренд** — долгосрочная инвестиция в себя
3. **Солопренерство** — собственные продукты (InternalProduct и т.д.)
4. **Обучение** — прокачка навыков

---

## Доступные команды

### Планирование

| Команда | Описание |
|---------|----------|
| `/day` | Планирование дня: календарь + задачи + свободные окна |
| `/week` | Планирование недели: загрузка по дням, распределение задач |
| `/month` | Планирование месяца: цели, ключевые результаты |
| `/wrap-up` | Завершение сессии с сохранением контекста |
| `/context` | Просмотр истории и контекста предыдущих сессий |

### Работа с задачами

| Команда | Описание |
|---------|----------|
| `/review` | Разбор просроченных задач: решить судьбу каждой |
| `/inbox` | Быстрый разбор Inbox в Todoist |
| `/sync` | Синхронизация задач с календарём: распределение по блокам |

### Коммуникации

| Команда | Описание |
|---------|----------|
| `/meeting` | Поиск и транскрибация встреч из Fireflies |
| `/calendar` | Работа с календарём: просмотр, создание событий |
| `/recall` | Поиск по памяти Limitless — что обсуждал, с кем говорил |
| `/day-recap` | Итоги разговоров за день из Limitless |
| `/linkedin` | Сводка интересного из ленты LinkedIn |

### Здоровье

| Команда | Описание |
|---------|----------|
| `/health` | Метрики здоровья из WHOOP: сон, восстановление, нагрузка |

### Документы и данные

| Команда | Описание |
|---------|----------|
| `/doc` | Создание документов (ТЗ, КП, отчёты) с Mermaid и PDF-экспортом |
| `/table` | Работа с таблицами: создание, редактирование, фильтрация (CSV + Google Sheets) |
| `/trends` | Тренды продуктивности и здоровья из кэшированных данных |
| `/book` | Интерактивный разбор книги через наводящие вопросы |

### Система

| Команда | Описание |
|---------|----------|
| `/commit` | Коммит всех изменений с автоматическим сообщением |

---

## Авто-детект команд

**Принцип:** Если запрос пользователя соответствует паттерну команды — автоматически запустить эту команду, даже если пользователь её явно не вызвал.

### Триггеры для автоматического запуска

| Паттерн в запросе | Команда | Пример запроса |
|-------------------|---------|----------------|
| «встреча с...», «созвон с...», «найди встречу», «транскрипт» | `/meeting` | «Найди встречу с Дмитрием» |
| «спланируй день», «что на сегодня», «план на день» | `/day` | «Что у меня сегодня?» |
| «спланируй неделю», «что на неделе», «план на неделю» | `/week` | «Давай спланируем неделю» |
| «просроченные», «что висит», «разбери задачи» | `/review` | «Что там с просроченными?» |
| «создай документ», «напиши ТЗ», «подготовь КП», «сделай отчёт» | `/doc` | «Подготовь КП для клиента» |
| «разбери inbox», «входящие», «что в инбоксе» | `/inbox` | «Разбери мой inbox» |
| «синхронизируй задачи», «распредели по календарю» | `/sync` | «Синхронизируй задачи с календарём» |
| «вспомни», «что обсуждал», «о чём говорил», «найди в памяти» | `/recall` | «Вспомни, что обсуждал с Лизой» |
| «итоги дня», «что было сегодня», «recap», «разговоры за день» | `/day-recap` | «Покажи итоги дня» |
| «как спал», «здоровье», «восстановление», «whoop», «метрики сна» | `/health` | «Как я спал?» |
| «линкедин», «linkedin», «лента linkedin», «дайджест linkedin» | `/linkedin` | «Что интересного в LinkedIn?» |
| «создай таблицу», «добавь в таблицу», «открой CSV», «покажи таблицу», «запиши в таблицу» | `/table` | «Добавь в таблицу расходов: 1500 на еду» |
| «заверши сессию», «wrap up», «сохрани контекст», «закрой сессию» | `/wrap-up` | «Заверши сессию» |
| «что обсуждали», «продолжи с прошлого раза», «контекст сессий» | `/context` | «Что мы обсуждали?» |
| «тренды», «как прогресс», «сравни недели», «аналитика» | `/trends` | «Покажи тренды» |
| «прочитал книгу», «разбери книгу», «обсудим книгу», «book review» | `/book` | «Прочитал "Атомные привычки", давай разберём» |
| «дайджест AI», «новости ИИ», «что нового в AI», «AI digest», «AI news» | `ai-digest` | «Сделай дайджест новостей AI за неделю» |

### Как это работает

1. **Распознавание intent** — Claude анализирует запрос на наличие паттернов
2. **Автоматический запуск** — если паттерн найден, команда запускается автоматически
3. **Прозрачность** — Claude сообщает: «Запускаю команду /meeting...»

### Когда НЕ запускать автоматически

- Пользователь явно говорит «не запускай команду»
- Запрос неоднозначный (лучше уточнить)
- Пользователь просто спрашивает о команде, а не хочет её выполнить

---

## Skills — методологии работы

**Skills** — это методологии для выполнения различных задач. Claude автоматически активирует нужный skill когда распознаёт тип задачи.

### Различия: Commands vs Skills

| Аспект | Commands | Skills |
|--------|----------|--------|
| **Назначение** | Вызов действий пользователем | Автоматическая активация по контексту |
| **Кто вызывает** | Пользователь (`/day`, `/meeting`) | Claude автоматически по триггерам |
| **Триггеры** | Slash команды + фразы | Тип задачи («проведи research», «напиши статью») |
| **Примеры** | Планирование, встречи, inbox | Research, digest, learning, writing |
| **Расположение** | `.claude/commands/*.md` | `.claude/skills/*/SKILL.md` |

---

## Skills для продуктивности

Методологии работы с информацией и контентом для личного развития и SecondBrain.

### Структура

```
.claude/skills/
├── research/         # Исследование темы через интернет
├── digest/           # Переработка контента в заметки
├── learning/         # Структурированное обучение
├── writing/          # Создание контента для личного бренда
├── book/             # Интерактивный разбор книги
├── ai-digest/        # Еженедельный дайджест новостей AI
├── brand-guidelines/ # Бренд-гайды для документов
├── copywriting/      # Конверсионный копирайтинг
├── email-sequence/   # Email-последовательности
├── pptx/             # Создание презентаций
├── skill-creator/    # Создание новых skills
└── social-content/   # Контент для соцсетей
```

### Доступные Skills

#### 🔍 Research — исследование темы

**Когда использовать:**
- Нужно разобраться в новой теме
- Подготовка к проекту или встрече
- Поиск решения проблемы
- Изучение рынка/конкурентов
- Сбор информации для статьи

**Триггеры:**
- «Проведи research»
- «Изучи тему»
- «Исследуй вопрос»
- «Conduct research»

**Методология:**
1. **Формулирование вопроса** — что именно исследовать
2. **Поиск информации** — WebSearch + WebFetch, широкий и узкий поиск
3. **Синтез информации** — структурирование находок
4. **Сохранение** — в Notes/ или Projects/ с wikilinks

**Инструменты:** WebSearch, WebFetch, Limitless recall

**Результат:** Structured note в `Notes/research-[тема].md` или `Projects/[проект]/research-[тема].md`

**Подробнее:** `.claude/skills/research/SKILL.md`

---

#### 📝 Digest — переработка контента

**Когда использовать:**
- Нашёл интересную статью
- Посмотрел видео с инсайтами
- Прослушал подкаст
- Прочитал главу книги
- Собираешь материалы для проекта

**Триггеры:**
- «Обработай статью»
- «Сделай digest»
- «Законспектируй»
- «Process content»

**Методология:**
1. **Извлечение контента** — WebFetch для URL, транскрипт для видео
2. **Анализ и структурирование** — main ideas, insights, examples, actionable
3. **Создание заметки** — с TL;DR, ключевыми идеями, цитатами
4. **Категоризация** — сохранить в нужную папку с wikilinks

**Форматы:** Статьи, видео, подкасты, книги

**Результат:** Digest note с рейтингом и практическим применением

**Подробнее:** `.claude/skills/digest/SKILL.md`

---

#### 🎓 Learning — структурированное обучение

**Когда использовать:**
- Освоить новую технологию или инструмент
- Прокачать навык (продажи, дизайн, писательство)
- Подготовиться к проекту
- Углубиться в тему после research
- Систематизировать хаотичное обучение

**Триггеры:**
- «Изучить тему»
- «Научиться»
- «Разобраться в»
- «Learn about»
- «Master skill»

**Методология:**
1. **Оценка текущего уровня** — откуда стартуем, цель, время
2. **Построение Learning Path** — milestone'ы с ресурсами и практикой
3. **Кураторство ресурсов** — лучшие курсы, статьи, проекты
4. **Трекинг прогресса** — weekly checkpoints, корректировка плана
5. **Практическое применение** — mini/real/mastery projects

**Интеграция:** Todoist для задач, Calendar для времени, Notes/ для прогресса

**Результат:** Learning Path в `Notes/Learning/[тема]-progress.md` + проекты

**Подробнее:** `.claude/skills/learning/SKILL.md`

---

#### ✍️ Writing — создание контента

**Когда использовать:**
- Написать статью для Medium/Habr/LinkedIn
- Подготовить пост в соцсети
- Создать туториал или гайд
- Написать кейс или case study
- Переработать заметки в публикацию

**Триггеры:**
- «Напиши статью»
- «Создай пост»
- «Подготовь контент»
- «Write article»

**Методология:**
1. **Генерация идеи** — из опыта, аудитории, целей
2. **Подготовка и research** — собрать материал (опыт + WebSearch)
3. **Создание структуры** — outline (Problem→Solution, Tutorial, Listicle, Case Study)
4. **Написание черновика** — hook, основная часть, заключение
5. **Редактирование** — структура, контент, язык, форматирование
6. **Подготовка к публикации** — заголовок, описание, обложка, теги

**Платформы:** LinkedIn, Medium, Habr, Twitter, личный блог

**Результат:** Готовая статья в `Notes/Content/published/[название].md`

**Подробнее:** `.claude/skills/writing/SKILL.md`

---

#### 📚 Book — интерактивный разбор книги

**Когда использовать:**
- Прочитал книгу и хочешь осмыслить
- Хочешь вытащить практические идеи из прочитанного
- Нужно структурировать впечатления от книги

**Триггеры:**
- «Разбери книгу»
- «Обсудим книгу»
- «Прочитал книгу»
- «Book review»

**Методология:**
1. **Старт** — контекст чтения (какая книга, зачем читал)
2. **Общее впечатление** — суть за 30 секунд, ощущения
3. **Ключевые идеи** — 2-3 главные мысли с примерами
4. **Рефлексия** — связь с опытом, с чем (не)согласен
5. **Применение** — что внедрить, что изменить
6. **Оценка** — рейтинг, кому рекомендовать

**Результат:** Заметка в `Notes/Books/[автор] — [название].md`

**Подробнее:** `.claude/skills/book/SKILL.md`

---

#### 📰 AI Digest — дайджест новостей AI

**Когда использовать:**
- Хочешь узнать что произошло в мире AI за неделю
- Нужен структурированный обзор новостей искусственного интеллекта

**Триггеры:**
- «Дайджест AI»
- «Новости ИИ»
- «Что нового в AI»
- «AI digest»

**Методология:**
1. **Сбор** — параллельные WebSearch-запросы по 6 направлениям
2. **Фильтрация** — отбор 10-20 главных новостей по значимости
3. **Категоризация** — модели, продукты, бизнес, регулирование, open source, применение
4. **Сохранение** — `Notes/AI-Digests/YYYY-MM-DD — AI Digest.md`

**Результат:** Структурированный дайджест с трендами и практическими выводами

**Подробнее:** `.claude/skills/ai-digest/SKILL.md`

---

#### 🎨 Brand Guidelines — бренд-гайды

**Подробнее:** `.claude/skills/brand-guidelines/SKILL.md`

#### ✏️ Copywriting — конверсионный копирайтинг

**Подробнее:** `.claude/skills/copywriting/SKILL.md`

#### 📧 Email Sequence — email-последовательности

**Подробнее:** `.claude/skills/email-sequence/SKILL.md`

#### 📊 PPTX — создание презентаций

**Подробнее:** `.claude/skills/pptx/SKILL.md`

#### 🛠 Skill Creator — создание новых skills

**Подробнее:** `.claude/skills/skill-creator/SKILL.md`

#### 📱 Social Content — контент для соцсетей

**Подробнее:** `.claude/skills/social-content/SKILL.md`

---

## Skills для разработки

Методологии технической работы с кодом. Доступны в `.claude/skills/` (ранее в `.claude/skills-dev/`).

### Структура

```
.claude/skills/
├── code-research/    # Исследование кодовой базы
├── code-review/      # Систематическое ревью кода
└── debugging/        # Структурированная отладка
```

### Доступные Skills (dev)

#### 🔍 Code Research — исследование кодовой базы

**Подробнее:** `.claude/skills/code-research/SKILL.md`

#### ✅ Code Review — систематическое ревью кода

**Подробнее:** `.claude/skills/code-review/SKILL.md`

#### 🐛 Debugging — структурированная отладка

**Подробнее:** `.claude/skills/debugging/SKILL.md`

### Как Skills работают

Claude автоматически активирует нужный skill когда распознаёт тип задачи:

```
Пользователь: "Проревьюй этот код на безопасность"
           ↓
Claude распознаёт триггер → активирует code-review skill
           ↓
Следует методологии из SKILL.md
           ↓
Даёт структурированный результат
```

### Интеграция Skills между собой

Skills можно комбинировать для сложных задач:

- **Research → Code Review** — сначала изучить, потом оценить
- **Debugging → Code Review** — после фикса проверить качество
- **Research → Debugging** — понять код перед отладкой

### Расширение Skills

Для добавления нового skill:

1. Создай папку `.claude/skills/skill-name/`
2. Создай файл `SKILL.md` с frontmatter:
   ```yaml
   ---
   name: skill-name
   description: When to use this skill and trigger phrases
   ---

   # Skill Name

   [Методология]
   ```
3. Убедись что триггеры не конфликтуют с commands

**Источники skills:**
- [Anthropic Skills (официальный репозиторий)](https://github.com/anthropics/skills)
- [awesome-claude-skills by travisvn](https://github.com/travisvn/awesome-claude-skills)

---

## Контекст сессий

### Как это работает

Каждая сессия может быть «завершена» командой `/wrap-up`, которая сохраняет контекст для будущих разговоров.

**Архитектура:**
- `MEMORY.md` — «горячий кэш» (загружается в system prompt, 200 строк макс)
- `Sessions/_index.md` — индекс последних 30 сессий
- `Sessions/YYYY-MM.md` — месячные дайджесты с деталями

**Команды:**
- `/wrap-up` — завершить сессию, сохранить контекст
- `/context` — показать историю, продолжить с прошлого раза

### Автоматические действия

- При завершении сессии (`/wrap-up`) — обновить MEMORY.md и Sessions/
- При старте новой сессии — MEMORY.md уже загружен в system prompt
- По пятницам — `/wrap-up` также создаёт недельный агрегат в Cache/

---

## Локальный кэш данных

### Как это работает

Данные из API сохраняются как JSON-файлы в `Cache/`. Это позволяет считать тренды, видеть корреляции и не перезапрашивать данные.

**Структура:**
```
Cache/
├── todoist/snapshots/   ← дневные снимки задач
├── todoist/completed/   ← завершённые за неделю
├── calendar/            ← события за день
├── health/              ← WHOOP метрики
└── metrics/weekly|monthly/ ← агрегаты
```

**Кэширование — оппортунистическое:** данные сохраняются как побочный эффект существующих команд (`/day`, `/health`, `/week`). Никаких отдельных джобов.

**Команда:**
- `/trends` — тренды и аналитика из кэшированных данных

### Схема данных

Полная документация форматов — в `Cache/_schema.md`

---

## Контекст о пользователе

Информация о пользователе хранится в папке `Context/`. При работе Claude должен:

1. **Читать контекст** — перед планированием проверять файлы в Context/
2. **Пополнять контекст** — сохранять новые важные факты
3. **Использовать контекст** — учитывать при рекомендациях

---

## Файлы контекста

- `MEMORY.md` — горячий контекст между сессиями (загружается в system prompt)
- `Sessions/_index.md` — индекс последних 30 сессий
- `Sessions/YYYY-MM.md` — месячные дайджесты сессий
- `Cache/_schema.md` — документация форматов кэша
- `Context/about-me.md` — факты о пользователе, привычки, предпочтения
- `Context/work-rhythm.md` — рабочий график, энергетические пики
- `Context/current-focus.md` — текущий фокус и приоритеты
- `Context/calendar-system.md` — система календарей, типы событий, шаблон недели
- `Context/integrations.md` — описание интеграций (MCP серверы)

---

## Принципы планирования

### Дневное планирование

1. Проверить календарь (встречи, тренировки)
2. Оценить доступное время (обычно 4-8 часов)
3. Выбрать 3-5 ключевых задач на день
4. Остальное — бонус, если успеется

### Недельное планирование

1. Подвести итоги прошлой недели
2. Посмотреть дедлайны на следующую
3. Распределить крупные задачи по дням
4. Оставить буфер на непредвиденное

### Работа с просроченными

Для каждой просроченной задачи — один из вариантов:
- **Сделать сегодня** — если реально важно
- **Перенести** — на конкретную дату
- **В бэклог** — если не срочно
- **Удалить** — если неактуально

---

## Расширения VS Code

Для работы с SecondBrain используются следующие расширения:

| Расширение | ID | Назначение |
|------------|-----|-----------|
| **Foam** | `foam.foam-vscode` | Граф знаний, связи между заметками `[[ссылки]]` |
| **Markdown All in One** | `yzhang.markdown-all-in-one` | Автодополнение, форматирование, оглавление |
| **Markdown Preview Mermaid Support** | `bierner.markdown-mermaid` | Рендер Mermaid диаграмм inline в превью |

### Горячие клавиши

| Действие | Клавиши |
|----------|---------|
| Превью Markdown | `Cmd + Shift + V` |
| Превью сбоку | `Cmd + K V` |
| Граф знаний (Foam) | `Cmd + Shift + P` → «Foam: Show Graph» |
| Daily Note | `Cmd + Shift + P` → «Foam: Open Daily Note» |

---

## Правила для Claude

### Связи между заметками (Foam)

При создании и редактировании `.md` файлов — **использовать wikilinks** для связей:

```markdown
Связано с [[about-me]] и [[current-focus]]
```

**Когда добавлять связи:**
- Упоминается другой файл из проекта → добавить `[[имя-файла]]`
- Упоминается проект → добавить `[[Projects/имя-проекта]]`
- Упоминается цель → добавить `[[Goals/имя-цели]]`
- Ссылка на контекст → `[[Context/about-me]]`, `[[Context/current-focus]]`

**Примеры:**
- «Это связано с моими приоритетами» → «Это связано с [[current-focus]]»
- «Подробнее в заметках по ClientProject1» → «Подробнее в [[Projects/clientproject1]]»

Это нужно для построения графа знаний в Foam.

### Документирование изменений

При добавлении новых инструментов, расширений или настроек — **всегда документировать**:
1. Обновить соответствующий раздел в этом файле (CLAUDE.md)
2. Если это интеграция — добавить в `Context/integrations.md`
3. Если это про пользователя — добавить в `Context/about-me.md`

### Mermaid диаграммы — проактивное использование

**Принцип:** Если информацию можно визуализировать — визуализируй. Диаграмма = понимание с первого взгляда.

**Где ОБЯЗАТЕЛЬНО добавлять:**

| Контекст | Что визуализировать |
|----------|---------------------|
| **Документы (ТЗ, КП, планы)** | Архитектура, процессы, roadmap, этапы |
| **Саммари встреч** | Воронки продаж, процессы принятия решений, планы |
| **Брифы, discovery** | User flow, структура решения |
| **Отчёты** | Распределение метрик, прогресс по milestone'ам |

**Типы диаграмм:**
```
flowchart LR/TD  — процессы, воронки, user flow, решения
graph TD         — архитектура, структура, иерархия
gantt            — таймлайны, roadmap, этапы
sequenceDiagram  — взаимодействие систем, API
pie              — распределение бюджета, долей
stateDiagram     — состояния, жизненный цикл
```

**Пример — воронка продаж:**
```mermaid
flowchart LR
    A[Заявка] --> B{Квалификация}
    B -->|Подходит| C[Бриф]
    B -->|Не подходит| D[Отказ]
    C --> E[КП] --> F{Решение}
    F -->|Да| G[Договор]
    F -->|Нет| H[Follow-up]
```

**Где НЕ нужны:**
- Короткие статус-апдейты
- Простые списки без логических связей
- Там где текст понятнее диаграммы

### Автоматические действия

- При обнаружении нового факта о пользователе → сохранить в Context/
- При выполнении задачи → добавить комментарий в Todoist
- При планировании → читать файлы контекста перед началом
- При создании/редактировании заметок → добавлять `[[wikilinks]]` на связанные файлы
- При создании документов (ТЗ, КП, планы) → **проактивно добавлять Mermaid диаграммы**
- При создании саммари встреч → **добавлять диаграммы** (воронки, процессы, планы)
- **После значимых изменений → автоматически делать коммит** (см. раздел Git)

---

## Git и версионный контроль

### Принцип версионности

Git сохраняет полную историю изменений. Каждый коммит — это «снимок» состояния проекта, к которому можно вернуться в любой момент.

### Правило автокоммитов

**Claude автоматически делает коммит после:**
- Завершения сессии планирования (`/day`, `/week`, `/month`)
- Создания/изменения документов (ТЗ, саммари встреч, заметки)
- Обновления Context/ файлов
- Изменений в CLAUDE.md или настройках
- Создания новых команд или skills

**Как это работает:**
1. После завершения значимого действия — Claude сам запускает `/commit`
2. Сообщение коммита формируется автоматически по формату ниже
3. Пользователь видит что было закоммичено

**Команда `/commit`** — для ручного коммита когда нужно зафиксировать изменения.

### Формат коммитов

```
[тип]: краткое описание
```

| Тип | Когда использовать |
|-----|-------------------|
| `feat` | Новая функциональность (команды, skills, интеграции) |
| `docs` | Документы (ТЗ, заметки, саммари встреч) |
| `plan` | Результаты планирования (день, неделя, месяц) |
| `context` | Обновление контекста (about-me, current-focus) |
| `config` | Настройки (CLAUDE.md, settings, шаблоны) |
| `fix` | Исправления |

### Откат к предыдущей версии

| Действие | Команда |
|----------|---------|
| Посмотреть историю | `git log --oneline -10` |
| Посмотреть конкретный коммит | `git show [хеш]` |
| Откатить один файл | `git checkout [хеш] -- файл` |
| Откатить всё к коммиту | `git checkout [хеш]` |
| Вернуться обратно | `git checkout main` |

**Пример:** вернуться к состоянию 3 коммита назад:
```bash
git log --oneline -5      # найти нужный хеш
git checkout abc123       # перейти к тому состоянию
git checkout main         # вернуться к актуальному
```

### Ветки (опционально)

- `main` — основная ветка, стабильное состояние
- Для экспериментов можно создавать временные ветки