GitAgentの紹介：LangChain、AutoGen、Claude Code間の断片化を解決する「AIエージェントのDocker」

現在のAIエージェント開発は、アーキテクチャの著しい断片化が特徴です。自律システムを構築するソフトウェア開発者は、一般的に、競合するいくつかのエコシステムのいずれかを選択する必要があります。具体的には、LangChain、AutoGen、CrewAI、OpenAI Assistants、あるいはより最近のClaude Codeです。これら「5つのフレームワーク」はそれぞれ、エージェントのロジック、メモリの永続化、ツール実行を定義する独自の方法を採用しています。共通標準の欠如は、高い移行コストと技術的負債を生み出します。なぜなら、エージェントをあるフレームワークから別のフレームワークへ移行するには、コアとなるコードベースをほぼ完全に書き直す必要があるからです。

GitAgentは、オープンソースの仕様およびCLIツールであり、エージェントの定義をその実行環境から切り離すように設計された、フレームワークに依存しないフォーマットを導入します。エージェントをGitリポジトリ内の構造化されたディレクトリとして扱うことで、GitAgentは開発者がエージェントを一度定義し、主要なオーケストレーションレイヤーのいずれにもエクスポートできる「ユニバーサルフォーマット」の提供を目指しています。

GitAgentのコンポーネントベースアーキテクチャ

AI開発者にとって、GitAgentは焦点を、フレームワーク固有のボイラープレートコードの記述から、モジュラーコンポーネントの定義へと移行させます。GitAgentは、その動作と状態を制御するいくつかの主要ファイルを含む、特定のフォルダ構造によって定義されます。

agent.yaml：中心的なマニフェストファイルです。モデルプロバイダー、バージョン情報、環境依存関係を含む、エージェントのメタデータが記述されます。

SOUL.md：エージェントの中核的なアイデンティティ、性格、口調を定義するMarkdownファイルです。従来の実装ではさまざまなPythonファイルに散在しがちだった、非構造化な「システムプロンプト」に代わるものです。

DUTIES.md：このファイルは、エージェントの具体的な責任と職務分掌（SOD）を概説します。エージェントが何を実行することが許可されているか、そして重要なことに、何が制限されているかを定義します。

skills/ および tools/：これらのディレクトリは、機能的な能力を格納します。「スキル」は高レベルの行動パターンを指し、「ツール」はエージェントが外部システムと対話するために呼び出すことができる個別のPython関数やAPI定義です。

rules/：ガードレールのための専用スペースです。これにより、エンジニアは安全性や組織的な制約をエージェントの定義に直接組み込むことができ、どのフレームワークをデプロイに使用してもそれらが維持されることを保証します。

memory/：揮発性メモリや分かりにくいデータベースに履歴を保存する従来のエージェントとは異なり、GitAgentは状態をdailylog.mdやcontext.mdなどの人間が読めるファイルに保存します。

監視とバージョン管理レイヤー

自律エージェントをデプロイする際の主要な技術的課題の一つは、エージェントの動作が時間とともにどのように進化するかについての透明性の欠如です。GitAgentは、Gitを主要な監視レイヤーとして利用することでこの課題に対処します。

標準的なGitAgentのワークフローでは、エージェントの「内部状態」への更新（メモリの変更や新しいスキルの習得など）はすべて、コード変更として扱われます。エージェントが新しい学習に基づいてcontext.mdを更新したりSOUL.mdを修正したりすると、システムは新しいGitブランチとプルリクエスト（PR）を作成するように設定できます。

これにより、ソフトウェア開発者は確立されたCI/CDプラクティスをAIの動作に適用できます。人間のレビュアーは、エージェントのメモリや性格の変更差分を検査し、エージェントが当初の意図に沿っていることを確認できます。エージェントが幻覚的な挙動を示し始めたり、そのペルソナから逸脱したりした場合、開発者は単にgit revertを実行して以前の安定した状態に戻すことができます。これにより、エージェントメモリの「ブラックボックス」が、バージョン管理され監査可能な資産へと変わります。

フレームワーク相互運用性と「エクスポート」ワークフロー

GitAgentの中核的な有用性は、そのCLI駆動のエクスポートメカニズムにあります。エージェントがユニバーサルフォーマットで定義されると、「5つのフレームワーク」の専門的な環境へ移植することが可能です。

OpenAI：エージェントをAssistants APIに必要なスキーマに標準化します。

Claude Code：Anthropicのターミナルベースのエージェント環境で使用できるように定義を適合させます。

LangChain/LangGraph：エージェントのロジックをグラフベースのノードとエッジにマッピングし、複雑で状態を持つRAGワークフローを実現します。

CrewAI：エージェントを、マルチエージェント「クルー」内で協働可能な役割分担エンティティにフォーマットします。

AutoGen：定義を、非同期のマルチエージェント対話が可能な会話エージェントに変換します。

gitagent export -f [framework_name]コマンドを使用することで、ソフトウェア開発者は、SOUL.mdやskills/ディレクトリに保存された基盤ロジックを変更することなく、実行エンジンを切り替えることができます。このモジュール性はベンダーロックインを防ぎ、チームが特定のタスクに最適なオーケストレーションレイヤーを選択できるようにします。

企業コンプライアンスと職務分掌（SOD）

規制対象セクターの開発者やAI研究者にとって、GitAgentはFINRA、SEC、連邦準備制度理事会の規制などのコンプライアンス基準に対する組み込みサポートを提供します。これは、リポジトリ内で定義された職務分掌（SOD）フレームワークを通じて実現されます。

複雑な金融または法務ワークフローでは、プロセスを開始する個人（またはエージェント）と、それを承認する者が同一であってはならないという規制要件がしばしば存在します。GitAgentでは、開発者が特定のエージェントにメーカー、チェッカー、エグゼキューターなどの役割を割り当てるコンフリクトマトリックスを定義できます。デプロイ前に、gitagent validateコマンドがこれらのルールに対して構成をチェックし、単一のエージェントがコンプライアンスプロトコルに違反する過度の権限を持たないことを保証します。

重要なポイント

フレームワークに依存しない移植性：GitAgentはエージェントロジックを実行環境から切り離します。gitagent exportコマンドを使用すれば、エージェントを一度定義するだけで、コアロジックを書き直すことなくClaude Code、OpenAI、LangChain、CrewAI、AutoGenのいずれにもデプロイできます。

Gitネイティブな監視（HITL）：カスタムの承認ダッシュボードを標準的なプルリクエスト（PR）に置き換えます。エージェントがメモリを更新したり新しいスキルを習得したりすると、ブランチとPRが作成され、人間が標準的なコードと同様にAIの動作変更をレビュー、差分確認、承認できるようになります。

人間が読める状態管理：不透明なベクターデータベースとは異なり、GitAgentは長期的なメモリをmemory/ディレクトリ内のMarkdownファイル（context.md、dailylog.md）として保存します。これにより、エージェントの状態は完全に検索可能、バージョン管理可能、git revertによる復元可能になります。

組み込みの企業コンプライアンス：このフォーマットには、FINRA、SEC、連邦準備制度理事会の規制に対するネイティブサポートが含まれています。DUTIES.mdを通じて、開発者は「職務分掌」（SOD）を強制し、重要なアクション（例：取引の承認）に対してマルチエージェントまたは人間による検証を要求することができます。

宣言的な「ソウル」とスキル：エージェントのアイデンティティと能力は、SOUL.md（性格/指示）やskills/（モジュラー関数）などの構造化されたファイルで定義されます。この標準化された構造により、エージェントはモジュラーなオープンソースリポジトリとしてブランチ、フォーク、共有できます。

この投稿「GitAgentの紹介：AIエージェントのための「Docker」―LangChain、AutoGen、Claude Code間の断片化を解決」は、MarkTechPostで最初に公開されました。