gitagent

your repository becomes your agent

フレームワーク非依存の git-native AI エージェント定義標準。リポジトリをクローンするだけでエージェントが手に入る。Claude Code, OpenAI, LangChain, CrewAI, AutoGen など任意のランタイムへエクスポートできる。

4 つの特徴

Git-native

バージョン管理が組み込み済み

git commit でプロンプト変更を追跡。git diff でエージェントの変化を確認。ブランチで並行開発、タグでリリース管理。

Framework-agnostic

どのフレームワークにも対応

アダプターで Claude Code / OpenAI / CrewAI / Cursor など 12 以上の形式にエクスポート。同一の定義を複数ランタイムで使い回せる。

Compliance-ready

金融規制に対応済み

FINRA・Federal Reserve・SEC の主要ルールを agent.yaml で宣言。職務分離（SOD）・監査ログ・キルスイッチを標準サポート。

Composable

エージェントを組み合わせる

extends で親エージェントを継承。dependencies で外部エージェントを取り込む。agents/ サブディレクトリで階層構造を定義。

リポジトリ = エージェント定義

2 つのファイルだけが必須。残りはすべてオプション。必要なものだけ追加していける。

my-agent/

# Core Identity (required)

├── agent.yaml # マニフェスト — 名前, バージョン, モデル, スキル, ツール, コンプライアンス

├── SOUL.md # アイデンティティ, ペルソナ, コミュニケーションスタイル, 価値観

# Behavior & Rules

├── RULES.md # ハード制約, must-always / must-never, 安全境界

├── DUTIES.md # 職務分離ポリシーとロール境界

├── AGENTS.md # フレームワーク非依存のフォールバック指示

# Capabilities

├── skills/ # 再利用可能な能力モジュール (SKILL.md + スクリプト)

├── tools/ # MCP 互換ツール定義 (YAML スキーマ)

├── workflows/ # マルチステップ手順 / プレイブック

# Knowledge & Memory

├── knowledge/ # エージェントが参照できる参考ドキュメント

├── memory/runtime/ # セッション横断の永続メモリ (dailylog.md, context.md)

# Lifecycle & Composition

├── hooks/ # ライフサイクルハンドラ (bootstrap.md, teardown.md)

├── compliance/ # 規制コンプライアンス成果物

└── agents/ # サブエージェント定義 (再帰構造)

必須は 2 ファイルだけ: agent.yaml（マニフェスト）と SOUL.md（アイデンティティ）。残りはすべてオプションで、必要に応じて追加する。

git-native エージェントが生み出すアーキテクチャパターン

01Human-in-the-Loop

RL エージェントが新スキルを学習 / メモリ書き込みの際、ブランチ + PR を開いて人間レビュー後にマージ。

02職務分離 (SOD)

maker / checker / executor / auditor ロールと競合マトリクスを DUTIES.md で定義。validate --compliance で違反を事前検出。

03Live Agent Memory

memory/runtime/ に dailylog.md・key-decisions.md・context.md を書き込み、セッション間でステートを維持。

04Agent Versioning

エージェントの変更はすべて git commit。壊れたプロンプトのロールバックや、過去バージョンの探索が可能。

05Shared Context

モノレポのルートに置いた context.md / skills/ / tools/ を全エージェントへ自動共有。重複なし、単一情報源。

06Branch Deployment

dev → staging → main のブランチでエージェント変更を環境昇格。ソフトウェアリリースと同じ感覚で管理。

07Knowledge Tree

knowledge/ にエンティティ関係を階層ツリー + エンベディングで格納。エージェントが実行時に構造化データを推論。

08Agent Forking

公開リポジトリをフォークして SOUL.md をカスタマイズ。改善を PR でアップストリームへ貢献できる OSS コラボ。

09CI/CD for Agents

push ごとに gitagent validate を GitHub Actions で実行。CI でエージェント品質をテストし、不正なマージをブロック。

10Agent Diff & Audit

git diff でバージョン間の変更を確認。git blame で全行の作者と日時を追跡。完全な監査証跡。

11Tagged Releases

安定バージョンを v1.1.0 タグで管理。本番はタグ固定、canary はステージングで検証。問題は即ロールバック。

12SkillsFlow

workflows/ の YAML で決定論的なパイプラインを定義。skill / agent / tool ステップを depends_on で順序付け。

5 ステップで始める

1

インストール

npm install -g gitagent

2

新規エージェント作成

gitagent init --template standard

3

バリデーション

gitagent validate

4

エージェント情報を確認

gitagent info

5

システムプロンプトへエクスポート

gitagent export --format system-prompt

agent.yaml — 最小構成

spec_version: "0.1.0"
name: my-agent
version: 0.1.0
description: A helpful assistant agent

agent.yaml — コンプライアンス設定例（金融機関向け）

spec_version: "0.1.0"
name: compliance-analyst
version: 1.0.0
model:
  preferred: claude-opus-4-6
compliance:
  risk_tier: high
  frameworks: [finra, federal_reserve, sec]
  supervision:
    human_in_the_loop: always
    kill_switch: true
  recordkeeping:
    audit_logging: true
    retention_period: 7y
    immutable: true
  segregation_of_duties:
    roles:
      - id: analyst
        permissions: [create, submit]
      - id: reviewer
        permissions: [review, approve, reject]
    conflicts:
      - [analyst, reviewer]
    enforcement: strict

主要コマンド一覧

コマンド	説明
`gitagent init [--template]`	新規エージェントを雛形から作成 (`minimal` / `standard` / `full`)
`gitagent validate [--compliance]`	仕様と規制要件に対してバリデーション
`gitagent info`	エージェントのサマリーを表示
`gitagent export --format <fmt>`	他フォーマットへエクスポート（アダプター経由）
`gitagent import --from <fmt> <path>`	claude / cursor / crewai / opencode からインポート
`gitagent run <source> --adapter <a>`	git リポジトリまたはローカルディレクトリからエージェントを実行
`gitagent install`	git ベースの依存エージェントを解決・インストール
`gitagent audit`	コンプライアンス監査レポートを生成
`gitagent skills <cmd>`	スキル管理 (`search` / `install` / `list` / `info`)

金融規制への対応

FINRA

Rule 3110 — 監督: human-in-the-loop, エスカレーション, キルスイッチ
Rule 4511 — 記録保持: 不変監査ログ, 保持期間, SEC 17a-4 準拠
Rule 2210 — コミュニケーション: 公正・均衡な強制
Reg Notice 24-09 — GenAI/LLM への既存ルール適用

Federal Reserve

SR 11-7 — モデルリスク管理: バリデーション頻度, 継続的モニタリング
SR 23-4 — サードパーティリスク: ベンダーデューデリジェンス, SOC レポート

SEC / CFPB

Reg S-P — 顧客プライバシー, PII 取扱い
CFPB 2022-03 — 説明可能な不利益処分, 差別影響の低減

職務分離 (SOD) の仕組み

4 ロール (maker / checker / executor / auditor) を定義し、同一エージェントが複数ロールを担えない競合マトリクスを宣言。重要なアクション（信用決定、規制申告等）は複数エージェントの参加を必須化。

compliance:
  segregation_of_duties:
    roles:
      - id: maker
        permissions: [create, submit]
      - id: checker
        permissions: [review, approve, reject]
    conflicts:
      - [maker, checker]          # maker は自分の作業を承認できない
    handoffs:
      - action: credit_decision
        required_roles: [maker, checker]
        approval_required: true
    enforcement: strict           # 違反はデプロイをブロック

対応エクスポート形式

gitagent export / gitagent run で利用できるアダプター。同一定義を任意のランタイムで動かせる。

アダプター	説明
`system-prompt`	連結システムプロンプト（任意の LLM で動作）
`claude-code`	Claude Code 互換の CLAUDE.md
`openai`	OpenAI Agents SDK Python コード
`crewai`	CrewAI YAML 設定
`cursor`	Cursor `.cursor/rules/*.mdc` ファイル
`github`	GitHub Actions エージェント
`gemini`	Google Gemini CLI (GEMINI.md + settings.json)
`lyzr`	Lyzr Studio エージェント
`opencode`	OpenCode 指示 + 設定

継承 & コンポジション

# 親エージェントを継承
extends: https://github.com/org/base-agent.git

# 依存エージェントを追加
dependencies:
  - name: fact-checker
    source: https://github.com/org/fact-checker.git
    version: ^1.0.0
    mount: agents/fact-checker

公式・関連

GitHub: open-gitagent/gitagent — 本体リポジトリ（TypeScript）
npm: @shreyaskapale/gitagent — パッケージ
仕様書 (SPECIFICATION.md) — フルスペック・JSON スキーマ
NVIDIA AIQ Deep Researcher — gitagent 移植サンプル（3 エージェント階層）
FINOS AI Governance Framework — コンプライアンス設計の参照元
Salient AI — SOD パターンのインスピレーション元