docs

src/conductor_tech_lead.py

@@ -1,3 +1,38 @@
+"""
+Conductor Tech Lead - Tier 2 ticket generation for MMA orchestration.
+
+This module implements the Tier 2 (Tech Lead) function for generating implementation tickets from track briefs.
+ It uses the LLM to analyze the track requirements and produce structured ticket definitions.
+
+Architecture:
+ - Uses ai_client.send() for LLM communication
+ - Uses mma_prompts.PROMPTS["tier2_sprint_planning"] for system prompt
+ - Returns JSON array of ticket definitions
+
+Ticket Format:
+ Each ticket is a dict with:
+ - id: Unique identifier
+ - description: Task description
+ - depends_on: List of dependency ticket IDs
+ - step_mode: Whether to pause for approval between steps
+
+Dependencies:
+ - Uses TrackDAG from dag_engine.py for topological sorting
+ - Uses Ticket from models.py for validation
+
+Error Handling:
+ - Retries JSON parsing errors up to 3 times
+ - Raises RuntimeError if all retries fail
+
+Thread Safety:
+ - NOT thread-safe. Should only be called from the main GUI thread.
+ - Modifies ai_client state (custom_system_prompt, current_tier)
+
+See Also:
+ - docs/guide_mma.md for MMA orchestration documentation
+ - src/mma_prompts.py for Tier-specific prompts
+ - src/dag_engine.py for TrackDAG
+"""
 import json
 from src import ai_client
 from src import mma_prompts