manual_slop/conductor/tracks/manual_ux_validation_20260302/plan.md

Implementation Plan: Manual UX Validation & Polish (manual_ux_validation_20260302)

Phase 1: Observation Harness Setup

• Task: Initialize MMA Environment activate_skill mma-orchestrator
• Task: Create Slow-Mode Simulation
  • WHERE: simulation/ directory
  • WHAT: Create ux_observation_sim.py that executes a standard workflow but with forced 3-5 second delays between actions to allow the user to watch the GUI respond.
  • HOW: Use ApiHookClient with heavy time.sleep() blocks specifically designed for human observation (exempt from the fast-test rule).
  • SAFETY: Keep this script strictly separate from the automated test suite.
• Task: Conductor - User Manual Verification 'Phase 1: Observation Harness' (Protocol in workflow.md)

Phase 2: Structural Layout & Organization

• Task: Interactive Layout Iteration
  • WHERE: gui_2.py
  • WHAT: Work live with the user to shift UI elements between Tabs, Panels, and Collapsing Headers. Focus on logical grouping of AI settings, operations, and logs.
  • HOW: Rapidly apply changes requested by the user and re-render.
  • SAFETY: Avoid breaking data bindings during structural moves.
• Task: Conductor - User Manual Verification 'Phase 2: Layout Finalization' (Protocol in workflow.md)

Phase 3: Animations, Knobs & Visual Feedback

• Task: Tune Blinking & State Animations
  • WHERE: gui_2.py
  • WHAT: Adjust math.sin(time.time() * X) frequencies, color vectors, and trigger conditions for "streaming", "working", and "error" states.
  • HOW: Modify rendering loops based on user feedback.
  • SAFETY: None.
• Task: Refine Controls & Knobs
  • WHERE: gui_2.py
  • WHAT: Evaluate the placement and feel of sliders, combo boxes, and buttons.
  • HOW: Adjust ImGui spacing, item widths, and same-line alignments.
  • SAFETY: None.
• Task: Conductor - User Manual Verification 'Phase 3: Visual Polish' (Protocol in workflow.md)

Phase 4: Popup Behavior & Final Sign-off

• Task: Implement Auto-Close Popups
  • WHERE: gui_2.py
  • WHAT: Review existing popups. Implement a timer mechanism (e.g., comparing time.time() against a trigger time) to automatically close specific informational popups after N seconds.
  • HOW: Add timer state to app_instance and use imgui.close_current_popup() conditionally.
  • SAFETY: Do not auto-close critical confirmation dialogs (like file write approvals).
• Task: Final UX Sign-off
  • Ask the user for a final comprehensive review of the application's feel.
• Task: Conductor - User Manual Verification 'Phase 4: Final Sign-off' (Protocol in workflow.md)