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

## Phase 0: Context Integration & Strategy
- [x] Task: Review all Phase 5 analysis reports in `./docs` to internalize the curation roadmap.
- [x] Task: Define a "Granular Review Protocol" for file-by-file auditing and culling.
- [x] 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)
