Workspaces And Changesets
Workspaces and changesets are the safe path for design work. They keep exploratory edits away from published runtime behavior until validation and review are complete.
Workspace
A workspace is an isolated design area for one app. Use it to add or change commands, events, projections, policies, permissions, adapters, agents, or pages without disturbing the published model.
Keep the workspace focused. A workspace called invoice-approval-v2 should not also contain unrelated page cleanup or adapter experiments.
Changeset
A changeset packages workspace changes for validation, review, and promotion. It should tell reviewers:
- what business capability changed
- which artifacts changed
- which validation errors are fixed or remain
- which runtime contracts will change
- which environment is the promotion target
AI builder workflow
When using Claude, Codex, or another agent through Design MCP, ask it to:
- inspect the current app
- create or select a focused workspace
- make the smallest coherent set of edits
- validate before asking to promote
- summarize model, API, permission, and runtime impact
Agents should not promote broad changes without an explicit builder approval step.
Promotion discipline
Before promotion, verify:
- validation passes
- generated OpenAPI changes are expected
- permission changes are intentional
- projection rebuild needs are understood
- custom pages and agents affected by the change are named
After promotion, run runtime smoke tests in the target environment.