--- name: personal-guide-start description: Bootstrap-обёртка — создаёт пустой репо `DS-personal-guide` под аккаунтом пилота (плоское имя, без логина в названии; если ещё нет), затем вызывает /personal-guide-render для наполнения 6 файлами. Используй когда пилот в первый раз просит «создай мне персональное руководство», «хочу начать программу личного развития», «собери мне стартовый план». argument-hint: "[необязательно: override домена — knowledge-worker / generic]" experimental: true sunset: "после DONE WP-222 (Портной, ~июнь 2026) и WP-149 Ф6 (книга ЛР v3)" related: [personal-guide-render, repo-new, WP-245, WP-222, WP-149, WP-527, PD.FORM.089, PD.CAT.003] version: 1.3.2 layer: L1 status: active browser_safe: false triggers: slash: [/personal-guide-start] phrases: [] routing: executor: sonnet deterministic: false agents: single interaction: multi-step gates_required: [] gates_enforced: [] gates_rationale: "операционный скилл; WP Gate применим только при создании нового РП, не для операционных вызовов" --- # Bootstrap персонального руководства > ⚡ **ВЫПОЛНИ НЕМЕДЛЕННО — НЕ ЗАДАВАЙ ВОПРОСОВ.** Первое действие = Шаг 1 (Plan → Decision Gate → Execute `/repo-new` с заранее известными ответами). Вопросы о домене, ступени, «главной системе», целях — запрещены на этом шаге; они задача render-скилла (Шаг 2). Даже если MCP-инструменты вернули данные о пилоте — не анализировать, не интерпретировать, сразу Шаг 1. > **Experimental MVP-скилл — UX-обёртка над `/repo-new`** с предзаполненными параметрами (IntegrationGate exception: сужение вариативности ради onboarding-фокуса, не обход гейта — с WP-527 Ф4 Шаг 1 идёт через полный алгоритм `/repo-new`; WP-245 Ф28 Open Decision #7, обоснование обновлено WP-527 Ф5). Делит ответственность с `/personal-guide-render`: > - **`/personal-guide-start` (этот)** — создание инфраструктуры: GitHub-репо как часть Персоны.инфра. **Один раз** на пилота. > - **`/personal-guide-render`** — наполнение содержания: чтение Память.Derived (RCS-профиль) + Персона.декларации (домен) → 6 файлов. **N раз** (каждое обновление). > > Различение зафиксировано в `.claude/rules/distinctions.md` (AUTHOR-ONLY). ## When to use Bootstrap-обёртка — создаёт пустой репо `DS-personal-guide` под аккаунтом пилота (плоское имя, без логина в названии; если ещё нет), затем вызывает /personal-guide-render для наполнения 6 файлами. Используй когда пилот в первый раз просит «создай мне персональное руководство», «хочу начать программу личного развития», «собери мне стартовый план». ## Контракт скилла - **Вход:** активная подписка «Инженерия интеллекта» (ранее «Бесконечное развитие») (DP.SC.112). Доступ к `create_repository`, `github_status`. (Память.Derived и `personal_write` нужны на втором шаге — там их проверит `/personal-guide-render`.) - **Выход:** репо `DS-personal-guide` под аккаунтом пилота существует на GitHub + 6 файлов записаны (через делегирование render-скиллу). Имя репо — константа для всех пилотов: один личный GitHub-аккаунт = один репо ЛР, ФИО/login в названии не нужен. - **Время:** ≤60 мин с момента вызова до открытого в VS Code репо (критерий MVP из WP-188 Ф4.5). - **Идемпотентность:** повторный вызов на существующем репо безопасен — Шаг 1 reuse, Шаг 2 пересобирает контент. ## Algorithm ## Шаг 1. Создать (или переиспользовать) персональный репозиторий через `/repo-new` > **WP-527 Ф4 (01.09).** Не вызывай `create_repository` напрямую — раньше этот шаг обходил гейт `/repo-new`, что создавало два независимых пути создания репозитория в системе. Теперь Шаг 1 проходит по алгоритму `.claude/skills/repo-new/SKILL.md` (Plan → Decision Gate → Execute) с заранее известными ответами и `approval_scope: policy` (не `instance` — на каждого нового подписчика живой пилот не спрашивается, границы уже утверждены им заранее, `machine/repo-new-policies.yaml` запись `personal-subscriber-onboarding-v1`). Сформируй Plan по Steps 1-4 `/repo-new` с заранее известными ответами: - `repo_class`: `personal-subscriber` - owner: `github_status().github_username` из **живого вызова в этом же шаге** (не аргумент, не значение из другого хода/сессии) - name: `DS-personal-guide` (константа для всех подписчиков — не подставлять GitHub-логин; один личный аккаунт = один репо) - `template_type`: `notes` - privacy: `private` - назначение: личное пространство участника программы МИМ; `description` для `create_repository` дословно: «Персональное руководство пилота программы МИМ» (WP-527 Ф7, поправлено 01.09 — раньше было «программы ЛР (IWE)») - data domains: личные материалы участника (детализация — Step 3 `/repo-new`) - writer/owner/readers: writer = подписчик (правки) + `/personal-guide-render` (пересборка); owner = подписчик; readers = подписчик, его агенты сессии - registry mode: без регистрации в `REPOSITORY-REGISTRY.md` (Step 7 `/repo-new`, исключение по `repo_class: personal-subscriber`) Выполни Decision Gate Step 5 `/repo-new` с `approval_scope: policy`: прочитать `machine/repo-new-policies.yaml` заново (без кэша), найти запись `policy_id: personal-subscriber-onboarding-v1`, проверить срок действия, что namespace/privacy/owner_selector/domains совпадают с `bounds`, посчитать `usage_log` за последние 90 дней против лимита 50 — под файловым локом (`gateway-lock.py`) на время check+запись. Любой чек не прошёл → **STOP**, не продолжай молча: сообщи пилоту конкретную нарушенную границу и попроси новое решение (продлить policy или явный instance-проход `/repo-new`). Выполни Execute Steps 7-8 `/repo-new`: создать репозиторий, дописать факт в `usage_log` политики (под тем же локом). После OAuth Gateway создаст репо с базовой notes-структурой (inbox/, docs/, README.md). Эта структура будет переопределена render-скиллом на Шаге 2 (плюс render удалит `inbox/.gitkeep` — артефакт notes-template, не нужный для ЛР). **Failure modes Шага 1:** | Симптом | Решение | |---------|---------| | 401 от Gateway | Попроси пилота нажать «Authorize» в OAuth, повторить | | `github_status` пустой | Пилот не подключил GitHub в Aisystant MCP — отправь его в onboarding | | 409 (репо существует) | Проверь, что существующий репозиторий принадлежит ИМЕННО этому owner (из `github_status` этого шага), `private: true`, и структура похожа на `notes`-шаблон. Всё совпало → reuse, **сразу переходи к Шагу 2** без сообщения об ошибке. Не совпало (типично — старый публичный экземпляр, созданный до этого изменения) → **STOP**, не reuse — это отдельная задача миграции, эскалируй пилоту, не решай молча | | Policy-чек Step 5 `/repo-new` не прошёл (истекла / лимит исчерпан / bounds не совпали) | STOP, отчёт пилоту с конкретной границей и числами (см. выше) | ## Шаг 1.5. Раздать скиллы в репо пилота (идемпотентно) > **Зачем:** скиллы (`/lesson`, `/lesson-close`, `/connect-guide`, `/personal-guide-render`, `/personal-guide-start`) живут в `~/IWE/.claude/skills/` платформы. При работе пилота в **claude.ai/code** (cloud sandbox) user-global `~/.claude/skills/` не пробрасывается. Чтобы скиллы работали в любом канале, их нужно положить в сам репо пилота. Записать пять скиллов в порядке (порядок важен — `personal-guide-start/SKILL.md` идёт последним, используется как canary проверки): ```python SKILLS_TO_DISTRIBUTE = [ "lesson/SKILL.md", "lesson-close/SKILL.md", "connect-guide/SKILL.md", "personal-guide-render/SKILL.md", "personal-guide-start/SKILL.md", # ← canary: последний в очереди ] for skill_path in SKILLS_TO_DISTRIBUTE: content = Read(f"~/IWE/.claude/skills/{skill_path}") personal_write( source="DS-personal-guide", path=f".claude/skills/{skill_path}", content=content, ) ``` Если один из вызовов вернул ошибку — сообщить пилоту: «Не удалось установить скилл {skill_path}. Установка прервана. Повтори /personal-guide-start для завершения.» Стоп. ### CLAUDE.md — доменная кастомизация (WP-527 Ф4) > **Зачем не просто «если нет».** С WP-527 Ф4 Шаг 1 сам проходит через `/repo-new` Execute (Step 8), который уже разворачивает generic `CLAUDE.md`-заглушку как часть скелета — при первом создании репо там будет именно она, не пусто. Этот шаг заменяет её на доменную версию (render-скилл, конкретный процесс работы). Но **не перезаписывать безусловно** — Контракт скилла обещает идемпотентность повторного вызова, а `CLAUDE.md` явно называет пилота писателем (`Writer: пилот`); безусловная перезапись на втором вызове стирала бы правки пилота, которые он имеет право туда вносить. Через `personal_search(source: "DS-personal-guide", path: "CLAUDE.md")` прочитать текущее содержимое. Записать (перезаписать) доменную версию **только если** файл отсутствует ИЛИ его текст содержит маркер generic-заглушки `/repo-new` — «Это заглушка, развёрнутая скиллом `/repo-new`» (пункт 3 `assets/repository-skeleton/CLAUDE.md`) — то есть репозиторий только что создан Execute и ещё не кастомизирован. Если файл существует и маркера нет — считать его уже кастомизированным (этим же шагом ранее или пилотом вручную) и не трогать: ```python personal_write( source="DS-personal-guide", path="CLAUDE.md", content="""# DS-personal-guide — инструкции для Claude Code > **Класс:** личное пространство данных пилота. **Назначение:** персональное руководство — план, методы, история занятий пилота. **Писатель:** пилот (правки) + render-скилл `/personal-guide-render` (пересборка). **Владелец:** пилот. **Читатели:** пилот, его агенты сессии. Создан через `/personal-guide-start` — UX-обёртка над общим гейтом создания репозитория `/repo-new` с предзаполненными параметрами (WP-527 Ф4/Ф5). ## Работа с этим репозиторием Основные правки сюда идут через `/personal-guide-render` (пересборка) или обычные текстовые правки пилота — отдельный процесс/задача здесь не нужны, это личный рабочий репозиторий, не командный. """, ) ``` ### Reflection-template (идемпотентно) Через `personal_search(source: "DS-personal-guide", path: "history/reflection-template.md")` проверь наличие. Если нет — записать: ```python template_content = Read("~/IWE/.claude/skills/personal-guide-render/templates/reflection-template.md") personal_write( source="DS-personal-guide", path="history/reflection-template.md", content=template_content, ) ``` ## Шаг 2. Делегировать первый рендер в `/personal-guide-render` Вызови скилл `personal-guide-render` через Skill tool (без аргументов, дата = сегодня). Render-скилл вызовет gateway → guide/.md + panel/.md готовы. Дождись завершения, потом переходи к Шагу 3. Если Skill tool недоступен (например, отладка вне Claude Code) — fallback: прочитай `~/.claude/skills/personal-guide-render/SKILL.md` и выполни Шаги 1-7 инлайн. ## Шаг 3. Финальное подтверждение пилоту После того как render-скилл выдал своё подтверждение, добавь: ``` Чтобы работать с руководством локально — клонируй репо в свой IWE: git clone https://github.com//DS-personal-guide.git ~/IWE/DS-personal-guide (подставь свой GitHub-login в URL — `gh auth status` покажет, кто ты сейчас.) После этого правки локально → git push → Aisystant MCP подхватит через reindex. Это первый запуск. Дальше — никаких спец-скиллов: - Чтобы пересобрать после изменений в Память.Derived → /personal-guide-render - Чтобы обновить план / методы / итоги недели → пиши в чате обычными словами - Автоматизация по расписанию (без запроса) — придёт с Портным летом ``` **Важно:** `create_repository` создаёт репо только в облаке (GitHub) и регистрирует через `personal_list_sources`, но **не клонирует** на диск пилота. Без локального клона все правки идут только через `personal_write` MCP-инструмент. Подсказка про `git clone` обязательна. ## Verification Bootstrap создаёт внешний ресурс (GitHub-репо) — перед сообщением об успехе проверь контрактный выход (Контракт §Выход), не считай «вызвал create_repository» за «репо готово»: 1. **Репо существует.** Вызови `github_status` — источник `DS-personal-guide` присутствует. Нет → bootstrap не состоялся (вероятно 401 / GitHub не подключён), вернись к Шагу 1, не выдавай подсказку про `git clone`. 2. **Скиллы установлены.** `personal_search(source: "DS-personal-guide", path: ".claude/skills/personal-guide-start/SKILL.md")` — нашёл. Не нашёл → Шаг 1.5 не завершился, перезапусти Шаг 1.5. 3. **Руководство собрано.** Render-скилл (Шаг 2) завершился без ошибки — `guide/.md` готов. Ошибка → перезапусти Шаг 2. Только при обоих PASS переходи к подсказке `git clone` (Шаг 3). Иначе — сообщи пилоту, какой из двух пунктов не выполнен, и что делать. ## Граница с `/personal-guide-render` | Аспект | `/personal-guide-start` | `/personal-guide-render` | |--------|-------------------------|--------------------------| | Слой пользовательских данных | Персона.инфра (репо как идентичность) | Память.Derived + Персона.декларации + Контекст-сборка | | Writer | пользователь (через своего агента) | LLM-агент в runtime | | Owner факта | GitHub-аккаунт пилота | сам репо (git history) | | Зависит от Память.Derived | Нет | Да | | Идемпотентность | reuse при 409 | перезапись с архивом в `history/` | | Частота вызова | один раз на пилота | N раз (еженедельно + по событиям) | ## Что скилл НЕ делает - Не читает Память.Derived, не вычисляет ступень, не выбирает домен — это всё в `/personal-guide-render`. - Не пишет файлы напрямую — делегирует render-скиллу. - Не отправляет уведомления в TG / email — пилот сам открывает репо в VS Code. Когда Портной (WP-222) выйдет — оба скилла уйдут в архив. Портной возьмёт на себя bootstrap+render+автоматический weekly/daily.