From c15e8b8d1f2b936f546277bc02f52b9669906165 Mon Sep 17 00:00:00 2001 From: Ed_ Date: Fri, 27 Feb 2026 20:13:25 -0500 Subject: [PATCH] docs(conductor): Synchronize docs for track 'MMA Data Architecture & DAG Engine' --- conductor/product.md | 3 +++ conductor/tech-stack.md | 1 + 2 files changed, 4 insertions(+) diff --git a/conductor/product.md b/conductor/product.md index c97d080..46351d0 100644 --- a/conductor/product.md +++ b/conductor/product.md @@ -16,6 +16,9 @@ To serve as an expert-level utility for personal developer use on small projects - **Tier 3 (Worker):** Surgical code implementation and TDD using `gemini-2.5-flash` or `deepseek-v3`. Operates statelessly with tool access and dependency skeletons. - **Tier 4 (QA):** Error analysis and diagnostics using `gemini-2.5-flash` or `deepseek-v3`. Operates statelessly with tool access. - **MMA Delegation Engine:** Utilizes the `mma-exec` CLI and `mma.ps1` helper to route tasks, ensuring role-scoped context and detailed observability via timestamped sub-agent logs. Supports dynamic ticket creation and dependency resolution via an automated Dispatcher Loop. + - **Track-Scoped State Management:** Segregates discussion history and task progress into per-track state files (e.g., `conductor/tracks//state.toml`). This prevents global context pollution and ensures the Tech Lead session is isolated to the specific track's objective. + - **Native DAG Execution Engine:** Employs a Python-based Directed Acyclic Graph (DAG) engine to manage complex task dependencies, supporting automated topological sorting and robust cycle detection. + - **Programmable Execution State Machine:** Governing the transition between "Auto-Queue" (autonomous worker spawning) and "Step Mode" (explicit manual approval for each task transition). - **Role-Scoped Documentation:** Automated mapping of foundational documents to specific tiers to prevent token bloat and maintain high-signal context. - **Strict Memory Siloing:** Employs tree-sitter AST-based interface extraction (Skeleton View, Curated View) and "Context Amnesia" to provide workers only with the absolute minimum context required, preventing hallucination loops. - **Explicit Execution Control:** All AI-generated PowerShell scripts require explicit human confirmation via interactive UI dialogs before execution, supported by a global "Linear Execution Clutch" for deterministic debugging. diff --git a/conductor/tech-stack.md b/conductor/tech-stack.md index 76a4ff4..af5685d 100644 --- a/conductor/tech-stack.md +++ b/conductor/tech-stack.md @@ -37,6 +37,7 @@ - **pytest:** For unit and integration testing, leveraging custom fixtures for live GUI verification. - **ApiHookClient:** A dedicated IPC client for automated GUI interaction and state inspection. - **mma-exec / mma.ps1:** Python-based execution engine and PowerShell wrapper for managing the 4-Tier MMA hierarchy and automated documentation mapping. +- **dag_engine.py:** A native Python utility implementing `TrackDAG` and `ExecutionEngine` for dependency resolution, cycle detection, and programmable task execution loops. ## Architectural Patterns