Mm Projects

mm-projects — Cross-Project Overview

Отвечает на вопрос «что у меня вообще есть и где что в работе» — в отличие от /mm-resume, который про один проект. Команда независима от cwd: читает папку проектов в Obsidian, не код.

Только чтение. Ничего не пишет. Git по проектам — только с флагом --git (иначе дорого при многих проектах).

Конфиг

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

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

• paths.obsidian_projects
• paths.obsidian_sessions (для legacy-проектов без папки)

Процесс

Шаг 1. Собери список проектов

В /:

• Папки-проекты (новый формат от /mm-init-project): каждая подпапка = проект.
• Legacy плоские файлы .md в корне / (старый формат) — тоже проект.

Если папка проектов не существует → Папка проектов не найдена: . Запусти /mm-init-project хотя бы в одном проекте. и стоп. Если проектов 0 → Зарегистрированных проектов пока нет. /mm new в любом проекте создаст первый.

Шаг 2. По каждому проекту прочитай дёшево (не углубляясь)

Папка-проект //:

• passport.md frontmatter: status, type, gsd_version, updated, mm_version.
• passport.md секция 8: есть ли маркер `` (не заполнена).
• passport.md секция 9 (если GSD): Текущий milestone / phase.
• passport.md секция 10: посчитай чекбоксы - [ ] в «Открытые вопросы».
• dashboard.md frontmatter updated: + секция «Сейчас» (первая непустая строка).
• handoff.md frontmatter generated: (для оценки свежести).
• sessions/ — дата самого свежего файла (по имени YYYY-MM-DD... или mtime).

Legacy плоский .md: вытащи что есть (секция «Текущее состояние», последняя сессия). Помечай в выводе как (legacy).

Last activity = максимум из: dashboard.updated, дата свежей сессии, handoff.generated, passport.updated.

Шаг 3. (Опционально) git — только если флаг --git

Если юзер передал --git: для каждого проекта, где из passport.md секции 1 «Путь к коду» извлекается существующий путь — выполни быстро:

git -C "" branch --show-current
git -C "" status --short    # посчитать строки = uncommitted

Без --git — пропусти, в выводе колонку git не показывай.

Шаг 4. Вывод (одним экраном, отсортировано по last activity ↓)

📂 mm-проекты ()

                      Q:
   └ 
...

Где:

• ` = — если none, иначе v1· / v2· / core·` (фаза из секции 9, кратко).
• ` = человекочитаемо: сегодня / 2д / 3нед / 2мес`.
• Q: = число открытых вопросов.
• С флагом --git добавь хвост · ( wip).

После таблицы — короткие сигналы (только непустые):

⚠️ Залежались (>30 дней без активности): 
⚠️ Паспорт без секции 8: 
⚠️ GSD есть, но в CLAUDE.md нет директивы: запусти /mm check в    ← если знаешь (см. ниже)
📌 Паспорт старше config.version (нужен /mm new update): 

Примечание: «GSD без директивы» точно проверяет /mm-doctor; здесь упоминай только если это дёшево определить (флага в Obsidian-копии нет — обычно просто не пиши эту строку).

Шаг 5. Подсказка по навигации

Одной строкой в конце:

Подробнее по проекту: /mm projects   (= /mm-resume для него)  ·  обзор с git: /mm projects --git

Режимы / аргументы

• /mm projects — таблица всех.
• /mm projects --git — + ветка и число несохранённых по каждому (медленнее).
• /mm projects --active — только status: active.
• /mm projects — не таблица, а deep-dive: запусти логику /mm-resume для этого проекта (его путь к коду из passport секции 1; если кода нет на диске — выведи сводку из Obsidian-артефактов).

Edge cases

• Папка проекта без passport.md (мусор / недоинициализирован): покажи строкой — ⚠️ нет passport.md (недоинициализирован, /mm new).
• Очень много проектов (>30): покажи топ-20 по активности + строку …ещё N (см. --all). С --all — все.
• Рассинхрон дат (dashboard свежее passport): бери максимум, не падай.
• Legacy и folder-формат для одного имени одновременно: предпочитай folder, отметь дубль.
• Vault недоступен: останови, скажи путь из конфига.

Что НЕ делать

• Не запускать git по всем проектам без флага --git — это дорого и шумит.
• Не писать ничего (это read-only обзор).
• Не углубляться в каждый проект — для этого /mm projects или /mm-resume.
• Не выдумывать «Сейчас», если в dashboard пусто — пиши —.

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.