# ADR-002: Twelve-Head (Dvādaśa) Architecture ## Status Accepted ## Context Multi-agent systems typically use 2-5 agents with fixed roles. FusionAGI needed a system that could analyze problems from many perspectives simultaneously while maintaining coherent output. ## Decision The orchestrator decomposes every query across **12 specialized heads**: | Head | Role | |------|------| | Logic | Logical reasoning and consistency | | Research | Source evaluation and synthesis | | Systems | Architecture and integration | | Strategy | Long-term planning | | Product | User experience and design | | Security | Threat analysis | | Safety | Risk observation (advisory) | | Reliability | Fault tolerance | | Cost | Resource optimization | | Data | Statistical reasoning | | DevEx | Developer experience | | Witness | Audit and observation | The Witness head is special: it observes but doesn't contribute to the consensus. ## Consequences - Comprehensive analysis from 12 angles on every query - Higher latency (12 parallel LLM calls) but better quality - The InsightBus enables cross-head learning - Each head has a unique color identity in the UI for visual distinction - The consensus mechanism must handle disagreement gracefully ## Alternatives Considered 1. **3-5 heads** — Rejected: insufficient perspective diversity 2. **Dynamic head count** — Future consideration: some queries don't need all 12 3. **Hierarchical heads** — Rejected: flat structure promotes equal consideration