메뉴
Complete guide for Mastra development — agents, tools, workflows, vertical organization, and type safety
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Always use Turborepo commands for building, testing, and serving projects in this monorepo
Always use Turborepo commands for building, testing, and serving projects in this monorepo
Always fix issues you encounter, even if unrelated to your current task
Essential clean code practices including naming, comments, and structure
Commit message format standards using Conventional Commits specification
Use GitHub MCP tools for all repository operations instead of CLI or API calls
| name | mastra-development |
| description | Complete guide for Mastra development — agents, tools, workflows, vertical organization, and type safety |
This skill covers all conventions for building with Mastra in the Hey Jarvis project. Always use the factory patterns — never import from Mastra's core packages directly.
createAgent() factory, file structure, naming conventions, registration stepscreateTool() factory, critical naming rules, export pattern, input/output schemascreateWorkflow(), agent-as-step, tool-as-step, state managementsatisfies| What | Factory | Import from |
|---|---|---|
| Agent | createAgent() | ../../utils/agent-factory |
| Tool | createTool() | ../../utils/tool-factory |
| Workflow | createWorkflow() | ../../utils/workflow-factory |
| Step | createStep() | ../../utils/workflow-factory |
| Agent step | createAgentStep() | ../../utils/workflow-factory |
| Tool step | createToolStep() | ../../utils/workflow-factory |
mastra/verticals/[vertical-name]/
├── agent.ts # or agents.ts for multiple
├── tools.ts
├── workflows.ts
└── index.ts
as) to fix type errors after version bumps@mastra/core/* directly — always use factories