feat: initial dream-core-start plugin

Skill 'старт' — handoff протокол між сесіями Dream Core. - skills/start/SKILL.md: 10 steps Part 1 (старт сесії) + 8 steps Part 2 (закриття) - userConfig: memory_dir + project_dir for cross-machine portability - Paths parameterized via ${MEMORY_DIR} / ${PROJECT_DIR} placeholders - License: MIT
2026-05-15 12:08:42 +03:00
commit 824f99c14b
5 changed files with 318 additions and 0 deletions
@@ -0,0 +1,221 @@
+---
+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_<slug>.md
+```
+
+Шаблон:
+```markdown
+---
+name: Сессия YYYY-MM-DD — <короткое название>
+description: <ключевые темы через запятую>
+type: project
+---
+
+## Корень проблемы (если был аудит)
+<симптом + диагностика>
+
+## Что сделано
+| # | Файл | Изменение | Эффект |
+|---|---|---|---|
+| 1 | path | что | зачем |
+
+## Hash-update (если protected files менялись)
+<old → new>
+
+## Доказательства совпадения цели и поведения
+<метрики ДО vs ПОСЛЕ>
+
+## Что НЕ зафиксили (отложено)
+<пункты>
+
+## Скиллы использованы
+<root-cause-fix, agent-restart-verify, ...>
+
+**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/<slug>.md
+```
+Шаблон:
+```markdown
+---
+name: <короткое имя>
+description: <одна строка>
+type: project
+---
+# <Заголовок>
+## Симптом
+## Корень
+## Решение (предложение)
+**Why:** <почему важно>
+**How to apply:** <когда чинить>
+```
+
+Если **закрыли в этой сессии** проблему которая была в `known_issues/` — переименовать в `name: ЗАКРЫТА YYYY-MM-DD — ...` + добавить ссылку на session.
+
+### Шаг 5: новые планы → `roadmap/`
+План развития → `${MEMORY_DIR}/roadmap/<slug>.md`. Старые планы НЕ удалять (помечать ✅ в `MEMORY.md` индексе).
+
+### Шаг 6: обновить `MEMORY.md` индекс
+- Если новая фаза или важная веха → добавить в хронологию
+- Закрытые known_issues помечать ✅
+- Новые roadmap-файлы добавлять с пометкой "← АКТИВНЫЙ"
+
+### Шаг 7: навести порядок
+- Свежий `session_*.md` остаётся в корне `${MEMORY_DIR}/`
+- Если в корне 3+ session_* — старые в `archive_sessions/`
+- Устаревшие audit-доки → `archive_audits/`
+
+### Шаг 8: подтвердить Антону
+> "Память сохранена. Session: <slug>. 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: команды + ожидаемые значения + триггеры.