2026 03 01_ux_execution_control_plane - mark-ik/graphshell GitHub Wiki
Date: 2026-03-02
Status: Canonical operational control-plane
Purpose: Consolidated execution surface for UX baseline done-gates, current milestone checklist, and issue-domain mapping.
Consolidates:
../../../../archive_docs/checkpoint_2026-03-01/2026-02-27_ux_baseline_done_definition.md../../../../archive_docs/checkpoint_2026-03-01/2026-02-28_current_milestone_ux_contract_checklist.md../../../../archive_docs/checkpoint_2026-03-01/2026-02-28_ux_issue_domain_map.md
Related:
2026-02-28_ux_contract_register.md../2026-03-03_spec_conflict_resolution_register.md../../research/2026-03-02_ux_integration_research.md../../design/surface_behavior_spec.md../../design/accessibility_baseline_checklist.md../../design/ux_telemetry_plan.md../2026-03-01_ux_migration_feature_spec_coverage_matrix.md../2026-03-01_ux_migration_lifecycle_audit_register.mdux_tree_and_probe_spec.mdux_scenario_and_harness_spec.md
This document is the operational UX execution surface for three questions:
- What defines baseline UX closure for “usable application” status?
- What is the current milestone checklist and execution order?
- Which open issues are primary UX work vs enabling/support lanes?
Canonical interaction semantics remain owned by the six-spec family in
2026-02-28_ux_contract_register.md.
UX baseline is considered closed only when all domains below pass together:
-
Interaction correctness
- graph navigation, pane open/close/switch, and focus handoff are deterministic.
-
Viewer baseline correctness
- baseline viewer set behaves predictably across render modes.
-
Lifecycle and routing correctness
- graph/workbench routing preserves identity and authority semantics.
-
Performance and degradation clarity
- fallback/degraded states are explicit and diagnostics-visible.
-
Spec/code parity
- active docs match runtime behavior; no stale claim drift.
Validation gate:
- quick smoke profile passes,
- diagnostics evidence exists for compositor pass ordering/fallback visibility,
- matrix/register rows reflect current truth.
-
Navigation and camera
-
#173,#104,#101,#103,#271
-
-
Pane/workbench lifecycle
-
#174,#186,#187,#118,#119
-
-
Content opening and routing
#175
-
Command-surface unification
-
#176,#108,#106,#107,#178,#270
-
-
Settings/control surfaces
-
#109,#110,#177,#189
-
-
Selection and viewer clarity
-
#185,#102,#162,#188
-
-
UX integration deliverables and parity
-
#292,#293,#294,#295,#296,#297,#298,#299,#300,#301
-
Before milestone closure, answer “yes” to all:
- Can users navigate graph space without control ambiguity?
- Are pane open/close/focus flows deterministic?
- Do content-opening actions always route through Graphshell semantics?
- Are command surfaces semantically unified?
- Do settings/history behave as first-class surfaces with return-path integrity?
- Are selection + degraded/fallback states explicit and testable?
Issue status classes:
- Primary: direct UX contract behavior slice.
- Enabling: architecture/refactor prerequisite for a UX slice.
- Support: docs/diagnostics/policy reinforcement.
- Primary:
#173,#104,#101,#185,#102 - Enabling:
#103,#105
- Primary:
#174,#175,#186,#187 - Enabling:
#118,#119 - Support:
#100
- Primary:
#176,#106,#107,#108,#178,#270 - Support:
#89
- Primary:
#140,#174,#187,#189 - Enabling:
#103 - Support:
#138,#139,#141,#95
- Primary:
#251,#257,#261,#269,#272,#273 - Support:
#246,#247,#248,#249,#250
- Primary:
#162,#188,#109,#111,#112 - Support:
#155,#159,#92
- Primary:
#109,#110,#177,#189 - Support:
#89,#134,#135,#136,#137,#142,#94
- Primary:
#292,#293,#294,#295,#296,#297,#298,#299,#300,#301 - Support:
#302(closed parity audit baseline)
| Severity | Gap slice | Issue links |
|---|---|---|
| Critical | Core canvas interaction invariants full closure (selection/lasso/zoom/edge focus) |
#173, #185, #102, #104, #101, #103, #271
|
| High | UxScenario snapshot baseline/diff CI gate (remaining open after G7) | #257 |
| High | Inter-workbench semantics and WorkbenchProfile composition contracts |
#174, #186, #187, #118, #119
|
| Medium | Readability/adaptation portfolio expansion and post-switch interaction tuning |
#180, #181, #182
|
The following remain migration-deferred and should not be counted as immediate UX-contract closure slices:
-
#179,#180,#181,#182,#183,#184
These can influence UX readiness but do not replace baseline UX closure work.
For any UX issue/PR touching current milestone semantics:
- Update this control-plane doc when priority/status/domain changes.
- Update
../2026-03-01_ux_migration_feature_spec_coverage_matrix.mdfor spec ownership + three-tree status. - Update
../2026-03-01_ux_migration_lifecycle_audit_register.mdfor lifecycle stage + timing gate. - Keep parity mapping current when UX research deliverables or closure statuses change (
#302establishes the baseline audit pass). - If a UX behavior contract changes because a spec-conflict authority doc lands (P1–P4), keep this control-plane doc aligned with the conflict register instead of preserving older terminology by inertia.
A UX slice is not considered done until all three artifacts agree.