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.

oracle_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.

oracle_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.

oracle_reflect()

Use for: Stuck, need fresh perspective, starting day

oracle_learn

Capture new pattern or insight discovered.

oracle_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:

oracle_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

1. 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

1. 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

1. 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

Person 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