Last Update

2026-05-10 19:18:50 +03:00
parent b7936a0912
commit 1036cb5739
40 changed files with 2918 additions and 0 deletions
@@ -0,0 +1,35 @@
+# 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"]
+}
+```