# ils15/pantheon-legacy architecture

> Architecture diagram of the GitHub repository ils15/pantheon-legacy, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ils15/pantheon-legacy
- Repository: https://github.com/ils15/pantheon-legacy

## Overview

Pantheon is a multi-agent coding system distributed across several AI-coding platforms. The documented user workflow is to request work from Zeus, move through specialist planning and implementation, pass review and human approval gates, then deploy and record project memory. This tree mainly exposes installation, platform synchronization, MCP servers, and memory tooling; the agent and quality stages are documented in the README but their implementation files are not present here. Edges are limited to README-described flows and source-indexed imports.

Main entry points: [`scripts/vector_memory/cli.py`](https://github.com/ils15/pantheon-legacy/blob/main/scripts/vector_memory/cli.py) (Vector Memory CLI), [`scripts/install/shared.mjs`](https://github.com/ils15/pantheon-legacy/blob/main/scripts/install/shared.mjs) (Install Helpers), [`scripts/vector_memory/schema.py`](https://github.com/ils15/pantheon-legacy/blob/main/scripts/vector_memory/schema.py) (Memory Database Schema), [`scripts/install/opencode.mjs`](https://github.com/ils15/pantheon-legacy/blob/main/scripts/install/opencode.mjs) (OpenCode Adapter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Agent Workflow"]
  node_zeus{{"Zeus Orchestrator"}}
  node_planning["Planning Specialists"]
  node_implementation["Implementation Agents"]
  node_review["Quality Review"]
  node_release["Deploy and Release"]
end

subgraph group_install["Platform Installation"]
  node_cli["CLI Entry<br/>[pantheon.js]"]
  node_installer["Installer Orchestrator"]
  node_opencode["OpenCode Adapter<br/>[opencode.mjs]"]
  node_copilot["Copilot Adapter<br/>[copilot.mjs]"]
  node_shared["Install Helpers<br/>[shared.mjs]"]
  node_agentsmd["Agent Manifest Writer<br/>[agents-md.mjs]"]
  node_platformsync["Platform Synchronizer<br/>[sync-platforms.mjs]"]
  node_migration["Install Migration<br/>[migrate.mjs]"]
  node_health["Install Health Check<br/>[health-check.mjs]"]
end

subgraph group_memory["Project Memory"]
  node_memorycommands["Memory Commands"]
  node_memoryserver["Memory MCP Server"]
  node_vectorcli["Vector Memory CLI<br/>[cli.py]"]
  node_indexer["Memory Indexer<br/>[index.py]"]
  node_rebuild["Index Rebuilder<br/>[rebuild.py]"]
  node_query["Hybrid Memory Query<br/>[query.py]"]
  node_schema[("Memory Database Schema<br/>[schema.py]")]
end

subgraph group_services["MCP Services"]
  node_persistence["Persistence MCP Server"]
  node_resources["Resources MCP Server"]
  node_code_mode["Code Mode Server"]
end

node_human(("Human"))

node_human -->|"requests work"| node_zeus
node_zeus -->|"dispatches planning"| node_planning
node_planning -->|"returns findings"| node_zeus
node_zeus -->|"dispatches work"| node_implementation
node_implementation -->|"submits for review"| node_review
node_review -->|"requests approval"| node_human
node_zeus -->|"dispatches release"| node_release
node_human -.->|"runs"| node_cli
node_installer -->|"invokes adapter"| node_copilot
node_installer -->|"uses helpers"| node_shared
node_opencode -->|"uses helpers"| node_shared
node_opencode -->|"runs migrations"| node_migration
node_opencode -->|"runs checks"| node_health
node_copilot -->|"uses helpers"| node_shared
node_platformsync -->|"uses helpers"| node_shared
node_memorycommands -.->|"uses memory tools"| node_memoryserver
node_vectorcli -->|"runs indexing"| node_indexer
node_vectorcli -->|"runs rebuild"| node_rebuild
node_vectorcli -->|"runs recall"| node_query
node_vectorcli -->|"reads status"| node_schema
node_rebuild -->|"re-indexes through"| node_indexer
node_rebuild -->|"initializes database"| node_schema
node_indexer -->|"uses schema"| node_schema
node_query -->|"uses schema"| node_schema

click node_cli "https://github.com/ils15/pantheon-legacy/blob/main/packages/cli/bin/pantheon.js"
click node_installer "https://github.com/ils15/pantheon-legacy/blob/main/scripts/pantheon-install.mjs"
click node_opencode "https://github.com/ils15/pantheon-legacy/blob/main/scripts/install/opencode.mjs"
click node_copilot "https://github.com/ils15/pantheon-legacy/blob/main/scripts/install/copilot.mjs"
click node_shared "https://github.com/ils15/pantheon-legacy/blob/main/scripts/install/shared.mjs"
click node_agentsmd "https://github.com/ils15/pantheon-legacy/blob/main/scripts/install/agents-md.mjs"
click node_platformsync "https://github.com/ils15/pantheon-legacy/blob/main/scripts/sync-platforms.mjs"
click node_migration "https://github.com/ils15/pantheon-legacy/blob/main/scripts/install/migrate.mjs"
click node_health "https://github.com/ils15/pantheon-legacy/blob/main/scripts/install/health-check.mjs"
click node_memoryserver "https://github.com/ils15/pantheon-legacy/blob/main/scripts/memory_mcp_server.py"
click node_vectorcli "https://github.com/ils15/pantheon-legacy/blob/main/scripts/vector_memory/cli.py"
click node_indexer "https://github.com/ils15/pantheon-legacy/blob/main/scripts/vector_memory/index.py"
click node_rebuild "https://github.com/ils15/pantheon-legacy/blob/main/scripts/vector_memory/rebuild.py"
click node_query "https://github.com/ils15/pantheon-legacy/blob/main/scripts/vector_memory/query.py"
click node_schema "https://github.com/ils15/pantheon-legacy/blob/main/scripts/vector_memory/schema.py"
click node_persistence "https://github.com/ils15/pantheon-legacy/blob/main/scripts/mcp_persistence_server.py"
click node_resources "https://github.com/ils15/pantheon-legacy/blob/main/scripts/mcp_resources_server.py"
click node_code_mode "https://github.com/ils15/pantheon-legacy/blob/main/scripts/code_mode_server.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_zeus,node_planning,node_implementation,node_review,node_release toneBlue
class node_cli,node_installer,node_opencode,node_copilot,node_shared,node_agentsmd,node_platformsync,node_migration,node_health toneAmber
class node_memorycommands,node_memoryserver,node_vectorcli,node_indexer,node_rebuild,node_query,node_schema toneMint
class node_persistence,node_resources,node_code_mode toneRose
class node_human toneIndigo
```

## Components

### Agent Workflow

- **Zeus Orchestrator**
- **Planning Specialists**
- **Implementation Agents**
- **Quality Review**
- **Deploy and Release**

### Platform Installation

- [CLI Entry](https://github.com/ils15/pantheon-legacy/blob/main/packages/cli/bin/pantheon.js): `packages/cli/bin/pantheon.js`
- [Installer Orchestrator](https://github.com/ils15/pantheon-legacy/blob/main/scripts/pantheon-install.mjs): `scripts/pantheon-install.mjs`
- [OpenCode Adapter](https://github.com/ils15/pantheon-legacy/blob/main/scripts/install/opencode.mjs): `scripts/install/opencode.mjs`
- [Copilot Adapter](https://github.com/ils15/pantheon-legacy/blob/main/scripts/install/copilot.mjs): `scripts/install/copilot.mjs`
- [Install Helpers](https://github.com/ils15/pantheon-legacy/blob/main/scripts/install/shared.mjs): `scripts/install/shared.mjs`
- [Agent Manifest Writer](https://github.com/ils15/pantheon-legacy/blob/main/scripts/install/agents-md.mjs): `scripts/install/agents-md.mjs`
- [Platform Synchronizer](https://github.com/ils15/pantheon-legacy/blob/main/scripts/sync-platforms.mjs): `scripts/sync-platforms.mjs`
- [Install Migration](https://github.com/ils15/pantheon-legacy/blob/main/scripts/install/migrate.mjs): `scripts/install/migrate.mjs`
- [Install Health Check](https://github.com/ils15/pantheon-legacy/blob/main/scripts/install/health-check.mjs): `scripts/install/health-check.mjs`

### Project Memory

- **Memory Commands**
- [Memory MCP Server](https://github.com/ils15/pantheon-legacy/blob/main/scripts/memory_mcp_server.py): `scripts/memory_mcp_server.py`
- [Vector Memory CLI](https://github.com/ils15/pantheon-legacy/blob/main/scripts/vector_memory/cli.py): `scripts/vector_memory/cli.py`
- [Memory Indexer](https://github.com/ils15/pantheon-legacy/blob/main/scripts/vector_memory/index.py): `scripts/vector_memory/index.py`
- [Index Rebuilder](https://github.com/ils15/pantheon-legacy/blob/main/scripts/vector_memory/rebuild.py): `scripts/vector_memory/rebuild.py`
- [Hybrid Memory Query](https://github.com/ils15/pantheon-legacy/blob/main/scripts/vector_memory/query.py): `scripts/vector_memory/query.py`
- [Memory Database Schema](https://github.com/ils15/pantheon-legacy/blob/main/scripts/vector_memory/schema.py): `scripts/vector_memory/schema.py`

### MCP Services

- [Persistence MCP Server](https://github.com/ils15/pantheon-legacy/blob/main/scripts/mcp_persistence_server.py): `scripts/mcp_persistence_server.py`
- [Resources MCP Server](https://github.com/ils15/pantheon-legacy/blob/main/scripts/mcp_resources_server.py): `scripts/mcp_resources_server.py`
- [Code Mode Server](https://github.com/ils15/pantheon-legacy/blob/main/scripts/code_mode_server.py): `scripts/code_mode_server.py`

### Other components

- **Human**

## Connections

- Human → Zeus Orchestrator: requests work
- Zeus Orchestrator → Planning Specialists: dispatches planning
- Planning Specialists → Zeus Orchestrator: returns findings
- Zeus Orchestrator → Implementation Agents: dispatches work
- Implementation Agents → Quality Review: submits for review
- Quality Review → Human: requests approval
- Zeus Orchestrator → Deploy and Release: dispatches release
- Human → CLI Entry: runs
- Installer Orchestrator → Copilot Adapter: invokes adapter (evidence: `scripts/pantheon-install.mjs`)
- Installer Orchestrator → Install Helpers: uses helpers (evidence: `scripts/pantheon-install.mjs`)
- OpenCode Adapter → Install Helpers: uses helpers (evidence: `scripts/install/opencode.mjs`)
- OpenCode Adapter → Install Migration: runs migrations (evidence: `scripts/install/opencode.mjs`)
- OpenCode Adapter → Install Health Check: runs checks (evidence: `scripts/install/opencode.mjs`)
- Copilot Adapter → Install Helpers: uses helpers (evidence: `scripts/install/copilot.mjs`)
- Platform Synchronizer → Install Helpers: uses helpers (evidence: `scripts/sync-platforms.mjs`)
- Memory Commands → Memory MCP Server: uses memory tools
- Vector Memory CLI → Memory Indexer: runs indexing (evidence: `scripts/vector_memory/cli.py`)
- Vector Memory CLI → Index Rebuilder: runs rebuild (evidence: `scripts/vector_memory/cli.py`)
- Vector Memory CLI → Hybrid Memory Query: runs recall (evidence: `scripts/vector_memory/cli.py`)
- Vector Memory CLI → Memory Database Schema: reads status (evidence: `scripts/vector_memory/cli.py`)
- Index Rebuilder → Memory Indexer: re-indexes through (evidence: `scripts/vector_memory/rebuild.py`)
- Index Rebuilder → Memory Database Schema: initializes database (evidence: `scripts/vector_memory/rebuild.py`)
- Memory Indexer → Memory Database Schema: uses schema (evidence: `scripts/vector_memory/index.py`)
- Hybrid Memory Query → Memory Database Schema: uses schema (evidence: `scripts/vector_memory/query.py`)
