orchestration-stack.mdupdated 2026-08-011,679 chars

オーケストレーター(上位制御プロセス)から​Claude Codeを​起動する

毎回​手動でclaudeを​起動していると、​設定の​陳腐化・役割の​再決定の​繰り返し・タスクキューの​断絶が​起きる。​解決策は、​外部の​オーケストレーター​(=いつ・どのように​セッションを​起動するかを​管理する​上位の​制御プロセス)から、​子プロセスと​して​Claude Codeを​起動する​ことに​ある。

エコシステムの​主要ツール

obra/superpowersは​スキルレジストリ​(=再利用​可能な​エージェント向け技能の​配布・管理基盤)であり、superpowers installを​実行すると.claude/skills/ディレクトリが​最新化される。​claude-code-beansは​プラグインパックで、​スキル・フック・コマンドを​ひとまとめに​して​配布する。​ECC​(Everything Claude Code)は、​経営業務と​開発の​両方を​一つの​Claude Code環境で​賄う​パラダイム​(=考え方の​枠組み)である。​ハイフンテクノロジーズ​(HT)が​内製した​paperclipは、​専門分業した9体の​サブエージェントが​一つの​ゴールへ​収束する​事例である。

起動レイヤーの​構造

起動の​流れは、​スケジューラ​(=時刻指定で​ジョブを​実行する​仕組み)または​cronから​始まり、​Notion Tasksデータベースを​読むオーケストレーターを​経て、claude --name id --add-dir repoを​実行する。​起動の​たびに​オーケストレーターはsuperpowers updatebeans syncを​実行し、.claude/ディレクトリを​常に​最新に​保つ。​この​ディレクトリには、​スキル・エージェント・コマンド・フック・MCP​(Model Context Protocol=AIモデルを​外部の​ツールや​データに​接続する​ための​標準規格)の​設定が​揃った​状態で​起動時に​読み込まれる。

セットアップの​手順

.claude/は​リポジトリごとに​gitで​版管理し、​HT全社​共通の​ルールは~/src/ht/CLAUDE.mdに​置く。​この​ファイルは​階層的に​自動読込される。​スキルレジストリに​登録して​OSS​(オープンソースソフトウェア)の​スキルを​取得し、​独自スキルは.claude/skills/name/SKILL.mdと​して​作成する。​特に​重要な​フックは​4つ​あり、​SessionStartは​メモリファイルを​読み込み、​PostToolUseは​Prettier​(=コード整形ツール)を​実行し、​Stopは​自動コミットを​行い、​PreCompactは​コンテキスト圧縮の​前に​CLAUDE.mdを​再注入する。​MCPの​設定は​親ディレクトリの.mcp.jsonに​集約し、​各リポジトリはenabledMcpjsonServersで​必要な​ものだけを​有効化する。

避けるべきアンチパターン

.claude/を​手動で​更新すると​陳腐化する​ため、​更新は​レジストリの​インストールコマンド経由で​行うべきである。​全作業を​単一セッションに​詰め込むと​メインコンテキストが​汚染される​ため、​サブエージェントや​git worktree​(=リポジトリの​作業コピーを​分離する​仕組み)に​切り出すべきである。​オーケストレーターを​Claude Code自体の​内部に​置くのは​危険で、​親プロセスが​停止すると​全体が​止まってしまう​ため、​外部に​置くべきである。​MCPを​リポジトリごとに​定義すると​認証情報が​散乱する​ため、​親ディレクトリに​集約すべきである。

Claude Codeは​REPL​(対話的に​コマンドを​実行する​シェル)ではなく​子プロセスと​して​扱う。.claude/を​版管理し、​レジストリで​スキルを​同期し、​外部​スケジューラが​セッションを​起動する​設計が​正解である。

出典・参考

148 notestil