Claude Code をオーケストレーション層から起動する

Claude Code を「ターミナルで claude を叩いて 1 セッション動かす」だけだと、

  • Skill / Sub-agent / Hook / MCP の追加・更新が手動になり、結局古い設定で走る
  • 並列セッション間の役割分担を毎回口頭で決め直す
  • 経営側のタスクキューと、開発側のセッションが分断される

ので、claude をオーケストレータから子プロセスとして起動する運用に寄せた方が早い。 これは Superpowers / Beans / ECC が共通して提示している方向。

エコシステム上の主要選択肢（2026-05 時点の理解）

| プロジェクト | 種類 | 何をくれるか | |---|---|---| | obra/superpowers | Skill レジストリ + meta orchestration | 「Skills as a Service」。superpowers install で最新 skill 群を .claude/skills/ に同期 | | claude-code-beans | Plugin pack | ありもの skills / hooks / commands を bundle で配布。Marketplace から install | | ECC（Everything Claude Code） | 思想 / 設計指針 | 「業務も開発も Claude Code 1 つで完結させる」というパラダイム名。固有実装ではなく合言葉 | | paperclip | HT 自作のマルチエージェント基盤 | 9 sub-agent を専門分担して 1 ゴールに収束させる例。social proof として参照 |

起動レイヤーの構造（推奨）

[Scheduler / Niki 起動]
      ↓
[Orchestrator]  ← Notion Tasks DB を読む / cron で起きる
      ↓
[claude --name <session-id> --add-dir <repo> <prompt>]
      ↓
.claude/   ← skills/agents/commands/hooks/MCP がすべて揃った状態で起動

ポイントは、.claude/ を**「常に最新の Skill / Hook / Agent が揃っている状態」**に保つこと。 Orchestrator はそのために superpowers update や beans sync を起動前に走らせる。

手順（HT 用の最短ルート）

  1. .claude/ をリポ単位でバージョン管理

    • ~/src/ht/<repo>/.claude/ を git で追う。settings.local.json だけ gitignore
    • HT 全社の共通ルールは ~/src/ht/CLAUDE.md（parent dir で hierarchical loading）

  2. Skill レジストリを購読

    • superpowers install 系で OSS skill を .claude/skills/ 配下に取り込む
    • 自前 skill は .claude/skills/<name>/SKILL.md に書く

  3. Hook で確実性を担保

    • SessionStart で MEMORY.md + Notion CONSENSUS を read
    • PostToolUse(Edit|Write) で prettier
    • Stop で auto-commit & push
    • PreCompact で CLAUDE.md 再注入

  4. MCP は parent dir に集約

    • ~/src/ht/.mcp.json を 1 ファイルで管理（Notion / browsermcp / context-mode 等）
    • 各リポは enabledMcpjsonServers で必要なものだけ ON

  5. Orchestrator が claude を起動

    • cron（schedule skill）/ Stop hook chain / Notion webhook 等のトリガー
    • 起動 prompt は「今日の Tasks DB を見て priority 1 から着手」の固定テンプレ

  6. 並列は worktree で

    • 独立タスクは claude --worktree で物理隔離
    • 協調タスクは Agent Teams（Sub-agent の集合）

成功例として参考にできるもの

  • paperclip（HT 内） — 9 agent / 6 goal / 3 project を 1 orchestrator が回す。Phase 1 完了。ローカル :3100
  • SCAS（HT 内） — Writer/Reviewer の 2 役を sub-agent 化して、CTO レビュー前の自己検証を走らせる構成
  • Superpowers の skill カタログ — web-research / commit-push-pr / daily-ops 等、運用色の強い skill を組み合わせると、経営オペ自体がスクリプタブルになる

やってはいけない構成

  • .claude/ を手で更新し続ける → すぐ陳腐化。skill/hook 更新は registry の install コマンド経由にする
  • 1 セッションで何でもやる → 主 context が汚れる。重作業は sub-agent / worktree に逃がす
  • Orchestrator を Claude Code 内部に置く → 親が落ちると全部止まる。Orchestrator は外部（cron / Notion / scheduler）で動かす
  • MCP を各リポでバラバラに定義 → parent dir に集約しないと認証情報が散乱する

今後検証する論点

  • Superpowers / Beans / 自前 skill の優先順位。同名 skill があったらどれが勝つか
  • ECC 的に「経営タスクも Claude Code でやる」と言った時、Slack / Discord / Notion それぞれの hand-off 点
  • Sub-agent の予算管理。並列が増えると Opus 4.7 でも普通に数千円 / セッション飛ぶ

参考・引用元

2026-05-20

関連ノート