Claude Code /team-onboarding — команда читает твои 30 дней работы и сама пишет гайд для новичка

Новый разработчик заходит в проект, где у тебя три месяца копились кастомные скиллы, полдюжины слэш-команд, пара субагентов и свой набор MCP-серверов. Для тебя всё это давно вторая натура. Новичок теряется в первый же час: какие команды у нас в ходу, что лежит в CLAUDE.md, к каким MCP подключаться, как тут вообще принято формулировать промпты. Обычно он неделями собирает ответы по обрывкам в Slack и чужим PR.

/team-onboarding пытается закрыть этот разрыв одной командой.

TL;DR: /team-onboarding — встроенная команда Claude Code, которая сканит твои последние 30 дней работы (сессии, частые слэш-команды, CLAUDE.md, установленные скиллы, MCP-серверы, паттерны workflow) и пишет ONBOARDING.md: карту того, как твоя команда реально пользуется агентом. С версии 2.1.152 (27 мая 2026) готовый гайд можно расшарить ссылкой, которую тиммейт открывает прямо в своём Claude Code.

Что именно она делает

Это не /init. /init обходит репозиторий и бутстрапит CLAUDE.md по коду: архитектура и конвенции. /team-onboarding смотрит в другую сторону. Не на код, а на то, как ты с этим кодом работаешь через агента.

Под капотом команда читает твою историю за 30 дней и сканит .claude/. На выходе — ONBOARDING.md, где собрано:

• какие слэш-команды у тебя в топе и что каждая делает (например, /carousel запускает GAN-петлю из carousel-designer и carousel-evaluator, /blog-post превращает карусель в MDX-страницу)
• что стоит из скиллов и MCP-серверов
• общие паттерны: как ты формулируешь задачи, что выносишь в CLAUDE.md

На бумагу ложится поведенческий слой, который раньше жил только у тебя в голове.

Два способа запустить

Интерактивно, прямо в сессии:

/team-onboarding

После первого черновика команда задаёт три вопроса: как называется команда, есть ли хорошая первая задача для новичка, какие тимовые тонкости стоит записать, которых нет в CLAUDE.md. Ответишь на них, и секции _TODO_ заполнятся. Пропустишь — плейсхолдеры останутся в файле.

Либо headless, сразу в файл:

claude -p "/team-onboarding" > ONBOARDING.md

Headless-вариант ничего не спрашивает и пишет черновик as-is, вместе с _TODO_. Удобно для скриптов и CI, но причёсывать результат придётся руками.

Главная фишка релиза — шаринг

Сам файл — это полдела. Новое в 2.1.152: встроенный флоу ShareOnboardingGuide заливает ONBOARDING.md и отдаёт короткую ссылку. Тиммейт открывает её прямо в своём Claude Code и сразу получает контекст вместо «вот тебе репо, разбирайся».

Режимов несколько:

• check (по умолчанию): если рядом есть локальный ONBOARDING.md, заливает его в самый свежий гайд организации (или создаёт новый, если гайдов ещё нет) и возвращает свежую ссылку. Если локального файла нет, просто отдаёт существующую ссылку.
• update: залить в конкретный гайд по его short_code
• create: всегда новый гайд
• delete: удалить

Кстати, команда жила в превью ещё с ~2.1.101 (конец марта), о ней успели написать на Medium и UX Planet. Официальную строчку в changelog и share-флоу она получила только сейчас.

Подводные камни

Это твои 30 дней, а не командные. Гайд отражает привычки одного человека: того, кто запустил команду. Если её прогонит джун с кривым workflow, новичок унаследует кривизну как «наш стандарт». Запускать должен тот, кто реально много и правильно работал в проекте за последний месяц.

Команда документирует, что ты делал, а не что правильно. Заброшенные эксперименты, разовые хаки, тупиковые слэш-команды попадут в топ, если ты их гонял последние недели. Вывод — это черновик, а не истина.

Приватность. Headless пишет файл as-is, со всеми твоими локальными путями. А ShareOnboardingGuide выгружает его на сервера Anthropic и отдаёт ссылку. Автоматического санитайзера нет: личные пути, внутренние названия, случайно попавшие секреты надо вычищать руками до шаринга.

Дефолтный check льёт в «самый свежий» гайд. Если в организации уже несколько гайдов и шарят несколько человек, легко долить не туда или перезаписать чужое. Чтобы целиться точно, нужен short_code и режим update.

Фиксированное окно в 30 дней. Только переключился на новый проект или вернулся из отпуска, и гайд выйдет тощим или вообще про не тот код.

Альтернативы

• /init — официальная команда CC, бутстрапит CLAUDE.md по репозиторию. Документирует код, а не workflow. Не конкурент, а дополнение: прогони обе, получишь карту и кода, и привычек.
• Community-скилл /onboard (Tom McFarlin) — работает по схеме scan, summarize, cache, delta-update, есть флаг --read-all для полной картины. Заточен под быструю ориентацию по ключевым файлам и обновляется дельтами, а не пересканивает всё заново.
• Пак из 5 onboarding-скиллов (раздавали на Reddit) — отдельные команды под architecture overview, dependency map, env setup, design decisions и contributor guide, где каждое утверждение привязано к реальному файлу. Гранулярнее, но это пять доков вместо одного.
• byterover Context Tree — версионированное дерево контекста прямо в репо, которое Claude запрашивает перед тем, как писать код. Это постоянная общая память, а не разовый снимок.

Вердикт

Запускай, если ты тимлид или сеньор и реально месяц пахал в проекте через Claude Code: получишь честную карту «как мы тут работаем» вместо протухшей вики на Confluence. Отдельно полезно мейнтейнерам фреймворков и темплейтов. Прогони команду в основном рабочем окружении, вычисти личные пути и закоммить результат как docs/how-we-use-claude-code.md, обновляя на каждом релизе. Это то, чего не даёт ни один стартер-кит: снимок реального использования, а не маркетинговый список фич.

Не стоит, если работаешь соло (онбордить некого), история за месяц мусорная, или у тебя жёсткие ограничения на выгрузку производного от сессий контента. И ни в коем случае не расшаривай вывод не глядя.

Как попробовать

1. Обнови клиент: npm install -g @anthropic-ai/claude-code, проверь claude --version. Для share-флоу нужен 2.1.152+ (сама команда есть и в более ранних версиях).
2. В корне проекта, после месяца реальной работы, запусти /team-onboarding и ответь на три вопроса, иначе в файле останутся _TODO_-секции.
3. Для автоматизации — headless: claude -p "/team-onboarding" > ONBOARDING.md.
4. Вычитай ONBOARDING.md: выкинь личные пути, внутренние названия и разовые хаки, которые не должны стать «стандартом».
5. Расшарь через встроенный флоу, получишь короткую ссылку, кинь её новичку — он откроет прямо в своём Claude Code. Или просто закоммить файл в репозиторий рядом с CLAUDE.md.

Полную строчку релиза можно найти в changelog Claude Code.