research: Claude Code Agent Teams と cekernel の関係整理

[clonable-eden]

Summary

Claude Code の Agent Teams (実験的機能, Opus 4.6 同梱) と cekernel の Orchestrator/Worker モデルの関係を整理する。

#86 のリサーチアップデートで「今後検討すべきテーマ」として挙げた項目。

背景

Claude Code Agent Teams は peer-to-peer のマルチエージェント協調を提供する:

• アーキテクチャ: 1セッションがチームリード、チームメイトは独立したコンテキストウィンドウで動作し、エージェント間で直接メッセージングが可能 (hub-and-spoke ではない)
• ツール: TeammateTool (spawnTeam, cleanup), SendMessage (message, broadcast, shutdown_request/response)
• 有効化: CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS を settings.json または環境変数で設定
• 制約: セッション再開時にチームメイトは復元されない (/resume, /rewind 非対応)

cekernel の現在のモデル

• Orchestrator が Bash 経由で claude --agent を起動 (別プロセス)
• Worker は git worktree 内で独立して動作
• IPC は FIFO + state file (一方向: Worker → Orchestrator)
• Worker 間の直接通信なし

検討ポイント

1. トレードオフの整理

軸	cekernel (Bash 起動)	Agent Teams
プロセス分離	完全分離 (別プロセス)	同一セッション内
コンテキスト独立性	完全独立	独立 (別コンテキストウィンドウ)
通信	FIFO (一方向)	SendMessage (双方向, broadcast 可)
Worker 間通信	なし	peer-to-peer 可能
障害分離	Worker crash が他に影響しない	チームメイト crash の影響範囲は?
ターミナル UI	WezTerm/tmux で各 Worker を可視化	IDE 内で subagent 表示
セッション永続性	checkpoint/resume 実装済み	/resume 非対応
権限モード	permissionMode 設定可能	Delegate Mode でバグあり (#24073)

2. 共存パスの検討

Agent Teams を cekernel の一部として活用する可能性:

• 短命タスク: Agent Teams で peer-to-peer 協調 (例: コードレビュー、テスト)
• 長期タスク: cekernel Worker で独立実行 (例: issue 実装、CI 待ち)
• ハイブリッド: Orchestrator が Agent Teams と Bash 起動を使い分け

3. Agent Teams の成熟度

• 実験的機能のため API が変更される可能性
• 権限継承バグの解消状況
• セッション再開対応の見通し

判断基準

• Agent Teams が GA になり、cekernel の use case (issue 単位の独立実装 → PR → merge) に十分な機能を提供するか
• cekernel の既存資産 (worktree 分離、FIFO IPC、checkpoint/resume、multi-backend) を Agent Teams で再現できるか/する必要があるか
• 両者の共存がユーザー体験を向上させるか

参考

• Agent Teams Docs
• Subagents Docs
• Permission Bug #24073

Related: #86

[clonable-eden]

関連機能の追加: /workflows（dynamic workflows）(2026-06-07)

Agent Teams と並んで、もう一つ「Orchestrator 的なもの」が Claude Code 本体に増えました。比較の対象として記録します。

/workflows の概要

• JavaScript script で agent / parallel / pipeline / phase を deterministic に書き、Claude が orchestrate するのではなくスクリプトが orchestrate する仕組み。
• 最大 16 並行（CPU-2 程度）、1 run あたり最大 1000 agents の上限。
• 中間結果は script の変数として保持され、Claude の context window には載らない。
• Resume は同一 session 内のみ。session を終了すると state はロスト。
• 起動は ultracode キーワードを prompt に含める／/workflows で list / /effort ultracode で session 全体を workflow 駆動に。

cekernel との比較（Agent Teams の表に並べると）

軸	cekernel	Agent Teams	/workflows
プロセス分離	完全分離	同一 session	runtime 上の thunk（プロセスではない）
Worker 間通信	なし（FIFO 経由で Orchestrator 経由）	SendMessage（双方向, broadcast）	script 変数を介した値受け渡し
状態の永続化	file-based（state / checkpoint / task / FIFO）	/resume 非対応	同一 session 内 cache のみ
cross-session	◯（OS scheduler 駆動）	×	×
並列上限	CEKERNEL_MAX_ORCH_CHILDREN（数〜十数）	不明（実験的）	16 並列 / 1000 agents
主用途	長時間バッチ・PR/CI ループ	peer-to-peer 協調	同一 session 内の deterministic 大規模 fan-out

棲み分け案

• /workflows: research / review / dimension 分割 / 大規模並列分析（ephemeral, single-session）
• Agent Teams: peer-to-peer 協調が必要なリアルタイム協調作業
• cekernel: cross-session の persistent batch / git worktree / OS process / OS scheduler 駆動

アクション

「/workflows をどう取り込む（あるいは取り込まない）か」を独立した ADR として整理した方が良さそうです（新規 issue 化候補）。本 issue は引き続き Agent Teams 単体の調査として保持します。

参考

• Orchestrate subagents at scale with dynamic workflows

[clonable-eden]

状況アップデート (2026-07-11 調査)

各機能の現在のステータス

機能	ステータス	備考
Agent Teams (Claude Code CLI)	実験的機能のまま (CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS, デフォルト無効)	v2.1.178+ で TeamCreate/TeamDelete 廃止・簡略化。SendMessage による peer-to-peer メッセージング、共有タスクリスト、team lead モデル。制約: teammate の /resume 不可、1セッション1チーム、ネスト不可
Subagents (Agent tool)	GA	ネスト深度5 (v2.1.172+)。cekernel の Reviewer が使用中 (ADR-0021)
Claude Agent SDK	GA (Python/TS)	Claude Code エンジンのライブラリ版。session resume/fork あり。Agent Teams 相当の peer-to-peer メッセージングは無し
Managed Agents Multiagent	Beta (managed-agents-2026-04-01)	coordinator/roster パターン (最大20 agent、25 thread、depth 1)。サーバーホスト型 sandbox

cekernel との構造比較

軸	cekernel	Agent Teams	Agent SDK	Managed Agents
プロセス分離	OS プロセス (claude --bg)	同一マシン別セッション	in-process	サーバー sandbox
クロスセッション永続	✅ state file + checkpoint/resume	❌ resume 不可	✅ session resume	✅ session 永続
エージェント間通信	state file (Worker→Orchestrator)	SendMessage (p2p)	戻り値のみ	coordinator 経由
git 分離	worktree per Worker	共有 FS	cwd 継承	共有 sandbox

結論

cekernel の差別化要素（クロスセッション永続化・OS プロセス分離・worktree per Worker・ファイルベース IPC・OS スケジューラ統合）はどの機能でも代替されない。移行の必要なし。

アクションアイテム

1. 即時対応不要 — 現アーキテクチャを維持
2. Agent SDK は将来の spawn 機構候補 — claude-bg.sh (ADR-0018) の置き換えになりうるが、SDK セッションが親プロセスを超えて生存できるかの feasibility check が前提
3. Managed Agents はクラウド展開時の選択肢 — ローカルマシン不要のモードが必要になった場合の長期検討事項
4. Agent Teams は採用時期尚早 — 実験的ステータス・resume 不可・1セッション1チーム制約がバッチ/CI ユースケースに不適合。GA 昇格をモニタリング

本 issue は引き続き open で維持し、各機能の GA 化・仕様変更時に再評価する。