Mm Resume

mm-resume — Context Restore for Claude Code

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

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

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

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

Конфиг

Загрузи mm-config.json по алгоритму из /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. Паспорт

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

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

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

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

• /.planning/ существует:
• Если /.planning/config.json существует → GSD Core
• Иначе → GSD v1
• /.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//CONTEXT.md (если есть текущая фаза) — preferences и решения этой фазы. Это критично — покажет что мы решали в текущей фазе.
5. .planning/phases//PLAN.md — что планировали. Извлеки список задач, посчитай completed/pending.
6. .planning/phases//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. Используй абсолютный путь от ``:

``bash sqlite3 "/.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-фаза или чек-лист открытых вопросов — что у проекта есть), затем «Точка возврата», затем один следующий конкретный шаг. Не плоский дамп коммитов.

Формат:

🚀  — где мы

Стек:  ·  · 
Ветка:  |  uncommitted |  stash'ей
Последний коммит:  "" ()

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

🎯 GSD : M «», фаза / — «»
   Статус: 
   Текущая фаза: 
   
   📌 HANDOFF (от /gsd-pause-work, ): 
   Решения текущей фазы (из CONTEXT.md): 
   Следующее: 

📝 Последняя сессия ()
   Тема: 
   Сделано: 
   Решения: 

❓ Открытые вопросы ()
   1. 
   2. 
   3. 
   

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

📌 Точка возврата (из handoff.md / последней сессии)
   Следующий шаг: 
   Висит: 

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

⚙️ Команды
   /mm prompt "..."     — собрать промпт для PowerShell-Клода (если ты сейчас в claude.ai)
   /gsd-execute-phase N — выполнить текущую GSD-фазу (если применимо)
   /mm save             — закрыть сессию когда закончишь
   /mm next             — обновить handoff.md перед новым чатом claude.ai

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

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

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

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

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

 ·  ·  uncommitted · последняя сессия 
Сейчас: 
Дальше: 

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-проверки.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: mworldorg
• Source: mworldorg/markdown-memory
• License: MIT

Install and usage instructions live in the source repository linked above.