manual_slop/conductor/tracks/codebase_migration_20260302/plan.md

Implementation Plan: Codebase Migration to src & Cleanup (codebase_migration_20260302)

Phase 1: Unused File Identification & Removal

• Task: Initialize MMA Environment activate_skill mma-orchestrator
• Task: Audit Codebase for Dead Files (1eb9d29)
• Task: Delete Unused Files (1eb9d29)
• [-] Task: Conductor - User Manual Verification 'Phase 1: Unused File Identification & Removal' (SKIPPED)

Phase 2: Directory Restructuring & Migration

• Task: Create src/ Directory
• Task: Move Application Files to src/
• Task: Conductor - User Manual Verification 'Phase 2: Directory Restructuring & Migration' (Protocol in workflow.md)

Phase 3: Entry Point & Import Resolution

• Task: Create sloppy.py Entry Point
• Task: Resolve Absolute and Relative Imports
• Task: Conductor - User Manual Verification 'Phase 3: Entry Point & Import Resolution' (Protocol in workflow.md)

Phase 4: Final Validation & Documentation

• Task: Full Test Suite Validation
  • WHERE: Project root
  • WHAT: Run uv run pytest. Fix any remaining path resolution issues for logs, artifacts, and configs.
  • HOW: Verify 100% pass rate.
  • SAFETY: Artifacts must still be written to tests/artifacts/.
• Task: Update Core Documentation
  • WHERE: Readme.md, docs/, conductor/tech-stack.md
  • WHAT: Document sloppy.py as the new entry point. Document the src/ directory layout.
  • HOW: Surgical text replacement.
  • SAFETY: Accurate representation of new structure.
• Task: Conductor - User Manual Verification 'Phase 4: Final Validation & Documentation' (Protocol in workflow.md)