From 2e44d0ea2efc1bf432cd2066974ba82638920c98 Mon Sep 17 00:00:00 2001 From: Ed_ Date: Fri, 6 Mar 2026 17:06:34 -0500 Subject: [PATCH] docs(conductor): Synchronize docs for track 'Deep AST-Driven Context Pruning' --- conductor/product.md | 2 +- conductor/tech-stack.md | 3 +-- 2 files changed, 2 insertions(+), 3 deletions(-) diff --git a/conductor/product.md b/conductor/product.md index 79bdb79..08128ce 100644 --- a/conductor/product.md +++ b/conductor/product.md @@ -40,7 +40,7 @@ For deep implementation details when planning or implementing tracks, consult `d - **Role-Scoped Documentation:** Automated mapping of foundational documents to specific tiers to prevent token bloat and maintain high-signal context. - **Tiered Context Scoping:** Employs optimized context subsets for each tier. Tiers 1 & 2 receive strategic documents and full history, while Tier 3/4 workers receive task-specific "Focus Files" and automated AST dependency skeletons. - **Worker Spawn Interceptor:** A mandatory security gate that intercepts every sub-agent launch. Provides a GUI modal allowing the user to review, modify, or reject the worker's prompt and file context before it is sent to the API. -- **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. +- **Strict Memory Siloing:** Employs tree-sitter AST-based interface extraction (Skeleton View, Curated View, and Targeted View) and "Context Amnesia" to provide workers only with the absolute minimum context required. Features multi-level dependency traversal and AST caching to minimize re-parsing overhead and token burn. - **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. - **Parallel Multi-Agent Execution:** Executes multiple AI workers in parallel using a non-blocking execution engine and a dedicated `WorkerPool`. Features configurable concurrency limits (defaulting to 4) to optimize resource usage and prevent API rate limiting. - **Parallel Tool Execution:** Executes independent tool calls (e.g., parallel file reads) concurrently within a single agent turn using an asynchronous execution engine, significantly reducing end-to-end latency. diff --git a/conductor/tech-stack.md b/conductor/tech-stack.md index 335f8a5..129a992 100644 --- a/conductor/tech-stack.md +++ b/conductor/tech-stack.md @@ -31,8 +31,7 @@ - **src/paths.py:** Centralized module for path resolution, allowing directory paths (logs, conductor, scripts) to be configured via `config.toml` or environment variables, eliminating hardcoded filesystem dependencies. -- **ast (Standard Library):** For deterministic AST parsing and automated generation of curated "Skeleton Views" - (signatures and docstrings) to minimize context bloat for sub-agents. +- **tree-sitter / AST Parsing:** For deterministic AST parsing and automated generation of curated "Skeleton Views" and "Targeted Views" (extracting specific functions and their dependencies). Features an integrated AST cache with mtime-based invalidation to minimize re-parsing overhead. - **pydantic / dataclasses:** For defining strict state schemas (Tracks, Tickets) used in linear orchestration. - **tomli-w:** For writing TOML configuration files. - **tomllib:** For native TOML parsing (Python 3.11+).