# Implementation Plan: GUI 2.py Cleanup & Structural Awareness

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

## Phase 2: Study & Document Codebase Conventions
- [x] 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.
- [x] Task: Synthesize learnings to update `conductor/code_styleguides/python.md` with specific, explicit coding conventions.
- [x] Task: Update `conductor/product-guidelines.md` with high-level structural and maintenance strategies derived from the codebase study.
- [x] Task: Conductor - User Manual Verification 'Phase 2: Study & Document Codebase Conventions' (Protocol in workflow.md)

## Phase 3: Apply Conventions & Finalize `gui_2.py` Nitpicks
- [x] Task: Audit `gui_2.py` against the newly documented conventions to identify remaining structural nitpicks.
- [x] Task: Apply formatting, type hint corrections, and layout refactoring to bring the rest of `gui_2.py` into alignment.
- [x] Task: Run automated test suite to ensure structural changes haven't broken the rendering pipeline.
- [x] 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
- [x] Task: Investigate existing Python MCP tool scripts (e.g., `py_get_skeleton`, `py_get_code_outline` implementations) for AST parsing logic.
- [x] Task: Enhance AST parsing logic to better extract and expose type annotations from Python source files.
- [x] Task: Modify structural extraction tools to recognize and highlight common ImGui/Dear PyGui patterns.
- [x] 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)