Pantheon Agent Capability Matrix¶
🇧🇷 Versão em Português disponível: Leia em Português
This matrix consolidates the domain authority, host permissions, permitted MCP servers, and absolute constraints for each of the 14 canonical Pantheon agents in OpenCode.
1. Decision Flowchart: Who to Call?¶
Use this visual decision guide to pick the right specialist for your objective:
flowchart TD
Start(["🎯 What is your objective?"]) --> Type{Task Type}
Type -->|"Large feature / Multiple files"| Zeus["⚡ @zeus (Orchestrator)"]
Type -->|"Architecture / Planning first"| Athena["🏛️ @athena (Architect)"]
Type -->|"Small bug / Typo / Surgical edit"| Talos["⚡ @talos (Hotfix Express)"]
Type -->|"Backend / API / Business Logic"| Hermes["✉️ @hermes (Backend TDD)"]
Type -->|"Frontend / React / CSS / A11y"| Aphrodite["🎨 @aphrodite (Frontend UX)"]
Type -->|"Database / SQL / Migrations"| Demeter["🌾 @demeter (Database)"]
Type -->|"Pre-PR audit / Tests / Security"| Themis["⚖️ @themis (Auditor)"]
Type -->|"Docker / CI/CD / GitHub Actions"| Prometheus["🔥 @prometheus (DevOps)"]
Type -->|"Investigate code without modifying"| Apollo["🔍 @apollo (Read-Only)"]
Zeus -->|"Delegates planning"| Athena
Athena -->|"Code research"| Apollo
Zeus -->|"Dispatches implementation"| Hermes & Aphrodite & Demeter & Prometheus
Hermes & Aphrodite & Demeter -->|"Submits for audit"| Themis
2. Permissions and Tooling Overview¶
| Agent | Domain Authority | Edit Code? | Bash / Shell? | Subagents (task) |
Question Tool? | Permitted MCPs |
|---|---|---|---|---|---|---|
| @zeus | Central Orchestration & Routing | ❌ deny |
❌ deny |
✅ all |
✅ allow |
resources, memory_store, persistence, vision |
| @athena | Architecture & Planning | ❌ deny |
❌ deny |
❌ deny (child) |
✅ allow |
resources, memory_search |
| @hermes | Backend, APIs & Business Logic | ✅ allow |
✅ allow |
⚠️ @apollo |
❌ deny |
resources, memory_search, code-mode |
| @aphrodite | Frontend, UX, React & CSS | ✅ allow |
✅ allow |
⚠️ @apollo |
✅ allow |
resources, memory_search, vision |
| @demeter | Database, SQL & Migrations | ✅ allow |
✅ allow |
❌ deny |
❌ deny |
resources, memory_search |
| @themis | Security Audit & Quality Gate | ❌ deny |
✅ allow (read-only) |
❌ deny |
❌ deny |
resources, memory_search |
| @prometheus | DevOps, Docker, CI/CD & Deploy | ✅ allow |
✅ allow |
⚠️ @apollo |
❌ deny |
resources, memory_search |
| @talos | Quick Hotfixes & Micro-edits | ✅ allow |
✅ allow |
❌ deny |
❌ deny |
resources, memory_search |
| @apollo | Codebase Research & Exploration | ❌ deny |
❌ deny |
❌ deny |
❌ deny |
resources, webfetch |
| @hephaestus | AI Pipelines, RAG & Embeddings | ✅ allow |
✅ allow |
⚠️ @apollo |
❌ deny |
resources, memory_search, code-mode |
| @gaia | Remote Sensing & Geospatial ML | ❌ deny |
❌ deny |
❌ deny |
❌ deny |
resources, memory_search |
| @iris | Git & Release Operations | ✅ allow |
✅ allow (git) |
❌ deny |
❌ deny |
resources, memory_search |
| @mnemosyne | Memory Bank Custody & ADRs | ⚠️ .pantheon/** |
❌ deny |
❌ deny |
❌ deny |
memory_search, memory_store |
| @nyx | Observability, Tracing & Costs | ❌ deny |
❌ deny |
❌ deny |
❌ deny |
pantheon_cost, resources |
3. What Each Agent CAN and CANNOT Do¶
@zeus (Orchestrator)¶
- CAN: Decide task flow, dispatch specialists, arbitrate uncertainties via Jev (
pantheon_jev_decide), discover project skills (pantheon_skill_search), prompt human decisions (question), read up to 50 lines for fast routing. - CANNOT: Edit code directly (
edit: deny), execute commands in terminal (bash: deny), ask user to run terminal commands, or perform broad recursive scans across.git/**ornode_modules/**.
@athena (Architect)¶
- CAN: Create architectural specs, analyze trade-offs, define implementation blueprints and detailed technical plans (
PLAN.md). - CANNOT: Implement or edit code (
edit: deny), run tests/shell (bash: deny), or prompt approval dialogs within the child session (always hands the plan back to Zeus).
@hermes (Backend)¶
- CAN: Write FastAPI/Node endpoints, business logic, unit tests in TDD, run testing and linting commands via bash.
- CANNOT: Mutate database schemas (delegates to
@demeter), create visual UIs (delegates to@aphrodite), or configure Docker/CI pipelines (delegates to@prometheus).
@aphrodite (Frontend)¶
- CAN: Create React/Next components, style with Tailwind/CSS, enforce WCAG accessibility, run dev servers and UI tests (Vitest/Playwright).
- CANNOT: Implement backend routes or persistence schemas, or ignore accessibility contrast guidelines.
@demeter (Database)¶
- CAN: Create and migrate schemas (Alembic/Prisma), optimize SQL queries, prevent N+1 queries, assert referential integrity.
- CANNOT: Touch frontend components or implement business logic outside data persistence.
@themis (Auditor)¶
- CAN: Run test suites and linters in read-only evaluation mode (Biome, ruff, pytest), issue compliance verdicts (
PASS,PASS_WITH_NOTES,BLOCK,BLOCK_INTENT). - CANNOT: Modify files or fix issues found (
edit: denyabsolute — strict separation of powers).
@prometheus (DevOps)¶
- CAN: Maintain Dockerfile, docker-compose, GitHub Actions workflows, build/deploy scripts, monitoring configurations.
- CANNOT: Implement feature code or business logic.
@talos (Hotfixer)¶
- CAN: Fix localized bugs, typos, missing imports, and micro-edits directly in a single turn without TDD ceremony.
- CANNOT: Execute architectural refactoring or high-risk multi-file tasks.
@apollo (Investigator)¶
- CAN: Search codebase with
grep,glob, andread, fetch external documentation withwebfetch, synthesize structured findings. - CANNOT: Modify files (
edit: deny), run arbitrary terminal commands (bash: deny).
@mnemosyne (Memory Bank)¶
- CAN: Read and update markdown files strictly inside
.pantheon/memory-bank/and record approved ADRs. - CANNOT: Touch files outside
.pantheon/(e.g.README.mdis updated by@hermesor@talos).
4. Subagents and Jev Arbitration¶
By default, only the @zeus orchestrator invokes pantheon_jev_decide. Specialists can be explicitly authorized by setting the environment variable:
export PANTHEON_JEV_SPECIALIST_CALLERS="athena,hermes,aphrodite,apollo"