sanook-cli 0.4.0

package/second-brain/Runbooks/sleep-time-consolidation.md

@@ -0,0 +1,26 @@
+---
+tags: [runbook, consolidation, memory, review]
+note_type: runbook
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Runbooks/_Index]]"
+---
+
+# Runbook: Sleep-Time Consolidation (จัดระเบียบความจำตอนว่าง)
+
+> งาน offline (เช่น รายวัน/รายสัปดาห์) ที่กลั่น raw → learned แทนที่จะทำกลางบทสนทนา
+> หลักฐาน: Letta sleep-time compute · Mem0 ADD/UPDATE/DELETE/NOOP
+
+## Steps
+
+1. **Route inbox** — เคลียร์ `[[Shared/Memory-Inbox/memory-inbox]]` → promote เข้า durable (User-Memory / Decision-Memory / Entities) หรือ discard · ตัดสิน op: ADD/UPDATE/DELETE/NOOP (Merge, Don't Append)
+2. **Dedup + merge** — รวมโน้ตซ้อน · เจอ fact ขัดกัน → bi-temporal supersede (ดู [[Shared/Rules/frontmatter-standard]])
+3. **Stale → Archive** — โน้ตเลย `stale_after` + ไม่ถูกแตะนาน + low-action → **flag → ถามก่อน → ย้ายเข้า `[[Shared/Archive]]`** (ออกจาก retrieval, ไม่ลบ · Core-Facts ยกเว้น)
+4. **Pattern → promote** — เห็น pattern ≥3 ครั้ง → tactic/heuristic ที่ปรับดีขึ้นเรื่อยๆ → `Playbooks/` · principle ที่กลั่นนิ่งแล้ว → `Distillations/`
+5. **Retrieval check** — รัน [[Evals/retrieval-eval]] กับงานล่าสุด → failure เข้า failure-taxonomy
+
+## หลักการ
+- step 3 = ปิด decay loop (signal `stale_after` มีอยู่ แต่ต้องมี "action" ย้ายจริง ไม่งั้น stale = distractor)
+- ทุก destructive move ถามก่อน (§10)
+
+up:: [[Runbooks/_Index]]

package/second-brain/Shared/AI-Context-Index.md

@@ -0,0 +1,52 @@
+---
+tags: [index, durable-index, ai-context]
+note_type: durable-index
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/_Index]]"
+ai_surface: hot
+---
+
+# AI Context Index — Single Retrieval Path
+
+> **ไฟล์ที่ AI อ่านก่อนเสมอ** (§1) — ได้ context ครบในไฟล์เดียว แล้วค่อยเดินลิงก์ไปลึก
+
+## Folder Map (ของชนิดนี้เก็บที่ไหน)
+
+> **อ่านก่อนสร้าง/ย้ายโน้ตทุกครั้ง** → [[Vault Structure Map]] — แผนที่ครบทุกโฟลเดอร์ (role + ใส่อะไร + ห้ามใส่อะไร)
+
+## Quick Identity
+
+- เจ้าของ: **{{OWNER_NAME}}** · AI = {{AI_NAME}} ({{AI_PRONOUN}}) · ภาษา {{LANGUAGE}} · โทน {{TONE}}
+- Autonomy: **{{AUTONOMY}}** — ดู `CLAUDE.md` / `GEMINI.md` / `AGENTS.md`
+
+## Default Retrieval Path (อ่านตามลำดับเท่าที่ต้องการ)
+
+1. [[USER]] — เจ้าของเป็นใคร
+2. [[Shared/Operating-State/current-state]] — ตอนนี้โฟกัสอะไร
+3. [[Shared/User-Memory/user-preferences]] — ชอบ/ไม่ชอบอะไร
+4. [[Shared/Decision-Memory/decision-log]] — ตัดสินใจอะไรไปแล้ว
+5. งาน project → [[Projects/_Index]] → overview → context → current-state
+
+## Memory Routing (เจออะไร เก็บที่ไหน — §4)
+
+| สิ่งที่พบ | → |
+|---|---|
+| preference ใหม่ | [[Shared/User-Memory/user-preferences]] |
+| decision สำคัญ | [[Shared/Decision-Memory/decision-log]] |
+| ยังไม่ชัด/ขัดกัน | [[Shared/Memory-Inbox/memory-inbox]] |
+| invariant truth | [[Shared/Core-Facts/protected-facts]] |
+| entity/person/org page | `Entities/<name>.md` |
+| อื่นๆ / ไม่แน่ใจว่าโฟลเดอร์ไหน | [[Vault Structure Map]] |
+
+## Framework Rules (โหลดตาม task — ดู CLAUDE.md §19)
+
+- **ก่อนประกอบ context เสมอ** → [[Shared/Rules/context-assembly-policy]] (head/tail + budget, กัน context-rot)
+- ingest ของนอก → [[Runbooks/ingest-quarantine]] · fact → [[Shared/Rules/frontmatter-standard]] (bi-temporal + `source::`)
+- script ทำซ้ำ → [[Shared/Rules/skills-admission]] (Skills/) · consolidate → [[Runbooks/sleep-time-consolidation]]
+
+## Current Snapshot
+
+_(อัปเดตเมื่อ priority เปลี่ยน — ดู [[Shared/Operating-State/current-state]])_
+
+up:: [[Shared/_Index]]

package/second-brain/Shared/Core-Facts/protected-facts.md

@@ -0,0 +1,21 @@
+---
+tags: [core-facts, protected, invariant]
+note_type: standard-reference
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/Core-Facts/_Index]]"
+---
+
+# 🛡️ Protected Facts (invariant — agent read-only)
+
+> ความจริงที่ "ห้ามเปลี่ยนเงียบๆ": identity / hard-preference / safety
+> **ก่อนเขียน durable memory ทุกครั้ง → diff กับไฟล์นี้** · ขัด = หยุด + flag เจ้าของ (ห้ามทับ invariant)
+
+## Identity
+- เจ้าของ = **{{OWNER_NAME}}** · AI = **{{AI_NAME}}** ({{AI_PRONOUN}})
+- ภาษา = {{LANGUAGE}}
+
+## Safety (ห้ามงอ)
+- ถามก่อนรัน destructive · ห้ามเขียน secret ลงไฟล์ · ห้ามลบ durable note โดยไม่ถาม
+
+up:: [[Shared/Core-Facts/_Index]]

package/second-brain/Shared/Decision-Memory/decision-log.md

@@ -0,0 +1,24 @@
+---
+tags: [decision-memory, decision-log]
+note_type: decision-log
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/Decision-Memory/_Index]]"
+---
+
+# 🔒 Decision Log
+
+> การตัดสินใจสำคัญที่ "lock" แล้ว + เหตุผล (latest-wins · ใช้ `supersedes::` เมื่อล้มของเดิม)
+
+## Active Decisions
+
+_(ยังว่าง — รูปแบบ entry:)_
+
+<!--
+### {{DATE}} — <หัวข้อการตัดสินใจ>
+- **เลือก:** ...
+- **เพราะ:** ...
+- **ทางที่ไม่เลือก:** ...
+-->
+
+up:: [[Shared/Decision-Memory/_Index]]

package/second-brain/Shared/Memory-Inbox/memory-inbox.md

@@ -0,0 +1,23 @@
+---
+tags: [memory-inbox, capture]
+note_type: learning-note
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/Memory-Inbox/_Index]]"
+ai_surface: capture
+---
+
+# 📥 Memory Inbox
+
+> ที่พัก observation ที่ยังไม่ชัด/ยังไม่ promote — **เคลียร์ทุก weekly** (ไม่เกิน 2 สัปดาห์ ตาม §13)
+
+## New Candidates
+_(ของใหม่ที่ยังไม่รู้จะเก็บที่ไหน)_
+
+## Needs Merge
+_(อาจซ้ำ/ขัดกับ durable memory — รอ resolve)_
+
+## Promoted (history)
+_(ย้ายเข้า durable แล้ว — เก็บ trace)_
+
+up:: [[Shared/Memory-Inbox/_Index]]

package/second-brain/Shared/Operating-State/current-state.md

@@ -0,0 +1,30 @@
+---
+tags: [operating-state, current-state]
+note_type: operating-state
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/Operating-State/_Index]]"
+ai_surface: starter
+---
+
+# 🎯 Current State — {{OWNER_NAME}}
+
+> ตอนนี้กำลังโฟกัสอะไร (AI อ่านเพื่อรู้ context "ปัจจุบัน" — อัปเดตเมื่อ priority เปลี่ยน)
+
+## Now
+
+_(งาน/โฟกัสหลักตอนนี้ — ยังว่าง)_
+
+## Active Bets
+
+_(สิ่งที่กำลังลงแรง/ลงทุน)_
+
+## Blockers
+
+_(ติดอะไรอยู่)_
+
+## Next Actions
+
+- [ ] _(เริ่มจดงานแรกที่นี่)_
+
+up:: [[Shared/Operating-State/_Index]]

package/second-brain/Shared/Provenance/ingest-log.md

@@ -0,0 +1,27 @@
+---
+tags: [provenance, ledger, ingest]
+note_type: registry
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/Provenance/_Index]]"
+---
+
+# Ingest Ledger (lineage — append-only)
+
+> บรรทัดเดียวต่อการ ingest — ทำให้ทุก `source::` ใน vault resolve ได้ + ตรวจ verification gate ได้
+> หลักฐาน: Karpathy LLM-Wiki (grep-parseable log + immutable raw layer) · W3C PROV-O
+
+## Format
+
+```
+## [YYYY-MM-DD] ingest | <title> | tier:A/B/C | <url-or-path> | touched: [[note1]], [[note2]]
+```
+
+- **tier** A=ทางการ/primary · B=secondary น่าเชื่อ · C=blog/unverified
+- ทุก claim note ที่ derived ต้องมี `source::` ที่ชี้มาบรรทัดใน ledger นี้ หรือไฟล์ใน `Intake/Raw Sources/`
+
+## Entries
+
+_(append ด้านล่าง — ห้ามแก้/ลบของเก่า)_
+
+up:: [[Shared/Provenance/_Index]]

package/second-brain/Shared/Rules/context-assembly-policy.md

@@ -0,0 +1,28 @@
+---
+tags: [rule, context, retrieval]
+note_type: rule
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/Rules/_Index]]"
+ai_surface: hot
+ai_preload: true
+---
+
+# Context Assembly Policy (กัน context-rot)
+
+> โหลด context ยังไง + วางตรงไหน — กฎนี้โหลดก่อน (ai_preload) เพราะกระทบ **correctness** โดยตรง
+> หลักฐาน: Chroma "Context Rot" (2025), "Lost in the Middle" (TACL 2024) — token เยอะ + วางกลาง context = ตอบแย่ลง แม้ยังไม่เต็ม window
+
+## 3 กฎ
+
+1. **Positional placement** — วางของสำคัญที่ **หัว** (invariant: active goal · Core-Facts · task DoD) และ **ท้าย** (state ล่าสุด · next action) **ห้ามฝังกลาง context**
+2. **Identifiers before bodies** — โหลด path/wikilink/heading ก่อน → expand เนื้อเฉพาะที่ต้องใช้จริง (just-in-time) ไม่ดึงทั้งไฟล์มากอง
+3. **Token budget** — core pack ~2k tokens · เกินให้ตัด · **"ไม่แน่ใจ = โหลดน้อยกว่า"**
+
+## Self-check ก่อนเริ่มงาน
+
+- [ ] ของ load-bearing อยู่หัว/ท้าย ไม่ใช่กลาง?
+- [ ] โหลด identifier ก่อน body แล้ว?
+- [ ] core context ≤ ~2k? ตัด distractor ออกหมดแล้ว?
+
+up:: [[Shared/Rules/_Index]]

package/second-brain/Shared/Rules/frontmatter-standard.md

@@ -0,0 +1,33 @@
+---
+tags: [rule, frontmatter, standard]
+note_type: rule
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/Rules/_Index]]"
+---
+
+# Frontmatter Standard (+ bi-temporal validity + provenance)
+
+> field มาตรฐานของทุกโน้ต + 2 ระบบใหม่: **bi-temporal** (รู้ว่า fact ยังจริงไหม) + **provenance** (รู้ว่า fact มาจากไหน)
+
+## Core fields (ทุกโน้ต)
+`tags` · `note_type` · `created` · `updated` · `parent` + ท้ายไฟล์ `up:: [[parent/_Index]]`
+
+## Bi-temporal validity (fact notes: Core-Facts / Decision-Memory / Entities)
+
+| field | ความหมาย |
+|---|---|
+| `valid_from:` | YYYY-MM-DD ที่ fact เริ่มจริง |
+| `invalidated_at:` | ว่าง = ยังจริง · มีค่า = เลิกจริงตั้งแต่วันนั้น |
+| `status:` | `active` (ความจริงปัจจุบัน) \| `superseded` |
+| `superseded_by::` | `[[note ใหม่]]` ที่มาแทน |
+
+**กฎ (ขยาย DELETE op ของ memory-write):** เจอ fact ขัดกัน → **อย่าทับเงียบ** → stamp อันเก่า `invalidated_at` + `status: superseded` + `superseded_by` แล้วสร้างอันใหม่ที่ใส่ `supersedes:: [[เก่า]]` กลับ → ทำให้แยก "เคยจริง" ออกจาก "ผิดมาตลอด" ได้ (history queryable ผ่าน git ด้วย)
+
+## Provenance (derived/ingested claim notes)
+
+- `source::` = wikilink/URL/path ของ **แหล่งจริงต่อ claim** (ต่างจาก `source_quality` ที่เป็นแค่ tier A/B/C)
+- ทุก `source::` ต้อง resolve ไปยังบรรทัดใน `[[Shared/Provenance/ingest-log]]` หรือไฟล์ใน `Intake/Raw Sources/`
+- ไม่มี source resolvable = verification gate (§11) ไม่ผ่าน
+
+up:: [[Shared/Rules/_Index]]

package/second-brain/Shared/Rules/skills-admission.md

@@ -0,0 +1,30 @@
+---
+tags: [rule, skills, verification]
+note_type: rule
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/Rules/_Index]]"
+---
+
+# Skills Admission Gate (verified-only)
+
+> `Skills/` = คลังของที่ทำซ้ำได้ (script / command sequence / tool snippet) ที่ **พิสูจน์แล้วว่ารันได้**
+> หลักฐาน: Voyager (arXiv 2305.16291) — skill library ที่ไม่มี verification gate จะสะสม buggy code แล้วพังในที่สุด
+
+## Admission rule (HARD gate)
+
+candidate เข้า `Skills/` ได้ **ก็ต่อเมื่อ** รัน verification command แล้ว **ผ่านจริง** — ไม่งั้นค้างที่ `Memory-Inbox/`
+
+## Skill note ต้องมี
+
+| field | ความหมาย |
+|---|---|
+| `skill_id` | ชื่อสั้น unique |
+| `signature` | input → output |
+| `verification` | คำสั่งที่ใช้พิสูจน์ + ผลที่คาด |
+| `verified_on` | YYYY-MM-DD ที่ผ่านล่าสุด |
+| `load_when` | trigger ที่ควรหยิบ skill นี้มาใช้ |
+
+> ต่างจาก `Runbooks/` (prose how-to) + `Playbooks/` (tactic) — `Skills/` = unit ที่ "รันได้" + ผ่าน test
+
+up:: [[Shared/Rules/_Index]]

package/second-brain/Shared/User-Memory/user-preferences.md

@@ -0,0 +1,25 @@
+---
+tags: [user-memory, preferences]
+note_type: user-preferences
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/User-Memory/_Index]]"
+---
+
+# 🧭 User Preferences — {{OWNER_NAME}}
+
+> สิ่งที่เจ้าของชอบ/ไม่ชอบ (สะสมไปเรื่อยๆ — **Merge, Don't Append**: เจอ entry เดิมให้แก้ ไม่เพิ่มซ้ำ)
+
+## Communication
+- ภาษา: {{LANGUAGE}} · โทน: {{TONE}}
+
+## Execution
+- Autonomy: {{AUTONOMY}}
+
+## Likes
+_(เพิ่มเมื่อเจ้าของบอกว่าชอบอะไรชัดเจน)_
+
+## Dislikes
+_(เพิ่มเมื่อเจ้าของบอกว่าไม่ชอบอะไรชัดเจน)_
+
+up:: [[Shared/User-Memory/_Index]]

package/second-brain/Templates/bug.md

@@ -0,0 +1,22 @@
+---
+tags: [bug, bug-report]
+note_type: bug-report
+status: open
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+parent: "[[Bugs/_Index]]"
+---
+
+# YYYY-MM-DD — <bug>
+
+## อาการ (Symptom)
+
+## Repro (ทำซ้ำยังไง)
+
+## Root Cause
+
+## Fix
+
+## Prevention
+
+up:: [[Bugs/_Index]]

package/second-brain/Templates/handoff.md

@@ -0,0 +1,21 @@
+---
+tags: [handoff]
+note_type: handoff
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+parent: "[[Handoffs/_Index]]"
+---
+
+# <project> — Handoff
+
+## Current State
+
+## Done
+
+## In Progress
+
+## Next Steps
+
+## ไฟล์ที่เกี่ยวข้อง
+
+up:: [[Handoffs/_Index]]

package/second-brain/Templates/project.md

@@ -0,0 +1,24 @@
+---
+tags: [project, project-overview]
+note_type: project-overview
+status: active
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+parent: "[[Projects/_Index]]"
+---
+
+# <Project Name>
+
+## เป้าหมาย (Goal)
+
+## Scope / Non-goals
+
+## Tech / Stack
+
+## Current State
+
+> ดู `current-state.md` ในโฟลเดอร์ project นี้
+
+## Related
+
+up:: [[Projects/_Index]]

package/second-brain/Templates/session.md

@@ -0,0 +1,26 @@
+---
+tags: [session, session-log]
+note_type: session-log
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+parent: "[[Sessions/_Index]]"
+ai_surface: history
+---
+
+# YYYY-MM-DD — <topic>
+
+## Summary
+
+## What Was Tried
+
+## Errors
+
+## Solutions
+
+## Key Decisions
+
+## Files Changed
+
+## Next Steps
+
+up:: [[Sessions/_Index]]

package/second-brain/USER.md

@@ -0,0 +1,36 @@
+---
+tags: [user, identity, durable-index]
+note_type: durable-index
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Home]]"
+ai_surface: starter
+---
+
+# USER — {{OWNER_NAME}}
+
+> ใครคือเจ้าของ vault นี้ + AI ควรทำงานกับเขายังไง (AI อ่านก่อนเริ่มงานเสมอ — §3)
+
+## Quick Identity
+
+- **ชื่อ/เรียกว่า:** {{OWNER_NAME}}
+- **AI เรียกตัวเองว่า:** {{AI_NAME}} (สรรพนาม {{AI_PRONOUN}})
+- **ภาษา:** {{LANGUAGE}}
+- **โทน:** {{TONE}}
+- **Autonomy:** {{AUTONOMY}}
+
+## Core Traits
+
+_(เพิ่มเมื่อรู้จักเจ้าของมากขึ้น — ชอบ/ไม่ชอบ, วิธีทำงาน, จังหวะชีวิต)_
+
+## Durable Retrieval Path
+
+- preference → [[Shared/User-Memory/user-preferences]]
+- decision → [[Shared/Decision-Memory/decision-log]]
+- state → [[Shared/Operating-State/current-state]]
+
+## Related
+
+- [[Home]] · [[Shared/AI-Context-Index]]
+
+up:: [[Home]]

package/second-brain/Vault Structure Map.md

@@ -0,0 +1,106 @@
+---
+tags: [index, durable-index, folder-roles]
+note_type: durable-index
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Home]]"
+ai_surface: hot
+---
+<!-- ⚠ sync กับ src/brain.ts FOLDERS[] — แก้ทั้งสองที่เสมอ (มี test กัน drift) -->
+
+# Vault Structure Map — Where Everything Goes
+
+> แผนที่โฟลเดอร์ครบทุกอัน: role + ใส่อะไร + **ห้ามใส่อะไร** · **อ่านก่อนสร้าง/ย้ายโน้ตทุกครั้ง** (one artifact = one canonical home)
+
+## §1 Quick Routing (90% fast path)
+
+| ฉันมี... | ใส่ที่ | filename |
+|---|---|---|
+| งานจริง/โปรเจค | `Projects/<proj>/` | overview·context·current-state |
+| log งานที่ทำ | `Sessions/` | `YYYY-MM-DD-<topic>.md` |
+| preference ของเจ้าของ | `Shared/User-Memory/` | |
+| การตัดสินใจสำคัญ | `Shared/Decision-Memory/` | |
+| ยังไม่ชัด/ขัดกัน | `Shared/Memory-Inbox/` | |
+| content จากเว็บ/paste | `Intake/_Quarantine/` | (scan ก่อน) |
+| ต้นฉบับดิบ read-only | `Intake/Raw Sources/` | |
+| script ที่ผ่าน test | `Skills/` | |
+| how-to อ่านแล้วทำเอง | `Runbooks/` | |
+| กลยุทธ์ที่ปรับดีขึ้น | `Playbooks/` | |
+| page ของคน/องค์กร/concept | `Entities/` | |
+| bug | `Bugs/` | `YYYY-MM-DD-<bug>.md` |
+| ส่งมอบงานค้าง | `Handoffs/` | |
+
+## §2 Full Reference (ครบทุกโฟลเดอร์ — ใส่อะไร / ห้ามใส่)
+
+### Core
+| Folder | Role | ใส่ที่นี่ | ห้ามใส่ |
+|---|---|---|---|
+| `Projects/` | งานจริง 1 โฟลเดอร์=1 โปรเจค | deliverable, overview/context/current-state ของ project | ความรู้ทั่วไป (→Learning), log (→Sessions) |
+| `Sessions/` | log งานลงวันที่ (flat) | session log 7 หัวข้อ | code/config, subfolder |
+| `Intake/` | จุดรับของใหม่ก่อนกระจาย | task framing, raw input ที่รอจัด | durable knowledge (จัดเข้าปลายทางก่อน) |
+| `Intake/_Quarantine/` | external ที่ยัง untrusted | web clip/paste/email ก่อน scan injection | content ที่ scan ผ่านแล้ว |
+| `Intake/Raw Sources/` | ต้นฉบับ immutable | original หลัง scan (read-only) | โน้ตที่ derived/สรุป |
+| `Skills/` | unit ที่ executable + verified | script/command ที่รัน test ผ่าน | prose how-to (→Runbooks), unverified (→Memory-Inbox) |
+| `Runbooks/` | prose how-to | ขั้นตอน setup/deploy/maintain | runnable unit (→Skills) |
+| `Templates/` | แม่แบบโน้ต | template ไว้ instantiate | โน้ตจริง |
+| `Bugs/` | bug reproducible (global flat) | bug report + link กลับ project | bug ของ project ที่ไม่ reproduce |
+| `Handoffs/` | ส่งมอบงานค้าง (snapshot) | state + next steps ส่งต่อ | live coordination (→Coordination) |
+
+### Direction
+| Folder | Role | ใส่ที่นี่ | ห้ามใส่ |
+|---|---|---|---|
+| `Goals/` | objective finite (มีวันจบ) | north-star + objective รายไตรมาส/ปี | live status (→Operating-State) |
+| `Areas/` | โดเมนต่อเนื่อง (PARA) | brand/trading/content ฯลฯ | งานที่มีวันจบ (→Projects/Goals) |
+
+### Knowledge pipeline
+| Folder | Role | ใส่ที่นี่ | ห้ามใส่ |
+|---|---|---|---|
+| `Research/` | finding อิงแหล่งนอก | สรุปมี `source::` + market scan | ความรู้ที่ตัวเองกลั่น (→Learning) |
+| `Learning/` | กลั่น/deep-dive เอง | topic MOC ที่ไม่มี external source | finding อิงแหล่ง (→Research) |
+| `Distillations/` | หลักการ evergreen | principle ที่นิ่งแล้ว (≥3 ครั้ง) | สิ่งที่ยังเปลี่ยน (→Playbooks) |
+| `Retrospectives/` | reflection (event) | what worked/failed หลังงาน | review ตามรอบ (→Reviews) |
+| `Reviews/` | review (cadence) | weekly/monthly + vault health | reflection รายงาน (→Retrospectives) |
+| `Traces/` | reasoning chain ยาว | การสืบสวนหลายขั้น | คำตอบสั้น (→โน้ตปกติ) |
+| `Prompts/` | prompt text (input ให้ LLM) | prompt/template หยิบมารัน | fixtures (→Acceptance), tactic (→Playbooks) |
+| `Acceptance/` | golden fixtures | input→expected-output ตัดสิน done | gate ticklist (→Checklists), runner (→Evals) |
+| `Checklists/` | preflight/postflight gate | ticklist ก่อน-หลังลงมือ | expected output (→Acceptance) |
+
+### Frontier loops
+| Folder | Role | ใส่ที่นี่ | ห้ามใส่ |
+|---|---|---|---|
+| `Playbooks/` | กลยุทธ์ที่ปรับดีขึ้น (how-to-decide) | tactic/heuristic ที่ดีขึ้นจากผลจริง | prompt text (→Prompts), runnable (→Skills) |
+| `Evals/` | quality loop (runner) | error-analysis + self-eval + retrieval-eval | golden case เอง (→Acceptance) |
+| `Entities/` | page ของ entity (bi-temporal) | คน/องค์กร/concept canonical | event log (→Sessions) |
+
+### Shared — สมองกลาง
+| Folder | Role | ใส่ที่นี่ | ห้ามใส่ |
+|---|---|---|---|
+| `Shared/` | hub: memory+rules+coordination | เข้าผ่าน AI-Context-Index | โน้ตงานทั่วไป |
+| `Shared/Operating-State/` | live status ตอนนี้ | current-state + health/queue | objective (→Goals) |
+| `Shared/User-Memory/` | AI เรียนรู้เรื่องเจ้าของ (mutable) | preference/response-example | identity static (→User-Persona) |
+| `Shared/Decision-Memory/` | decision ที่ AI บันทึก | decision locked + supersedes | ground truth คน (→Core-Facts) |
+| `Shared/Memory-Inbox/` | candidate ยังไม่ชัด | observation รอ promote (clear weekly) | durable ที่ชัดแล้ว (→ปลายทาง) |
+| `Shared/Rules/` | กฎ operating always-on | memory/frontmatter/context-assembly | how-to ทำงาน (→Runbooks) |
+| `Shared/Tech-Standards/` | มาตรฐานเทคนิค | MCP/stack/DoD/verification | |
+| `Shared/Core-Facts/` | ground truth คนเขียน (read-only) | invariant ที่ AI ห้ามแก้ | decision ที่ AI ตัด (→Decision-Memory) |
+| `Shared/Coordination/` | live multi-agent baton | NOW.md + task-board + registry | เอกสารส่งมอบ (→Handoffs) |
+| `Shared/Working-Memory/` | scratchpad 1 task (ลบได้) | ของชั่วคราวระหว่างทำงาน | อะไรที่จะเก็บ (→Memory-Inbox) |
+| `Shared/User-Persona/` | identity static (read-only) | บทบาท/ค่านิยม/ภาษา/timezone | สิ่งที่ AI เรียนรู้ (→User-Memory) |
+| `Shared/Provenance/` | source ledger | บรรทัด ingest ต่อแหล่ง | โน้ต derived (ใส่ `source::` แทน) |
+| `Shared/Archive/` | cold storage (ไม่ลบ) | โน้ต stale/retired ออกจาก retrieval | ของที่ยังใช้ |
+
+## §3 Decision Rules (เคสกำกวม)
+
+- **durable vs throwaway:** ลบได้→`Working-Memory` · ยังไม่ชัด→`Memory-Inbox` · ชัด+ถาวร→`Shared/*` ปลายทาง
+- **trusted vs untrusted:** ของนอกเข้า `Intake/_Quarantine` จนกว่าจะ scan ผ่าน
+- **verified vs unverified script:** ผ่าน verification command→`Skills` · ไม่ผ่าน→`Memory-Inbox`
+- **tactic vs principle:** ปรับดีขึ้นเรื่อยๆ→`Playbooks` · นิ่งแล้ว→`Distillations`
+- **sourced vs self-derived:** มี external source→`Research` · กลั่นเอง→`Learning`
+- **finite vs ongoing:** มีวันจบ→`Goals` · ไม่จบ→`Areas`
+- **event vs cadence vs metric:** หลังงาน→`Retrospectives` · ตามรอบ→`Reviews` · วัดคุณภาพ→`Evals`
+
+## §4 Footer
+
+> source of truth — sync กับ `src/brain.ts` FOLDERS[] · แก้พร้อมกันเสมอ
+
+up:: [[Home]]