ダブルクリックで英日反転
Applied Sciences · Engineering
Launching Claude Code from an Orchestration Layer
Running `claude` manually per session leads to stale settings, repeated role decisions, and a disconnected task queue. The fix: launch Claude Code as a child process from an external orchestrator.
Ecosystem Tools
- obra/superpowers — skill registry; `superpowers install` syncs skills into `.claude/skills/`
- claude-code-beans — plugin pack; distributes skills/hooks/commands as a bundle
- ECC (Everything Claude Code) — paradigm for running both business and dev in one Claude Code
- paperclip (HT) — 9 sub-agents converging on a single goal via specialised division of labour
Launch Layer Structure
- Scheduler/cron → Orchestrator (reads Notion Tasks DB) → `claude --name <id> --add-dir <repo>`
- Orchestrator runs `superpowers update` or `beans sync` before each launch to keep `.claude/` fresh
- `.claude/` holds skills, agents, commands, hooks, and MCP — all ready on startup
Setup Checklist
- Version-control `.claude/` per repo; HT-wide rules in `~/src/ht/CLAUDE.md` (hierarchical load)
- Subscribe to a skill registry for OSS skills; write custom skills in `.claude/skills/<name>/SKILL.md`
- Four key hooks: SessionStart (read MEMORY), PostToolUse (prettier), Stop (auto-commit), PreCompact (re-inject CLAUDE.md)
- Centralise MCP in parent-dir `.mcp.json`; each repo opts in via `enabledMcpjsonServers`
Anti-Patterns
- Updating `.claude/` by hand — goes stale; route updates through registry install commands
- Single-session monolith — dirties the main context; offload to sub-agents / worktrees
- Orchestrator inside Claude Code — if the parent dies, everything stops; keep it external
- Per-repo MCP definitions — credentials scatter; consolidate in the parent directory
→ Treat Claude Code as a child process, not a REPL: version-control `.claude/`, sync skills via a registry, and let an external scheduler trigger sessions.
Applied Sciences · Engineering
オーケストレーター(上位制御プロセス)からClaude Codeを起動する
毎回手動で `claude` を起動すると、設定の陳腐化・役割再決定の繰り返し・タスクキューの断絶が起きる。解決策は、外部オーケストレーターから子プロセスとして Claude Code を起動することにある。
エコシステムの主要ツール
- obra/superpowers — スキルレジストリ(技能の配布・管理基盤)。`superpowers install` で `.claude/skills/` を最新化
- claude-code-beans — プラグインパック。スキル/フック/コマンドをまとめて配布
- ECC(Everything Claude Code)— 経営と開発を一つの Claude Code で賄うパラダイム(思想的な方向性)
- paperclip(HT内製)— 専門分業した9サブエージェントが一つのゴールに収束する事例
起動レイヤーの構造
- スケジューラ/cron → オーケストレーター(Notion Tasks DB を読む)→ `claude --name <id> --add-dir <repo>`
- 起動前に `superpowers update` や `beans sync` を実行し `.claude/` を常に最新に保つ
- `.claude/` にスキル・エージェント・コマンド・フック・MCPを揃えた状態で起動する
セットアップの手順
- `.claude/` をリポジトリごと git 管理。HT全社共通ルールは `~/src/ht/CLAUDE.md` に(階層的自動読込)
- スキルレジストリに登録してOSSスキルを取得。独自スキルは `.claude/skills/<name>/SKILL.md` に作成
- 4つの必須フック: SessionStart(MEMORY読込)・PostToolUse(prettier)・Stop(自動コミット)・PreCompact(CLAUDE.md再注入)
- MCPは親ディレクトリの `.mcp.json` に集約し、各リポは `enabledMcpjsonServers` で必要なものだけ有効化
避けるべきアンチパターン
- `.claude/` を手動更新 → すぐ陳腐化する。レジストリのインストールコマンド経由で管理する
- 全作業を単一セッションに詰め込む → メインコンテキストが汚染される。サブエージェント/worktreeに切り出す
- オーケストレーターを Claude Code 内部に置く → 親プロセスが死ぬと全停止。cron等の外部に置く
- MCPをリポジトリごとに定義する → 認証情報が散乱する。親ディレクトリに集約する
→ Claude Code はREPL(対話型シェル)ではなく子プロセスとして扱う。`.claude/` をバージョン管理し、レジストリでスキルを同期し、外部スケジューラがセッションを起動する設計が正解。
Applied Sciences · Engineering
Launching Claude Code from an Orchestration Layer
Running `claude` manually per session leads to stale settings, repeated role decisions, and a disconnected task queue. The fix: launch Claude Code as a child process from an external orchestrator.
Ecosystem Tools
- obra/superpowers — skill registry; `superpowers install` syncs skills into `.claude/skills/`
- claude-code-beans — plugin pack; distributes skills/hooks/commands as a bundle
- ECC (Everything Claude Code) — paradigm for running both business and dev in one Claude Code
- paperclip (HT) — 9 sub-agents converging on a single goal via specialised division of labour
Launch Layer Structure
- Scheduler/cron → Orchestrator (reads Notion Tasks DB) → `claude --name <id> --add-dir <repo>`
- Orchestrator runs `superpowers update` or `beans sync` before each launch to keep `.claude/` fresh
- `.claude/` holds skills, agents, commands, hooks, and MCP — all ready on startup
Setup Checklist
- Version-control `.claude/` per repo; HT-wide rules in `~/src/ht/CLAUDE.md` (hierarchical load)
- Subscribe to a skill registry for OSS skills; write custom skills in `.claude/skills/<name>/SKILL.md`
- Four key hooks: SessionStart (read MEMORY), PostToolUse (prettier), Stop (auto-commit), PreCompact (re-inject CLAUDE.md)
- Centralise MCP in parent-dir `.mcp.json`; each repo opts in via `enabledMcpjsonServers`
Anti-Patterns
- Updating `.claude/` by hand — goes stale; route updates through registry install commands
- Single-session monolith — dirties the main context; offload to sub-agents / worktrees
- Orchestrator inside Claude Code — if the parent dies, everything stops; keep it external
- Per-repo MCP definitions — credentials scatter; consolidate in the parent directory
→ Treat Claude Code as a child process, not a REPL: version-control `.claude/`, sync skills via a registry, and let an external scheduler trigger sessions.
Applied Sciences · Engineering
オーケストレーター(上位制御プロセス)からClaude Codeを起動する
毎回手動で `claude` を起動すると、設定の陳腐化・役割再決定の繰り返し・タスクキューの断絶が起きる。解決策は、外部オーケストレーターから子プロセスとして Claude Code を起動することにある。
エコシステムの主要ツール
- obra/superpowers — スキルレジストリ(技能の配布・管理基盤)。`superpowers install` で `.claude/skills/` を最新化
- claude-code-beans — プラグインパック。スキル/フック/コマンドをまとめて配布
- ECC(Everything Claude Code)— 経営と開発を一つの Claude Code で賄うパラダイム(思想的な方向性)
- paperclip(HT内製)— 専門分業した9サブエージェントが一つのゴールに収束する事例
起動レイヤーの構造
- スケジューラ/cron → オーケストレーター(Notion Tasks DB を読む)→ `claude --name <id> --add-dir <repo>`
- 起動前に `superpowers update` や `beans sync` を実行し `.claude/` を常に最新に保つ
- `.claude/` にスキル・エージェント・コマンド・フック・MCPを揃えた状態で起動する
セットアップの手順
- `.claude/` をリポジトリごと git 管理。HT全社共通ルールは `~/src/ht/CLAUDE.md` に(階層的自動読込)
- スキルレジストリに登録してOSSスキルを取得。独自スキルは `.claude/skills/<name>/SKILL.md` に作成
- 4つの必須フック: SessionStart(MEMORY読込)・PostToolUse(prettier)・Stop(自動コミット)・PreCompact(CLAUDE.md再注入)
- MCPは親ディレクトリの `.mcp.json` に集約し、各リポは `enabledMcpjsonServers` で必要なものだけ有効化
避けるべきアンチパターン
- `.claude/` を手動更新 → すぐ陳腐化する。レジストリのインストールコマンド経由で管理する
- 全作業を単一セッションに詰め込む → メインコンテキストが汚染される。サブエージェント/worktreeに切り出す
- オーケストレーターを Claude Code 内部に置く → 親プロセスが死ぬと全停止。cron等の外部に置く
- MCPをリポジトリごとに定義する → 認証情報が散乱する。親ディレクトリに集約する
→ Claude Code はREPL(対話型シェル)ではなく子プロセスとして扱う。`.claude/` をバージョン管理し、レジストリでスキルを同期し、外部スケジューラがセッションを起動する設計が正解。
Related notes
- Agentic Commerce — ACP and Visibility into Being 'Bought by AI'
- AI Search Evaluation: The 12 Metrics — Gateway
- AI Search Evaluation ①Citation Rate — How Many URLs Are Pulled In Per Answer
- AI Search Evaluation ②Source Diversity — How Unskewed the Cited Sources Are
- AI Search Evaluation ③Accuracy Score — How Often It Answers Factual Questions Correctly
- AI Search Evaluation ④Answer Length — How Many Characters It Returns to the User on Average