onboarding

Лёгкий онбординг: за один разговор — маленький полезный результат на задаче человека методом из локальной библиотеки (FPF и паки), итог — квитанция «было → стало». Без аккаунта, без подписки, без обра

SKILL.md

GitHub

/onboarding — лёгкий онбординг

Задача человека (если передана): $ARGUMENTS

Этот навык — тонкая привязка к среде шаблона IWE. Сценарий разговора в навыке не пишется. Он целиком в одном файле, единственной редакции, которую так же читает инструкция Open MCP.

When to use

  • Любая реплика нового человека, пока bash .claude/scripts/light-onboarding-state.sh status печатает active (каждый ход каждого разговора, не только первый; о том же напоминает хук перед сообщением).
  • Человек пишет /onboarding.
  • Новый человек спрашивает «с чего начать?» или «что ты умеешь?».
  • Человек просит разобрать свою задачу методом.

Не для участника, вошедшего аккаунтом МИМ: у него полный онбординг (DP.SC.170).

Algorithm

Шаг 1. Прочитай канонический текст целиком

Текст лежит в копии шаблона IWE, в docs/onboarding/light-onboarding.md. Найди его по порядку, до первого найденного:

  1. $IWE_TEMPLATE/docs/onboarding/light-onboarding.md, если переменная окружения IWE_TEMPLATE задана;
  2. <рабочая папка IWE>/FMT-exocortex-template/docs/onboarding/light-onboarding.md (рабочая папка — та, где лежит CLAUDE.md);
  3. поиск по имени: find <рабочая папка IWE> -maxdepth 4 -path '*docs/onboarding/light-onboarding.md' -not -path '*/archive/*'.

Прочитай файл полностью, не по фрагментам, и веди разговор строго по нему: правила §1, развилка §2, разделы §3–§11.

Файл не найден ни одним способом → скажи человеку, что сценарий онбординга в этой установке недоступен, и предложи обновить шаблон (/iwe-update). Не восстанавливай сценарий по памяти.

Шаг 2. Что в этой среде значит «найди метод в библиотеке методов»

Библиотека методов в шаблоне — локальные копии в рабочей папке IWE ($IWE_WORKSPACE, по умолчанию папка, где лежит CLAUDE.md):

Порядок Где искать Что это
1 PACK-*/pack/ паки — методы предметных областей; в чистой установке их может не быть
2 FPF/: сначала FPF/FPF-LIBRARY-REFERENCE.md (устройство библиотеки) и FPF/USING-FPF.md (как искать и читать), затем наборы FPF/DPFs/ (решения, цели, объяснение, инженерия, мышление) и FPF/FPF-Spec.md первые принципы и общие методы мышления и работы; текст на английском — ищи по английским словам
3 SPF/ (docs/, spec/, process/) форма и порядок описания знаний

Как искать:

  • Поиск по смыслу задачи, на русском и на английском: rg -n -i -C 2 --no-ignore -g '*.md' -- '<термин>' <папка>; нет rg → grep -rn -i --include='*.md' -- '<термин>' <папка>.
  • Совпадение в оглавлении или справочнике — ещё не метод. Прочитай найденный раздел целиком, прежде чем объяснять метод человеку.
  • Повторный поиск (текст, §7 шаг 2) — другие слова: синонимы, английское название, уровень обобщённее.
  • «Место в библиотеке» для объяснения и квитанции — название раздела без внутреннего кода (номер паттерна не называй) и путь к файлу; версия — git -C <папка> log -1 --format='%h %ad' --date=short, если папка под git.
  • Нет ни одной из папок → это отказ 1 текста (библиотека недоступна). Скажи человеку, как её получить: копии FPF и SPF скачиваются при установке шаблона, если на компьютере есть вход в GitHub (gh auth login); вручную — gh repo clone ailev/FPF <рабочая папка IWE>/FPF -- --depth=1.

Шаг 3. Сайт для §9

Ссылку на сайт текст берёт из привязки. В шаблоне — по полю region в params.yaml рабочей папки: ru → https://system-school.ru; другое значение, пусто или поля нет → https://aisystant.com. Ссылку на установку шаблона текст даёт сам.

Шаг 4. Отметка «онбординг пройден»

Команды этого шага запускай ровно в таком виде, из рабочей папки и с коротким путём (bash .claude/scripts/light-onboarding-state.sh done): так они разрешены заранее и человек не увидит запроса на запуск. Полный путь к скрипту этот запрос вызывает.

  • Показал квитанцию §10 со всеми полями (поле «Стало» — словами человека) → выполни bash .claude/scripts/light-onboarding-state.sh done.
  • Человек сам просит работу в среде — команда среды (/day-open, /wp-new и подобные: завести или открыть рабочий продукт, дневной протокол, ведение проектов) или прямая просьба («хочу вести проекты в IWE») → выполни … done и исполни просьбу, не пересказывая устройство среды.
  • Не снимают онбординг: /onboarding с аргументами или без; справочные и служебные команды (/help, /clear, /compact, /mcp); строка, которую вставил хук; «хочу попробовать», «с чего начать», «хочу научиться».
  • Человек просит пройти знакомство заново → bash .claude/scripts/light-onboarding-state.sh reset (его рабочие продукты не трогаются).

Шаг 5. Границы привязки

  • Не вызывай инструменты MCP с подпиской (поиск по базе знаний, профиль, онбординг аккаунта, диагностика, руководство) — даже если подключение есть. Лёгкий онбординг их не использует. Человек сам спросил про аккаунт → §9 текста.
  • Не перепоручай поиск навыку /fpf: он сначала обращается к MCP с подпиской. Ищи по шагу 2.
  • Отметки §11 текста держи в разговоре. Ничего не записывай в файлы человека, пока он сам об этом не попросит; единственное исключение — служебная отметка шага 4.
  • Пока онбординг активен: не рассказывай о среде и её служебных командах, не заводи рабочих продуктов, не предлагай вход в подписочный сервер (/mcp). «Подключилось?» — это §3 текста, не §9.
  • Квитанцию §10 покажи в чате; сохранить её в файл — только по просьбе человека и туда, куда он скажет.
<!-- USER-SPACE --> <!-- /USER-SPACE -->