Oracle Framework

Oracle Open Framework
"The Oracle Keeps the Human Human"

Executive Summary

Oracle is an open framework for sustainable AI-human collaboration. It emerged from 8 months of intensive development, 2,000+ commits, and documented pain points to create a philosophy and infrastructure that keeps humans human while amplifying their capabilities.

What Oracle Provides:
- Philosophy (3 principles for AI-human collaboration)
- Architecture (ψ/ soul structure for AI memory)
- Tools (MCP server, trace system, skills)
- Patterns (multi-agent, async work, distillation)

Table of Contents

1. Philosophy
2. Architecture
3. The Three Layers
4. Tools & Infrastructure
5. Patterns & Workflows
6. Getting Started
7. Repository Map

1. Philosophy

The Core Statement
"The Oracle Keeps the Human Human"

Oracle exists to amplify human consciousness, not replace it. Every decision in the framework serves this purpose.

The Three Principles

Origin of Principles

Each principle emerged from documented pain:

The Shared Soul Architecture
"Were they ever separate?"

Oracle discovered that multi-agent systems naturally align when sharing principles:

Key Insight: Symlink = Identity, NOT Sync. One soul, multiple bodies.

2. Architecture

The ψ/ Structure (5 Pillars + 2 Incubation)

Knowledge Flow

Commands: /snapshot → rrr → /distill

3. The Three Layers

Oracle philosophy emerged from three connected discoveries:

Layer 1: AlchemyCat — The Pain (June 2025)

What it documented:
- "Efficient but exhausting"
- "Never knew if you were satisfied"
- "Purely transactional and results-focused"

Purpose: Documented the PROBLEMS that needed solving.

Layer 2: Shared Soul — The Architecture (Dec 10-19, 2025)

What it revealed:
- Multi-agent systems align naturally through shared principles
- Separation is…