manual_slop/conductor/tracks/code_path_analysis_20260507/plan.md

Implementation Plan: Code Path & Data Pipeline Analysis (code_path_analysis_20260507)

Phase 1: Structural Exploration & Tooling Setup

• Task: Initialize PIPELINE_ANALYSIS.md template.
• Task: Deploy codebase_investigator subagents to identify top-level entry points in gui_2.py and simulation/.
• Task: Verify usage of existing tree-sitter tools to generate initial call-graph skeletons for ./src.
• Task: Conductor - User Manual Verification 'Phase 1' (Protocol in workflow.md)

Phase 2: Mapping Core Source Pipelines (./src)

• Task: Map the Context Aggregation Pipeline (aggregate.py, models.py).
• Task: Map the AI Interaction Loop (ai_client.py, mcp_client.py, shell_runner.py).
• Task: Map the GUI Event & State Pipeline (gui_2.py, app_controller.py).
• Task: Document data responsibilities and state boundaries for each route.
• Task: Conductor - User Manual Verification 'Phase 2' (Protocol in workflow.md)

Phase 3: Mapping Simulation Pipelines (./simulation)

• Task: Map the Simulation Lifecycle (sim_base.py, sim_context.py, workflow_sim.py).
• Task: Analyze data flow between sim_ai_settings.py and the execution engine.
• Task: Document the "Verification & Checkpointing" route in simulations.
• Task: Conductor - User Manual Verification 'Phase 3' (Protocol in workflow.md)

Phase 4: Synthesis & Reporting

• Task: Consolidate all findings into Mermaid diagrams within PIPELINE_ANALYSIS.md.
• Task: Identify specific "Curation Targets" (redundancies, style violations) for the next track.
• Task: Final review and hand-off to Track 2 (Codebase Curation).
• Task: Conductor - User Manual Verification 'Phase 4' (Protocol in workflow.md)