chore(conductor): Add new track 'I started to do a large cleanup to gui_2.py...'

This commit is contained in:
2026-05-13 16:14:05 -04:00
parent ae063c77ed
commit 5ac7688e6c
5 changed files with 77 additions and 1 deletions
@@ -0,0 +1,26 @@
# 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)