--- name: старт description: Использовать при старте новой сессии работы над Dream Core. Объясняет как ознакомиться со всеми документами проекта и как правильно оставить документы для следующей сессии после окончания работы. Триггеры — "старт", "включи скилл старт", "начнём сессию", "новая сессия Dream Core". --- # Skill: старт — handoff протокол между сессиями Dream Core ## Цель Гарантировать что **каждая новая сессия Claude** входит в контекст за 5 минут, а **Антон** получает структурированный отчёт без копания в логах. Память — единственный канал между сессиями. Без обновления — следующая сессия слепая. --- ## Конфигурация путей Все пути к памяти и проекту берутся из `userConfig` плагина: - `${MEMORY_DIR}` — `userConfig.memory_dir` (default `~/.claude/projects/C--Users-anton/memory`) - `${PROJECT_DIR}` — `userConfig.project_dir` (default `C:\pro\terminal-agent`) Если плагин установлен с дефолтами — пути ниже разворачиваются автоматически. Если Антон переопределил `memory_dir` / `project_dir` (другая машина, другой проект) — подставлять значения из конфига перед чтением. --- ## 🟢 ЧАСТЬ 1 — Старт сессии (Claude читает в этом порядке) ### Шаг 1: МАСТЕР-документ (читать целиком) ``` ${MEMORY_DIR}/NEXT_SESSION_START_HERE.md ``` Это **единственный handoff документ** между сессиями. Содержит 4 секции: - **✅ ПОСЛЕДНЯЯ ПРОДЕЛАННАЯ РАБОТА** — что закрыто, какие файлы изменены, какой эффект - **👁 НАБЛЮДЕНИЯ** — live state + команды проверки - **🤖 РЕКОМЕНДАЦИИ CLAUDE CODE** — что делать новому Claude, что НЕ делать, приоритет фиксов - **👤 РЕКОМЕНДАЦИИ АНТОНУ** — что проверять, когда возвращаться, триггеры вмешательства Если этот файл свежий — большинство контекста ты уже понимаешь. ### Шаг 2: Индекс памяти ``` ${MEMORY_DIR}/MEMORY.md ``` Карта папки + хронология фаз + где что лежит. ### Шаг 3: Архитектура и грабли ``` ${MEMORY_DIR}/dream-core.md ``` 5 уровней защиты, текущий статус (обновлённый), хронология. ### Шаг 4: Профиль и правила работы ``` ${MEMORY_DIR}/user_profile.md ${MEMORY_DIR}/feedback_autonomy.md ${MEMORY_DIR}/feedback_dev_process.md ${MEMORY_DIR}/feedback_read_project_claude_md.md ``` ### Шаг 5: Главный гайд проекта (по необходимости) ``` ${PROJECT_DIR}/CLAUDE.md ``` 1813 строк. Читать **только если** мастер-документ ссылается на конкретный раздел или ты собираешься менять защищённые файлы. ### Шаг 6: Активные планы ``` ${MEMORY_DIR}/roadmap/dream_action_plan_after_critical_fixes.md ${MEMORY_DIR}/roadmap/dream_graduation_plan.md ``` ### Шаг 7: Известные проблемы ``` ${MEMORY_DIR}/known_issues/ ``` Те что без ✅ — открытые. ### Шаг 8: Последняя сессия (если есть детали) Самый свежий `session_YYYY_MM_DD_*.md` в корне `${MEMORY_DIR}/`. Если master-документ ссылается — читать. ### Шаг 9: Запустить команды проверки live state Из секции 👁 в `NEXT_SESSION_START_HERE.md`. Запустить ВСЕ, не пропуская. ### Шаг 10: Подтвердить понимание Антону Одной строкой: > "Память прочитана. Phase X/10, success=N (за час +M), win_rate=NN%, architecture=Y. Открытые TODO: <короткий список из 🤖 рекомендаций>. Готов к работе." **НЕ задавать уточняющих вопросов** до завершения шагов 1-9. --- ## 🔴 ЧАСТЬ 2 — Завершение сессии (обновление handoff) Триггеры: "хватит на сегодня", "сохраняем", "обновляй память", "до следующей сессии", "обнови память проекта". **Цель закрытия:** следующая сессия должна войти в контекст из ОДНОГО `NEXT_SESSION_START_HERE.md` (плюс детальный session_*.md для глубокого). ### Шаг 1: создать session-файл ``` ${MEMORY_DIR}/session_YYYY_MM_DD_.md ``` Шаблон: ```markdown --- name: Сессия YYYY-MM-DD — <короткое название> description: <ключевые темы через запятую> type: project --- ## Корень проблемы (если был аудит) <симптом + диагностика> ## Что сделано | # | Файл | Изменение | Эффект | |---|---|---|---| | 1 | path | что | зачем | ## Hash-update (если protected files менялись) ## Доказательства совпадения цели и поведения <метрики ДО vs ПОСЛЕ> ## Что НЕ зафиксили (отложено) <пункты> ## Скиллы использованы **Why:** <главная цель сессии> **How to apply:** <что проверить при возврате> ``` ### Шаг 2: обновить `NEXT_SESSION_START_HERE.md` (КРИТИЧНО) Переписать 4 секции под актуальное состояние: ```markdown ## ✅ ПОСЛЕДНЯЯ ПРОДЕЛАННАЯ РАБОТА (YYYY-MM-DD) <коротко: какая дыра закрыта, какие файлы, общий эффект> <ссылка на session_YYYY_MM_DD_*.md для деталей> ## 👁 НАБЛЮДЕНИЯ (live state) <команды проверки + ожидаемые значения> ## 🤖 РЕКОМЕНДАЦИИ CLAUDE CODE <что НЕ делать> <приоритет следующих фиксов> <обязательные скиллы перед изменениями> ## 👤 РЕКОМЕНДАЦИИ АНТОНУ <когда проверять> <триггеры вмешательства> <чего избегать> ``` **НЕ дублировать** содержимое session_*.md в master-документ — там ссылка. ### Шаг 3: обновить `dream-core.md` Добавить блок `## Текущий статус (YYYY-MM-DD, время — заголовок)` в начало (после frontmatter). Старый статус НЕ удалять — переименовать в `## Прошлый статус`. ### Шаг 4: новые проблемы → `known_issues/` Если выявлен НОВЫЙ баг, не закрылся: ``` ${MEMORY_DIR}/known_issues/.md ``` Шаблон: ```markdown --- name: <короткое имя> description: <одна строка> type: project --- # <Заголовок> ## Симптом ## Корень ## Решение (предложение) **Why:** <почему важно> **How to apply:** <когда чинить> ``` Если **закрыли в этой сессии** проблему которая была в `known_issues/` — переименовать в `name: ЗАКРЫТА YYYY-MM-DD — ...` + добавить ссылку на session. ### Шаг 5: новые планы → `roadmap/` План развития → `${MEMORY_DIR}/roadmap/.md`. Старые планы НЕ удалять (помечать ✅ в `MEMORY.md` индексе). ### Шаг 6: обновить `MEMORY.md` индекс - Если новая фаза или важная веха → добавить в хронологию - Закрытые known_issues помечать ✅ - Новые roadmap-файлы добавлять с пометкой "← АКТИВНЫЙ" ### Шаг 7: навести порядок - Свежий `session_*.md` остаётся в корне `${MEMORY_DIR}/` - Если в корне 3+ session_* — старые в `archive_sessions/` - Устаревшие audit-доки → `archive_audits/` ### Шаг 8: подтвердить Антону > "Память сохранена. Session: . NEXT_SESSION_START_HERE.md обновлён всеми 4 секциями. Следующая сессия — команда 'старт'." --- ## 🛠 Связанные скиллы (использовать активно) | Скилл | Когда | |---|---| | `root-cause-fix` | Перед ЛЮБЫМ багфиксом — найти корень | | `agent-restart-verify` | После правки кода Dream Core (особенно protected) — restart + grep + functional test | | `update-project-memory` | Альтернативный шаблон закрытия (если эта структура не подходит) | --- ## Правила (всегда) 1. **NEXT_SESSION_START_HERE.md — единственный handoff документ.** Не дублировать его контент в других местах. Только ссылки. 2. **Доказательства, не слова.** Каждое "сделано" подкреплять curl / лог / grep / `file_path:line`. 3. **Автономно.** Не спрашивать разрешения продолжать пока скилл не дошёл до конца. 4. **По-русски** — никакого английского кроме кода/команд/тулов. 5. **Скиллы поверх default** — `root-cause-fix` и `agent-restart-verify` проактивно. 6. **НЕ трогать protected files** (см. `${PROJECT_DIR}/scripts/protected_hashes.json`) без обновления SHA. 7. **Память — единственная связь между сессиями.** Без обновления master-документа следующий Claude слеп. 8. **Антон зашёл — он первым делом читает свою секцию** (👤 РЕКОМЕНДАЦИИ АНТОНУ) в master-документе. Эта секция должна быть actionable: команды + ожидаемые значения + триггеры.