1.7 KiB
Repository guidance
Unless asked, don't inspect reference or modify examples.
Use the most-specific AGENTS.md; for package work, read packages/<name>/AGENTS.md first.
Turborepo pnpm workspace; packages use strict TypeScript; Vitest tests are colocated.
For schema-backed execution, put deterministic input/output constraints (shape, types, ranges, formats, cross-field invariants) in schemas, not execute. Keep runtime/external checks (authorization, existence, conflicts, API responses) in execute.
Use literal model names/IDs from docs/src/plugins/remark-model-tokens/models.ts in changesets/comments; placeholders are not replaced.
Use the narrowest package build/test/lint/typecheck; run unit/integration before E2E. Prefer targeted pnpm --filter or pnpm turbo build --filter commands; avoid root setup/build scripts unless needed. Fresh clone: pnpm install, then build relevant dependencies. Unresolved workspace imports usually mean dependencies need building; some integration tests need pnpm i --ignore-workspace.
Features/new packages need docs. For docs, follow docs/AGENTS.md and styleguides. After code changes, read @.mastracode/commands/changeset.md.
Architecture: packages/core/src; mastra/ config/DI; agent/, tools/, memory/, workflows/, storage/ are modular framework components.
Read applicable @.claude/commands/: changeset, commit, gh-new-pr, gh-pr-comments, make-moves.
Read @.agents/skills/real-world-testing before writing any test or fixing any bug.
Read applicable @.claude/skills/: playground-msw-tests (primary for playground/UI), e2e-tests-studio (secondary), mastra-docs, react-best-practices, tailwind-v4, mastra-frontend, mastra-smoke-test, smoke-test.