สถาปัตยกรรม

แผนที่ระบบ เส้นทาง config โครงสร้าง ψ และบทบาทของ repo หลัก

2.1 แผนที่สถาปัตยกรรม

Oracle แยกเป็นหลายชั้นเพื่อให้ระบบตรวจสอบง่ายและไม่ผูกกับ UI หรือ agent ตัวเดียว แผนภาพนี้ย่อจาก เอกสารสถาปัตยกรรมต้นน้ำจาก อาจารย์ Nat ให้เห็นทางเดินหลักของข้อมูล

2.2 Skills table

Skill คือ workflow ที่ agent เรียกใช้ได้ซ้ำ ส่วน plugin คือความสามารถที่ระบบ maw โหลดได้หลาย surface เช่น CLI, API, peer transport หรือ cron

กลุ่ม	ตัวอย่าง	หน้าที่	เก็บที่ไหน
Session awareness	`recap`, `where-we-are`	สรุปบริบทก่อนเริ่มงาน	skill folder ของ agent
Codebase discovery	`learn`, `trace`, `dig`	อ่าน repo ค้นประวัติ และเก็บหลักฐาน	skills + Oracle memory
Memory capture	`rrr`, `forward`, `inbox`	บันทึกบทเรียนและส่งต่อ session ถัดไป	`psi` และ `oracle.db`
Maw lifecycle	`wake`, `sleep`, `stop`, `done`	คุม agent pane และสถานะงาน	`maw-core-plugins`
Plugin migration	`maw-learn`, `maw-project`	ย้าย workflow จาก skill ไปเป็น runtime plugin	`~/.maw/plugins`

2.3 โครงสร้าง ψ

ψ/
├── inbox/          # handoff, ข้อความเข้า
│   └── handoff/
├── memory/
│   ├── learnings/       # บทเรียนที่เรียนรู้
│   ├── retrospectives/  # สรุป session
│   └── resonance/       # ตัวตน, หลักการ
├── writing/        # ร่าง
├── learn/          # repo ที่ clone มาศึกษา
├── archive/        # งานเสร็จแล้ว
├── outbox/         # ข้อความออก
└── metrics/        # telemetry data

โครงสร้างนี้ตั้งใจให้คนอ่านได้ด้วยตา ไม่ใช่ข้อมูลลับในกล่องดำ ถ้า search แปลกหรือ UI แสดงผลผิด ให้เปิดไฟล์ใน ψ ตรวจสอบได้ทันที

หมายเหตุ: โครงสร้าง ψ อาจต่างกันในแต่ละ Oracle — default จากต้นน้ำของอาจารย์ Nat สร้างจาก /awaken

2.4 Config map

ORACLE_DATA_DIRตัวชี้ data store หลัก เช่น ~/.oracle มี oracle.db, feed.log, lancedb/ และเนื้อหา psi

ORACLE_DB_PATHoverride path ของ SQLite เมื่อไม่ต้องการใช้ค่า default ใต้ data dir

ORACLE_REPO_ROOTroot ที่ MCP ใช้อ่านเขียน learning, inbox, trace และ handoff

ORACLE_PORTport ของ HTTP API ค่า default จากต้นน้ำของอาจารย์ Nat คือ 47778

MAW_HOMEแยก instance ของ maw เช่น config, plugin และ UI dist

MAW_CONFIG_DIRตำแหน่ง maw.config.json และ fleet config ใต้ fleet/*.json

MAW_PORTport ของ maw serve ค่า default คือ 3456

MAW_PLUGIN_HOMEตำแหน่ง runtime plugin packages เช่น ~/.maw/plugins

2.5 กฎจำง่าย

MCP สำหรับ agentCodex และ Claude เรียกเครื่องมือผ่าน stdio MCP เพื่อ search, learn, trace และ handoff

HTTP สำหรับ UIStudio, Vector, Feed, Forum และ UI bridge อ่านข้อมูลผ่าน endpoint เช่น /api/search และ /api/stats

maw สำหรับทีมงาน orchestration ใช้ tmux, fleet config, API, websocket และ plugin runtime

books เป็น consumerหนังสือและ guide ใช้อธิบายระบบ ไม่ใช่ runtime dependency ที่ต้องติดตั้งก่อน