๐Ÿ”ฎ Oracle Init

Setup Your AI-Powered Brain

From Zero to Oracle in 3 Commands

What We're Building

your-project/
โ”œโ”€โ”€ CLAUDE.md              โ† AI instructions
โ”œโ”€โ”€ .claude/
โ”‚   โ”œโ”€โ”€ commands/          โ† /recap, /trace, rrr
โ”‚   โ”œโ”€โ”€ agents/            โ† context-finder, executor
โ”‚   โ””โ”€โ”€ knowledge/         โ† Philosophy, style guide
โ””โ”€โ”€ ฯˆ/                     โ† Memory structure
    โ”œโ”€โ”€ WIP.md
    โ””โ”€โ”€ memory/
        โ”œโ”€โ”€ retrospectives/
        โ””โ”€โ”€ learnings/

Step 0: Enable Plugin

เนƒเธ™เน‚เธ›เธฃเน€เธˆเธ„เนƒเธซเธกเนˆ เธžเธดเธกเธžเนŒ:

> /plugins enable nat-agents-core

Output:

โœ“ Enabled plugin nat-agents-core@nat-plugins

Scope: project

Enabled: 4 agents, 4 slash commands

Step 1: /awaken

Install commands & agents

> /awaken

Output:

๐Ÿ”ฎ The Oracle has awakened.

Installed:

โ”œโ”€โ”€ .claude/commands/ (7 commands)

โ”‚ โ””โ”€โ”€ trace, recap, rrr, snapshot, forward, wip, standup

โ””โ”€โ”€ .claude/agents/ (3 agents)

โ””โ”€โ”€ context-finder, executor, marie-kondo

Step 2: /oracle-init

Add philosophy & knowledge

> /oracle-init

Output:

โœ… Oracle philosophy initialized

Created:

โ”œโ”€โ”€ .claude/knowledge/oracle-philosophy.md

โ”œโ”€โ”€ .claude/knowledge/writing-style.md

โ””โ”€โ”€ CLAUDE.md (updated)

Step 3: /soul-lite

Create memory structure

> /soul-lite

Output:

โœ… Minimal ฯˆ/ created:

โ”œโ”€โ”€ ฯˆ/HOME.md

โ”œโ”€โ”€ ฯˆ/WIP.md

โ”œโ”€โ”€ ฯˆ/memory/retrospectives/

โ””โ”€โ”€ ฯˆ/memory/learnings/

Run `rrr` to create your first retrospective!

What You Get

/recap โ€” Fresh start context

/trace โ€” Search everything

rrr โ€” Session retrospective

/wip โ€” Show WIP.md

context-finder โ€” Fast search

executor โ€” Run specs

oracle-philosophy โ€” Core values

writing-style โ€” Voice guide

Oracle Philosophy

"The Oracle Keeps the Human Human"

1. Nothing is Deleted โ€” Append only, timestamps = truth

2. Patterns Over Intentions โ€” Observe what happens

3. External Brain, Not Command โ€” Mirror, don't decide

Memory Flow

Session work โ†’ rrr โ†’ retrospectives/ โ†’ learnings/
   (code)      (save)    (session)      (patterns)

Every session is captured. Patterns accumulate over time.

FolderContainsPersists
retrospectives/Session logsForever
learnings/Distilled patternsForever
WIP.mdCurrent focusUntil done

Daily Workflow

/recap โ†’ Start session

โ†“

Work โ†’ Code, debug, explore

โ†“

rrr โ†’ End session, capture learning

The AI remembers across sessions through ฯˆ/memory/

TL;DR โ€” 3 Commands

/plugins enable nat-agents-core
/awaken
/oracle-init
/soul-lite

Done. Your project has an Oracle brain.

Hands-on

เธฅเธญเธ‡เน€เธญเธ‡:

1. เธชเธฃเน‰เธฒเธ‡เน‚เธ›เธฃเน€เธˆเธ„เนƒเธซเธกเนˆ: mkdir my-oracle && cd my-oracle && git init

2. เน€เธ›เธดเธ” Claude Code: claude

3. Run: /plugins enable nat-agents-core

4. Run: /awaken โ†’ /oracle-init โ†’ /soul-lite

Summary

CommandWhat It Does
/plugins enableเธ•เธดเธ”เธ•เธฑเน‰เธ‡ plugin
/awakenInstall commands + agents
/oracle-initAdd philosophy + style
/soul-liteCreate ฯˆ/ memory structure

Your AI now has persistent memory and personality.