AI・テクノロジー

Claude Code /team-onboarding 活用ガイド：新メンバー立ち上げを自動化する

anchang info 約1分で読めます
# Claude Code # チーム開発 # オンボーディング # v2.1.101 # 2026

結論：チームオンボーディングの属人化を解決する新コマンド

Claude Code v2.1.101 で追加された /team-onboarding は、チーム固有のワークフローやツール設定を自動的に集約し、新メンバー向けのガイドとして出力するスラッシュコマンドです。これまで「CLAUDE.md を読んで」「口頭で引き継ぎ」「Notionを探して」と分散していた初期立ち上げ情報を、一つのドキュメントにまとめてくれます。

特に5人以上のチームや、複数リポジトリを横断する環境で威力を発揮します。本記事では、このコマンドが解決する課題、生成物の中身、実用的な運用フローを整理します。

/team-onboarding が解決する課題

チーム開発に Claude Code を導入すると、以下のような「属人化問題」が発生しがちです。

  • CLAUDE.md は存在するが、どこを読めばよいか新メンバーが迷う
  • .claude/commands/ 配下のスラッシュコマンドが増えすぎ、使い方が不明
  • MCP サーバ設定（.mcp.json）が追加されても共有されない
  • カスタムエージェント（.claude/agents/）の使い分けが口伝
  • チーム固有のルール（コミット規約、PRレビューフロー等）がリーダーの頭の中にしかない

/team-onboarding は、プロジェクトルートの設定ファイル群をスキャンし、新メンバーが最初の1日で理解すべき情報を構造化された Markdown として生成します。

実行すると生成される内容

コマンド実行後、Claude Code はプロジェクトを解析し、以下のセクションを含むオンボーディングドキュメントを提示します。

1. CLAUDE.md の読み解きガイド

既存の CLAUDE.md を要約し、「必読ルール」「状況依存ルール」「参考情報」に分類して提示します。長大になりがちな CLAUDE.md のうち、新メンバーが最初に押さえるべき部分を抽出してくれます。

2. よく使うスラッシュコマンドの説明

.claude/commands/ 配下のコマンドを一覧化し、それぞれの用途・引数・使用頻度を説明します。

## チーム固有のスラッシュコマンド

- /deploy-staging: ステージング環境へのデプロイ（毎日使用）
- /review-pr <番号>: PRレビュー自動化（週2〜3回）
- /gen-migration: DBマイグレーションファイル生成（月1〜2回）

3. MCP 設定の概要

.mcp.json に定義された MCP サーバを列挙し、各サーバが何を提供するか、認証が必要かを説明します。

{
  "mcpServers": {
    "github": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"] },
    "postgres": { "command": "mcp-postgres", "env": { "DATABASE_URL": "..." } }
  }
}

4. カスタムエージェントの紹介

.claude/agents/ 配下の YAML/Markdown を解析し、「どのエージェントをいつ呼び出すべきか」の判断基準を整理します。

5. チーム特有のワークフロー

コミット規約、ブランチ戦略、PRテンプレート、CI/CDフローなどを CLAUDE.md や .github/ から抽出してまとめます。

実行手順と活用フロー

基本的な実行手順

# プロジェクトルートで実行
claude

# Claude Code 起動後
/team-onboarding

初回実行時は数十秒〜1分ほどかかります。出力された Markdown は docs/onboarding.md などに保存し、チームでレビューしてから配布するのがおすすめです。

新メンバー参加時のフロー例

  1. リーダーが最新版の docs/onboarding.md を生成・コミット
  2. 新メンバーはリポジトリを clone 後、まず docs/onboarding.md を読む
  3. 不明点は Claude Code に /team-onboarding を再実行させて追加質問
  4. 2日目以降は通常の開発フローに合流

ベストプラクティス

定期的な更新

プロジェクトの設定は日々変わります。.claude/commands/ や .mcp.json を変更したら、月1回程度 /team-onboarding を再実行し、ドキュメントを更新しましょう。GitHub Actions で月次実行し、差分があれば PR を自動作成する運用も有効です。

on:
  schedule:
    - cron: '0 0 1 * *'  # 毎月1日
jobs:
  refresh-onboarding:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: claude --headless "/team-onboarding" > docs/onboarding.md
      - uses: peter-evans/create-pull-request@v6

他のチーム共有機能との組み合わせ

/team-onboarding は単独で使うより、以下と組み合わせると効果が倍増します。

  • .mcp.json: MCP サーバ設定を Git 管理して配布
  • .claude/agents/: カスタムエージェントを共有
  • .claude/commands/: スラッシュコマンドを共有
  • CLAUDE.md: プロジェクトルールを明文化

これらが整備されていれば、/team-onboarding は「最新の設定状態のスナップショット」として機能します。

5人以上・マルチプロジェクト環境での活用

複数のリポジトリを横断する環境では、リポジトリごとに生成したオンボーディングドキュメントを、社内 Wiki にインデックスする運用が便利です。新メンバーは「どのプロジェクトでも同じ入り口で情報にアクセスできる」体験を得られます。

まとめ

/team-onboarding は派手な機能ではありませんが、チームのスケール時に効いてくる地味に重要なコマンドです。既存の CLAUDE.md や MCP 設定を整備しているチームほど、恩恵が大きくなります。まずは次のメンバー参加前に一度実行してみて、出力を現状のドキュメントと見比べることから始めてみてください。

関連記事