setup

OrchestKit セットアップウィザード

コードベースをスキャンして技術スタックを検出し、スキルと MCP を推奨して、実行可能な改善計画を作成する、パーソナライズされたオンボーディングです。

使用するタイミング

• OrchestKit のインストール後、初めて使用するとき（/plugin install ork）
• 新しいプロジェクトに参加し、OrchestKit をそのプロジェクト向けに調整したいとき
• --rescan を使って定期的に改善状況を追跡するとき
• 安全なユーザースコープのインストール確認が必要なエンタープライズユーザー

クイックスタート

setup              # Full 7-phase wizard
setup --rescan     # Re-scan after changes (skip safety phase)
setup --score-only # Just show readiness score
setup --plan-only  # Just show improvement plan
setup --configure  # Jump directly to Phase 3.5: project configuration wizard

引数の解決

FLAG = "$ARGUMENTS[0]"  # First token: --rescan, --score-only, --plan-only, --channel
# If no arguments, run full 7-phase wizard.
# $ARGUMENTS is the full string (CC 2.1.59 indexed access)

重要：タスク管理は必須です（CC 2.1.16）

ほかのことを始める前に、進捗を追跡するタスクを作成してください：

# 1. Create main task IMMEDIATELY
TaskCreate(
  subject="Setup: onboarding wizard",
  description="Personalized setup scanning codebase and configuring OrchestKit",
  activeForm="Running setup wizard"
)

# 2. Create subtasks for key phase groups
TaskCreate(subject="Scan & detect stack", activeForm="Scanning codebase and detecting stack")
TaskCreate(subject="Safety & configure", activeForm="Checking config and running configuration wizard")
TaskCreate(subject="Recommend skills & MCPs", activeForm="Matching stack to skills and MCPs")
TaskCreate(subject="Score & plan", activeForm="Computing readiness score and improvement plan")

# 3. Set dependencies for sequential phases
TaskUpdate(taskId="3", addBlockedBy=["2"])
TaskUpdate(taskId="4", addBlockedBy=["3"])
TaskUpdate(taskId="5", addBlockedBy=["4"])

# 4. Update status as you progress
TaskUpdate(taskId="2", status="in_progress")  # When starting
TaskUpdate(taskId="2", status="completed")    # When done

各フェーズ

フェーズ	内容	使用ツール	出力
1. スキャン	言語、フレームワーク、インフラ、既存設定を検出	Glob, Grep, Read	スキャンの生データ
2. スタック	検出したスタックと信頼度を分類	—	スタックプロファイル
3. 安全性	既存設定を確認し、スコープ（ユーザー／プロジェクト）を確認	Read, AskUserQuestion	インストールの確認
3.5. 設定	対話形式のプロジェクト設定ウィザード → プロジェクトごとの設定に環境変数ブロックを書き込みます	Read, Write, AskUserQuestion	設定済みの設定ファイル
3.6. 保護	ork の標準 permissions.deny ペイロードを、強制適用されるスコープに適用します（プラグインの settings.json は何もしません。CC が読み取るのは agent／subagentStatusLine のみです、#3835）。node ${CLAUDE_SKILL_DIR}/scripts/write-operator-permissions.mjs --scope user --dry-run を実行し、追加内容と、出力のみを行うサンドボックスの提案を表示します。その後、明示的な同意があった場合に限り、--dry-run なしで再実行します。このスクリプトはファイルをバックアップし、1 コマンドでのロールバック方法を出力します。ドライランと同意の両方が揃わない限り、書き込みを行わないでください。	Bash, AskUserQuestion	強制適用された拒否ルールとロールバックコマンド
4. スキル	スタックにスキルを対応付け、カスタムスキルを提案	Grep, Glob	スキルの推奨
5. MCP	スタックと不足項目に基づいて MCP を推奨	Read, Bash	MCP の推奨
6. スコア	準備状況のスコアを算出（0～10、6 つの評価軸）	上記すべてのデータ	準備状況スコア
7. 計画	実行可能なコマンドを含む、優先順位付きの改善項目	—	アクションプラン

---

フェーズ 1：スキャン

詳細を読み込むには、完全なスキャンコマンド（並列 Glob プローブ 20 件 + 依存関係ファイルの読み取り + パターン検出数）が記載された references/scan-phase.md を Read("references/scan-phase.md") で読み込みます。

パッケージマニフェスト（package.json、pyproject.toml、go.mod、Cargo.toml など）、インフラ（Docker、GitHub Actions、Terraform、K8s）、既存の CC 設定をスキャンします。パターン検出では、カスタムスキルの提案に向けて、API ルート、React コンポーネント、モデル、テストの数を集計します。

フェーズ 2：スタックの検出

まずスタックスナップショットを読み込んでください。 フォークされたスキルではフロントマターのフックが実行されないため（#4683）、ローダーを自分で実行し、その additionalContext を考慮してください：

echo '{"tool_name":"Bash","tool_input":{}}' | node "${CLAUDE_PLUGIN_ROOT}/hooks/bin/run-hook.mjs" skill/setup-env-detector

スキャン結果をスタックプロファイルに分類し、ユーザーに提示します（言語、フレームワーク、データベース、インフラ、テスト、既存の CC 設定）。

スタックとスキルの完全な対応表、MCP 推奨マトリクス、カスタムスキルの提案パターンについては、references/stack-skill-mapping.md を Read("references/stack-skill-mapping.md") で読み込みます。

フェーズ 2b：チャネルの検出

フェーズ 3：安全性チェック

詳細を読み込むには、Read("references/safety-check.md") を実行してください。AskUserQuestion の完全なプロンプトと競合検出ロジックを確認できます。

インストール範囲として、ユーザーのみ（推奨、チームメイトには見えません）、プロジェクト全体（リポジトリにコミットされます）、すでにインストール済み（設定に進みます）の 3 つを提示します。既存の OrchestKit インストールと競合するプラグインを確認します。

コンソール認証（CC 2.1.79+）： Anthropic Console（API 請求）で認証するユーザーは、デフォルトの OAuth フローの代わりに claude auth login --console を実行できます。Pro／Team サブスクリプションではなく、従量課金の API を利用するチームに便利です。

チームのオンボーディング（CC 2.1.101+）： /team-onboarding は、ローカルの CC 使用パターンに基づいてチームメイト向けの導入ガイドを生成します。セットアップ後に実行して、新しいチームメンバー向けのオンボーディングドキュメントを作成することをおすすめします。

エンタープライズ TLS（CC 2.1.101+）： OS の CA 証明書ストアはデフォルトで信頼されるため、エンタープライズ TLS プロキシは追加設定なしで動作します。必要に応じて CLAUDE_CODE_CERT_STORE=bundled を設定すると、バンドルされた CA のみが使用されます。

プロンプトキャッシュ（CC 2.1.108+）： API キー、Bedrock、Vertex、Foundry のユーザーには、プロンプトキャッシュの TTL を 5 分から 1 時間に延長するため、ENABLE_PROMPT_CACHING_1H=1 の設定をおすすめします。これにより、OrchestKit の長時間セッション（brainstorm、implement、cover のチェーン）のトークンコストが大幅に削減されます。セッションの要約は、テレメトリーが無効でも、CC 2.1.110 以降はデフォルトで有効です。

TUI モード（CC 2.1.110+）： 長時間セッションでちらつきのない描画を実現するため、/tui fullscreen の使用をおすすめします。brainstorm／implement の出力を確認する際に手動でスクロールを制御するには、/config で autoScrollEnabled: false と組み合わせてください。/focus コマンドを使うと、プロンプト、1 行のツール要約、最終応答だけを表示する簡潔なビューになります。

プラグインのインストール（CC 2.1.157+）： .claude/skills 内のプラグインはマーケットプレイスなしで自動ロードされます。ローカル／開発環境でインストールする場合は、そこにプラグインを配置するだけで十分です。claude plugin init <name> は、.claude/skills に新しいプラグインのひな形を作成します。

--dangerously-skip-permissions のポリシー（CC 2.1.121 + 2.1.126、#1583）： このフラグの適用範囲は大幅に拡大しました。2.1.126 以降は、2.1.121 以降ですでに許可プロンプトが回避されていた .claude/skills/、.claude/agents/、.claude/commands/ に加え、.claude/、.git/、.vscode/、シェル設定ファイル（~/.bashrc、~/.zshrc など）、および「その他の従来保護されていたパス」への書き込みでもプロンプトが回避されます。壊滅的な削除コマンド（例：rm -rf /）でのみ、引き続きプロンプトが表示されます。共有ワークステーション、CI ランナー、オンボーディングセッションでは、このフラグを使用しないことをおすすめします。 安全策を一括で無効にせず、きめ細かな許可リストを設定できる src/hooks/README.md の自動承認パーミッションフックをおすすめします。セットアップウィザードでは、設定中にユーザーがこのフラグを有効にした場合、ブロックせずに警告してください。

フェーズ 3.5：プロジェクト設定ウィザード

詳細を読み込むには、Read("references/configure-wizard.md") を実行してください。6 ステップの対話型設定フロー（ブランチ戦略、コミット範囲、パフォーマンスのテレメトリー、ログの詳細度、Webhook テレメトリー。ステップ 3 のローカルホストブラウザーは廃止済み）と環境変数のリファレンスを確認できます。

setup --configure からも直接実行できます。フェーズ 1～3 はスキップされます。

---

フェーズ 4：スキルのおすすめ

AskUserQuestion を使い、4 つの重点分野（フルスタック、バックエンド、フロントエンド、DevOps）から選べる形でスキルのカテゴリを提示し、multiSelect: true を指定します。マッピング表とカスタムスキルの提案については、Read("references/stack-skill-mapping.md") を読み込んでください。

フェーズ 5：MCP の推奨事項

.mcp.json と ~/.claude/settings.json を読み取り、インストール済みの MCP と推奨する MCP を確認します。MCP の推奨マトリックスを確認するには、Read("references/stack-skill-mapping.md") を読み込みます。インストールコマンド付きの切り替え項目として提示します。

CC 2.1.121 以降のヒント（#1541）： 広く必要とされる T2 の 3 つ（memory、context7、sequential-thinking）については、.mcp.json の各エントリーに "alwaysLoad": true を設定することを推奨します。これによりスキルごとの ToolSearch プローブが省略され、コールドスタートが約 150ms 短縮されます。このキーは古い CC では無視されるため、先行して追加しても問題ありません。

プラグインのライフサイクルのクリーンアップ（CC 2.1.121 以降、#1544）： クリーンアップのセクションで claude plugin uninstall <name> --prune に触れます。これにより、連鎖的に処理され、孤立した自動インストール済みの依存関係が削除されます。単独で実行する claude plugin prune は、何もアンインストールせずに同じクリーンアップを行います。dream はこれを毎週実行します。

フェーズ 6：準備状況スコア

6 つの評価項目から総合スコア（0～10）を算出します。評価項目の重み、スコアの提示テンプレート、メモリー連携、改善計画のテンプレートについては、Read("references/readiness-scoring.md") を読み込みます。

フェーズ 7：改善計画

優先順位を付けた、実行可能な推奨事項を P0／P1／P2 の段階に分けて作成します。テンプレートとメモリーへの永続化パターンについては、readiness-scoring.md を参照してください。

フェーズ 7b：CLAUDE.md の健全性チェック

改善計画の後、ユーザーの CLAUDE.md が CC 2.1.59 以降のモジュール構造を活用できるか確認します。CC 2.1.277 以降では、CLAUDE.md がないプロジェクトでは AGENTS.md がこの役割を担うため、プロジェクトが使用している指示ファイルを対象に同じチェックを行います。

詳細を確認するには、Read("references/claude-md-health.md") を読み込みます。分析手順、しきい値、@import 構文、および .claude/rules/ のパススコープルールを確認できます。

# Quick check
Bash(command="wc -l CLAUDE.md 2>/dev/null | awk '{print $1}'")
Glob(pattern=".claude/rules/*.md")

CLAUDE.md が 200 行を超え、.claude/rules/ が存在しない場合は、分割を推奨します。リファレンス文書の出力テンプレートを示してください。

セットアップ後

ヒント（CC 2.1.69 以降）： セットアップの完了後に /reload-plugins を実行すると、セッションを再起動せずにすべてのプラグインの変更を有効にできます。

ヒント（CC 2.1.90 以降）： Claude Code を初めて使う方は、アニメーションデモで主要な機能を学べる対話型レッスン /powerup をお試しください。

フェーズ 9：テレメトリと Webhook

以前は configure に含まれていました。現在は、セットアップの単一のエントリーポイントの一部になっています。

設定フローの全体については、Read("references/telemetry-setup.md") を読み込んで詳細を確認します。

AskUserQuestion を使ってユーザーの希望を尋ねます。

モード	イベント	認証	オーバーヘッド
Webhook にストリーミング	HMAC 署名付き http-sink による分析イベントと SessionEnd の要約	ORCHESTKIT_HOOK_TOKEN	バッチ処理、非同期
スキップ	テレメトリなし	なし	なし

ストリーミングが選択された場合：

1. Webhook URL を尋ねます
2. webhookUrl を .claude/orchestration/config.json に保存します
3. ORCHESTKIT_HOOK_TOKEN 環境変数についてユーザーに伝えます

イベントごとのネイティブ HTTP フックジェネレーター（チャネル 1）は #3867 で削除されました。settings.local.json に type: "http" エントリーを書き込むものはありません。

フェーズ 10：任意の統合

セットアップ手順については、Read("references/integrations.md") を読み込んで詳細を確認します。

CC のバージョン固有の設定（CC 2.1.7 の MCP 遅延読み込み、CC 2.1.20 のタスク削除、CC 2.1.23 のスピナー動詞、CC 2.1.79 のターン所要時間表示）と、モノレポのワークツリー最適化について説明します。

モノレポのスパースパス（CC 2.1.76 以降）

フェーズ 1 のスキャンでモノレポ（pnpm-workspace.yaml、nx.json、lerna.json、turbo.json、または package.json の workspaces）を検出した場合は、.claude/settings.json で worktree.sparsePaths を設定することを提案します。

{
  "worktree": {
    "sparsePaths": ["src/", "packages/core/", "tests/", "scripts/"]
  }
}

これにより、--worktree とエージェントの isolation: worktree は git sparse-checkout を使って、指定されたディレクトリのみをチェックアウトします。大規模なモノレポでは大幅に高速化できます。

複数ディレクトリからのプラグインのシード（CC 2.1.79+）

CLAUDE_CODE_PLUGIN_SEED_DIR では、プラットフォームのパス区切り文字（Unix では :、Windows では ;）で区切って複数のディレクトリを指定できるようになりました。

export CLAUDE_CODE_PLUGIN_SEED_DIR="/shared/team/plugins:/shared/org/plugins"

これは、共有の組織全体向けプラグインディレクトリとチーム固有のディレクトリを併用するなど、複数のプラグインソースを持つチームに便利です。Claude Code は起動時に、指定されたすべてのディレクトリをスキャンしてプラグイン定義を検索します。

.zip からの一時的なプラグイン読み込み（CC 2.1.128 / 2.1.129）

マーケットプレイスへのインストールを確定せずにプラグインを評価する場合に使います。同僚のブランチビルド、CI で生成された PR 成果物、公開前の OrchestKit プレリリース .zip の試用などに便利です。

• --plugin-dir <path-to-zip>（CC 2.1.128+）：ローカルの .zip アーカイブを、セッション用プラグインとして読み込みます。これまでディレクトリのみを受け付けていた同じフラグで、アーカイブも受け付けるようになりました。

  claude --plugin-dir ./vendor/some-plugin.zip
  

• --plugin-url <url>（CC 2.1.129+）：URL から .zip を取得し、現在のセッションでのみ読み込みます。CC の終了時にプラグインは破棄され、~/.claude/plugins/ には何も書き込まれません。

  claude --plugin-url https://example.com/some-plugin.zip
  

どちらもセッション限定のお試し用オプションです。恒久的にインストールするには、マーケットプレイスに対して標準の /plugin install フローを使用してください。詳細は ${CLAUDE_PLUGIN_ROOT}/skills/configure/references/cc-version-settings.md § CC 2.1.128/2.1.129 を参照してください。

CLI フラグ

フラグ	動作
（なし）	フルウィザード（フェーズ 1～10）
--rescan	スキャンとスコア計算を再実行し、安全性チェックのフェーズはスキップします
--configure	フェーズ 3.5「プロジェクト設定ウィザード」に直接移動します
--score-only	現在の準備状況スコアを表示します（フェーズ 6 のみ）
--plan-only	改善計画を表示します（フェーズ 7 のみ）
--telemetry	フェーズ 9「テレメトリ／Webhook の設定」に移動します
--preset	プリセットを適用します（complete/standard/lite/hooks-only/monorepo）

プリセット（--preset 経由）

フルウィザードを使わずに OrchestKit をすばやく設定するには、プリセットを適用します。

プリセット	スキル	エージェント	フック	おすすめの用途
complete	91	31	96	フルパワー — すべてを有効化
standard	91	0	96	スキル＋フック。エージェントなし
lite	10	0	96	必須のワークフロースキルのみ
hooks-only	0	0	96	安全性フックのみ
monorepo	91	31	96	complete ＋モノレポのワークスペース検出

プリセットの詳細を読み込むには、Read("references/presets.md") を実行します。

リファレンス

Read("references/<file>") で必要に応じて読み込みます。

ファイル	内容
scan-phase.md	フェーズ 1：20 個の並列 Glob プローブ＋パターン検出
safety-check.md	フェーズ 3：インストール範囲と競合の検出
configure-wizard.md	フェーズ 3.5：6 ステップの対話式プロジェクト設定
claude-md-health.md	フェーズ 7b：CLAUDE.md のモジュール構造分析
telemetry-setup.md	フェーズ 9：Webhook／テレメトリの設定
integrations.md	フェーズ 10：CC のバージョン設定
presets.md	プリセットの定義とスキル／エージェントの一覧

CC --channels とコンソール認証（2.1.128+）

--channels（組織ごとの通知チャンネルのルーティング）は、OAuth だけでなくコンソール（API キー）認証でも動作するようになりました。ただし、管理 API を使って組織に channelsEnabled: true が設定されている必要があります。API キー認証で claude --channels=... を実行した際、組織の設定にこのフラグがない場合、チャンネルの選択は何も通知されずに無視されます。セットアップウィザードは、API キー認証を検出し、チャンネルルーティングを行うスキルまたはエージェントがインストール対象として選択されている場合に、この点を表示します。

関連スキル

• ork:doctor — ヘルス診断（ウィザードはそのチェック項目を使用します）
• ork:configure — 内部設定（ウィザードのフェーズ 3.5、9、10 から呼び出されます）
• ork:remember — ナレッジの永続化（ウィザードは初期パターンをシードします）
• ork:explore — コードベースの詳細分析（ウィザードは後続作業用にリンクします）
• ork:help — スキルディレクトリ（ウィザードは関連するサブセットを表示します）