v0.4.0 to v0.4.0

---

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_projects>/<name>/dashboard.md` — секция «Сейчас», «Последние сессии»

- `<obsidian_projects>/<name>/handoff.md` (если есть) — последний snapshot для chat; обязательно вытащи секцию «Точка возврата» (следующий шаг + висящее: неотправленный промпт прошлой сессии, недоделанное, WIP)

- `<obsidian_projects>/<name>/sessions/` — найди самый свежий .md по mtime; прочти секции «Что сделано», «Открытые вопросы», «Следующие шаги»

Если папки `<obsidian_projects>/<name>/` нет — попробуй legacy путь `<obsidian_sessions>/` отфильтровав по `project: <name>` в frontmatter.

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

```bash

git rev-parse --show-toplevel

git branch --show-current

git status --short # сколько uncommitted

git log --oneline -5 # последние коммиты

git stash list 2>/dev/null # есть ли stash'ы

```

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

- Оба → используй `gsd_version` из passport frontmatter; если нет — спроси.

- Ничего нет → пропусти секцию.

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>`:

```bash

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'и и охраняющие хуки).

#### 2e. mm-система (smoke check)

Быстрая проверка:

- `~/.claude/skills/mm-bridge` существует и junction живой → ✅

- Иначе — намекни запустить `/mm check`

Не делай полный `/mm-doctor` — это лишнее на старте, юзер вызовет если нужно.

### Шаг 3. Синтезируй сводку

Не просто вывали данные — **синтезируй**. Коротко, в одном экране. Веди той же формой, что и возвращение в claude.ai: **ориентир по структуре плана** (GSD-фаза или чек-лист открытых вопросов — что у проекта есть), затем **«Точка возврата»**, затем **один следующий конкретный шаг**. Не плоский дамп коммитов.

Формат:

```

🚀 <project_name> — где мы

Стек: <язык> · <фреймворк> · <DB>

Ветка: <branch> | <N> uncommitted | <K> stash'ей

Последний коммит: <hash> "<subject>" (<X дней назад>)

📍 Сейчас в работе

<1-3 строки из dashboard.md «Сейчас» + если есть текущая GSD-фаза — она>

<Если GSD:>

Статус: <X задач completed, Y pending, Z blocked>

Текущая фаза: <статус из STATE.md>

<Если есть HANDOFF.json свежее последней сессии:>

📌 HANDOFF (от /gsd-pause-work, <date>): <первый параграф what_next>

Решения текущей фазы (из CONTEXT.md): <топ-2 пункта>

Следующее: <next phase title или "execute current" или "verify">

📝 Последняя сессия (<date>)

Тема: <тема из имени файла>

Сделано: <первые 2 пункта>

Решения: <если были — 1 ключевое>

❓ Открытые вопросы (<всего N>)

1. <q1>

2. <q2>

3. <q3>

<если больше — «...ещё (N-3)»>

🐛 Известные баги (если есть)

• <bug1>

📌 Точка возврата (из handoff.md / последней сессии)

Следующий шаг: <один конкретный>

Висит: <неотправленный промпт прошлой сессии / недоделанное / WIP — если есть; иначе пропусти строку>

💡 Что брать следующим

<синтезируй из: GSD next phase ИЛИ первый open question ИЛИ последний "Следующий шаг" из сессии>

Аргумент: <почему именно это>

⚙️ Команды

/mm prompt "..." — собрать промпт для PowerShell-Клода (если ты сейчас в claude.ai)

/gsd-execute-phase N — выполнить текущую GSD-фазу (если применимо)

/mm save — закрыть сессию когда закончишь

/mm next — обновить handoff.md перед новым чатом claude.ai

```

### Шаг 4. После сводки — жди

Не предлагай делать что-то конкретное автоматически. Юзер прочёл, решил, скажет.

## Особые режимы

### Если включена опция `--quick` (или юзер пишет «коротко»)

Выдай только:

```

<name> · <branch> · <N> uncommitted · последняя сессия <date>

Сейчас: <одна строка>

Дальше: <одна строка>

```

3 строки максимум. Для случая «я просто проверить вспомнить».

### Если включена `--verbose` (или «подробно»)

Дополни:

- Полный список open questions (без обрезки)

- Полное «Сделано» из последней сессии (не первые 2)

- Список последних 3 сессий с темами

- Список фаз GSD с галочками

## Edge cases

- **Несколько проектов в моно-репо**: в Discovery возьми проект ближе к cwd. Если cwd на корне — спроси какой.

- **Свежий `/mm new`, ещё нет сессий**: пропусти секцию «Последняя сессия», в «Что брать следующим» предложи «заполнить секцию 8 паспорта».

- **GSD без активной фазы** (между milestone'ами): «GSD: между фазами, последняя завершена N дней назад. /gsd-new-milestone?»

- **Нет git вообще** (просто папка с файлами): пропусти git-секцию.

- **passport.md очень старый** (`updated:` > 60 дней назад): добавь предупреждение «Паспорт давно не обновлялся, может быть неточен. /mm new для refresh».

- **Уже Memory у Anthropic накопилась**: не дублируй её. mm-resume — про **актуальное** (что сейчас, что вчера). Memory — про **долгосрочное** (как ты любишь работать).

## Что НЕ делать

- Не запрашивать данные из чата если их можно прочитать из файлов.

- Не выводить полные тексты файлов — только выжимки.

- Не делать `git pull` / `git fetch` без явного запроса.

- Не запускать сам `/gsd-progress` как отдельную команду — логика встроена сюда.

- Не предлагать действие если не уверен что нужно — лучше промолчать чем советовать наугад.

- Не дублируй чек `/mm-doctor` — для смок-теста достаточно одной junction-проверки.