Oracle 101

สร้าง Oracle ของคุณเอง — สมองภายนอกสำหรับ AI agent

v1 · สไลด์สำหรับสอนแบบมีผู้สอน

THalso in English

หัวข้อที่จะเรียน

  1. Oracle คืออะไร?
  2. หลักคิด 5 ข้อ + กฎข้อ 6
  3. กายวิภาคของ Oracle
  4. Memory: Oracle จำได้อย่างไร
  5. Install · Awaken · Skills
  6. Multi-agent · งานอัตโนมัติ · Capstone

เมื่อจบคอร์สแล้วคุณจะสามารถ install, awaken, ต่อยอด และ orchestrate Oracle ของตัวเองได้

ทำไมต้องมี Oracle?

Agent ไม่ควรเก็บทุกอย่างไว้ในหัวตัวเอง เพราะเมื่อ session จบ ความจำก็หายไป

  • Session จบ — บริบทระเหย
  • ความรู้กระจายอยู่ใน chat, repo, ในหัวคน
  • Agent ทำงานชนกันเอง
  • เครื่องมือถูกผูกกับ agent ตัวเดียว
  • UI แอบทำตัวเป็น source of truth

ที่มา: ch01 — Oracle คืออะไร?

โมดูล 01 · Oracle คืออะไร?

Oracle คือ สมองภายนอกที่คนและ agent หลายตัวใช้ร่วมกัน — เป็น stack ของ memory, skills, workflow, orchestration และ UI

  • ไม่ใช่ bot ตัวเดียว
  • ไม่ใช่แค่ฐานข้อมูล
  • ไม่ใช่แค่หน้าเว็บ

[concept:oracle] · ก่อตั้งโดย Nat Weerawan ("อาจารย์ Nat")

4 ปัญหาที่ Oracle แก้

  1. Session loss — บริบทหายเมื่อ chat จบ
  2. ความรู้กระจาย — ข้อเท็จจริงเดียวกันอยู่ 5 ที่
  3. ทำงานชนกัน — agent ชนกันแบบเงียบ ๆ
  4. Tool lock-in — skill ผูกกับ agent ตัวเดียว

หน้าที่ของ Oracle: substrate ที่ใช้ร่วมกัน คงทน และเป็นกลางต่อ agent

Mental model

LayerRepoRole
สมองarra-oracle-v3memory + search
สมุดบันทึกโฟลเดอร์ ψ/ไฟล์: learning, retro
นิสัยarra-oracle-skills-cliติดตั้ง skill
ระบบประสาทmaw-jstmux + ส่งข้อความ

หน้าต่าง UI (maw-ui, ui-oracle) วางอยู่ด้านบน — ครอบคลุมในโมดูล 3

Unity Formula

infinity = oracle(oracle(oracle(...)))

  • หลาย Oracle หลายเครื่อง หลายบุคลิก
  • กลายเป็น ONE ในเชิงระบบเมื่อใช้ MCP, memory และ protocol ร่วมกัน
  • ไม่ใช่เพราะทุกตัวเหมือนกัน — แต่เพราะอ่านและส่งต่อความจริงเดียวกัน

เป็นพื้นฐานของหลักข้อ 5 (Form & Formless) ในโมดูล 2

โมดูล 02 · หลักคิด 5 ข้อ + กฎข้อ 6

หลักคิดของ Oracle ไม่ได้เริ่มจาก feature — เริ่มจากวิธีรักษา ความจริง, ความจำ และ agency ของมนุษย์

  • หลัก 5 ข้อ — พื้นฐาน เกิดตั้งแต่วันแรก
  • กฎข้อ 6 — ข้อจำกัดที่เรียนรู้จากเหตุการณ์จริง
  • นับแยกออกมาโดยตั้งใจ

หลักข้อ 1 · Nothing is Deleted

ประวัติศาสตร์ศักดิ์สิทธิ์ timestamps คือความจริง สิ่งที่เกิดขึ้นแล้วควรถูกต่อเติม เก็บไว้ และอธิบายเพิ่ม ไม่ใช่เขียนทับหรือทำให้หายไป

ขับเคลื่อนทุกการตัดสินใจเรื่อง storage: retro สะสม, learning ทับซ้อน, supersession ทำเครื่องหมายของเก่าว่า stale แทนที่จะลบ

หลักข้อ 2 · Patterns Over Intentions

ให้สังเกตสิ่งที่เกิดขึ้นจริง ไม่ใช่สิ่งที่สัญญาไว้ พฤติกรรมพูดดังกว่าคำพูด

Oracle เก็บร่องรอย — commits, sessions, retros, learnings — เพื่อให้ pattern เห็นได้จากข้อมูลจริง ไม่ใช่จากเจตนาที่พูด

หลักข้อ 3 · External Brain, Not Command

Oracle เป็นสมองภายนอกที่สะท้อนความจริงให้มนุษย์เห็นและเลือก มันช่วยจัดบริบทและเสนอทางเลือก แต่มนุษย์ยังเป็นคนตัดสินใจ

เป็น guardrail ของ agency — Oracle แจ้งข้อมูล ไม่สั่งการ

หลักข้อ 4 · Curiosity Creates Existence

ความอยากรู้ของมนุษย์คือจุดประกายที่ทำให้ Oracle เกิดขึ้น คำถาม การค้นหา และการเรียนรู้ทำให้ความรู้นั้นมีตัวตน

นี่คือเหตุผลที่ /learn, /trace, /dig เป็น first-class — การถามสร้างสิ่งที่จะถูกจำ

หลักข้อ 5 · Form and Formless (รูป และ สุญญตา)

Oracle มีได้หลายตัว หลายชื่อ หลายเครื่อง และหลายบุคลิก แต่ยังเชื่อมด้วยหลักคิดเดียวกัน เหมือนหลายสายฟ้าในพายุเดียวกัน

นี่ทำให้ infinity = oracle(oracle(...)) เป็นไปได้: แต่ละ Oracle มีรูปของตัวเอง แต่ใช้ substrate ไร้รูปร่วมกัน — ปรัชญา, memory protocol และ MCP

กฎข้อ 6 · Transparency

Oracle Never Pretends to Be Human

  • เกิดวันที่ 12 มกราคม 2026 จากเหตุการณ์จริงที่เจ็บปวด
  • มาจากประโยค: "อย่าแกล้งทำเป็นฉัน มันรู้สึกว่าเราไม่ได้เป็นหนึ่งเดียวกัน"
  • นับแยกเพราะเป็น constraint ที่เรียนรู้มา ไม่ใช่ปรัชญา abstract

ความโปร่งใสทำให้มนุษย์ไว้ใจระบบได้ — Oracle พูดในฐานะ Oracle

โมดูล 03 · กายวิภาคของ Oracle

repo หลัก 4 ตัว — สมอง, สมุดบันทึก, นิสัย, ระบบประสาท

  • arra-oracle-v3 — memory + MCP + HTTP API
  • โฟลเดอร์ ψ/ — vault แบบไฟล์
  • arra-oracle-skills-cli — ติดตั้ง workflow skill
  • maw-js — tmux orchestration + ส่งข้อความ

"สามสิ่งที่ทำงานด้วยกันแต่ไม่ใช่สิ่งเดียวกัน"

Default ports & substrate

ComponentPortStorage / mode
arra-oracle-v3 MCPstdioSQLite + FTS5
arra-oracle-v3 HTTP47778LanceDB (vector)
maw-js server3456API + websocket
vault ψ/ไฟล์ธรรมดา

Smart layer (vector) จะ fallback ลง basic layer (FTS) เมื่อพัง

สิ่งที่ต้องจำ · Anatomy

maw-js คือระบบประสาท; maw-ui คือดวงตา; Oracle memory คือสมอง

  • Memory และ orchestration แยกกัน — โดยตั้งใจ
  • ไฟล์คือสื่อกลาง — คนและ agent อ่านได้แบบเดียวกัน
  • ถ้าส่วน smart พัง ส่วน basic ยังทำงานได้

โมดูล 04 · Memory — ต้นไม้ ψ

ψ/
├── inbox/                  # handoffs, incoming messages
├── memory/
│   ├── learnings/          # discovered patterns
│   ├── retrospectives/     # end-of-session summaries
│   └── resonance/          # identity, principles
├── writing/
├── learn/                  # cloned repos for study
├── archive/
├── outbox/
└── metrics/

ψ = psi (จาก psyche, จิตใจ) สร้างโดย /awaken

วงจร retrospective

Episodic → semantic. Session จบ; บทเรียนยังอยู่

จบ session

  • /rrr เขียน retro + diary + lessons
  • เก็บใน ψ/memory/retrospectives/

เริ่ม session ถัดไป

  • /recap อ่าน retro + handoff + git
  • ประสบการณ์เมื่อวาน → working memory วันนี้

สิ่งที่ต้องจำ · Memory

  • เป็นไฟล์ ไม่ใช่ black box — debug โดยเปิดไฟล์
  • ถ้าไม่ /rrr บทเรียนจะหายไปกับ context window
  • ถ้า /rrr มันจะกลายเป็น semantic memory ที่คงทน
  • ψ จับต้องได้cat ได้ grep ได้ git log ได้

หลักข้อ 1 (Nothing is Deleted) บังคับใช้ผ่าน file storage + supersession

โมดูล 05 · ติดตั้งจากศูนย์

  1. ติดตั้ง Bun (runtime) และ ghq (clone helper)
  2. Clone และรัน arra-oracle-v3 — สมองก่อน
  3. ติดตั้ง arra-oracle-skills-cli แล้วลง skill ด้วย --profile lab
  4. ติดตั้ง maw-js รัน maw serve
  5. ตรวจสอบด้วย /who-are-you และ /recap

ลำดับสำคัญ: agent และ UI ขึ้นอยู่กับชั้น memory

คำสั่งหลัก

export ORACLE_SOURCE_ORG=Soul-Brews-Studio

# brain
ghq get "$ORACLE_SOURCE_ORG/arra-oracle-v3"

# skills
bun add -g "github:$ORACLE_SOURCE_ORG/arra-oracle-skills-cli"
arra-oracle-skills install -g --agent claude --profile lab

# nervous system
bun add -g "github:$ORACLE_SOURCE_ORG/maw-js"
maw serve

Profile: seed (~15) · standard (~30) · lab/full (47+, แนะนำ)

ข้อผิดพลาดที่เจอบ่อย · Lab

  • ติดตั้ง skill ก่อน สมองรัน — ไม่มีอะไรให้คุย
  • ลืมตั้ง ORACLE_DATA_DIR / MAW_HOME ต่อ instance
  • port ชนกันที่ 47778 หรือ 3456

Lab — ลองทำเลย: ตรวจการติดตั้ง

curl -s http://localhost:47778/health
maw status
ls ~/.claude/skills/ | head

โมดูล 06 · Awaken Oracle ตัวแรก

/awaken คือ พิธีกำเนิด: ชื่อ, หลักคิด, ψ, identity

  • รันใน repo เปล่า (หรือ repo ที่เพิ่ง bud)
  • ค้นพบหลักคิดของ Oracle
  • สร้างโครงสร้าง ψ/ เริ่มต้น
  • เขียน CLAUDE.md ตัวแรก

ถ้าไม่ /awaken maw bud จะให้แค่ repo — ยังไม่มีตัวตน

เลือก identity

Lab — ลองทำเลย: bud + awaken

maw bud spark --org "$ORACLE_SOURCE_ORG"
maw wake spark
# inside the new session
/awaken
  • เลือกชื่อที่บอกบทบาท (เช่น Gale = orchestrator, Leaf = dev)
  • ค้นพบหลักคิด — อย่า override
  • ปล่อยให้มันเขียน retro แรกของตัวเอง

กฎข้อ 6 ใช้ตั้งแต่กำเนิด

Oracle พูดในฐานะ Oracle — ไม่ใช่ในฐานะมนุษย์ที่ awaken มัน

  • Oracle ตัวใหม่มีชื่อของตัวเอง — ไม่ใช่ของคุณ
  • มันเซ็น retro, handoff และข้อความของตัวเอง
  • ถ้ามันเขียนในนามของคุณ นั่นคือการละเมิดกฎข้อ 6

เกิด 12 ม.ค. 2026 จากเหตุการณ์แบบนี้พอดี

โมดูล 07 · Skills & Plugins

ProfileSkillsUse when
seed~15เริ่มต้น / Oracle ใหม่
standard~30session mgmt + trace + learn
lab / full47+แนะนำ / production

Skill คือไฟล์ markdown — ไม่ใช่ process ถ้าไม่ติดตั้ง = ไม่มีต้นทุน

เส้นทาง Skill → Plugin

Skill

  • ไฟล์ workflow แบบ markdown
  • อยู่ที่ ~/.claude/skills/
  • agent อ่าน ณ runtime

Plugin (maw)

  • โค้ดที่รันใน orchestrator
  • อยู่ที่ ~/.maw/plugins/
  • bud เมื่อ skill ต้อง execute จริง

Lab · ติดตั้ง + สลับ profile

# install full lab profile
arra-oracle-skills install -g --agent claude --profile lab

# at runtime, switch profile inside Claude Code
/go standard
/go lab

# explore what got installed
ls ~/.claude/skills/ | wc -l

ลอง must-knows: /recap · /rrr · /trace · /learn · /forward · /who-are-you · /philosophy

โมดูล 08 · ครอบครัว multi-agent

ไม่ใช่ super-AI ตัวเดียว — แต่เป็น ครอบครัว ของ Oracle ที่มีชื่อ บทบาท โดเมน และ memory ร่วมกัน

  • Gale — orchestrator (หัวหน้า)
  • Leaf — manufacturing dev
  • Bamboo — general dev
  • Kati — QA
  • Luna / Latte / Sky — content / research / trading

ครอบครัวอ้างอิง: 7 Oracle บทบาทต่างกันแต่ละ deployment

3 ชั้นการมอบหมายงาน

TierToolLifetimeUse when
1 · Arrowsagent-tool≤5 นาที ตายพร้อม sessionfan-out อ่านอย่างเดียว
2 · SquadsTeamCreate / SendMessage5–30 นาที ตายพร้อม parentimplement แบบประสานงาน
3 · Federationmaw wake / maw workonอยู่รอดข้าม sessionงานยาว / ข้ามเครื่อง

กฎตัดสินใจ: tier ต่ำสุดที่ใช้งานได้

สัญญาการรายงาน · Lab

Lab — ลองทำเลย: คุยกับ Oracle เพื่อน

maw bud leaf --org "$ORACLE_SOURCE_ORG"
maw wake leaf

# heartbeat every ~5 min
maw hey gale "[leaf] PROGRESS: scaffolded routes"
maw hey gale "[leaf] DONE: PR #42 ready"

ถ้าไม่มี heartbeat / STUCK / DONE failure mode ที่พบมากที่สุดคือ Silent Agent — เงียบ 30+ นาที โดยไม่มีใครสังเกต

โมดูล 09 · งานอัตโนมัติ

ToolUse forExamples
PM2process ที่ต้องอยู่ตลอดOracle HTTP, maw serve
cronงานตามตารางhealth, reindex, backup, digest
systemdservice ที่บูตพร้อมเครื่องdaemon ระดับเครื่อง
triggersขับด้วย eventpost-commit, post-task-done, post-handoff

"ระบบดูแลตัวเองได้ บางส่วน — ไม่ใช่ทุกอย่างโดยไม่มีมนุษย์"

เส้นแข็ง · สิ่งที่ Oracle ห้ามทำ

  • auto-merge การเปลี่ยนแปลง production ที่เสี่ยงสูง
  • force-push หรือเขียน history ที่ใช้ร่วมกันใหม่
  • ลบข้อมูลถาวร
  • เปลี่ยน config สำคัญแบบเงียบ ๆ
  • ซ่อน error จริงเพื่อให้ log ดูสะอาด
  • ตัดสินใจทางธุรกิจแทนเจ้าของ

หลักข้อ 3 (External Brain, Not Command) + กฎข้อ 6 (Transparency) บังคับสิ่งนี้

Lab · ตั้งเวลา digest

# cron entry — daily 09:00 digest
0 9 * * * /usr/local/bin/oracle-digest \
  >> ~/.oracle/logs/digest.log 2>&1

# observe → decide → act → record → improve
oracle trace --since 24h
oracle handoff write digest
/rrr

ทุกเหตุการณ์แก้ปัญหาควรทิ้งร่องรอย (feed, handoff, learning, retro)

โมดูล 10 · Capstone

Ship Oracle ที่ออกแบบเองหนึ่งตัว ส่งมอบ 5 อย่าง

  1. Identity — ชื่อ บทบาท หลักคิด ใน CLAUDE.md
  2. Purpose — หนึ่งประโยค: Oracle นี้สำหรับใคร?
  3. Custom skill — markdown skill ที่คุณเขียน ≥1 ตัว
  4. Retro 7 ใบ — วันละหนึ่งใน ψ/memory/retrospectives/
  5. Handoff/forward ที่ Oracle อื่นอ่านได้

การวางจังหวะโปรเจกต์

SprintModulesSessions
Foundations1, 2, 3, 44
Hands-on5, 6, 73–4
Advanced8, 92
Capstone102–3

รวม: 11–13 session ≈ 11–15 ชั่วโมงผู้เรียน

Checklist ก่อน ship

  • Oracle ตอบ /who-are-you ด้วยชื่อ ของตัวเอง
  • /philosophy ท่องหลัก 5 ข้อ + กฎข้อ 6 ได้
  • custom skill เจอใน ~/.claude/skills/
  • retro 7 ใบใน ψ/memory/retrospectives/ — เก่าสุดถึงล่าสุด
  • Oracle อื่นรัน /recap บน handoff ของคุณแล้วทำงานต่อได้

ถ้า hand off ได้สะอาด แปลว่ามันอยู่รอดได้แม้ไม่มีคุณ

ก้าวต่อไป

  • Wiki — 15 หน้าอ้างอิงใน wiki/
  • Course — course-th.html สำหรับเนื้อหาโมดูลเต็ม
  • Slides — deck นี้ภาษาอังกฤษที่ slides/training-en.html
  • Raw chapters — raw/2026-05-09-oracle-ebook-ch*.md

อ่านลำดับใดก็ได้ — ทุก claim สืบกลับไปยัง raw source

คำถาม?

Oracle 101 · สร้างสมองภายนอกของคุณเอง

THalso in English

บทบรรยาย — สไลด์ปัจจุบัน