mybook

第13章 — フレームワーク大全: 何を選び、どう組み合わせるか

「全部自作するの?」

ユウキのハーネスは充実してきたが、メモリ管理、ガードレール、サンドボックス、観測可能性——すべて自作するのは現実的ではない。

ミサキが助け舟を出した。「2025年はハーネスフレームワーク元年。ゼロから作る必要はない。ただし、何が何をするのかを理解した上で選ばないと、逆に振り回される」

ETCLOVG 七層分類

学術論文で提唱された ETCLOVG 分類法が、ハーネスの構成要素を体系化している。

Loading diagram...
意味具体例
Executionコードを安全に実行する環境サンドボックス、MicroVM、コンテナ
ToolingAI が使えるツールと接続方法MCP、ファイルシステム、Web 検索
ContextAI に与える情報と記憶CLAUDE.md、RAG、自動メモリ
Lifecycleタスクの計画・分解・進捗管理タスクグラフ、write_todos
Observability何が起きたかを見る仕組みトレーシング、トークンコスト追跡
Verification出力の正しさを検証する仕組みテスト実行、ガードレール、LLM-as-Judge
Governance権限とポリシーの強制権限設定、フック、監査ログ

ハーネス vs フレームワーク vs SDK

Loading diagram...
種類定義
ハーネスループを所有。ツール実行の許可/拒否、予算管理、観測を行うClaude Code, Archon
フレームワークループの構成部品を提供。組み立ては開発者LangGraph, CrewAI, OpenAI Agents SDK
SDK特定サービスへの接続を提供Anthropic SDK, OpenAI SDK

主要ツール カタログ

統合ハーネス

Claude Code

全7層をカバーする統合ハーネス。CLI ネイティブ。

  • CLAUDE.md(Context)+ Hooks(Governance)+ MCP(Tooling)+ サンドボックス(Execution)
  • Dynamic Workflows で大規模オーケストレーション
  • サブエージェント、Skills、Commands による拡張

Archon

YAML でワークフローを定義するハーネスビルダー。OSS。

Loading diagram...
  • 各実行が独立した Git Worktree で動作(5つの修正を同時実行)
  • エージェント非依存(Claude Code, Codex CLI, 将来のツールにも対応)
  • Web UI でモニタリング

オーケストレーション・フレームワーク

LangGraph

有向グラフベースで最も柔軟な制御フロー。本番実績 No.1。

  • チェックポイントで状態永続化
  • interrupt_before でヒューマンインザループ
  • 本番 AI エージェントの 51% が LangGraph で稼働

CrewAI

ロールベースのチーム設計が直感的。学習曲線が最も緩やか。

  • プロトタイピングに最適
  • トークンオーバーヘッド約18%(LangGraph 比)
  • 本番は LangGraph に移行するパターンが多い

OpenAI Agents SDK

2025年に大幅リアーキテクチャ。ハーネスとコンピュートを分離。

  • 7つのサンドボックスプロバイダを標準サポート
  • 100以上のモデルに対応

ガードレール・検証

NVIDIA NeMo Guardrails

5種類のレール: Input / Dialog / Retrieval / Execution / Output

  • Colang 2.0 DSL でプログラム可能なルール定義
  • ジェイルブレイク検出、PII フィルタ、毒性検出、ハルシネーション検出

Guardrails AI

50以上の事前構築バリデータ(PII、毒性、ハルシネーション、バイアス等)

観測可能性

ツール種類特徴
LangfuseOSSエージェントの全ツール呼び出しをトレース、コスト追跡
LangSmithSaaSLangChain ネイティブ、評価パイプラインと A/B テスト
BraintrustSaaSMCP サーバーによる IDE 内トレースクエリが最も成熟

サンドボックス・実行環境

ツール隔離レベル特徴
E2BMicroVMAI エージェント特化のクラウドサンドボックス
DaytonaコンテナOpenAI / Anthropic 公式サポート
Modalコンテナサーバーレス GPU コンピュート
FirecrackerMicroVMAWS 開発、最高レベルの隔離
gVisorユーザースペースカーネルGoogle 開発

選び方ガイド

Loading diagram...

レベル別推奨スタック

Loading chart...
レベルスタックコスト感
入門Claude Code + CLAUDE.md月$20〜100
チームClaude Code + Hooks + カスタムエージェント月$100〜500
プロArchon + Claude Code + Langfuse月$500〜2000
エンタープライズLangGraph + NeMo Guardrails + E2B + LangSmith月$2000〜

Gartner の予測

INFO

「2026年末までに企業アプリケーションの 40% がタスク特化型 AI エージェントを含む。差別化はハーネス層に移行する」— Gartner

Loading diagram...

ユウキの選択

ユウキのチーム(8人のスタートアップ)が選んだスタック:

  • Claude Code — 統合ハーネスとして(CLAUDE.md + Hooks + Skills + Subagents)
  • Langfuse — 観測可能性(トークンコスト追跡、トレース)
  • Biome + Vitest — 構造的検証(PostToolUse Hook で自動実行)

「最初から全部入れる必要はない。Claude Code で始めて、必要に応じて層を追加していく。それが一番現実的だ」

次の章では、ここまで学んだすべてを統合し、実際のプロジェクトにゼロからハーネスを組む実践ガイドに入る。