Files
ss-tools/specs/038-dashboard-scenario-model/contracts/ux/alternatives.md
busya d874a4dca6 feat(speckit): workflow architecture upgrades + rework 038 spec per new flow
Add prototype/openapi/validate/resume commands, wire edge-failure matrix into UX,
enforce traceability + validation gates, mandate C4/C5 belief-runtime verification.
Rework 038-dashboard-scenario-model artifacts: applicability, structured edge cases,
24-class UX state matrix, interactive HTML prototype, standardized OpenAPI 3.1 (7 ops),
full RTM with coverage gate, 56-task backlog, and PASS validation report.
2026-07-31 11:25:43 +03:00

42 lines
1.7 KiB
Markdown

#region DashboardScenarioModel.UxAlternatives [C:3] [TYPE ADR] [SEMANTICS ux,alternatives,scenario]
@defgroup Ux Design alternatives explored for the DashboardTestScenario graph preview.
## Navigation
- ✅ CHOSEN: Scenario preview embedded in agent workspace with direct link from task run
- ❌ Rejected: Standalone /scenarios route — 039 owns page routing; 038 supplies DTOs only
- ❌ Rejected: Modal over task list — loses graph context and deep-linking
## Graph Presentation
- ✅ CHOSEN: Topological phase lanes + linear accessible step table
- ❌ Rejected: Force-directed graph — non-deterministic layout, hurts scanability, no semantic fallback
- ❌ Rejected: Text-only step list — loses dependency visibility
## Coverage Presentation
- ✅ CHOSEN: All 19 checklist cases visible with classification + rationale, including unsupported/manual
- ❌ Rejected: Show only applicable cases — hides coverage gaps and silent drops
## Resolution Interaction
- ✅ CHOSEN: Controls operate on declared parameters/selectors only
- ❌ Rejected: Free-form graph editing — breaks determinism, ref integrity, and immutable revisions
## Stale Revision Handling
- ✅ CHOSEN: 409 reject + recompile guidance modal
- ❌ Rejected: Silent auto-merge — changes business intent without review
## Draft Pack States
- ✅ CHOSEN: Explicit preview_only vs save_eligible with blocker list
- ❌ Rejected: Single "generate" button without state — hides validation failures
## VLM Findings Presentation
- ✅ CHOSEN: Typed findings (severity/region/confidence/provenance) with disposition controls
- ❌ Rejected: Raw VLM prose as step state — non-reproducible, non-auditable
#endregion DashboardScenarioModel.UxAlternatives