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