manual_slop/conductor/tracks/sdm_docstrings_20260509/plan.md

Implementation Plan: Structural Dependency Mapping (SDM) Docstrings

Phase 1: Convention & Documentation

• Task: Update conductor/product-guidelines.md with SDM convention [3267928]
• Task: Update conductor/code_styleguides/python.md with SDM convention [3267928]
• [~] Task: Conductor - User Manual Verification 'Phase 1: Convention' (Protocol in workflow.md)

Phase 2: Tooling & Pilot

• Task: Research AST-based mapping logic (identify mutation points and callers)
• Task: Create a pilot script scripts/sdm_mapper.py to generate SDM tags for a single module (src/models.py)
• Task: Manually verify generated tags for src/models.py
• Task: Conductor - User Manual Verification 'Phase 2: Tooling' (Protocol in workflow.md)

Phase 3: Global Rollout (Core Logic)

• Task: Run sdm_mapper.py on all files in ./src
• Task: Agent review of generated tags for core modules (app_controller.py, gui_2.py)
• Task: Inject tags into ./src docstrings
• Task: Conductor - User Manual Verification 'Phase 3: Rollout' (Protocol in workflow.md)

Phase 4: Full Codebase & Finalization

• Task: Run rollout for ./simulation and ./tests
• Task: Run full test sweep to ensure no regressions [checkpoint: ]
• Task: Conductor - User Manual Verification 'Phase 4: Finalization' (Protocol in workflow.md)