0
Fork 0
mirror of https://github.com/mastra-ai/mastra.git synced 2026-11-17 08:44:46 +00:00
mastra/AGENTS.md
Abhi Aiyer 888b1ce43b
chore: add real-world-testing skill for coding agents (#27391)
Co-authored-by: mastracode <284800079+mastra-platform[bot]@users.noreply.github.com>
2026-10-17 18:45:03 -07:00

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.