---
title: Agent Trace 調査レポート
tool_name: Agent Trace
tool_reading: エージェントトレース
category: オブザーバビリティ/APM
developer: オープンコミュニティ (Cursor主導)
official_site: https://agent-trace.dev/
date: '2026-03-10'
last_updated: '2026-06-25'
tags:
  - AI
  - エージェント
  - オープンソース
  - コーディング支援
  - 開発者ツール
description: AIが生成したコードと人間が作成したコードを区別・追跡するためのベンダーニュートラルなオープン仕様。
quick_summary:
  has_free_plan: true
  is_oss: true
  starting_price: 無料
  target_users:
    - 開発者
    - AIツール開発者
  latest_highlight: 2026年2月にスキーマのバージョン指定形式（semver）など仕様のアップデートを実施
  update_frequency: 不定期
evaluation:
  score: 85
  base_score: 70
  plus_points:
    - point: 5
      reason: 多数のAIコーディングツールやプラットフォームの賛同と連携
    - point: 5
      reason: ベンダーニュートラルで拡張可能なオープンな仕様
    - point: 5
      reason: 既存のVCSと連動する実用的なリファレンス実装の提供
  minus_points: []
  summary: AIコーディング時代のコードの来歴管理を解決する強力なオープン標準。
links:
  github: https://github.com/cursor/agent-trace
  deepwiki: https://deepwiki.com/cursor/agent-trace
relationships:
  related_tools:
    - Cursor
    - Cline
    - OpenCode
---

# **Agent Trace 調査レポート**

## **1. 基本情報**

* **ツール名**: Agent Trace
* **ツールの読み方**: エージェントトレース
* **開発元**: オープンコミュニティ (Cursor主導。パートナーとしてAmp, Amplitude, Cline, Cloudflare, Cognition, git-ai, Jules, OpenCode, Tapes, Vercelが参加)
* **公式サイト**: [https://agent-trace.dev/](https://agent-trace.dev/)
* **関連リンク**:
  * GitHub: [https://github.com/cursor/agent-trace](https://github.com/cursor/agent-trace)
  * DeepWiki: [https://deepwiki.com/cursor/agent-trace](https://deepwiki.com/cursor/agent-trace)
* **カテゴリ**: AI開発ライブラリ
* **概要**: AIエージェントやAIコーディングツールが生成したコードと、人間が記述したコードをバージョン管理されたコードベース上で区別し、追跡するためのベンダーニュートラルなオープン仕様。AIの貢献を記録する標準フォーマットを提供している。

## **2. 目的と主な利用シーン**

* **解決する課題**:
  * AIエージェントがコードを記述する機会が増える中、どのコードがAIによって生成され、どのモデルが使用され、どのような会話コンテキストから生まれたのかを特定することが困難になる課題。
* **想定利用者**:
  * AIコーディング支援ツール（IDE、エディタ、自律型エージェント）の開発者。
  * チーム内のコードの来歴や貢献を把握したいエンジニアリングマネージャーや開発チーム。
* **利用シーン**:
  * AIが生成したコードのトラブルシューティング時に、元のプロンプトや使用されたAIモデルの情報を振り返る。
  * リポジトリ内でのAIと人間の貢献比率を測定する。
  * ベンダーロックインを避けて、複数のAIツールを跨いだトレース情報を一元管理する。

## **3. 主要機能**

* **Trace Record Schema (トレースレコードのスキーマ化)**: ファイル・行単位でコードの貢献元（人間、AI、混合、不明）や使用モデルをJSON Schemaで構造化して記録する。
* **Model Identifierの標準化**: `models.dev`の規約（例: `anthropic/claude-opus-4-5-20251101`）に従い、プロバイダーとモデル名を一意に記録する。
* **Content Hashesによる行追跡**: 変更されたコードのコンテンツハッシュを記録することで、コードがファイル内で移動したりリファクタリングされた場合でも、位置に依存せずに追跡を維持する。
* **VCS (バージョン管理システム) サポート**: Gitだけでなく、Jujutsu (jj)、Mercurial (hg)、Subversion (svn) など複数のVCSでのリビジョン追跡をサポートする。
* **Extensibility (拡張性)**: 各ベンダーが標準仕様を壊すことなく、独自の実装やメタデータを追加できる拡張フィールド（`metadata`）を提供する。

## **4. 開始手順・セットアップ**

* **前提条件**:
  * Trace Recordを読み書きするためのクライアントやAIツール。
  * Node.js/TypeScriptなどの実行環境（リファレンス実装を使用する場合）。
* **インストール/導入**:
  Agent Traceは仕様であるため、直接のインストールコマンドはない。AIツールの開発者は提供されているリファレンス実装を参考に組み込むことができる。

  ```bash
  # GitHubからリファレンス実装を取得する場合
  git clone https://github.com/cursor/agent-trace.git
  ```

* **初期設定**:
  * AIコーディングツール側でファイルの変更を検知した際に、トレースデータを生成・保存するフックを実装する（例: `trace-hook.ts`）。
* **クイックスタート**:
  * `reference/trace-store.ts`などを活用して、ファイル変更時の`Trace Record`をJSONで出力・保存する処理を組み込む。

## **5. 特徴・強み (Pros)**

* **Interoperability (相互運用性)**: 準拠するツールであれば、異なるベンダー間でも同じフォーマットでトレース情報の読み書きが可能な相互運用性を持つ。
* **Granularity (きめ細かな粒度)**: ファイルレベルだけでなく、特定の行（Range）や特定の会話（Conversation）レベルでAIモデルの貢献を正確に追跡できる。
* **Human & Agent Readable**: 特別なツールがなくても人間とAIの双方が容易に理解できるJSON形式を採用している。

## **6. 弱み・注意点 (Cons)**

* **Non-Goalsの明確な範囲制限**:
  * コードの法的要件や著作権、学習データの出所（Provenance）を保証するものではない。
  * AIが生成したコードの品質を評価する機能は含まれていない。
* **普及への移行段階**: 現在はVersion 0.1.0 (RFC) の段階であり、ツールごとの実装状況によってエコシステム全体の完全な相互運用には時間がかかる可能性がある。
* **日本語対応**: 仕様の公式ドキュメント（agent-trace.dev）は英語での提供となっているが、仕様自体はデータフォーマットのため言語に依存しない。

## **7. 料金プラン**

| プラン名 | 料金 | 主な特徴 |
|---------|------|---------|
| **オープンソース (CC BY 4.0)** | 無料 | 制限なく利用・実装可能なオープン仕様 |

* **課金体系**: なし (オープンソース・オープン仕様のため)
* **無料トライアル**: なし

## **8. 導入実績・事例**

* **導入企業**: オープン仕様へのパートナーおよび賛同として、主要なAI企業やツール開発企業が参加している。
  * Amp
  * Amplitude
  * Cline
  * Cloudflare
  * Cognition (Devin開発元)
  * git-ai
  * Jules
  * OpenCode
  * Tapes
  * Vercel
* **導入事例**: 具体的なプロダクトへの組み込み事例として、CursorやCline等のAIコーディングツールでの活用が進んでいる。
* **対象業界**: ソフトウェア開発全般、AIプラットフォーム開発

## **9. サポート体制**

* **ドキュメント**: [agent-trace.dev](https://agent-trace.dev/) にて仕様の詳細、スキーマの定義、統合のガイドラインが提供されている。
* **コミュニティ**: GitHubのIssuesやPull Requestsを通じてコミュニティからのフィードバック（RFC）を受け付けている。
* **公式サポート**: オープン仕様のため、特定の公式サポート窓口はなく、コミュニティベースでのサポートとなる。

## **10. エコシステムと連携**

### **10.1 API・外部サービス連携**

* **API**: プロトコルおよびデータフォーマットの仕様として機能。REST APIなどのエンドポイント自体は提供されないが、生成されたJSON（`application/vnd.agent-trace.record+json`）を通じてツール間の連携を実現する。
* **外部サービス連携**: Cursor、Cline、Jules、OpenHandsなどのAIコーディング支援ツール・エディタでの生成履歴をバージョン管理ツール（Git, jj, hgなど）と連動して管理する。

### **10.2 技術スタックとの相性**

| 技術スタック | 相性 | メリット・推奨理由 | 懸念点・注意点 |
|:---|:---:|:---|:---|
| **TypeScript/Node.js** | ◎ | 公式の参照実装（Reference Implementation）が提供されている | 特になし |
| **Git/GitHub** | ◎ | コミットSHAをリビジョンとして直接追跡するスキーマに対応 | 既存のgit blameとの統合UIの開発は各ツール側に依存する |
| **その他のVCS (jj, hg)** | ◯ | 仕様として組み込まれている | ツールの対応状況に依存 |

## **11. セキュリティとコンプライアンス**

* **認証**: 仕様のため、仕様自体に認証機構はない。
* **データ管理**: トレースデータの保存方法（ローカルファイル、Git notes、データベース等）は意図的に実装側に委ねられている（Storage mechanism implementation-defined）。
* **準拠規格**: 仕様ドキュメントは Creative Commons Attribution 4.0 International (CC BY 4.0) ライセンスの下で公開されている。法的・著作権管理の目的（Code Ownershipの追跡）としては設計されていないため、組織のコンプライアンス要件に合わせた運用・保管の仕組み作りが必要。

## **12. 操作性 (UI/UX) と学習コスト**

* **UI/UX**: 仕様は「UI Agnostic（UIに依存しない）」として設計されている。実際のUXは、仕様を実装したIDEやエディタのインターフェースに依存する。
* **学習コスト**: ツールの開発者が仕様を理解し実装するためのコストは、提供されているJSON Schemaとリファレンス実装により低く抑えられている。エンドユーザーの学習コストは、導入されたツールのUI設計に依存する。

## **13. ベストプラクティス**

* **効果的な活用法 (Modern Practices)**:
  * **コード移動の追跡**: 単純な行番号ではなく、仕様で提供されている `content_hash` フィールドを活用し、リファクタリングやファイル間でのコード移動があってもAIの貢献履歴を追跡し続けられるようにする。
  * **エージェント間のハンドオフ**: `ranges`配列内の特定の範囲に対して、オーバーライドする形で`contributor`を指定し、人間とAI、またはAI同士が協力して生成したコードの粒度を正確に記録する。
* **陥りやすい罠 (Antipatterns)**:
  * **現在の行番号の直接参照**: Trace Record内の行番号は「記録されたリビジョン（コミット等）」時点のものであるため、現在ファイルの行番号と直接比較しない。常にVCSのblame機能を使ってリビジョンを特定してからTrace情報を検索する必要がある。

## **14. ユーザーの声（レビュー分析）**

* **調査対象**: GitHub Repository, 賛同パートナーの発表, 開発コミュニティ (X等のSNS)
* **総合評価**: (オープン仕様のためレビューサイトのスコアはなし)
* **ポジティブな評価**:
  * 「複数のAIエージェントが連携する未来において、どのAIがどのコードを書いたかを標準フォーマットで追跡できるのは極めて重要。」
  * 「Cursorだけでなく、CognitionやVercelなど多くのプレイヤーが早期に賛同している点が標準化の強力な後押しになっている。」
  * 「Our team would really like to be part of this spec creation! Happy to help in any way possible」（GitHub Issuesより引用）と、仕様策定へのチーム参加意欲を示す好意的な声がある。
* **ネガティブな評価 / 改善要望**:
  * 「Git rebaseやMerge commitが発生した際に、どのようにトレース情報を維持・統合するかのベストプラクティスがさらに必要。」
  * 「仕様が定義されたばかりであり、実際のIDE上でのGit BlameのようなシームレスなUI表示が普及するまでは真価を発揮しにくい。」
  * 「The schema captures who contributed, but not how the contribution occurred.」（GitHub Issuesより引用）として、chat editやinline editなどの操作（Modality）を区別できる機能拡張の要望が挙げられている。
* **特徴的なユースケース**:
  * スクリプトを通じてAIがコードを生成した場合でも、実行前後のスナップショットとGit Diffを用いてAIの貢献を計算し、Agent Traceフォーマットとして記録するアプローチ。

## **15. 直近半年のアップデート情報**

* **2026-02-06**: スキーマのバージョン指定形式（semver）など仕様のアップデートおよびドキュメントの改善を実施。
* **2026-01**: Agent Trace Version 0.1.0 が Request for Comments (RFC) として公開される。

(出典: [公式サイト](https://agent-trace.dev/), [GitHub](https://github.com/cursor/agent-trace/commits/main))

## **16. 類似ツールとの比較**

### **16.1 機能比較表 (星取表)**

| 機能カテゴリ | 機能項目 | Agent Trace | Model Context Protocol (MCP) | git blame (標準VCS) | Cursor | Cline |
|:---:|:---|:---:|:---:|:---:|:---:|:---:|
| **基本機能** | トレース標準化 | ◎<br><small>コード生成元の特定</small> | ◯<br><small>ツール連携の標準化</small> | ◯<br><small>コミット単位の履歴</small> | - | - |
| **カテゴリ特定** | AIモデル/会話連携 | ◎<br><small>モデル名やプロンプトのURLを記録</small> | ×<br><small>コンテキスト提供に特化</small> | ×<br><small>コミッターのみ記録</small> | - | - |
| **エンタープライズ** | データ拡張性 | ◎<br><small>カスタムメタデータに対応</small> | ◎<br><small>多様なツール連携</small> | △<br><small>コミットメッセージへの依存</small> | - | - |
| **非機能要件** | ベンダー非依存 | ◎<br><small>幅広いエコシステムの賛同</small> | ◎<br><small>オープン標準プロトコル</small> | ◎<br><small>普遍的なVCSの標準</small> | - | - |

### **16.2 詳細比較**

| ツール名 | 特徴 | 強み | 弱み | 選択肢となるケース |
|---------|------|------|------|------------------|
| **Agent Trace** | AI生成コードの来歴をファイル/行単位で記録するオープン仕様。 | AIモデル名やチャットログとの紐づけに特化。ハッシュによる移動追跡機能。 | 法的権利・品質評価機能は持たない。 | 開発組織として「AIがどこまでコードを書いたか」を分析・追跡したい場合。 |
| **Model Context Protocol (MCP)** | AIモデルと外部ツール・データソースを繋ぐためのAnthropic主導の標準プロトコル。 | 任意のデータソースやツールをAIに安全に公開・連携できる。 | コード生成の「結果」を追跡・記録するものではない。 | AIに社内DBや外部ツールの実行権限を付与し、コンテキストを提供したい場合。 |
| **git blame** | Git標準の行単位の変更履歴追跡機能。 | 追加ツール不要で、全てのGitリポジトリで即座に利用可能。 | AIによる生成か人間による記述かの区別ができない。 | 従来通り、コミッターベースで変更の責任者や意図（コミットログ）を確認したい場合。 |
| **Cursor** | VS CodeベースのAIネイティブエディタ。 | 深い文脈理解、Composerによる強力な編集機能、既存VS Code環境との互換性。 | ベースのVS Code更新に追従するラグがある。独自の拡張機能ストアはない（VS Code用を使う）。 | コードベース全体にまたがる複雑なタスクをAIに任せたい場合。 |
| **Cline** | IDE/CLIで動作する協調型AIエージェント。BYOKモデル。 | オープンソース、高いセキュリティ、最新モデル(GPT-5.5, Claude Fable 5等)への即時対応。 | 学習コストが高く、API料金が変動する。 | セキュリティ要件が厳しい、または特定のLLMに縛られたくない場合。 |

## **17. 総評**

* **総合的な評価**:
  Agent Traceは、AI支援開発が標準となる「AIネイティブ」な開発フローにおいて、避けては通れない「誰が（どのAIモデルが）このコードを書いたのか」という課題を解決する極めて重要な取り組みである。Cursor主導でありながら、Cognition (Devin) やVercel、Amplitudeなど多数の有力プレイヤーが賛同・協力しており、デファクトスタンダードとして定着する可能性が高い。
* **推奨されるチームやプロジェクト**:
  * 複数のAIツール（例: CursorとCline、または自律型エージェント）を組み合わせて開発を行っているチーム。
  * 将来的なAIのROI測定や、コード品質の監査・分析を見据えている先進的な開発組織。
* **選択時のポイント**:
  Agent Trace自体は単体のツールではなく「仕様」であるため、利用するエディタやAIエージェントがこのフォーマットをサポートしているか、またチームでどうデータを蓄積・活用するか（例: Git notesに保存する、専用DBに保存するなど）の運用方針を検討した上で採用する必要がある。