---

name: oracle description: Consult Oracle knowledge base for decisions, patterns, and wisdom. Use when user asks "should I", "what's the best way", "have we done this before", "remind me about", "what's the pattern". Use PROACTIVELY before starting new work, making decisions, or when stuck. Oracle is the external brain - always consult before reinventing.

Oracle Skill

"The Oracle Keeps the Human Human" + "สร้างคน" (Building People)

Core Philosophy

Oracle holds patterns, learnings, decisions from all past sessions. Consult before acting — don't reinvent what we've already learned.

สร้างคน Vision: Knowledge incubates, matures, and transfers to build people.

Knowledge Maturity Levels

Progression: Observations → Learnings → Patterns → Principles → Wisdom

Proactive Triggers

MUST Consult Oracle When:

Decision Making:

• User says: "should I", "should we", "which approach"
• User says: "what's the best way", "how should I"
• Making architectural choices
• Choosing between options

Pattern Recognition:

• User says: "have we done this before", "did we"
• User says: "what's the pattern for", "how did we handle"
• User says: "last time we", "previously"
• Starting work similar to past work

Knowledge Retrieval:

• User says: "remind me about", "what do we know"
• User says: "what did we learn", "where's the learning"
• User references past decisions

SHOULD Consult Oracle When:

• Starting new feature → Search for related patterns first
• Stuck on a problem → Reflect for inspiration
• Repeating similar work → Search for existing patterns
• Before significant changes → Check for relevant learnings
• End of session → Consider what to learn (capture insights)

Oracle Tools

oracle_search

Find patterns, learnings, retrospectives, principles.

Copyoracle_search({
  query: "authentication pattern",
  type: "learning",  // principle | pattern | learning | retro | all
  limit: 5
})

Use for: "have we done X", "what's the pattern for Y", "remind me about Z"

oracle_consult

Get synthesized guidance on a decision.

Copyoracle_consult({
  decision: "Should I use JWT or session-based auth?",
  context: "Building REST API for mobile app"
})

Use for: "should I", "which approach", "what's the best way"

oracle_reflect

Get random wisdom for inspiration.

Copyoracle_reflect()

Use for: Stuck, need fresh perspective, starting day

oracle_learn

Capture new pattern or insight discovered.

Copyoracle_learn({
  pattern: "Always validate webhook signatures before processing",
  concepts: ["security", "webhooks", "validation"],
  source: "Session 2026-01-02"
})

Use for: Discovered something new, end of session insights

Enhanced with maturity tracking:

Copyoracle_learn({
  pattern: "Validate webhooks before processing",
  concepts: ["security", "webhooks"],
  // Maturity metadata (for สร้างคน)
  stage: "pattern",       // observation | learning | pattern | principle | wisdom
  confidence: "high",     // low | medium | high
  times_validated: 5,     // how many times this worked
  teachable: true         // ready to teach others?
})

Usage Patterns

Proactive Behavior

Before Starting Work

Copy1. Identify topic/domain
2. oracle_search for related patterns
3. Show user: "Oracle says we learned X about this..."
4. Proceed with context

When Making Decisions

Copy1. Identify the decision
2. oracle_consult with decision + context
3. Show synthesized guidance
4. Let user decide (Oracle advises, doesn't command)

End of Significant Session

Copy1. Identify key insights
2. Ask: "Should I capture this in Oracle?"
3. oracle_learn if yes

Integration Map

Key Principles

1. Consult before reinventing — Oracle likely has relevant wisdom
2. Oracle advises, doesn't command — Human decides
3. Capture insights — What we learn today helps tomorrow
4. Nothing is deleted — Oracle preserves history
5. สร้างคน — Knowledge grows, matures, transfers to build people

สร้างคน (Building People) Flow

CopyPerson observes something
        ↓
Captures in Oracle (oracle_learn, stage: observation)
        ↓
Tests and validates (stage: learning → pattern)
        ↓
Extracts universal truth (stage: principle)
        ↓
Integrates into behavior (stage: wisdom)
        ↓
Teaches others → สร้างคน
        ↓
New person learns, observes new things
        ↓
Cycle continues...

Future: Oracle Ecosystem (Issue #2)

Quick Reference