# Implementation Plan: Manual UX Validation & Polish (manual_ux_validation_20260302)

> **TEST DEBT NOTE:** This track is explicitly manual/visual and naturally bypasses the current `live_gui` automated testing debt (documented in `test_architecture_integrity_audit_20260304`). 

## 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)