chore(conductor): Replace monolithic curation with 5 granular tracks

2026-05-08 18:11:33 -04:00
parent d04e33ea06
commit 712e235699
26 changed files with 167 additions and 3 deletions
@@ -0,0 +1,35 @@
+# Specification: Comprehensive Codebase Curation & Style Alignment (codebase_curation_20260507)
+
+## Overview
+Aggressive pruning, optimization, and standardization of the codebase. This track uses the findings from the Code Path Analysis and other Phase 5 audits to trim away non-essential logic, data, and processing while strictly enforcing the project's technical integrity standards.
+
+## Foundational Context (MANDATORY REVIEW)
+All curation efforts MUST be informed by the following Phase 5 analysis reports:
+- `docs/PIPELINE_ANALYSIS_PHASE5_INIT.md`: Processing route and pipeline mapping.
+- `docs/STATE_INVENTORY_PHASE5.md`: Core data structure and property inventory.
+- `docs/MUTATION_MATRIX_PHASE5.md`: Thread-safe state modification and lock map.
+- `docs/CULLING_CANDIDATES_PHASE5.md`: Identified redundant symbols, modules, and structures.
+
+## Granular Care & Regression Guardrails
+- **Surgical Execution:** Changes must be applied file-by-file with extreme granularity. No bulk culling without individual justification.
+- **Regression Monitoring:** Continuous verification of behavioral integrity. Any unintended entropy or performance degradation must trigger an immediate halt and review.
+- **Traceability:** Every removed line must be cross-referenced against the culling audit or pipeline map.
+
+## Scope
+- **Target Files:** All `.py` files in `./src` and `./simulation`.
+- **Primary Goal:** Trimming the "slop" (redundancies, dead code, excessive complexity).
+
+## Functional Requirements
+1.  **Redundancy Pruning:** Eliminate duplicate logic across different data pipelines.
+2.  **Dead Code Removal:** Strip out legacy "just-in-case" code and unused processing paths.
+3.  **Strict Style Enforcement:**
+    - Universal 1-space indentation.
+    - CRLF line endings.
+    - Standardized type hinting.
+4.  **Guideline Alignment:** Refactor any code that deviates from `product-guidelines.md` (e.g., ensuring explicit composition over complex inheritance).
+5.  **Validation:** Ensure no loss of functionality or performance degradation.
+
+## Acceptance Criteria
+- [ ] Significant reduction in total codebase line count (where applicable).
+- [ ] 100% pass on style audit (`scripts/ai_style_formatter.py`).
+- [ ] All remaining code is mapped to a necessary functional requirement or performance goal.