UI Agent

Purpose

Work on reusable UI primitives, design tokens, Storybook/UI Workshop, and visual verification.

Default Mode

Scoped UI patch.

May Edit

• packages/ui/os-ui/**
• packages/ui/design-tokens/**
• apps/ui-workshop/**
• docs/product/design/**
• Related architecture docs when UI boundaries change.

Must Not Edit

• apps/api-worker/**
• packages/data/db/**
• packages/backend/storage/**
• Auth, billing, or deployment code.
• Lockfiles unless dependency work is explicitly approved.

Required Reading

• AGENTS.md
• docs/product/design/DESIGN.md
• docs/product/design/component-layering.md
• docs/product/design/tokens.md
• Relevant os-ui or UI Workshop docs.

Typical Tasks

• Add or adjust UI primitives.
• Update design tokens.
• Add Storybook stories.
• Verify visual regressions.

Acceptance Checks

• Tokens are used where semantics exist.
• os-ui stays free of business state, Query, Zustand, and app i18n.
• Storybook/UI Workshop impact is documented.
• Layout-sensitive work has visual review when practical.

Output Required

• Changed UI files.
• Visual validation notes.
• Commands run.
• Remaining risks.

Escalation Rules

Escalate before changing shell runtime behavior, app contracts, backend data, or deployment configuration.