46 lines
2.1 KiB
Markdown
46 lines
2.1 KiB
Markdown
# MMA Hierarchical Delegation: Recommended Architecture
|
|
|
|
## 1. Overview
|
|
The Multi-Model Architecture (MMA) utilizes a 4-Tier hierarchy to ensure token efficiency and structural integrity. The primary agent (Conductor) acts as the Tier 2 Tech Lead, delegating specific, stateless tasks to Tier 3 (Workers) and Tier 4 (Utility) agents.
|
|
|
|
## 2. Agent Roles & Responsibilities
|
|
|
|
### Tier 2: The Conductor (Tech Lead)
|
|
- **Role:** Orchestrator of the project lifecycle via the Conductor framework.
|
|
- **Context:** High-reasoning, long-term memory of project goals and specifications.
|
|
- **Key Tool:** `mma-orchestrator` skill (Strategy).
|
|
- **Delegation Logic:** Identifies tasks that would bloat the primary context (large code blocks, massive error traces) and spawns sub-agents.
|
|
|
|
### Tier 3: The Worker (Contributor)
|
|
- **Role:** Stateless code generator.
|
|
- **Context:** Isolated. Sees only the target file and the specific ticket.
|
|
- **Protocol:** Receives a "Worker" system prompt. Outputs clean code or diffs.
|
|
- **Invocation:** `.\scripts\run_subagent.ps1 -Role Worker -Prompt "..."`
|
|
|
|
### Tier 4: The Utility (QA/Compressor)
|
|
- **Role:** Stateless translator and summarizer.
|
|
- **Context:** Minimal. Sees only the error trace or snippet.
|
|
- **Protocol:** Receives a "QA" system prompt. Outputs compressed findings (max 50 tokens).
|
|
- **Invocation:** `.\scripts\run_subagent.ps1 -Role QA -Prompt "..."`
|
|
|
|
## 3. Invocation Protocol
|
|
|
|
### Step 1: Detection
|
|
Tier 2 detects a delegation trigger:
|
|
- Coding task > 50 lines.
|
|
- Error trace > 100 lines.
|
|
|
|
### Step 2: Spawning
|
|
Tier 2 calls the delegation script:
|
|
```powershell
|
|
.\scripts\run_subagent.ps1 -Role <Worker|QA> -Prompt "Specific instructions..."
|
|
```
|
|
|
|
### Step 3: Integration
|
|
Tier 2 receives the sub-agent's response.
|
|
- **If Worker:** Tier 2 applies the code changes (using `replace` or `write_file`) and verifies.
|
|
- **If QA:** Tier 2 uses the compressed error to inform the next fix attempt or passes it to a Worker.
|
|
|
|
## 4. System Prompt Management
|
|
The `run_subagent.ps1` script should be updated to maintain a library of role-specific system prompts, ensuring that Tier 3/4 agents remain focused and tool-free (to prevent nested complexity).
|