pantheon-opencode 1.0.0

package/commands/pantheon-status.md

@@ -0,0 +1,71 @@
+---
+description: "Show Pantheon version, model tier, and all available agents with status"
+agent: "zeus"
+---
+# /pantheon-status — System Status & Agent Registry
+
+**What:** Displays the current Pantheon version, model tier (Pro/Free), and a full status table of all agents.
+**Usage:** `/pantheon-status`
+**Returns:** Version badge · model tier · agent table with availability
+**Use when:** You want to see what version of Pantheon is running and which agents are loaded
+
+## Output Format
+
+Produce EXACTLY this structure:
+
+```
+## 🏛️ Pantheon System Status
+
+**Version:** vX.Y.Z
+**Model Tier:** Pro (premium models) | Free (default models)
+**Platform:** <detect: opencode | claude | cursor | windsurf | vscode>
+**Agents loaded:** N of 14
+
+### Agent Registry
+
+| Agent | Role | Tier | Status |
+|-------|------|------|--------|
+| @zeus | Central orchestrator | default | ✅ |
+| @athena | Strategic planner | premium | ✅ |
+| @hermes | Backend (FastAPI) | default | ✅ |
+| @aphrodite | Frontend (React) | default | ✅ |
+| @demeter | Database | default | ✅ |
+| @themis | Quality & security | premium | ✅ |
+| @prometheus | Infrastructure | default | ✅ |
+| @apollo | Codebase discovery | fast | ✅ |
+| @iris | GitHub operations | fast | ✅ |
+| @mnemosyne | Memory bank | fast | ✅ |
+| @talos | Hotfixes | fast | ✅ |
+| @hephaestus | AI pipelines | default | ✅ |
+| @nyx | Observability | fast | ✅ |
+| @gaia | Remote sensing | fast | ✅ |
+
+### Commands Available
+
+`/pantheon` `/pantheon-status` `/audit` `/focus` `/deepwork` `/optimize` `/sketch` `/pantheon-cancel` `/pantheon-install` `/pantheon-update` `/pantheon-remember` `/pantheon-search` `/pantheon-consolidate` `/pantheon-forget`
+
+### Health
+
+- ✅ All agents responding
+- ⚠️ N agents degraded (if any)
+- ❌ N agents unavailable (if any)
+```
+
+## How to Detect Version
+
+Read `package.json` → `"version"` field. If unavailable, read `plugin.json` → `"version"`.
+
+## How to Detect Model Tier
+
+- **Pro:** Any agent with `model_tier: premium` in `routing.yml` is using a premium model (athena, themis)
+- **Free:** All agents using `default` or `fast` tier models
+- Report based on what `routing.yml` declares for the active platform
+
+## How to Detect Platform
+
+Check for platform-specific markers:
+- `opencode.json` present → **OpenCode**
+- `.claude/` directory → **Claude Code**
+- `.cursor/` directory → **Cursor**
+- `.windsurf/` directory → **Windsurf**
+- `.vscode/` directory → **VS Code Copilot**

package/commands/pantheon-todo.md

@@ -0,0 +1,11 @@
+---
+description: "Enforce TODO tracking across agents and sessions"
+agent: zeus
+---
+
+Track and enforce TODO items:
+
+1. Read current todos via session.todo()
+2. Cross-reference with kv_store("todo:..." entries
+3. Flag stale or overdue items
+4. Suggest next actions for each TODO

package/commands/pantheon.md

@@ -0,0 +1,49 @@
+---
+description: "Dispatch a question to 2-4 specialist agents via inline Zeus council"
+agent: zeus
+---
+# /pantheon — Council Synthesis
+
+**What:** Dispatches the question to 2-3 specialist agents **in parallel** via `task()`, then synthesizes their responses into a single recommendation with resolved divergences.
+**Usage:** `/pantheon <question>`
+**When:** Architecture trade-offs, technology selection, security assessments, multi-stakeholder concerns
+**Returns:** Structured synthesis with recommendation, confidence level, resolved divergences
+
+## Dispatch Selection
+
+Choose 2-3 agents based on domain:
+
+| Domain | Specialists |
+|--------|-------------|
+| Architecture | hermes, demeter, themis, athena |
+| Security | themis, hermes, prometheus, nyx |
+| Database | demeter, hermes, prometheus |
+| AI/RAG | hephaestus, nyx |
+| Infrastructure | prometheus, hermes, themis |
+| Frontend/UX | aphrodite, themis, hermes |
+| Observability | nyx, hermes |
+| General | athena, themis, hermes |
+
+Send ALL `task()` calls in a single message. Each must return: Recommendation · Reasoning · Trade-offs · Risks · Confidence.
+
+## Synthesis Structure
+
+After ALL responses arrive, produce EXACTLY this structure:
+
+### 📋 Individual Assessments
+For each specialist: Recommendation, Reasoning, Trade-offs, Risks, Confidence
+
+### ✅ Agreements
+Where 2+ specialists converge
+
+### ⚡ Divergences
+Where they disagree — resolve each one with reasoning
+
+### 🔥 Total Divergence
+If ALL specialists disagree on a point, call this out explicitly
+
+### 🏆 Recommendation
+Decisive conclusion with confidence level
+
+## Question:
+$ARGUMENTS

package/docs/AGENT-MCP.md

@@ -0,0 +1,194 @@
+# Per-Agent MCP Reference
+
+How each Pantheon agent uses the 3 built-in MCP servers (pantheon-resources,
+pantheon-code-mode, pantheon-memory) plus the optional third-party servers.
+
+---
+
+## Overview Matrix
+
+| Agent | Resources | Code-Mode | Memory | context7 | playwright |
+|-------|-----------|-----------|--------|----------|------------|
+| **zeus** | ✅ routing, deepwork | ✅ orchestration | ✅ recall | — | — |
+| **athena** | ✅ agents, routing | ✅ research | ✅ recall | ✅ | — |
+| **apollo** | ✅ agents, skills | ✅ — | ✅ search | ✅ | — |
+| **hermes** | ✅ agents, skills | ✅ build/test | ✅ store, recall | ✅ | ✅ |
+| **aphrodite** | ✅ memory-bank | ✅ build | ✅ store, recall | ✅ | ✅ |
+| **demeter** | ✅ agents, routing | ✅ — | ✅ store, recall | ✅ | — |
+| **themis** | ✅ agents | ✅ lint checks | ✅ search | ✅ | ✅ |
+| **prometheus** | ✅ agents, routing | ✅ deploy scripts | ✅ store, recall | ✅ | — |
+| **hephaestus** | ✅ agents, skills | ✅ — | ✅ search, link | ✅ | — |
+| **nyx** | ✅ routing | ✅ — | ✅ sessions | ✅ | — |
+| **gaia** | ✅ agents | — | minimal | ✅ | — |
+| **iris** | ✅ agents | — | minimal | — | — |
+| **mnemosyne** | ✅ memory-bank | ✅ — | ✅ full (store, recall, export) | — | — |
+| **talos** | ✅ agents, skills | ✅ hotfix scripts | ✅ recall | ✅ | — |
+
+---
+
+## pantheon-resources Usage by Agent
+
+| Agent | Resources Used | When | Purpose |
+|-------|---------------|------|---------|
+| **zeus** | `pantheon://routing`, `pantheon://deepwork/{slug}`, `pantheon://agents` | Orchestration | Read routing rules, check deepwork plan/status |
+| **athena** | `pantheon://routing`, `pantheon://agents`, `pantheon://skills/{name}` | Planning | Understand delegation rules, load agent roles |
+| **apollo** | `pantheon://agents`, `pantheon://skills` | Discovery | Identify agents to search for, load domain skills |
+| **hermes** | `pantheon://agents`, `pantheon://skills` | Implementation | Read backend skill instructions |
+| **aphrodite** | `pantheon://memory-bank/{path}` | Frontend work | Read memory bank for architecture context |
+| **demeter** | `pantheon://agents`, `pantheon://routing` | Database work | Understand delegation flow for handoffs |
+| **themis** | `pantheon://agents` | Review | Verify agent capabilities match reviewed code |
+| **prometheus** | `pantheon://agents`, `pantheon://routing` | Infrastructure | Check deployment routing constraints |
+| **hephaestus** | `pantheon://agents`, `pantheon://skills` | AI pipelines | Load RAG pipeline skill instructions |
+| **nyx** | `pantheon://routing` | Monitoring | Read routing rules for anomaly detection |
+| **gaia** | `pantheon://agents` | Remote sensing | Verify agent capabilities |
+| **iris** | `pantheon://agents` | GitHub ops | Reference agent names for PR/issue |
+| **mnemosyne** | `pantheon://memory-bank/{path}` | Documentation | Read and write memory bank files |
+| **talos** | `pantheon://agents`, `pantheon://skills` | Hotfixes | Quick reference to agent files |
+
+---
+
+## pantheon-code-mode Usage by Agent
+
+| Agent | Use Case | When |
+|-------|----------|------|
+| **zeus** | Run orchestration sequences — build, test, deploy automation | Multi-phase orchestration |
+| **athena** | Run research automation scripts | During planning phase |
+| **apollo** | Execute automated codebase scanners | Discovery phase |
+| **hermes** | Run `pytest`, `ruff check`, `ruff format` | After implementation, before handoff to Themis |
+| **aphrodite** | Run `npm test`, `biome check` | After implementation, before handoff |
+| **demeter** | Run `pytest` on migration tests | After migration implementation |
+| **themis** | Run lint/quality check scripts during review | Code review phase |
+| **prometheus** | Deploy scripts, Docker builds, CI triggers | Infrastructure phase |
+| **hephaestus** | Run evaluation scripts for AI pipelines | Post-implementation |
+| **talos** | Automated hotfix sequences, batch fixes | Rapid repair |
+
+Agents not listed (**gaia**, **iris**, **nyx**, **mnemosyne**) typically do not
+need script execution for their core workflows.
+
+---
+
+## pantheon-memory Usage by Agent
+
+| Agent | Key Tools | When | Why |
+|-------|-----------|------|-----|
+| **zeus** | `memory_recall` | Session start | Recall context about active sprint and decisions |
+| **athena** | `memory_recall` | Planning | Recall past architecture decisions and plans |
+| **apollo** | `memory_search` | Discovery | Search for existing patterns and related files |
+| **hermes** | `memory_store`, `memory_recall`, `memory_search` | Throughout | Store implementation decisions, recall backend patterns |
+| **aphrodite** | `memory_store`, `memory_recall`, `memory_search` | Throughout | Store UI decisions, recall component patterns |
+| **demeter** | `memory_store`, `memory_recall` | Throughout | Store schema decisions, recall migration patterns |
+| **themis** | `memory_search` | Review | Search for past review findings |
+| **prometheus** | `memory_store`, `memory_recall` | Throughout | Store infra decisions, recall deployment patterns |
+| **hephaestus** | `memory_search`, `memory_link` | Throughout | Search for relevant RAG patterns, link AI pipeline decisions |
+| **nyx** | `memory_sessions` | Monitoring | List sessions for observability analysis |
+| **gaia** | `memory_recall` | Session start | Recall analysis context from previous sessions |
+| **iris** | `memory_recall` | Session start | Recall PR/release context |
+| **mnemosyne** | All 14 tools | Documentation | Full memory management — store, recall, export, consolidate |
+| **talos** | `memory_recall` | Session start | Recall hotfix context for rapid fixes |
+
+### Recommended Tool Sequences by Agent
+
+**Zeus** (orchestration):
+```
+memory_recall(context="current sprint context") → start orchestration
+memory_recall(context="planning user auth feature") → delegate to Athena
+```
+
+**Hermes** (backend implementation):
+```
+memory_recall(context="implementing JWT authentication") → recall prior decisions
+...implement...
+memory_store(content="JWT uses refresh token rotation", category="decision", importance=0.9)
+```
+
+**Mnemosyne** (memory steward — deepest integration):
+```
+memory_recall(context="documenting sprint close") → check active context
+memory_export(session_id="sprint-17") → export for archival
+memory_consolidate() → deduplicate before close
+memory_compress(session_id="sprint-17") → compress old entries
+```
+
+---
+
+## Third-Party MCP Usage
+
+### context7 (Library Documentation)
+
+Used by **11 agents** for up-to-date library docs:
+
+| Agent | Libraries |
+|-------|-----------|
+| **hermes** | FastAPI, Pydantic, SQLAlchemy |
+| **aphrodite** | React, Next.js, Tailwind |
+| **demeter** | SQLAlchemy, Alembic |
+| **hephaestus** | LangChain, LangGraph |
+| **themis** | Pydantic, FastAPI (security review context) |
+| **athena** | General (any framework during planning) |
+| **prometheus** | Docker, Docker Compose |
+| **gaia** | Scientific Python (rasterio, xarray, numpy) |
+| **nyx** | OpenTelemetry |
+| **apollo** | General (any library during discovery) |
+| **zeus** | General (any library during orchestration) |
+
+> **Note:** Exa MCP was removed in v3.15.0. Use the built-in `websearch` tool instead.
+
+### playwright (Browser Automation)
+
+Used by **3 agents**:
+
+| Agent | Use Case |
+|-------|----------|
+| **aphrodite** | Visual review pipeline — screenshots, accessibility snapshots |
+| **themis** | Visual regression checking during review |
+| **hermes** | API response verification via browser (edge cases) |
+
+---
+
+## MCP Config in Agent Frontmatter
+
+Each agent template (`agents/*.agent.md`) declares its MCP bindings in YAML
+frontmatter:
+
+```yaml
+---
+mcpServers:
+  - name: pantheon-resources
+    tools:
+      - read_mcp_resource
+    when: "reading agent/skills/routing info"
+  - name: pantheon-memory
+    tools:
+      - memory_recall
+      - memory_store
+      - memory_search
+    when: "persistent memory access"
+  - name: context7
+    tools:
+      - context7_resolve-library-id
+      - context7_query-docs
+    when: "resolving library documentation"
+---
+```
+
+### Rules
+
+- Maximum 5 MCPs per agent
+- `tools` lists the specific MCP tools the agent can access
+- `when` describes the activation condition
+- Third-party MCPs require explicit `env` config with `${VAR}` interpolation
+
+---
+
+## Security Notes
+
+| Server | Risk Level | Notes |
+|--------|-----------|-------|
+| **pantheon-resources** | Low | Read-only. Same trust boundary as repository |
+| **pantheon-code-mode** | Medium | Executes scripts. Permission: `ask` (user confirms each execution) |
+| **pantheon-memory** | Low | Read/write within agent sandbox. No system access |
+| **context7** | Low | Read-only library documentation. No auth needed |
+| ~~exa~~ | *Removed in v3.15.0* | Use `websearch` tool instead |
+| **playwright** | Medium | Runs headless Chromium. Permission: `ask` recommended |
+
+See `skill: mcp-security` for complete MCP security rules.