# UX Spec Patterns

Use these patterns for `ux_spec.json`.

## Flow

```json
{
  "id": "FLOW-001",
  "name": "Create project from documentation",
  "actor_id": "ACT-001",
  "trigger": "User starts a new wireframe project",
  "steps": [
    "Upload or select source documentation",
    "Review normalized project summary",
    "Confirm open questions",
    "Generate UX screen blueprints"
  ],
  "success_outcome": "Project has validated screen blueprints",
  "failure_states": ["unsupported_source", "missing_business_decision"]
}
```

## UX Decision

```json
{
  "id": "UXD-001",
  "decision": "Use a step-by-step review flow before Figma generation.",
  "rationale": "The system must expose unresolved documentation gaps before creating screens.",
  "source_refs": ["REQ-004", "Q-002"],
  "citation_ids": ["nng-heuristics"],
  "impacts": ["screen-project-review", "screen-generation-status"]
}
```