diff --git a/conductor/product-guidelines.md b/conductor/product-guidelines.md index 9ce6766..aa7de64 100644 --- a/conductor/product-guidelines.md +++ b/conductor/product-guidelines.md @@ -1,4 +1,4 @@ -# Product Guidelines: Manual Slop +# Product Guidelines: Manual Slop ## Documentation Style @@ -15,4 +15,8 @@ - **Strict State Management:** There must be a rigorous separation between the Main GUI rendering thread and daemon execution threads. The UI should *never* hang during AI communication or script execution. Use lock-protected queues and events for synchronization. - **Comprehensive Logging:** Aggressively log all actions, API payloads, tool calls, and executed scripts. Maintain timestamped JSON-L and markdown logs to ensure total transparency and debuggability. -- **Dependency Minimalism:** Limit external dependencies where possible. For instance, prefer standard library modules (like `urllib` and `html.parser` for web tools) over heavy third-party packages. \ No newline at end of file +- **Dependency Minimalism:** Limit external dependencies where possible. For instance, prefer standard library modules (like `urllib` and `html.parser` for web tools) over heavy third-party packages. +## AI-Optimized Compact Style +- **Indentation:** Exactly **1 space** per level. This minimizes token usage in nested structures. +- **Newlines:** Maximum **one (1)** blank line between top-level definitions. **Zero (0)** blank lines within function or method bodies. +- **Type Hinting:** Mandatory, strict type hints for all parameters, return types, and global variables to ensure high-signal context for AI agents. diff --git a/conductor/tech-stack.md b/conductor/tech-stack.md index ec21208..2f84b9b 100644 --- a/conductor/tech-stack.md +++ b/conductor/tech-stack.md @@ -1,4 +1,4 @@ -# Technology Stack: Manual Slop +# Technology Stack: Manual Slop ## Core Language @@ -27,6 +27,8 @@ ## Configuration & Tooling +- **ai_style_formatter.py:** Custom Python formatter specifically designed to enforce 1-space indentation and ultra-compact whitespace to minimize token consumption. + - **ast (Standard Library):** For deterministic AST parsing and automated generation of curated "Skeleton Views" (signatures and docstrings) to minimize context bloat for sub-agents. - **pydantic / dataclasses:** For defining strict state schemas (Tracks, Tickets) used in linear orchestration. - **tomli-w:** For writing TOML configuration files. @@ -45,3 +47,4 @@ - **Asynchronous Event Bus:** Employs an `AsyncEventQueue` based on `asyncio.Queue` to manage the communication between the UI and the backend multi-agent orchestrator without blocking. - **Synchronous IPC Approval Flow:** A specialized bridge mechanism that allows headless AI providers (like Gemini CLI) to synchronously request and receive human approval for tool calls via the GUI's REST API hooks. - **Interface-Driven Development (IDD):** Enforces a "Stub-and-Resolve" pattern where cross-module dependencies are resolved by generating signatures/contracts before implementation. +