diff --git a/conductor/product.md b/conductor/product.md index ff2eb9a..ee2f616 100644 --- a/conductor/product.md +++ b/conductor/product.md @@ -10,7 +10,13 @@ To serve as an expert-level utility for personal developer use on small projects ## Key Features - **Multi-Provider Integration:** Supports both Gemini and Anthropic with seamless switching. -- **4-Tier Hierarchical Multi-Model Architecture:** Orchestrates an intelligent cascade of specialized models (Product Manager, Tech Lead, Contributor, QA) to isolate cognitive loads and minimize token burn. +- **4-Tier Hierarchical Multi-Model Architecture:** Orchestrates an intelligent cascade of specialized models to isolate cognitive loads and minimize token burn. + - **Tier 1 (Orchestrator):** Product alignment and high-level strategy using `gemini-3.1-pro-preview`. + - **Tier 2 (Tech Lead):** Architectural design and technical planning using `gemini-3-flash-preview`. + - **Tier 3 (Worker):** Focused implementation and surgical code changes using `gemini-2.5-flash-lite`. + - **Tier 4 (QA):** Bug reproduction, test analysis, and error translation using `gemini-2.5-flash-lite`. + - **MMA Delegation Engine:** Utilizes the `mma-exec` CLI and `mma.ps1` helper to route tasks, ensuring each tier receives role-scoped context (e.g., Orchestrators get Product docs; Workers get Workflow specs). + - **Role-Scoped Documentation:** Automated mapping of foundational documents to specific tiers to prevent token bloat and maintain high-signal context. - **Strict Memory Siloing:** Employs AST-based interface extraction 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. - **Detailed History Management:** Rich discussion history with branching, timestamping, and specific git commit linkage per conversation. diff --git a/conductor/tech-stack.md b/conductor/tech-stack.md index 0337357..0cabf24 100644 --- a/conductor/tech-stack.md +++ b/conductor/tech-stack.md @@ -19,6 +19,9 @@ - **google-genai:** For Google Gemini API interaction and explicit context caching. - **anthropic:** For Anthropic Claude API interaction, supporting ephemeral prompt caching. - **Gemini CLI:** Integrated as a headless backend provider, utilizing a custom subprocess adapter and bridge script for tool execution control. +- **Gemini 3.1 Pro Preview:** Tier 1 Orchestrator model for complex reasoning. +- **Gemini 3 Flash Preview:** Tier 2 Tech Lead model for rapid architectural planning. +- **Gemini 2.5 Flash Lite:** High-performance, low-latency model for Tier 3 Workers and Tier 4 QA. ## Configuration & Tooling @@ -29,6 +32,7 @@ - **uv:** An extremely fast Python package and project manager. - **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. ## Architectural Patterns