UXSpec Builder

Interactive workflow for creating UXSpec files — the JSON format that unifies state machines and visual specifications for AI agents.

Trigger

Use when the user wants to create, build, or scaffold a .uxspec.json file, or asks "help me write a uxspec".

Workflow

Follow these phases in order. Each phase produces a concrete artifact before moving on.

Phase 1 — Gather Requirements

Ask the user:

1. What is this component/page? (e.g., "login form", "toast notifications", "media player")
2. What are the key states? (e.g., "idle, loading, error, success")
3. What events drive transitions? (e.g., "SUBMIT, INPUT_CHANGED, HTTP_OK, HTTP_ERROR")
4. What context data is needed? (e.g., "email: string, password: string, error: string | null")