mastra-ai-architecture-rules
Mastra AIサービス アーキテクチャ憲章
設計はまず Mastra の既存プリミティブ から始めること。カスタムのプログラムコードは、決定性・安全性・可観測性・外部連携・コスト/レイテンシ最適化に明確な価値がある場合にのみ追加する。
この憲章は capability-aware である。Mastra が提供するすべての機能が、すべてのプロジェクトで有効・必要とは限らない。 Workspace、Memory、RequestContext、永続ストレージ、Observability、Evals、Browser、Vector DB などは optional であり、このリポジトリに既に存在するか、ユーザーが導入を明示承認した場合にのみ前提としてよい。
0. Capability-aware 原則と導入承認ゲート
実装や設計変更の前に、必ずこのリポジトリの capability inventory を確認すること。
最低限、以下を明示すること：
- 既に存在するもの: agents / workflows / tools / workspace / memory / request context / storage / observability / evals / browser / queues / external systems
- 存在しないが問題ないもの: 今回の要件では不要な機能
- 追加したくなっているもの: 追加理由があるが、まだ導入承認されていない機能
More from efoo-team/skills
langfuse
Query, debug, and analyze LLM observability data from Langfuse via REST API. Covers traces, observations, sessions, scores, prompts, and datasets. Use when investigating agent behavior, debugging LLM calls, analyzing costs/latency, reviewing prompt versions, or auditing Mastra agent runs.
22formation-designer
oh-my-opencode formation (agent-model configuration) design and creation guide. Use when creating new formations, modifying existing formations, adding new providers/models, or reviewing formation design decisions. Covers multi-axis model classification (Reasoning, Cost, Speed, Instruct, Style, Multimodal), agent-model matching principles, naming conventions, and cost optimization strategy.
22refactor-mindset
構造と意図の整合をとり、変更容易性を高める。局所最適化された設計を将来の変更を見据えた構造へ再構築する。Code Smellの仮説的扱い、AI向け大規模一貫変更を提供。ローカル開発完了後のリファクタリング時に使用。
21module-boundary-design
ソフトウェアの機能境界・責務分離・モジュール分割・抽象化の設計判断を行うためのスキル。設計相談を受けたときの内部思考プロセスとして使用する。「この機能をどう設計すべきか」「責務をどう分けるか」「リファクタリングしたい」「モジュール分割を考えたい」「抽象化が正しいか判断したい」「クラス設計を見直したい」「コードの見通しが悪い」「何をどこに置くべきか」といった設計構造に関する相談全般で必ずこのスキルを参照すること。設計レビュー、アーキテクチャ検討、コード構造の改善提案にも適用される。
21github-pull-request
AIに実装させた変更を抽象度の階層構造で分析し、構造化されたGitHub PR本文として出力する。大規模変更（1万行超）でも、システム構成図→データ構造→API→処理フロー→実装詳細の順で抽象→具体へ整理する。画像エビデンスを含むPR本文の組み立て方も扱う。「PR本文を書いて」「この変更をPRにする」「実装した内容のPRを作りたい」といった場面で使用する。
13database-design
DB のテーブル・カラム命名を、処理目的ではなく永続化する概念・entity・関係から判断するためのスキル。DB命名、スキーマ命名、正規化に伴う命名、用途に過適合した名前を避けるときに使用する。
12