/mm-resume

name: mm-resume
version: 0.4.0
description: Восстановить контекст в начале сессии или после /clear. Читает passport.md + dashboard + последнюю сессию + git status + (если есть GSD) полный контекст планирования (.planning/ для v1 или .gsd/ для v2 — STATE, ROADMAP, текущий phase CONTEXT/PLAN, HANDOFF.json). Выдаёт компактную сводку «где мы». Use when user says "ну что у нас", "напомни где мы остановились", "вернулся", "возобновляю", "/mm resume", "/mm start", "/mm context", "что у нас по проекту", "где мы" в начале новой сессии Claude Code или после /clear.

mm-resume — Context Restore for Claude Code

Решает проблему: после `/clear`, `exit && claude`, или после паузы на день — нет контекста. Этот skill за один вызов читает все источники и говорит «где мы, что в работе, что брать следующим».

**Это аналог git status, но для проекта в целом** — не для рабочей копии, а для головы.

Когда вызывать

• В начале новой Claude Code сессии в проекте — первая команда
• После `/mm save` → `/clear` — восстановить контекст в той же сессии
• После недели паузы — догнать что вообще происходило
• Когда юзер пишет «где мы», «что у нас», «напомни» — сразу запускай, не переспрашивай

Конфиг

Загрузи `mm-config.json` по алгоритму из `<repo>/docs/CONFIG-LOADING.md`. Поддержка `mm-config.local.json` overlay обязательна.

Понадобятся:

• `paths.obsidian_projects`
• `paths.obsidian_sessions` (на случай старого формата без папки проекта)

Процесс

Шаг 0. Фоновый автоапдейт mm-системы (неблокирующий)

Выполни в фоновом режиме команду проверки обновлений:

• На macOS/Linux: `python3 $MM_REPO_ROOT/scripts/auto-update.py --background &` (или используя путь `~/.markdown-memory/scripts/auto-update.py` если переменная не задана)
• На Windows: запусти `python` со скриптом `auto-update.py --background` в фоновом режиме (скрипт сам сделает Popen detached-процесс и мгновенно вернет управление).

Шаг 1. Определи проект (worktree-aware)

То же что в `mm-init-project` Phase 0:

• Если cwd внутри `.claude/worktrees/...` — resolve до main repo через `.git` файл-указатель
• Иначе — поднимись до корня (где `.git/`, `package.json`, `pyproject.toml`, и т.п.)
• Имя проекта = из `passport.md` frontmatter (если есть) ИЛИ basename корневой папки

Если в проекте **нет** `passport.md` — скажи: `Проект не инициализирован для mm. Запустить /mm new сначала?` и остановись.

Шаг 2. Прочитай источники (параллельно если можно)

2a. Паспорт

• `<project_root>/passport.md` — frontmatter, секция 8 (контекст промптов), секция 10 (текущее состояние)

2b. Obsidian-артефакты (Obsidian Knowledge Vault)

• Определи путь к хранилищу `<vault_root>` (из секции `## Obsidian Knowledge Vault` в `CLAUDE.md`, либо дефолтная локальная папка `.vault/`, либо глобальная папка проекта `<obsidian_projects>/<name>/`).
• Прочитай `<vault_root>/00-home/текущие приоритеты.md` — извлеки текущие цели, WIP и следующие шаги.
• Прочитай `<vault_root>/00-home/index.md` — для понимания структуры доступных в `knowledge/` и `atlas/` заметок.
• `<vault_root>/handoff.md` (если есть) — последний snapshot для chat; обязательно вытащи секцию «Точка возврата» (следующий шаг + висящее: неотправленный промпт прошлой сессии, недоделанное, WIP).
• `<vault_root>/sessions/` — найди самый свежий .md по mtime; прочти секции «Что сделано», «Открытые вопросы», «Следующие шаги».
• Если текущая задача пользователя касается конкретных интеграций, решений или архитектурных вопросов, найди релевантные заметки в `<vault_root>/knowledge/` (или в `atlas/`) и предложи агенту прочитать их.

2c. Git-контекст

git rev-parse --show-toplevel
git branch --show-current
git status --short              # сколько uncommitted
git log --oneline -5            # последние коммиты
git stash list 2>/dev/null      # есть ли stash'ы

2d. GSD-контекст (dual-detection v1/v2/core)

Сначала определи версию:

• `<project_root>/.planning/` существует:
• Если `<project_root>/.planning/config.json` существует → **GSD Core**
• Иначе → **GSD v1**
• `<project_root>/.gsd/` существует → **GSD v2**
• Оба → используй `gsd_version` из passport frontmatter; если нет — спроси.
• Ничего нет → пропусти секцию.

**Если GSD v1 или GSD Core (`.planning/`)** — прочитай в этом порядке (приоритет ↓):

1. **`.planning/STATE.md`** — главное. Из него: текущий milestone, position (phase/step), последние решения, blockers. 2. **`.planning/HANDOFF.json`** (если существует) — самый свежий snapshot от `/gsd-pause-work`. Если его mtime > чем у последней mm-сессии — приоритет HANDOFF. 3. **`.planning/ROADMAP.md`** — список фаз с `[x]/[~]/[ ]`. Покажи позицию: фаза X из Y, прогресс milestone'а. 4. **`.planning/phases/<NN-current>/CONTEXT.md`** (если есть текущая фаза) — preferences и решения этой фазы. Это критично — покажет что мы решали в текущей фазе. 5. **`.planning/phases/<NN-current>/PLAN.md`** — что планировали. Извлеки список задач, посчитай completed/pending. 6. **`.planning/phases/<NN-current>/SUMMARY.md`** (если фаза завершена) — итог. 7. **`.planning/threads/`** (если есть) — активные темы для cross-session.

**Если GSD v2 (`.gsd/`)**:

1. **`.gsd/STATE.md`** (rendered dashboard от gsd CLI) — главное. 2. **`.gsd/AGENTS.md`** — preferences для агентов (равно `CONTEXT.md` v1). 3. **`.gsd/gsd.db`** (SQLite) — опционально, если есть `sqlite3` в PATH. Используй абсолютный путь от `<project_root>`:

   sqlite3 "<project_root>/.gsd/gsd.db" "SELECT name, status FROM milestones WHERE active=1; SELECT name, status FROM slices WHERE milestone_id=(SELECT id FROM milestones WHERE active=1); SELECT title, status FROM tasks WHERE slice_id=(SELECT id FROM slices WHERE active=1) LIMIT 10;"

Парси вывод. Если sqlite3 недоступен — пропусти, сводка будет беднее но не сломается.

**Это эквивалент `/gsd-progress` плюс часть `/gsd-resume-work`** — встроено сюда, не нужно дёргать GSD-команды отдельно.

**Не пиши в `.planning/*` или `.gsd/*`** — только читай (там file-lock'и и охраняющие хуки).