Personal Guide Start

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:

Шаг 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 проверки):

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 и ещё не кастомизирован. Если файл существует и маркера нет — считать его уже кастомизированным (этим же шагом ранее или пилотом вручную) и не трогать:

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") проверь наличие. Если нет — записать:

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/<github-login>/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/<date>.md готов. Ошибка → перезапусти Шаг 2.

Только при обоих PASS переходи к подсказке git clone (Шаг 3). Иначе — сообщи пилоту, какой из двух пунктов не выполнен, и что делать.

Граница с /personal-guide-render

Что скилл НЕ делает

• Не читает Память.Derived, не вычисляет ступень, не выбирает домен — это всё в /personal-guide-render.
• Не пишет файлы напрямую — делегирует render-скиллу.
• Не отправляет уведомления в TG / email — пилот сам открывает репо в VS Code.

Когда Портной (WP-222) выйдет — оба скилла уйдут в архив. Портной возьмёт на себя bootstrap+render+автоматический weekly/daily.