⚡ Pantheon

Agent Factory for Claude Code

Scaffold sophisticated AI agent setups with a single command

Quick Start • Agents • Workflows • Memory

🎯 What is Pantheon?

Pantheon transforms how you work with Claude Code. Instead of building agent configurations from scratch, deploy production-ready AI agents—each named after a deity whose domain reflects their responsibility.

npx pantheon init

That's it. Your project now has an ecosystem of specialized agents ready to review code, write tests, fix bugs, and more.

✨ Key Features

🚀 One Command Setup

Initialize complete agent ecosystems instantly

🏛️ Mythological Design

Intuitive agents named after gods (Athena reviews, Apollo tests)

🧠 Shared Memory

SQLite-powered coordination between agents

📋 Workflow Automation

Pre-built workflows for common dev patterns

🎯 Zero Config

Opinionated defaults that just work

🛠️ Battle-Tested

Production-ready configurations

🚀 Quick Start

Initialize Pantheon

# Initialize in your project
npx pantheon init

# This creates:
# .claude/
#   agents/          ← Your agents
#   pantheon.jsonc   ← Configuration
#   memory.db        ← Shared memory

Manage Agents

# List all available agents
npx pantheon list

# Add specific agents
npx pantheon add athena apollo

# Get agent details
npx pantheon info athena

# Remove agents
npx pantheon remove athena

# Update agents to latest
npx pantheon update

🏛️ The Pantheon

Meet the gods of your codebase:

🔄 Workflows

Orchestrate agents to handle complex tasks:

Built-in Workflows

# Feature development (design → code → test → review → docs)
npx pantheon workflow run feature-development \
  --var feature_name="User Authentication"

# Bug fix (reproduce → investigate → fix → verify)
npx pantheon workflow run bug-fix \
  --var bug_description="Login fails with special chars"

# Code review (architecture + tests + performance + docs)
npx pantheon workflow run code-review \
  --var files_to_review="src/auth/**"

# Safe refactoring (analyze → plan → refactor → verify)
npx pantheon workflow run refactoring \
  --var refactor_scope="src/legacy/**"

# Release prep (test → audit → docs → package → tag)
npx pantheon workflow run release-preparation \
  --var release_version="1.2.0"

Custom Workflows

Create .claude/workflows/my-workflow.yaml:

id: my-workflow
name: My Workflow
version: 1.0.0

steps:
  - id: review
    type: agent
    agent: athena
    next: test

  - id: test
    type: agent
    agent: apollo
    next: deploy

  - id: deploy
    type: hook
    hook: ./scripts/deploy.sh

initialStep: review

🧠 Memory System

Agents share context through SQLite-powered memory:

# In agent configuration
prompt: |
  ## Memory System

  ### Your Private Memory (agent_memory)
  - `last_review_summary` - Your last review
  - `common_issues` - Patterns you've noticed

  ### Shared Memory (shared_memory)
  - `review:findings` - Share with other agents
  - `test:results` - Test outcomes
  - `bugs:found` - Discovered bugs

Agents coordinate automatically:

• Athena shares architectural insights
• Apollo publishes test results
• Artemis reads bug reports
• Hermes documents decisions

📖 Examples

Initialize with specific agents

npx pantheon init
# Interactive: Select athena, apollo, hephaestus

Quick code review

npx pantheon workflow run code-review \
  --var files_to_review="src/"

Fix and verify bug

npx pantheon workflow run bug-fix \
  --var bug_description="Memory leak in cache" \
  --var steps_to_reproduce="1. Create cache 2. Add 1000 items 3. Check memory"

Add testing to existing project

npx pantheon add apollo
# Apollo will analyze your code and suggest tests

🎨 Philosophy

Simplicity over Flexibility Opinionated, production-ready configurations over endless customization

Readability First Code should be clear and maintainable, not clever

Teams First Built for collaborative environments where consistency matters

📋 Requirements

• Node.js 22 or higher
• npm (any recent version)

🛠️ Development

# Install dependencies
npm install

# Run in development
npm run dev

# Run tests
npm test

# Coverage
npm run test:coverage

# Lint & format
npm run lint:fix

🗺️ Project Structure

pantheon/
├── .claude/
│   ├── agents/           ← Agent configurations
│   ├── workflows/        ← Workflow definitions
│   └── pantheon.jsonc    ← Project config
├── src/
│   ├── commands/         ← CLI commands
│   ├── memory/           ← Memory system
│   ├── templates/        ← Template engine
│   └── workflows/        ← Workflow engine
├── templates/
│   ├── agents/           ← Agent templates
│   ├── workflows/        ← Workflow templates
│   └── guidelines/       ← Best practices
└── tests/                ← Test suite

📚 Documentation

• Workflow System - Comprehensive workflow guide
• Workflow Quick Start - Get started with workflows
• Memory System - How agents coordinate
• Memory Patterns - Common coordination patterns
• Memory Usage - Memory best practices
• Agent Schema - Agent configuration format

🤝 Contributing

We welcome contributions! Pantheon is in active development.

📜 License

MIT © fortini

⬆ back to top

Built with wisdom from the gods ⚡