ce-agent-native-architecture

<overview> ## Agent-Native Architecture

Agent-native アプリケーションは、agents を第一級の市民として扱います。機能はコードに書かれた関数ではなく、ツールを備えたエージェントがループ内で動作することで達成される成果です。Claude Code を動かしているのと同じアーキテクチャが、コーディングをはるかに超えたアプリケーションを動かすことができます。

5つのコア原則:

1. Parity — ユーザーが UI で実行できることは、すべてエージェントがツールを通じて達成できること。
2. Granularity — ツールはアトミックプリミティブであり、機能はプロンプトで定義される成果。動作を変えるには、コードではなく文章を編集する。
3. Composability — 新機能 = 新しいコードではなく新しいプロンプト。アトミックツール + Parity によってこれが可能になる。
4. Emergent Capability — エージェントは明示的に設計されていないことを達成する。オープンエンドのリクエストは潜在的なニーズを露呈する。
5. Improvement Over Time — アプリケーションはコードを配布することなく、蓄積されたコンテキスト (context.md ファイルなど) とプロンプト改良を通じて時間とともに改善される。

これらの原則がどのようにアーキテクチャパターンに変換されるかの詳細については、references/architecture-patterns.md を参照してください。 </overview>

<intake> ## agent-native アーキテクチャのどの側面でサポートが必要ですか?

1. Design architecture - 新しい agent-native システムを一からプラン
2. Files & workspace - ファイルを普遍的インターフェース、共有ワークスペースパターン
3. Tool design - プリミティブツール、動的機能検出、CRUD 完全性
4. Domain tools - ドメインツールを追加するタイミング vs プリミティブとしての継続
5. Execution patterns - 完了シグナル、部分的完了、コンテキスト制限
6. System prompts - エージェント動作の定義、判定基準
7. Context injection - ランタイムアプリケーション状態をエージェントプロンプトに注入
8. Action parity - エージェントがユーザーと同じことができることを保証
9. Self-modification - エージェントが自分たち自身を安全に進化させることを可能にする
10. Product design - 段階的開示、潜在的ニーズ、承認パターン
11. Mobile patterns - iOS ストレージ、バックグラウンド実行、チェックポイント/再開
12. Testing - 機能と Parity を確認するための agent-native アプリケーステスト
13. Refactoring - 既存コードをより agent-native にする
14. Review / checklists - アーキテクチャチェックリスト、アンチパターン、成功基準

番号を選ぶか、必要なことを説明してください。進める前に回答を待ってください。 </intake>

<routing> | Response | Read | |----------|------| | 1, "design", "architecture", "plan" | `references/architecture-patterns.md`, then apply the checklist in `references/checklists.md` | | 2, "files", "workspace", "filesystem" | `references/files-universal-interface.md` and `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` |

After reading the reference, apply those patterns to the user's specific context. </routing>

<reference_index>

Reference Files

Core patterns:

• references/architecture-patterns.md — Event-driven, unified orchestrator, agent-to-UI; full coverage of the five principles
• references/files-universal-interface.md — Why files, organization, context.md
• references/mcp-tool-design.md — Tool design, dynamic capability discovery, CRUD
• references/from-primitives-to-domain-tools.md — When to graduate primitives to domain tools
• references/agent-execution-patterns.md — Completion signals, partial completion, context limits
• references/system-prompt-design.md — Features as prompts, judgment criteria

Disciplines:

• references/dynamic-context-injection.md — Runtime context injection
• references/action-parity-discipline.md — Capability mapping, parity workflow
• references/shared-workspace-architecture.md — Shared data space, UI integration
• references/product-implications.md — Progressive disclosure, latent demand, approval
• references/agent-native-testing.md — Testing outcomes, parity tests
• references/checklists.md — Architecture checklist, anti-patterns, success criteria

Platform-specific:

• references/mobile-patterns.md — iOS storage, checkpoint/resume, cost awareness
• references/self-modification.md — Git-based evolution, guardrails
• references/refactoring-to-prompt-native.md — Migrating existing code </reference_index>