/mm-init-project

name: mm-init-project
version: 0.6.0
description: Инициализирует или обновляет проект для mm-системы — создаёт passport.md в корне, копию в Obsidian, dashboard.md, handoff.md (скелет), project-instructions.md для claude.ai. Use when user says "оформи проект", "сделай паспорт", "init project", "/mm-init", "/mm-init-project", "обнови паспорт", "регистрирую проект". Работает на пустой папке (новый проект) и на существующем коде с любыми .md файлами (auto-discovery + dry-run preview перед записью). Включает auto-detect стека (~150 фреймворков), dual-detection GSD v1 (.planning/) и v2 (.gsd/), import scope/requirements из GSD-артефактов, secret-grep, детектор рассинхрона между копиями паспорта.

mm-init-project — Project Bootstrap & Refresh (safe edition)

Создаёт «паспорт» проекта — единый источник контекста для claude.ai Project Knowledge и для всех mm-* skills. **Всегда показывает план перед записью**, никогда не уничтожает чужие .md файлы.

Контракт безопасности (это важно — соблюдай дословно)

**Skill ПИШЕТ только в эти файлы:**

• `<project_root>/passport.md` — создаёт или обновляет
• `<project_root>/CLAUDE.md` — **только** добавляет секции `## Obsidian Knowledge Vault` и `## mm-system` если их нет; **никогда** не редактирует существующие секции
• `<project_root>/.gitignore` — добавляет правила для игнорирования локальных настроек Obsidian (`.vault/.obsidian/`)
• Файлы Obsidian Vault (хранилище в `<project_root>/.vault/` при локальном режиме или `<obsidian_projects>/<name>/` при глобальном режиме):
• `00-home/index.md` — карта всех заметок; **в режиме update не трогает, если файл есть и непустой**
• `00-home/текущие приоритеты.md` — текущие приоритеты; **в режиме update не трогает, если файл есть и непустой**
• `project-instructions.md` — инструкции для claude.ai (в корне хранилища, туда же пишет `/mm rules`)
• `handoff.md` — создаёт **скелет** на старте (в корне хранилища)
• `passport.md` — копия паспорта проекта (в корне хранилища; её читают `/mm projects`, `clear-gate.py` и sync-check фазы 1f)
• `atlas/архитектура проекта.md` — описание архитектуры
• `atlas/база данных.md` — схема БД
• `atlas/деплой.md` — информация о деплое
• Создает папки `knowledge/integrations/`, `knowledge/decisions/`, `knowledge/debugging/`, `knowledge/patterns/`, `knowledge/business/`, `sessions/`, `inbox/` if they don't exist.

**Skill ТОЛЬКО ЧИТАЕТ (никогда не редактирует):**

• README.md, ARCHITECTURE.md, NOTES.md, OVERVIEW.md, CONTEXT.md, DESIGN.md, ROADMAP.md, TODO.md, BUGS.md, DECISIONS.md, и любые другие *.md в проекте
• package.json, pyproject.toml, requirements.txt, go.mod, Cargo.toml, pom.xml
• .env.example (не .env!)
• Dockerfile, docker-compose.yml, railway.json, vercel.json
• .git/config, git log, git status

**Skill НЕ ТРОГАЕТ ВООБЩЕ:**

• `.env`, `*.key`, `*.pem`, `secrets/` — даже не читает значения
• node_modules/, .venv/, dist/, build/, target/
• Файлы вне `<project_root>` за исключением Obsidian-папки из конфига

**Перед любой записью** — обязательная фаза Preview (см. ниже). Без подтверждения `y` — ничего не пишется.

Конфиг

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

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

• `paths.obsidian_projects`
• `_repo_root` (для `templates/passport.md` и `templates/project-instructions.md`)
• `bot_defaults.*`
• `default_language`

Фаза 0. Определи целевую папку (worktree-aware)

**Целевая папка** = «корень проекта», не «cwd как есть».

Алгоритм: 1. Возьми `cwd`. 2. Если в пути есть подстрока `\.claude\worktrees\` или `/.claude/worktrees/` — это worktree. Найди корневой репо:

• Прочитай `<cwd>/.git` (это файл-указатель, не папка). Извлеки `gitdir: <path>`. Из него выведи main repo path.
• Если не получилось — спроси: `Это git worktree. Какую папку считать корнем проекта? <предложи: ...>`.

3. Иначе — поднимись от `cwd` пока не найдёшь `.git/` (папку, не файл) или `package.json` / `pyproject.toml` / любой явный маркер корня. Если ничего нет — `cwd` и есть корень.

**Имя проекта** = basename целевой папки. Покажи: `Имя проекта: <name> (целевая папка: <path>). Ок? (y/n или новое имя)`.

Фаза 1. Discovery (что уже есть в проекте)

Просканируй и **выведи отчёт пользователю** перед любыми действиями.

1a. Существующие паспорта (миграция)

Поищи (case-insensitive) в `<project_root>` и `<project_root>/docs/`:

• `passport.md`, `PASSPORT.md`, `Passport.md`, `passport.MD` — варианты case
• `PROJECT_PASSPORT.md`, `project_passport.md` — старая louise-система (`Claude Setup/`)
• `*_passport.md`, `passport_*.md`

Любой найденный — **кандидат на миграцию**, не конфликт-блокер.

1b. Документы которые могут содержать контекст

Просканируй `*.md` в:

• `<project_root>/` (корень)
• `<project_root>/docs/`, `<project_root>/notes/`, `<project_root>/_docs/`
• `<project_root>/.planning/` (GSD-документы)

Распознай семантически по имени (case-insensitive substring): | В имени есть | Категория | |---|---| | `readme` | Описание / overview | | `architecture`, `design`, `arch` | Архитектура | | `overview`, `context`, `intro` | Контекст | | `notes`, `ideas` | Заметки | | `decisions`, `adr`, `rfc` | Решения | | `roadmap`, `plan` | Планы | | `todo`, `tasks`, `backlog` | Задачи | | `bugs`, `issues`, `known-issues` | Проблемы | | `changelog`, `history` | История | | `claude` (CLAUDE.md, claude-rules.md) | Правила для AI |

Прочитай **первые 50 строк** каждого найденного файла — для понимания.

1c. Маркеры стека (auto-detection)

**Manifest-файлы** — прочитай если есть:

• `package.json`, `pyproject.toml`, `requirements.txt`, `go.mod`, `Cargo.toml`, `pom.xml`, `composer.json`, `Gemfile`, `mix.exs`, `pubspec.yaml`
• `Dockerfile`, `docker-compose.yml`, `railway.json`, `vercel.json`, `fly.toml`, `Procfile`
• `.env.example`, `.env.template` (не `.env`!)
• `tsconfig.json`, `next.config.*`, `vite.config.*`, `astro.config.*`, `nuxt.config