manual_slop/conductor/product.md

Product Guide: Manual Slop

Vision

To serve as an expert-level utility for personal developer use on small projects, providing full, manual control over vendor API metrics, agent capabilities, and context memory usage.

Primary Use Cases

• Full Control over Vendor APIs: Exposing detailed API metrics and configuring deep agent capabilities directly within the GUI.
• Context & Memory Management: Better visualization and management of token usage and context memory, allowing developers to optimize prompt limits manually.
• Manual "Vibe Coding" Assistant: Serving as an auxiliary, multi-provider assistant that natively interacts with the codebase via sandboxed PowerShell scripts and MCP-like file tools, emphasizing manual developer oversight and explicit confirmation.

Key Features

• 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): 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 or deepseek-v3.
  • Tier 4 (QA): Bug reproduction, test analysis, and error translation using gemini-2.5-flash-lite or deepseek-v3.
  • 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.
• In-Depth Toolset Access: MCP-like file exploration, URL fetching, search, and dynamic context aggregation embedded within a multi-viewport Dear PyGui/ImGui interface.
• Integrated Workspace: A consolidated Hub-based layout (Context, AI Settings, Discussion, Operations) designed for expert multi-monitor workflows.
• Session Analysis: Ability to load and visualize historical session logs with a dedicated tinted "Prior Session" viewing mode.
• Performance Diagnostics: Built-in telemetry for FPS, Frame Time, and CPU usage, with a dedicated Diagnostics Panel and AI API hooks for performance analysis.
• Automated UX Verification: A robust IPC mechanism via API hooks and a modular simulation suite allows for human-like simulation walkthroughs and automated regression testing of the full GUI lifecycle across multiple specialized scenarios.
• Headless Backend Service: Optional headless mode allowing the core AI and tool execution logic to run as a decoupled REST API service (FastAPI), optimized for Docker and server-side environments (e.g., Unraid).
• Remote Confirmation Protocol: A non-blocking, ID-based challenge/response mechanism for approving AI actions via the REST API, enabling remote "Human-in-the-Loop" safety.
• Gemini CLI Integration: Allows using the gemini CLI as a headless backend provider. This enables leveraging Gemini subscriptions with advanced features like persistent sessions, while maintaining full "Human-in-the-Loop" safety through a dedicated bridge for synchronous tool call approvals within the Manual Slop GUI.