manual_slop/conductor/archive/codebase_curation_20260507/plan.md

Implementation Plan: Comprehensive Codebase Curation & Style Alignment (codebase_curation_20260507)

Phase 0: Context Integration & Strategy

• Task: Review all Phase 5 analysis reports in ./docs to internalize the curation roadmap.
• Task: Define a "Granular Review Protocol" for file-by-file auditing and culling.
• Task: Conductor - User Manual Verification 'Curation Strategy' (Protocol in workflow.md)

Phase 1: Automated Standardization & Audit

• [~] Task: Run scripts/ai_style_formatter.py and scripts/force_1space.py on all files in ./src and ./simulation.
• Task: Conduct an automated entropy audit to identify potential redundancy "hotspots".
• Task: Conductor - User Manual Verification 'Standardization' (Protocol in workflow.md)

Phase 2: Surgical Curation of ./src

• Task: Comprehensive rework of src/aggregate.py. Modernize context assembly to leverage MCP tools, snapshots, and file caching. Consolidate tier-specific boilerplate.
• Task: Review and trim gui_2.py and app_controller.py based on pipeline maps.
• Task: Consolidate data models in models.py and remove redundant state in aggregate.py.
• Task: Refactor ai_client.py to ensure lean processing of provider responses.
• Task: Conductor - User Manual Verification 'Source Curation' (Protocol in workflow.md)

Phase 3: Surgical Curation of ./simulation

• Task: Review and trim ./simulation/ base classes and utility scripts.
• Task: Eliminate redundant setup logic in sim_context.py and workflow_sim.py.
• Task: Conductor - User Manual Verification 'Simulation Curation' (Protocol in workflow.md)

Phase 4: Final Integrity Pass

• Task: Verify all tests pass with the trimmed codebase.
• Task: Final comparison against product-guidelines.md for architectural purity.
• Task: Final performance baseline check to ensure no regressions.
• Task: Conductor - User Manual Verification 'Final Review' (Protocol in workflow.md)