OpenAgentsControl/.opencode/context/development/ai/mastra-ai/README.md

Mastra Context

Purpose: Documentation and quick references for Mastra implementation in this project.

Last Updated: 2026-01-09

---

Navigation

Concepts

File	Description	Priority
core.md	Central orchestration layer	critical
workflows.md	Linear and parallel execution chains	critical
agents-tools.md	Reusable units of logic and LLM entities	high
evaluations.md	Quality assurance and scoring	high
storage.md	Persistence layer and schema	high

Guides

File	Description	Priority
testing.md	How to run and validate components	high
modular-building.md	Best practices for large-scale Mastra	high
workflow-step-structure.md	Maintainable step patterns	critical

Lookup

File	Description	Priority
mastra-config.md	File locations and database tables	high

Errors

File	Description	Priority
mastra-errors.md	Common errors and recovery	high

---

Quick Start

1. Explore Config: See src/mastra/index.ts for the main Mastra instance.
2. Check Workflows: Look at src/mastra/workflows/ for business logic.
3. View Traces: Run npm run traces to see execution history.