Mastra Framework Guide

Last verified: 2026-07（Mastra v1.50.1 / @mastra/core 同梱 docs / https://mastra.ai で検証。DOCTOR.md の四半期鮮度チェックの対象）

Build AI applications with Mastra. This skill teaches you how to find current documentation and build agents and workflows.

このスキルは Mastra の利用・更新ガイド（API 検証・ドキュメント探索・バージョン移行）である。設計上の責務分離・単一エージェント優先などの設計原則は、設計憲章スキル mastra-ai-architecture-rules（編集禁止）に従うこと。本ガイド = どう使い最新仕様に追従するか、憲章 = どう設計すべきか、という棲み分けである。

⚠️ Critical: Do not trust internal knowledge

Everything you know about Mastra is likely outdated or wrong. Never rely on memory. Always verify against current documentation.

Your training data contains obsolete APIs, deprecated patterns, and incorrect usage. Mastra evolves rapidly - APIs change between versions, constructor signatures shift, and patterns get refactored.

Prerequisites

Before writing any Mastra code, check if packages are installed: