busya/ss-tools
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity
Files
d874a4dca6bee2c72a07cbc129eb1e66816783a0
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

1.7 KiB
Raw Blame History

#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