From f8cd125c8a2fb3a3b7039b1d20e3f791cd871ffc Mon Sep 17 00:00:00 2001 From: Ed_ Date: Sat, 2 May 2026 13:13:28 -0400 Subject: [PATCH] docs(conductor): Synchronize docs for track 'Codebase Audit and Cleanup' --- conductor/product.md | 6 +++--- conductor/tech-stack.md | 5 +++-- 2 files changed, 6 insertions(+), 5 deletions(-) diff --git a/conductor/product.md b/conductor/product.md index e4f8a7d..070e520 100644 --- a/conductor/product.md +++ b/conductor/product.md @@ -25,9 +25,9 @@ For deep implementation details when planning or implementing tracks, consult `d - **Multi-Provider Integration:** Supports Gemini, Anthropic, and DeepSeek with seamless switching. - **4-Tier Hierarchical Multi-Model Architecture:** Orchestrates an intelligent cascade of specialized models to isolate cognitive loads and minimize token burn. - **Tier 1 (Orchestrator):** Strategic product alignment, setup (`/conductor:setup`), and track initialization (`/conductor:newTrack`) using `gemini-3.1-pro-preview`. - - **Tier 2 (Tech Lead):** Technical oversight and track execution (`/conductor:implement`) using `gemini-2.5-flash`. Maintains persistent context throughout implementation. - - **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. + - **Tier 2 (Tech Lead):** Technical oversight and track execution (`/conductor:implement`) using `gemini-3-flash-preview`. Maintains persistent context throughout implementation. + - **Tier 3 (Worker):** Surgical code implementation and TDD using `gemini-2.5-flash-lite`. Operates statelessly with tool access and dependency skeletons. + - **Tier 4 (QA):** Error analysis and diagnostics using `gemini-2.5-flash-lite`. Operates statelessly with tool access. - **MMA Delegation Engine:** 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. - **MMA Observability Dashboard:** A high-density control center within the GUI for monitoring and managing the 4-Tier architecture. - **Track Browser:** Real-time visualization of all implementation tracks with status indicators and progress bars. Includes a dedicated **Active Track Summary** featuring a color-coded progress bar, precise ticket status breakdown (Completed, In Progress, Blocked, Todo), and dynamic **ETA estimation** based on historical completion times. diff --git a/conductor/tech-stack.md b/conductor/tech-stack.md index 3263bd5..551e258 100644 --- a/conductor/tech-stack.md +++ b/conductor/tech-stack.md @@ -22,7 +22,8 @@ - **DeepSeek (Dedicated SDK):** Integrated for high-performance codegen and reasoning (Phase 2). - **Gemini CLI:** Integrated as a headless backend provider, utilizing a custom subprocess adapter and bridge script for tool execution control. Achieves full functional parity with direct SDK usage, including real-time token counting and detailed subprocess observability. - **Gemini 3.1 Pro Preview:** Tier 1 Orchestrator model for complex reasoning. -- **Gemini 2.5 Flash:** High-performance, low-latency model for Tier 2 Tech Lead, Tier 3 Workers, and Tier 4 QA. +- **Gemini 3-Flash Preview:** High-reasoning low-latency model for Tier 2 Tech Lead. +- **Gemini 2.5 Flash Lite:** Ultra-low-cost, high-speed model for Tier 3 Workers and Tier 4 QA. - **DeepSeek-V3:** Tier 3 Worker model optimized for code implementation. - **DeepSeek-R1:** Specialized reasoning model for complex logical chains and "thinking" traces. @@ -40,7 +41,7 @@ - **src/tool_presets.py:** Extends `ToolPresetManager` to handle nested `Tool` models, weights, and global `BiasProfile` persistence within `tool_presets.toml`. -- **src/mcp_client.py (External Extension):** Implements the `ExternalMCPManager` for orchestrating third-party Model Context Protocol servers. +- **src/mcp_client.py:** Implements the native tool registry and the `ExternalMCPManager` for orchestrating third-party Model Context Protocol servers. Provides dynamic tool discovery and validation. - **StdioMCPServer:** Manages local MCP servers via asynchronous subprocess pipes (stdin/stdout/stderr). - **RemoteMCPServer (SSE):** Provides a foundation for remote MCP integration via Server-Sent Events. - **JSON-RPC 2.0 Engine:** Handles asynchronous message routing, request/response matching, and error handling for all external MCP communication.