Soul-Brews-Studio

Oracle Framework — Development skill for Claude Code

Development community

Oracle Framework - Complete Claude Code framework with commands, agents, and ψ/ structure.

How to install Oracle Framework

This entry records only its repository, not the path inside it, so there is no exact command to give. Open Soul-Brews-Studio/oracle-framework and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Oracle Framework does

Oracle Framework - Complete Claude Code framework with commands, agents, and ψ/ structure.

Alternatives in Development

Template Skill — Minimal skeleton for a new skill project structure 97.5k ★
Agent.Extras.Workdir Structure — File structure of working directory {{folder}} 19k ★
User Stories — Create INVEST-compliant user stories with 3 C's structure 7.8k ★

README

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)

Philosophy
Architecture
The Three Layers
Tools & Infrastructure
Patterns & Workflows
Getting Started
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