v0.1.0 to v0.1.0

---

name: mm-setup

version: 0.1.0

description: Онбординг/персонализация mm-системы под конкретного пользователя — спрашивает имя, чем занимается, стек, язык, путь к Obsidian vault, и записывает это в личный gitignored-оверлей config/mm-config.local.json + генерирует персональную копию claude.ai-скилла mm-web-bridge. Use when user says "/mm setup", "/mm onboard", "настрой под меня", "персонализируй", "первичная настройка", "сделай систему моей", "это не моё имя в скилле", "поменяй данные под меня". Запускать ОДИН раз после клонирования репо на новой машине.

---

# mm-setup — Персонализация mm-системы под пользователя

Делает систему «своей»: имя, домен, стек, пути — без правки committed-файлов (репо общий, расшарен на GitHub). Личное идёт в **gitignored** оверлей и в **генерируемую** персональную копию claude.ai-скилла.

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

**Skill ПИШЕТ только в:**

- `<repo>/config/mm-config.local.json` — создаёт или мёрджит (gitignored, личный оверлей)

- `<repo>/claude-ai-skills/_generated/mm-web-bridge/SKILL.md` — персональная копия для загрузки в claude.ai (gitignored)

**Skill НИКОГДА не трогает:**

- `config/mm-config.json` (committed — общие дефолты louise; их не перезаписываем)

- `claude-ai-skills/mm-web-bridge/SKILL.md` (committed шаблон — читаем как источник, не правим)

- любые `skills/*/SKILL.md`, `~/.claude/CLAUDE.md` (для глобального — только предложим сниппет)

- git-операции

## Конфиг

Загрузи `mm-config.json` по алгоритму из `<repo>/docs/CONFIG-LOADING.md` (нужен `_repo_root`). Если уже есть `mm-config.local.json` — прочитай его как текущие значения (режим повторной настройки).

## Шаг 1. Интервью

Задай **одним сообщением** (не по одному вопросу), с разумными дефолтами в скобках:

```

Настрою mm-систему под тебя. Ответь (можно коротко):

1. Имя — как тебя называть? <текущее из config, если есть>

2. Чем занимаешься / домен? (например: «Telegram-боты», «веб на React», «data-инженерия»)

3. Основной стек? (язык · фреймворк · БД · деплой — например «Python · aiogram 3.x · SQLite · Railway»)

4. Язык общения по умолчанию? (ru / en) <текущий default_language>

5. Путь к Obsidian vault? <текущий obsidian_vault, или предложи C:\Users\<user>\Documents\Obsidian Vault>

```

Дополнительно (не спрашивай, выведи сам):

- `<user>` для дефолтных путей возьми из `$env:USERPROFILE` / `~`.

- Если на п.5 дают только vault — остальные obsidian-пути (`Claude/`, `Bridge/`, `Sessions/`, `Projects/`, `INDEX.md`) выведи относительно него по той же структуре, что в committed `mm-config.json`.

- Если пользователь говорит «как у тебя в дефолте / пропусти» — оставь committed-значение (не дублируй его в local без нужды).

## Шаг 2. Покажи план (preview перед записью)

```

📋 Запишу в config/mm-config.local.json (личный, gitignored):

user.name = <name>

user.domain = <domain>

user.stack = <stack>

default_language = <lang>

paths.obsidian_* = <выведенные из vault пути>

📋 Сгенерирую claude.ai-скилл:

claude-ai-skills/_generated/mm-web-bridge/SKILL.md

(персональная копия — louise/Telegram заменены на <name>/<domain>/<stack>)

Committed-файлы НЕ трогаю. Продолжить? (y / n / правки)

```

Без `y` — ничего не пишется.

## Шаг 3. Запиши mm-config.local.json

Сформируй/обнови `<repo>/config/mm-config.local.json`. Только изменённые относительно дефолта ключи (deep-merge поверх committed). Минимум:

```json

{

"default_language": "<lang>",

"user": {

"name": "<name>",

"domain": "<domain>",

"stack": "<stack>"

},

"paths": {

"obsidian_vault": "<...>",

"obsidian_claude_root": "<...>\\Claude",

"obsidian_bridge": "<...>\\Claude\\Bridge",

"obsidian_bridge_archive": "<...>\\Claude\\Bridge\\archive",

"obsidian_sessions": "<...>\\Claude\\Sessions",

"obsidian_projects": "<...>\\Claude\\Projects",

"obsidian_index": "<...>\\Claude\\INDEX.md"

}

}

```

Если файл уже есть — мёрджи, не затирай чужие ключи. Пути — в формате текущей ОС (Windows — `\\`).

## Шаг 4. Сгенерируй персональный mm-web-bridge

1. Прочитай committed-шаблон `<repo>/claude-ai-skills/mm-web-bridge/SKILL.md`.

2. Сделай **персональную копию**, заменив louise-специфику на данные пользователя:

- имя «louise» → `<name>` (везде);

- строку про стек/домен (абзац «louise работает на русском. Её типичный стек: …») → под `<domain>` и `<stack>` пользователя;

- в **Принципе 1 (веб-проверка)** примеры «Telegram Bot API / aiogram» → под технологии из `<stack>` пользователя (если стек неизвестен/общий — оставь обобщённо «внешние API/библиотеки/фреймворки» без конкретики, но сам принцип сохрани — он универсален);

- язык изложения — под `<lang>` (если en — можно перевести ключевые формулировки; если ru — оставь как есть).

- `description` во frontmatter — тоже под пользователя (имя + домен + что следить за актуальностью именно его стека).

3. Сохрани в `<repo>/claude-ai-skills/_generated/mm-web-bridge/SKILL.md`.

4. **Не меняй смысл и структуру** скилла (три принципа, режимы A/B/C, GSD, конвенция «вариант N») — только идентичность/домен/стек.

## Шаг 5. Финальный отчёт + следующие шаги

```

✅ mm-system персонализирована под <name>

Записано:

✓ config/mm-config.local.json (личный оверлей)

✓ claude-ai-skills/_generated/mm-web-bridge/SKILL.md (для claude.ai)

Дальше:

1. Загрузи claude.ai-скилл: заархивь _generated/mm-web-bridge/ → claude.ai → Customize → Skills → Upload a skill

(или Write skill instructions и вставь содержимое SKILL.md)

3. /mm check — проверь, что vault и пути на месте

4. /mm new — оформи первый проект

Хочешь — выведу сниппет для ~/.claude/CLAUDE.md (глобальные правила под тебя)? Сам файл не трогаю (он вне репо).

```

Если пользователь просит сниппет CLAUDE.md — выведи готовый текст (имя, что mm подключён, ссылку на /mm), но **вставляет он сам**.

## Edge cases

- **Повторный запуск** (local уже есть): покажи текущие значения, спроси что менять, мёрджи.

- **Vault по указанному пути не существует**: предупреди, предложи создать папки (это безопасно) или поправить путь.

- **Пользователь = louise / её данные**: всё равно отработай — просто значения совпадут с committed-дефолтами (local будет минимальным).

- **Нет committed mm-web-bridge** (репо неполный): пропусти шаг 4 с предупреждением, config всё равно запиши.

- **Не Windows** (если когда-нибудь): пути в формате текущей ОС, `~` вместо `C:\Users\<user>`.

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

- Не писать личные данные в committed `mm-config.json` или committed `mm-web-bridge/SKILL.md` — только в local/_generated.

- Не делать git add/commit.

- Не править `~/.claude/CLAUDE.md` напрямую — только предложить сниппет.

- Не пропускать preview (шаг 2).