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: Type Hints & Layout Refactoring in gui_2.py

• Task: Inject and validate Python type hints across gui_2.py methods and properties.
• Task: Refactor complex layout and rendering logic blocks within gui_2.py for better readability.
• Task: Run automated test suite to ensure structural changes haven't broken the rendering pipeline.
• Task: Conductor - User Manual Verification 'Phase 2: Type Hints & Layout Refactoring in gui_2.py' (Protocol in workflow.md)

Phase 3: MCP Tool Enhancements

• Task: Investigate existing MCP tools (e.g., py_get_skeleton, py_get_code_outline) for AST parsing logic.
• Task: Enhance AST parsing logic to better extract 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 3: MCP Tool Enhancements' (Protocol in workflow.md)

Phase 4: Documentation & Guidelines Update

• Task: Synthesize learnings from Phase 1 & 2 to define best practices for Python maintenance in this codebase.
• Task: Update conductor/product-guidelines.md with high-level structural and maintenance strategies.
• Task: Update conductor/code_styleguides/python.md with explicit coding conventions (e.g., 1-space indentation, ImGui patterns) derived from the cleanup.
• Task: Conductor - User Manual Verification 'Phase 4: Documentation & Guidelines Update' (Protocol in workflow.md)