manual_slop/conductor/tracks/gui_2_cleanup_20260513/plan.md

Implementation Plan: GUI 2.py Cleanup & Structural Awareness

Phase 1: gui_2.py Structural Analysis & Init Cleanup

• Task: Audit gui_2.py state variables and __init__ declarations to identify redundancies or disorganization.
• Task: Refactor gui_2.py's __init__ method to group related state variables and improve clarity.
• Task: Verify GUI initialization functionality and ensure no regressions using manual/test hooks.
• Task: Conductor - User Manual Verification 'Phase 1: gui_2.py Structural Analysis & Init Cleanup' (Protocol in workflow.md)

Phase 2: Study & Document Codebase Conventions

• Task: Study recent changes to gui_2.py (via git diffs and current file state) to identify established conventions for type hints, layout logic, and ImGui scoping.
• Task: Synthesize learnings to update conductor/code_styleguides/python.md with specific, explicit coding conventions.
• Task: Update conductor/product-guidelines.md with high-level structural and maintenance strategies derived from the codebase study.
• Task: Conductor - User Manual Verification 'Phase 2: Study & Document Codebase Conventions' (Protocol in workflow.md)

Phase 3: Apply Conventions & Finalize gui_2.py Nitpicks

• Task: Audit gui_2.py against the newly documented conventions to identify remaining structural nitpicks.
• Task: Apply formatting, type hint corrections, and layout refactoring to bring the rest of gui_2.py into alignment.
• Task: Run automated test suite to ensure structural changes haven't broken the rendering pipeline.
• Task: Conductor - User Manual Verification 'Phase 3: Apply Conventions & Finalize gui_2.py Nitpicks' (Protocol in workflow.md)

Phase 4: MCP Tool Enhancements for Structural Awareness

• Task: Investigate existing Python MCP tool scripts (e.g., py_get_skeleton, py_get_code_outline implementations) for AST parsing logic.
• Task: Enhance AST parsing logic to better extract and expose type annotations from Python source files.
• Task: Modify structural extraction tools to recognize and highlight common ImGui/Dear PyGui patterns.
• Task: Write/update tests for MCP tools to verify accurate annotation and pattern parsing.
• [~] Task: Conductor - User Manual Verification 'Phase 4: MCP Tool Enhancements for Structural Awareness' (Protocol in workflow.md)