# Mapping MMA to Manual Slop

This document maps the components of the `manual_slop` project to the 4-Tier Hierarchical Multi-Model Architecture.

## Tier 1: User-Facing Model (Orchestrator)
*   **`gui.py` & `gui_2.py`:** Provides the user interface for input and displays the synthesized output.
*   **`ai_client.py`:** Acts as the primary orchestrator, managing the conversation loop and determining when to call specific tools or providers.

## Tier 2: Specialized Models (Experts/Tools)
*   **`mcp_client.py`:** Provides a suite of specialized "tools" (e.g., `read_file`, `list_directory`, `search_files`) that act as domain experts for file system manipulation.
*   **`shell_runner.py`:** A specialist tool for executing PowerShell scripts to perform system-level changes.
*   **External AI Providers:** Gemini and Anthropic models are used as the "engines" behind these specialized operations.

## Tier 3: Data & Knowledge Base (Information)
*   **`aggregate.py`:** The primary mechanism for building the context sent to the AI. It retrieves file contents and metadata to ground the AI's reasoning.
*   **`manual_slop.toml`:** Stores project-specific configuration, tracked files, and discussion history.
*   **`file_cache.py`:** Optimizes data retrieval from the local file system.

## Tier 4: Monitoring & Feedback (Governance)
*   **`session_logger.py`:** Handles timestamped logging of communication history (`logs/comms_<ts>.log`) and tool calls.
*   **`performance_monitor.py`:** Tracks metrics related to execution time and resource usage.
*   **Script Archival:** Generated `.ps1` scripts are saved to `scripts/generated/` for later review and auditing.