# Builder Smoke Test

Smoke tests the Agent Builder branch end to end in a scaffolded project.

- Repository: https://github.com/mastra-ai/mastra (29259 stars)
- Category: Testing
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add mastra-ai/mastra --skill builder-smoke-test -g -a claude-code -y`
Codex: `npx skills add mastra-ai/mastra --skill builder-smoke-test -g -a codex -y`
Cursor: `npx skills add mastra-ai/mastra --skill builder-smoke-test -g -a cursor -y`
Gemini CLI: `npx skills add mastra-ai/mastra --skill builder-smoke-test -g -a gemini-cli -y`

## Description

Smoke test the Agent Builder feature branch end-to-end against a hermetic project scaffolded by the skill (linked to the current worktree). Covers workspace reconciliation, stored agents/skills CRUD, ownership, visibility, stars, registry/library Copy flow, picker allowlists, model policy, RBAC role gating, role impersonation UI, builder defaults, infrastructure diagnostics, channels, and Studio + Agent Builder UI. Trigger when validating the agent-builder feature branch, PRs that touch packages/server, packages/playground, packages/playground-ui agent-builder routes, or builder EE code paths.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Builder Smoke Test

End-to-end smoke testing of the Agent Builder feature set against a hermetic project the skill scaffolds at `~/mastra-builder-smoke-tests/builder-smoke` (configurable). The project links to the current worktree via `pnpm` `link:` overrides, so changes to packages under `packages/`, `stores/`, `auth/`, `channels/`, `observability/`, `browser/`, and `client-sdks/` take effect on the next `mastra dev` restart.

This skill is for **branch QA**, it complements the release-time `mastra-smoke-test`. It exercises the Builder EE surface (stored entities, RBAC, registry, infra, channels) using a minimal, predictable project rather than the kitchen-sink `examples/agent`.

## ⚠️ Mandatory Test Checklist

**Use `task_write` to track progress.** Run ALL sections unless `--test` or `--scope` narrows the run.

**Do not skip sections unless you hit an actual blocker.** "Seemed complex" or "I'll come back to it" are not valid reasons. Attempt every step, only stop when you literally cannot proceed. Report what you tried and what blocked you.

The rest: https://github.com/mastra-ai/mastra/blob/HEAD/.claude/skills/builder-smoke-test/SKILL.md