ce-agent-native-architecture

## エージェントネイティブアーキテクチャ

エージェントネイティブアプリケーションでは、エージェントを第一級の構成要素として扱います。機能とはコードで記述された関数ではなく、ツールを使ってループ内で動作するエージェントが実現する成果です。Claude Code を支えるアーキテクチャは、コーディング以外の幅広いアプリケーションにも活用できます。

5 つの基本原則：

1. 同等性 — ユーザーが UI から実行できることは、エージェントもツールを使って実現できます。
2. 粒度 — ツールは原子的なプリミティブであり、機能はプロンプトで定義される成果です。動作を変えるには、コードではなく文章を編集します。
3. 組み合わせ可能性 — 新機能は新しいコードではなく、新しいプロンプトによって実現します。原子的なツールと同等性によって、これが可能になります。
4. 創発的な能力 — エージェントは、明示的に設計していないことも実現します。自由度の高いリクエストから、潜在的な需要が明らかになります。
5. 時間とともに向上 — アプリは、蓄積されたコンテキスト（たとえば context.md ファイル）やプロンプトの改善によって、コードをリリースすることなく、より良くなります。

これらの原則がアーキテクチャパターンにどう反映されるか詳しく知るには、references/architecture-patterns.md をお読みください。

## エージェントネイティブアーキテクチャのどの側面についてサポートが必要ですか？

1. アーキテクチャの設計 - 新しいエージェントネイティブシステムをゼロから設計する
2. ファイルとワークスペース - 普遍的なインターフェースとしてのファイル、共有ワークスペースのパターン
3. ツールの設計 - プリミティブなツール、動的な機能の検出、CRUD の完全性
4. ドメインツール - ドメインツールを追加するタイミングとプリミティブにとどめる判断
5. 実行パターン - 完了シグナル、部分的な完了、コンテキストの上限
6. システムプロンプト - エージェントの動作、判断基準の定義
7. コンテキストの注入 - 実行時のアプリ状態をエージェントのプロンプトに注入する
8. アクションの同等性 - エージェントがユーザーと同じことをすべて実行できるようにする
9. 自己変更 - エージェントが安全に自身を進化させられるようにする
10. プロダクト設計 - 段階的な情報開示、潜在的な需要、承認パターン
11. モバイルのパターン - iOS のストレージ、バックグラウンド実行、チェックポイントと再開
12. テスト - エージェントネイティブアプリの能力と同等性をテストする
13. リファクタリング - 既存のコードをよりエージェントネイティブにする
14. レビュー／チェックリスト - アーキテクチャのチェックリスト、アンチパターン、成功基準

番号を選ぶか、希望する内容を説明してください。先へ進む前に、応答をお待ちください。

| 応答 | 参照先 | |----------|------| | 1, "design", "architecture", "plan" | `references/architecture-patterns.md` を読み、続いて `references/checklists.md` のチェックリストを適用します | | 2, "files", "workspace", "filesystem" | `references/files-universal-interface.md` と `references/shared-workspace-architecture.md` | | 3, "tool", "mcp", "primitive", "crud" | `references/mcp-tool-design.md` | | 4, "domain tool", "when to add" | `references/from-primitives-to-domain-tools.md` | | 5, "execution", "completion", "loop" | `references/agent-execution-patterns.md` | | 6, "prompt", "system prompt", "behavior" | `references/system-prompt-design.md` | | 7, "context", "inject", "runtime", "dynamic" | `references/dynamic-context-injection.md` | | 8, "parity", "ui action", "capability map" | `references/action-parity-discipline.md` | | 9, "self-modify", "evolve", "git" | `references/self-modification.md` | | 10, "product", "progressive", "approval", "latent demand" | `references/product-implications.md` | | 11, "mobile", "ios", "android", "background", "checkpoint" | `references/mobile-patterns.md` | | 12, "test", "testing", "verify", "validate" | `references/agent-native-testing.md` | | 13, "refactor", "existing", "migrate" | `references/refactoring-to-prompt-native.md` | | 14, "review", "audit", "anti-pattern", "checklist", "success criteria" | `references/checklists.md` |

参照資料を読んだ後、そのパターンをユーザー固有のコンテキストに適用します。

<reference_index>

参照ファイル

コアパターン：

• references/architecture-patterns.md — イベント駆動型、統合オーケストレーター、エージェントから UI への連携；5 つの原則を網羅
• references/files-universal-interface.md — ファイルを使う理由、整理方法、context.md
• references/mcp-tool-design.md — ツール設計、動的な機能検出、CRUD
• references/from-primitives-to-domain-tools.md — プリミティブをドメインツールへ発展させるタイミング
• references/agent-execution-patterns.md — 完了シグナル、一部完了、コンテキスト制限
• references/system-prompt-design.md — プロンプトとしての機能、判断基準

各分野：

• references/dynamic-context-injection.md — 実行時のコンテキスト注入
• references/action-parity-discipline.md — 機能のマッピング、同等性を確保するワークフロー
• references/shared-workspace-architecture.md — 共有データ領域、UI 統合
• references/product-implications.md — 段階的な情報開示、潜在的な需要、承認
• references/agent-native-testing.md — 結果のテスト、同等性テスト
• references/checklists.md — アーキテクチャのチェックリスト、アンチパターン、成功基準

プラットフォーム固有：

• references/mobile-patterns.md — iOS のストレージ、チェックポイントと再開、コストへの配慮
• references/self-modification.md — Git に基づく進化、ガードレール
• references/refactoring-to-prompt-native.md — 既存コードの移行