# Track state for manual_ux_validation_20260608_PLACEHOLDER
# Workflow + first-target redesign; 4 phases
# Updated by Tier 2 Tech Lead as phases complete

[meta]
track_id = "manual_ux_validation_20260608_PLACEHOLDER"
name = "Manual UX Validation — ASCII-Sketch Workflow"
status = "active"
current_phase = 1  # Phase 1: Resolve the 5 Open Questions
last_updated = "2026-06-08"

[blocked_by]
# No blockers; track is independent
none = "no blockers"

[blocks]
# Future follow-up tracks (promoted from next_targets.md after Phase 4)
discussion_hub_redesign_20260608_PLACEHOLDER = "potential follow-up; promoted from next_targets.md after Phase 4"
context_panel_redesign_20260608_PLACEHOLDER = "potential follow-up; promoted from next_targets.md after Phase 4"
mma_spawn_modal_redesign_20260608_PLACEHOLDER = "potential follow-up; promoted from next_targets.md after Phase 4"

[phases]
phase_1 = { status = "pending", checkpointsha = "", name = "Resolve the 5 Open Questions" }
phase_2 = { status = "pending", checkpointsha = "", name = "Execute Workflow on First Target" }
phase_3 = { status = "pending", checkpointsha = "", name = "Implement the Design" }
phase_4 = { status = "pending", checkpointsha = "", name = "Document the Pattern + Identify Next Targets" }

[tasks]
# Phase 1: Resolve the 5 Open Questions
t1_1 = { status = "pending", commit_sha = "", description = "Initialize MMA Environment (activate_skill mma-orchestrator)" }
t1_2 = { status = "pending", commit_sha = "", description = "Pose the 5 open questions to the user (one at a time, with defaults)" }
t1_3 = { status = "pending", commit_sha = "", description = "Write decisions.md capturing the 5 answers" }
t1_4 = { status = "pending", commit_sha = "", description = "Conductor - User Manual Verification 'Phase 1: 5 Open Questions Resolved'" }

# Phase 2: Execute the Workflow on the First Target
t2_1 = { status = "pending", commit_sha = "", description = "Establish the boundary (per spec §3.2)" }
t2_2 = { status = "pending", commit_sha = "", description = "Audit the current gui_2.py:3770 implementation (1-page summary)" }
t2_3 = { status = "pending", commit_sha = "", description = "ASCII sketch round 1 (Tier-1 first draft)" }
t2_4 = { status = "pending", commit_sha = "", description = "User critique → Tier-1 revision (rounds 2, 3 if needed)" }
t2_5 = { status = "pending", commit_sha = "", description = "Lock the design: write designs/discussion_hub_per_entry_v1.md" }
t2_6 = { status = "pending", commit_sha = "", description = "Conductor - User Manual Verification 'Phase 2: Design Contract Locked'" }

# Phase 3: Implement the Design (TDD)
t3_1 = { status = "pending", commit_sha = "", description = "Add live_gui fixture baseline check" }
t3_2 = { status = "pending", commit_sha = "", description = "Write failing tests for A1 (collapse/expand)" }
t3_3 = { status = "pending", commit_sha = "", description = "Write failing tests for A2 (edit/read toggle)" }
t3_4 = { status = "pending", commit_sha = "", description = "Write failing tests for A3 (role change via combo)" }
t3_5 = { status = "pending", commit_sha = "", description = "Write failing tests for A4 + A5 (insert before/after)" }
t3_6 = { status = "pending", commit_sha = "", description = "Write failing tests for A6 (delete)" }
t3_7 = { status = "pending", commit_sha = "", description = "Write failing tests for A7 (branch)" }
t3_8 = { status = "pending", commit_sha = "", description = "Run A1-A7 test suite; confirm 7 fail (Red phase)" }
t3_9 = { status = "pending", commit_sha = "", description = "Implement the redesign in gui_2.py:3770" }
t3_10 = { status = "pending", commit_sha = "", description = "Run A1-A7 tests; confirm 7 pass (Green phase)" }
t3_11 = { status = "pending", commit_sha = "", description = "Run full test suite; confirm no regressions" }
t3_12 = { status = "pending", commit_sha = "", description = "Verify with MiniMax understand_image (per Q2 decision)" }
t3_13 = { status = "pending", commit_sha = "", description = "Atomic commit per task (test files separate)" }
t3_14 = { status = "pending", commit_sha = "", description = "Final commit for the implementation" }
t3_15 = { status = "pending", commit_sha = "", description = "Attach git notes per workflow.md protocol" }
t3_16 = { status = "pending", commit_sha = "", description = "Conductor - User Manual Verification 'Phase 3: Implementation Complete'" }

# Phase 4: Document the Pattern + Identify Next Targets
t4_1 = { status = "pending", commit_sha = "", description = "Update docs/reports/ascii_sketch_ux_workflow_20260608.md with answered Q1-Q5" }
t4_2 = { status = "pending", commit_sha = "", description = "Write next_targets.md (5-7 candidate panels)" }
t4_3 = { status = "pending", commit_sha = "", description = "Commit the docs + next-targets" }
t4_4 = { status = "pending", commit_sha = "", description = "Update conductor/tracks.md to reflect track status" }
t4_5 = { status = "pending", commit_sha = "", description = "Conductor - User Manual Verification 'Phase 4: Pattern Documented'" }

[verification]
# Track verification criteria
spec_md_exists = true
plan_md_exists = true
metadata_json_exists = true
state_toml_exists = true
index_md_exists = true

# 5 open questions documented with defaults
open_questions_documented = true
open_questions_defaults_documented = true

# SSDL cross-reference in spec §2.6
ssdl_cross_reference_documented = true

# 4 phases planned with 21 tasks
plan_phases_documented = true
plan_tasks_documented = true

# First target specified
first_target_specified = true  # Discussion Hub per-entry panel (gui_2.py:3770)

# No code modified yet
no_code_modified_yet = true

[ssdl_alignment]
# Per spec §2.6, GUI ASCII and SSDL are different vocabularies for different purposes
gui_ascii_for_panel_design = true
ssdl_for_internal_refactoring = true
conflation_warning_documented = true

# SSDL principles that may inform Phase 3 internal refactoring
nil_sentinel_pattern_available = true  # For entry.get("collapsed") defusing
generational_handle_pattern_available = true  # For entry references across frames
effective_codepath_pattern_available = true  # For the 4-5 branches in render_discussion_entry
immediate_mode_pattern_available = true  # For the role combo (immediate-mode vs retained-mode)
xar_chunkification_pattern_available = false  # Not relevant for a single-panel GUI render

[status]
# Active; Phase 1 is the current phase
status = "active (Phase 1: awaiting 5 user answers to open questions)"
