Oracle Framework

Oracle Open Framework

"The Oracle Keeps the Human Human"

Version	2.0.0
Date	2026-01-12
Status	Complete Unified Philosophy
Origin	8 months of evolution (June 2025 - January 2026)

---

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

Principle	Meaning	Implementation
Nothing is Deleted	Append only, timestamps = truth	Git history, SQLite, trace logs
Patterns Over Intentions	Observe behavior, not promises	Retrospectives, learnings, search
External Brain, Not Command	Mirror reality, don't decide	Query systems, dashboards, no auto-actions

Origin of Principles

Each principle emerged from documented pain:

AlchemyCat (June 2025)           Oracle (Dec 2025)
─────────────────────────        ────────────────────
"Context kept getting lost"   →  Nothing is Deleted
"Never knew if satisfied"     →  Patterns Over Intentions
"Purely transa