Mastra AIサービス アーキテクチャ憲章

設計はまず Mastra の既存プリミティブ から始めること。カスタムのプログラムコードは、決定性・安全性・可観測性・外部連携・コスト/レイテンシ最適化に明確な価値がある場合にのみ追加する。

この憲章は capability-aware である。Mastra が提供するすべての機能が、すべてのプロジェクトで有効・必要とは限らない。 Workspace、Memory、RequestContext、永続ストレージ、Observability、Evals、Browser、Vector DB などは optional であり、このリポジトリに既に存在するか、ユーザーが導入を明示承認した場合にのみ前提としてよい。

本スキルと一般スキルの関係:

• 本スキルは Mastra ランタイム固有層 の憲章である。agent-harness-engineering の適用優先順位に従い、Mastra プロジェクトでは本憲章が一般則に優先する。
• 本憲章が明示的に扱わない論点（停止条件・wrap-up・冪等性契約・認可の合成・キャッシュ規律・検証の証拠主義など）は、agent-harness-engineering（ランタイム非依存のハーネス設計一般則）と agent-native-project-design（Claude Code / Codex 等の既製ハーネス上で運用するリポジトリ側の設計）を補完として適用する。
• §1「設計の根本原則」は上記2スキルのコア公理を Mastra 文脈へ射影したものである。公理10箇条の全文複製は、3ファイル間の drift コストを避けるため行わない。

0. Capability-aware 原則と導入承認ゲート

実装や設計変更の前に、必ずこのリポジトリの capability inventory を確認すること。