# Genesis Agent Tiers - Quick Reference

**Last Updated**: 2026-02-15
**Validation Status**: ✅ All tests passing

---

## Tier Comparison Matrix

| Feature | L1 BASIC | L2 STANDARD | L3 PRO | L4 ENTERPRISE |
|---------|----------|-------------|--------|---------------|
| **Pricing** | Free/Internal | $497-697/mo | $997-1,497/mo | $5K-10K/mo |
| **Model** | Sonnet | Sonnet | Opus | Opus |
| **Capabilities** | 5 | 15 | 19 | 32 |
| **Max Turns** | 50 | 100 | 150 | 200 |
| **Daily Budget** | $1 | $5 | $10 | $50 |
| **Memory** | Session | Project | Project | Sovereign |
| **Autonomy** | Level 3 (Advisory) | Level 2 (Pre-confirm) | Level 2 (Pre-confirm) | Level 1 (Post-notify) |

---

## Core Capabilities by Tier

### L1 BASIC (5 capabilities)
- text_chat
- web_search
- file_analysis
- knowledge_base
- scheduled_tasks

### L2 STANDARD (15 capabilities = L1 + 10 new)
**Inherits all L1 capabilities plus:**
- native_voice
- persistent_memory
- owner_identity
- browser
- conductor_sync
- mcp_tools
- workflows
- concurrent_tasks
- outbound_comms
- access_gating

### L3 PRO (19 capabilities = L2 + 4 new)
**Inherits all L2 capabilities plus:**
- domain_expertise
- platform_workflows
- troubleshooting_knowledge
- best_practice_guidance

### L4 ENTERPRISE (32 capabilities = L3 + 13 new)
**Inherits all L3 capabilities plus:**
- ide_access
- cli_terminal
- sovereign_memory
- compliance
- knowledge_graph
- constitutional_guard
- budget_enforcement
- credential_broker
- skill_generation
- multi_agent
- audit_trail
- all_domain_overlays
- custom_knowledge_ingestion

---

## Tool Access by Tier

| Tool | L1 | L2 | L3 | L4 |
|------|----|----|----|----|
| Read | ✅ | ✅ | ✅ | ✅ |
| Grep | ✅ | ✅ | ✅ | ✅ |
| Glob | ✅ | ✅ | ✅ | ✅ |
| WebSearch | ✅ | ✅ | ✅ | ✅ |
| WebFetch | ❌ | ✅ | ✅ | ✅ |
| Bash | ❌ | ✅ | ✅ | ✅ |
| Edit | ❌ | ❌ | ❌ | ✅ |
| Write | ❌ | ❌ | ❌ | ✅ |
| TaskCreate | ❌ | ❌ | ❌ | ✅ |
| TaskUpdate | ❌ | ❌ | ❌ | ✅ |
| TaskList | ❌ | ❌ | ❌ | ✅ |
| TeamCreate | ❌ | ❌ | ❌ | ✅ |
| SendMessage | ❌ | ❌ | ❌ | ✅ |

---

## MCP Tools by Tier

| MCP Tool Pattern | L1 | L2 | L3 | L4 |
|-----------------|----|----|----|----|
| kg_search, kg_get | ✅ | ✅ | ✅ | ✅ |
| memory_query | ✅ | ✅ | ✅ | ✅ |
| browser_* | ❌ | ✅ | ✅ | ✅ |
| get_identity | ❌ | ✅ | ✅ | ✅ |
| memory_* (full) | ❌ | ✅ | ✅ | ✅ |
| sync_* | ❌ | ✅ | ✅ | ✅ |
| task_board_* | ❌ | ✅ | ✅ | ✅ |
| ALL | ❌ | ❌ | ❌ | ✅ |

---

## Domain Overlays

| Tier | Allowed Overlays | Cost per Additional |
|------|------------------|---------------------|
| L1 BASIC | 0 | N/A |
| L2 STANDARD | 0 | N/A |
| L3 PRO | 1 included | +$297-497/mo each |
| L4 ENTERPRISE | Unlimited | Included |

**Available Overlays:**
- GHL Mastery (10,000+ data points)
- Voice AI (Vapi, Telnyx, LiveKit)
- Telnyx (SIP, provisioning, WebRTC)
- Ponte Intelligence (business patterns)
- Tradie Snapshot (Australian trades)
- Shopify (coming soon)
- WordPress/WooCommerce (coming soon)
- HubSpot (coming soon)
- Xero/QuickBooks (coming soon)

---

## Model Stack by Tier

### L1 BASIC
- Primary: Gemini 2.0 Flash

### L2 STANDARD
- Primary: Gemini 2.0 Flash
- Voice: Gemini 2.5 Flash Native Audio
- Vision: Gemini 2.0 Flash
- Reasoning: Claude Sonnet 4

### L3 PRO
- Primary: Gemini 2.0 Flash
- Voice: Gemini 2.5 Flash Native Audio
- Vision: Gemini 2.0 Flash
- Standard Reasoning: Claude Sonnet 4
- Complex Reasoning: Claude Opus 4.5

### L4 ENTERPRISE
- Bulk/Fast: Gemini 2.0 Flash
- Voice: Gemini 2.5 Flash Native Audio
- Vision: Gemini 3 Flash Preview
- Standard Reasoning: Claude Sonnet 4
- Complex Architecture: Claude Opus 4.5

---

## Autonomy Levels

### Level 0: Full Autonomous (L4 only for low-risk ops)
Execute immediately without notification. Examples: memory read, research, axiom generation.

### Level 1: Autonomous + Post-Notification (L4 default)
Execute immediately, send summary notification. Examples: workflow triggering, GitHub issues, alerts.

### Level 2: Autonomous + Pre-Confirmation (L2, L3, L4 for risky ops)
Propose action + reasoning, wait for approval. Examples: API spending, protocol changes, production logic.

### Level 3: Advisory Only (L1, L4 for critical ops)
Research and recommend only, user handles execution. Examples: strategic pivots, high spending, legal, security.

---

## Usage Examples

### Creating a TierGate

```python
from core.tiering.tier_gate import TierGate

# Create gate for a specific tier
gate = TierGate("STANDARD")

# Check capabilities
if gate.has("native_voice"):
    print("Voice is available!")

# Check tool access
if "Edit" in gate.get_tool_access():
    print("Can edit files")

# Check tier level
if gate.at_least("STANDARD"):
    print("At or above STANDARD tier")

# Get model stack
models = gate.get_model_stack()
print(f"Primary model: {models['primary']}")
```

### Creating TierGate from Agent Definition

```python
# Parse agent definition file and create gate
gate = TierGate.from_agent_definition(".claude/agents/l2-digital-employee.md")

print(f"Tier: {gate.tier_name}")
print(f"Capabilities: {len(gate.get_all_capabilities())}")
print(f"Budget: ${gate.get_budget_limits()['daily_budget_usd']}")
```

### Checking Specific Features

```python
gate = TierGate("PRO")

# Voice available?
has_voice = gate.has("native_voice")  # True

# Multi-agent available?
has_multi_agent = gate.has("multi_agent")  # False (only L4)

# Domain overlays?
overlay_count = gate.get_domain_overlays()  # 1

# Autonomy level?
autonomy = gate.get_autonomy_level()  # 2 (pre-confirmation)
```

---

## Files

| Component | Location |
|-----------|----------|
| Tier Definitions | `/mnt/e/genesis-system/config/tier_definitions.json` |
| TierGate Runtime | `/mnt/e/genesis-system/core/tiering/tier_gate.py` |
| Config Loader | `/mnt/e/genesis-system/core/tiering/tier_config.py` |
| L1 Agent | `/mnt/e/genesis-system/.claude/agents/l1-basic.md` |
| L2 Agent | `/mnt/e/genesis-system/.claude/agents/l2-digital-employee.md` |
| L3 Agent | `/mnt/e/genesis-system/.claude/agents/l3-domain-expert.md` |
| L4 Agent | `/mnt/e/genesis-system/.claude/agents/l4-executive.md` |
| Test Suite | `/mnt/e/genesis-system/tests/test_agent_tiers.py` |
| Validation Report | `/mnt/e/genesis-system/hive/progress/L1_L4_AGENT_VALIDATION.md` |

---

## Testing

Run the full validation suite:

```bash
python3 tests/test_agent_tiers.py
```

Expected output:
```
🎉 ALL TESTS PASSED! Genesis tier system is fully operational.
```

---

## Upgrade Paths

- L1 BASIC → L2 STANDARD: Unlock voice, memory, browser
- L2 STANDARD → L3 PRO: Add domain expertise overlay
- L3 PRO → L4 ENTERPRISE: Unlock full autonomy, multi-agent, IDE access

---

**Quick Decision Tree:**

- Need just text chat + web search? → **L1 BASIC**
- Need voice + memory + browser? → **L2 STANDARD**
- Need platform expertise (GHL, Shopify, etc.)? → **L3 PRO**
- Need full autonomy + multi-agent + IDE? → **L4 ENTERPRISE**

---

**Validation Status**: ✅ 8/8 tests passing (2026-02-15)
**Production Ready**: Yes
