sanook-cli 0.4.0 → 0.5.1

package/second-brain/Shared/Archive/_Index.md

@@ -0,0 +1,30 @@
+---
+tags: [index, moc, archive]
+note_type: moc
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/_Index]]"
+---
+
+# Archive
+
+> cold storage (ไม่ลบ)
+
+## ใส่ที่นี่
+โน้ต stale/retired ที่ออกจาก retrieval
+
+## ไม่ใส่ที่นี่
+ของที่ยังใช้
+
+## AI Routing Contract
+
+- ก่อนเขียน: เช็กว่าเนื้อหาตรง "ใส่ที่นี่" และไม่เข้า "ไม่ใส่ที่นี่"; ถ้าก้ำกึ่งอ่าน [[Vault Structure Map]] ก่อน
+- ก่อนสร้างไฟล์ใหม่: ค้นหาโน้ตเดิมในโฟลเดอร์นี้และโฟลเดอร์ใกล้เคียงก่อน เพื่อ merge/update แทน append ซ้ำ
+- เมื่อสร้างโน้ตในโฟลเดอร์นี้: ตั้ง `parent: "[[Shared/Archive/_Index]]"` และท้ายไฟล์ `up:: [[Shared/Archive/_Index]]`
+- หลังเขียน: เชื่อม link ไป source/project/session/decision ที่เกี่ยวข้อง และอัปเดต hub/index ถ้าโน้ตนี้ควรถูกค้นเจอในอนาคต
+
+> รายละเอียดทุกโฟลเดอร์ + decision rules → [[Vault Structure Map]]
+
+_(ยังว่าง — โน้ตในโฟลเดอร์นี้จะถูกลิงก์ที่นี่)_
+
+up:: [[Shared/_Index]]

package/second-brain/Shared/Assets/_Index.md

@@ -0,0 +1,30 @@
+---
+tags: [index, moc, assets]
+note_type: moc
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/_Index]]"
+---
+
+# Assets
+
+> รูป/logo/binary ของ vault
+
+## ใส่ที่นี่
+image/logo/asset
+
+## ไม่ใส่ที่นี่
+โน้ต .md
+
+## AI Routing Contract
+
+- ก่อนเขียน: เช็กว่าเนื้อหาตรง "ใส่ที่นี่" และไม่เข้า "ไม่ใส่ที่นี่"; ถ้าก้ำกึ่งอ่าน [[Vault Structure Map]] ก่อน
+- ก่อนสร้างไฟล์ใหม่: ค้นหาโน้ตเดิมในโฟลเดอร์นี้และโฟลเดอร์ใกล้เคียงก่อน เพื่อ merge/update แทน append ซ้ำ
+- เมื่อสร้างโน้ตในโฟลเดอร์นี้: ตั้ง `parent: "[[Shared/Assets/_Index]]"` และท้ายไฟล์ `up:: [[Shared/Assets/_Index]]`
+- หลังเขียน: เชื่อม link ไป source/project/session/decision ที่เกี่ยวข้อง และอัปเดต hub/index ถ้าโน้ตนี้ควรถูกค้นเจอในอนาคต
+
+> รายละเอียดทุกโฟลเดอร์ + decision rules → [[Vault Structure Map]]
+
+_(ยังว่าง — โน้ตในโฟลเดอร์นี้จะถูกลิงก์ที่นี่)_
+
+up:: [[Shared/_Index]]

package/second-brain/Shared/Context-Packs/_Index.md

@@ -0,0 +1,30 @@
+---
+tags: [index, moc, context-packs]
+note_type: moc
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/_Index]]"
+---
+
+# Context-Packs
+
+> full-context bundle ต่อ domain/task-type
+
+## ใส่ที่นี่
+pack รวม context พร้อมโหลด
+
+## ไม่ใส่ที่นี่
+โน้ตเดี่ยว (→ปลายทางปกติ)
+
+## AI Routing Contract
+
+- ก่อนเขียน: เช็กว่าเนื้อหาตรง "ใส่ที่นี่" และไม่เข้า "ไม่ใส่ที่นี่"; ถ้าก้ำกึ่งอ่าน [[Vault Structure Map]] ก่อน
+- ก่อนสร้างไฟล์ใหม่: ค้นหาโน้ตเดิมในโฟลเดอร์นี้และโฟลเดอร์ใกล้เคียงก่อน เพื่อ merge/update แทน append ซ้ำ
+- เมื่อสร้างโน้ตในโฟลเดอร์นี้: ตั้ง `parent: "[[Shared/Context-Packs/_Index]]"` และท้ายไฟล์ `up:: [[Shared/Context-Packs/_Index]]`
+- หลังเขียน: เชื่อม link ไป source/project/session/decision ที่เกี่ยวข้อง และอัปเดต hub/index ถ้าโน้ตนี้ควรถูกค้นเจอในอนาคต
+
+> รายละเอียดทุกโฟลเดอร์ + decision rules → [[Vault Structure Map]]
+
+_(ยังว่าง — โน้ตในโฟลเดอร์นี้จะถูกลิงก์ที่นี่)_
+
+up:: [[Shared/_Index]]

package/second-brain/Shared/Context7-Docs/_Index.md

@@ -0,0 +1,30 @@
+---
+tags: [index, moc, context7-docs]
+note_type: moc
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/_Index]]"
+---
+
+# Context7-Docs
+
+> cached external lib doc (regenerable — gitignore)
+
+## ใส่ที่นี่
+cache ของ context7/lib doc
+
+## ไม่ใส่ที่นี่
+durable knowledge (→Learning/Research)
+
+## AI Routing Contract
+
+- ก่อนเขียน: เช็กว่าเนื้อหาตรง "ใส่ที่นี่" และไม่เข้า "ไม่ใส่ที่นี่"; ถ้าก้ำกึ่งอ่าน [[Vault Structure Map]] ก่อน
+- ก่อนสร้างไฟล์ใหม่: ค้นหาโน้ตเดิมในโฟลเดอร์นี้และโฟลเดอร์ใกล้เคียงก่อน เพื่อ merge/update แทน append ซ้ำ
+- เมื่อสร้างโน้ตในโฟลเดอร์นี้: ตั้ง `parent: "[[Shared/Context7-Docs/_Index]]"` และท้ายไฟล์ `up:: [[Shared/Context7-Docs/_Index]]`
+- หลังเขียน: เชื่อม link ไป source/project/session/decision ที่เกี่ยวข้อง และอัปเดต hub/index ถ้าโน้ตนี้ควรถูกค้นเจอในอนาคต
+
+> รายละเอียดทุกโฟลเดอร์ + decision rules → [[Vault Structure Map]]
+
+_(ยังว่าง — โน้ตในโฟลเดอร์นี้จะถูกลิงก์ที่นี่)_
+
+up:: [[Shared/_Index]]

package/second-brain/Shared/Coordination/NOW.md

@@ -0,0 +1,28 @@
+---
+tags: [coordination, baton, now]
+note_type: registry
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/Coordination/_Index]]"
+ai_surface: hot
+---
+
+# NOW — Multi-Agent Baton
+
+> **อ่านก่อนแตะ vault ถ้ามีหลาย agent ทำงานพร้อมกัน** — กันชนกัน (single agent ข้ามได้)
+
+## Active
+
+- **agent:** _(ใครกำลังทำ — ว่าง = ไม่มีใคร)_
+- **working on:** _(งานอะไร + ไฟล์/โฟลเดอร์ที่แตะ)_
+- **since:** _(เวลา)_
+
+## Hand-off / Next
+
+_(งานค้างส่งต่อ → รายละเอียดเต็มไป [[Handoffs/_Index]])_
+
+## Tie-break
+
+ชนกัน → ลำดับ claude < codex < gemini (ตัวหลังยอม) · เขียน session ไฟล์ unique ต่อ agent (`YYYY-MM-DD-<agent>-<topic>.md`)
+
+up:: [[Shared/Coordination/_Index]]

package/second-brain/Shared/Coordination/_Index.md

@@ -0,0 +1,30 @@
+---
+tags: [index, moc, coordination]
+note_type: moc
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/_Index]]"
+---
+
+# Coordination
+
+> live coordination ของหลาย agent พร้อมกัน
+
+## ใส่ที่นี่
+NOW.md baton + task-board + agent-registry
+
+## ไม่ใส่ที่นี่
+เอกสารส่งมอบครั้งเดียว (→Handoffs)
+
+## AI Routing Contract
+
+- ก่อนเขียน: เช็กว่าเนื้อหาตรง "ใส่ที่นี่" และไม่เข้า "ไม่ใส่ที่นี่"; ถ้าก้ำกึ่งอ่าน [[Vault Structure Map]] ก่อน
+- ก่อนสร้างไฟล์ใหม่: ค้นหาโน้ตเดิมในโฟลเดอร์นี้และโฟลเดอร์ใกล้เคียงก่อน เพื่อ merge/update แทน append ซ้ำ
+- เมื่อสร้างโน้ตในโฟลเดอร์นี้: ตั้ง `parent: "[[Shared/Coordination/_Index]]"` และท้ายไฟล์ `up:: [[Shared/Coordination/_Index]]`
+- หลังเขียน: เชื่อม link ไป source/project/session/decision ที่เกี่ยวข้อง และอัปเดต hub/index ถ้าโน้ตนี้ควรถูกค้นเจอในอนาคต
+
+> รายละเอียดทุกโฟลเดอร์ + decision rules → [[Vault Structure Map]]
+
+_(ยังว่าง — โน้ตในโฟลเดอร์นี้จะถูกลิงก์ที่นี่)_
+
+up:: [[Shared/_Index]]

package/second-brain/Shared/Coordination/agent-registry.md

@@ -0,0 +1,24 @@
+---
+tags: [coordination, agents, registry]
+note_type: registry
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/Coordination/_Index]]"
+ai_surface: hot
+---
+
+# Agent Registry
+
+> Who is allowed to touch the vault and what each agent should read first.
+
+| Agent | Reads First | Writes | Notes |
+|---|---|---|---|
+| Claude | `CLAUDE.md` + `Shared/AI-Context-Index.md` | normal vault writes | Follow local tool safety. |
+| Gemini | `GEMINI.md` + `Shared/AI-Context-Index.md` | normal vault writes | Follow COI activation rules. |
+| Codex | `AGENTS.md` + `Shared/AI-Context-Index.md` | repo and vault writes | Prefer verified changes and concise handoffs. |
+
+## Coordination Rule
+
+Before making broad vault changes, read [[Shared/Coordination/NOW]] and update [[Shared/Coordination/task-board]] if the task spans multiple sessions.
+
+up:: [[Shared/Coordination/_Index]]

package/second-brain/Shared/Coordination/task-board/_Index.md

@@ -0,0 +1,30 @@
+---
+tags: [index, moc, task-board]
+note_type: moc
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/Coordination/_Index]]"
+---
+
+# task-board
+
+> file-Kanban task cards สำหรับ multi-agent coordination
+
+## ใส่ที่นี่
+task file ต่อชิ้นงาน มี claimed_by/status/frontmatter
+
+## ไม่ใส่ที่นี่
+session narrative (→Sessions) · handoff snapshot (→Handoffs)
+
+## AI Routing Contract
+
+- ก่อนเขียน: เช็กว่าเนื้อหาตรง "ใส่ที่นี่" และไม่เข้า "ไม่ใส่ที่นี่"; ถ้าก้ำกึ่งอ่าน [[Vault Structure Map]] ก่อน
+- ก่อนสร้างไฟล์ใหม่: ค้นหาโน้ตเดิมในโฟลเดอร์นี้และโฟลเดอร์ใกล้เคียงก่อน เพื่อ merge/update แทน append ซ้ำ
+- เมื่อสร้างโน้ตในโฟลเดอร์นี้: ตั้ง `parent: "[[Shared/Coordination/task-board/_Index]]"` และท้ายไฟล์ `up:: [[Shared/Coordination/task-board/_Index]]`
+- หลังเขียน: เชื่อม link ไป source/project/session/decision ที่เกี่ยวข้อง และอัปเดต hub/index ถ้าโน้ตนี้ควรถูกค้นเจอในอนาคต
+
+> รายละเอียดทุกโฟลเดอร์ + decision rules → [[Vault Structure Map]]
+
+_(ยังว่าง — โน้ตในโฟลเดอร์นี้จะถูกลิงก์ที่นี่)_
+
+up:: [[Shared/Coordination/_Index]]

package/second-brain/Shared/Coordination/task-board/task-template.md

@@ -0,0 +1,43 @@
+---
+tags: [template, coordination, task]
+note_type: template
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/Coordination/task-board/_Index]]"
+status: todo
+claimed_by:
+priority: medium
+---
+
+# Task Template
+
+> ใช้เป็นการ์ดงานที่ claim ได้สำหรับหลาย session/หลาย agent โดยเก็บ objective, scope, owner ปัจจุบัน และ progress สั้น ๆ; narrative ยาวให้ไป Sessions/Handoffs
+
+## Objective
+
+_(What needs to be true when this task is done.)_
+
+## Scope
+
+- Files / folders:
+- Non-goals:
+
+## Claim
+
+- claimed_by:
+- claimed_at:
+- last_checked:
+
+## Progress
+
+- [ ] Read [[Shared/Coordination/NOW]]
+- [ ] Verify no other agent claimed this task
+- [ ] Do the work
+- [ ] Update links / indexes / session log
+- [ ] Mark done or hand off
+
+## Notes
+
+_(Short operational notes only. Long narrative goes to Sessions or Handoffs.)_
+
+up:: [[Shared/Coordination/task-board/_Index]]

package/second-brain/Shared/Coordination/task-board.md

@@ -0,0 +1,32 @@
+---
+tags: [coordination, task-board]
+note_type: registry
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/Coordination/_Index]]"
+ai_surface: hot
+---
+
+# Task Board
+
+> Lightweight board for multi-session or multi-agent vault work.
+
+## Active
+
+| Task | Owner | Files / Folders | Status | Next Step |
+|---|---|---|---|---|
+| _(none)_ | | | | |
+
+## Waiting
+
+| Task | Waiting On | Since |
+|---|---|---|
+| _(none)_ | | |
+
+## Done Recently
+
+| Date | Task | Link |
+|---|---|---|
+| _(none)_ | | |
+
+up:: [[Shared/Coordination/_Index]]

package/second-brain/Shared/Core-Facts/_Index.md

@@ -0,0 +1,30 @@
+---
+tags: [index, moc, core-facts]
+note_type: moc
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/_Index]]"
+---
+
+# Core-Facts
+
+> ground truth ที่เจ้าของเขียนเอง (read-only, invariant)
+
+## ใส่ที่นี่
+protected-facts ที่ AI ห้ามแก้/supersede
+
+## ไม่ใส่ที่นี่
+decision ที่ AI ตัด (→Decision-Memory)
+
+## AI Routing Contract
+
+- ก่อนเขียน: เช็กว่าเนื้อหาตรง "ใส่ที่นี่" และไม่เข้า "ไม่ใส่ที่นี่"; ถ้าก้ำกึ่งอ่าน [[Vault Structure Map]] ก่อน
+- ก่อนสร้างไฟล์ใหม่: ค้นหาโน้ตเดิมในโฟลเดอร์นี้และโฟลเดอร์ใกล้เคียงก่อน เพื่อ merge/update แทน append ซ้ำ
+- เมื่อสร้างโน้ตในโฟลเดอร์นี้: ตั้ง `parent: "[[Shared/Core-Facts/_Index]]"` และท้ายไฟล์ `up:: [[Shared/Core-Facts/_Index]]`
+- หลังเขียน: เชื่อม link ไป source/project/session/decision ที่เกี่ยวข้อง และอัปเดต hub/index ถ้าโน้ตนี้ควรถูกค้นเจอในอนาคต
+
+> รายละเอียดทุกโฟลเดอร์ + decision rules → [[Vault Structure Map]]
+
+_(ยังว่าง — โน้ตในโฟลเดอร์นี้จะถูกลิงก์ที่นี่)_
+
+up:: [[Shared/_Index]]

package/second-brain/Shared/Decision-Memory/_Index.md

@@ -0,0 +1,30 @@
+---
+tags: [index, moc, decision-memory]
+note_type: moc
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/_Index]]"
+---
+
+# Decision-Memory
+
+> การตัดสินใจที่ AI บันทึก (latest-wins + supersedes)
+
+## ใส่ที่นี่
+decision locked + เหตุผล
+
+## ไม่ใส่ที่นี่
+ground truth คน (→Core-Facts)
+
+## AI Routing Contract
+
+- ก่อนเขียน: เช็กว่าเนื้อหาตรง "ใส่ที่นี่" และไม่เข้า "ไม่ใส่ที่นี่"; ถ้าก้ำกึ่งอ่าน [[Vault Structure Map]] ก่อน
+- ก่อนสร้างไฟล์ใหม่: ค้นหาโน้ตเดิมในโฟลเดอร์นี้และโฟลเดอร์ใกล้เคียงก่อน เพื่อ merge/update แทน append ซ้ำ
+- เมื่อสร้างโน้ตในโฟลเดอร์นี้: ตั้ง `parent: "[[Shared/Decision-Memory/_Index]]"` และท้ายไฟล์ `up:: [[Shared/Decision-Memory/_Index]]`
+- หลังเขียน: เชื่อม link ไป source/project/session/decision ที่เกี่ยวข้อง และอัปเดต hub/index ถ้าโน้ตนี้ควรถูกค้นเจอในอนาคต
+
+> รายละเอียดทุกโฟลเดอร์ + decision rules → [[Vault Structure Map]]
+
+_(ยังว่าง — โน้ตในโฟลเดอร์นี้จะถูกลิงก์ที่นี่)_
+
+up:: [[Shared/_Index]]

package/second-brain/Shared/Glossary/_Index.md

@@ -0,0 +1,30 @@
+---
+tags: [index, moc, glossary]
+note_type: moc
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/_Index]]"
+---
+
+# Glossary
+
+> vocabulary กลาง (routes ไป category pages)
+
+## ใส่ที่นี่
+term + นิยาม กลาง
+
+## ไม่ใส่ที่นี่
+entity page (→Entities)
+
+## AI Routing Contract
+
+- ก่อนเขียน: เช็กว่าเนื้อหาตรง "ใส่ที่นี่" และไม่เข้า "ไม่ใส่ที่นี่"; ถ้าก้ำกึ่งอ่าน [[Vault Structure Map]] ก่อน
+- ก่อนสร้างไฟล์ใหม่: ค้นหาโน้ตเดิมในโฟลเดอร์นี้และโฟลเดอร์ใกล้เคียงก่อน เพื่อ merge/update แทน append ซ้ำ
+- เมื่อสร้างโน้ตในโฟลเดอร์นี้: ตั้ง `parent: "[[Shared/Glossary/_Index]]"` และท้ายไฟล์ `up:: [[Shared/Glossary/_Index]]`
+- หลังเขียน: เชื่อม link ไป source/project/session/decision ที่เกี่ยวข้อง และอัปเดต hub/index ถ้าโน้ตนี้ควรถูกค้นเจอในอนาคต
+
+> รายละเอียดทุกโฟลเดอร์ + decision rules → [[Vault Structure Map]]
+
+_(ยังว่าง — โน้ตในโฟลเดอร์นี้จะถูกลิงก์ที่นี่)_
+
+up:: [[Shared/_Index]]

package/second-brain/Shared/Memory-Inbox/_Index.md

@@ -0,0 +1,30 @@
+---
+tags: [index, moc, memory-inbox]
+note_type: moc
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/_Index]]"
+---
+
+# Memory-Inbox
+
+> candidate durable memory ที่ยังไม่ชัด/ขัดกัน
+
+## ใส่ที่นี่
+observation รอ promote (เคลียร์ทุก weekly)
+
+## ไม่ใส่ที่นี่
+durable ที่ชัดแล้ว (→ปลายทาง)
+
+## AI Routing Contract
+
+- ก่อนเขียน: เช็กว่าเนื้อหาตรง "ใส่ที่นี่" และไม่เข้า "ไม่ใส่ที่นี่"; ถ้าก้ำกึ่งอ่าน [[Vault Structure Map]] ก่อน
+- ก่อนสร้างไฟล์ใหม่: ค้นหาโน้ตเดิมในโฟลเดอร์นี้และโฟลเดอร์ใกล้เคียงก่อน เพื่อ merge/update แทน append ซ้ำ
+- เมื่อสร้างโน้ตในโฟลเดอร์นี้: ตั้ง `parent: "[[Shared/Memory-Inbox/_Index]]"` และท้ายไฟล์ `up:: [[Shared/Memory-Inbox/_Index]]`
+- หลังเขียน: เชื่อม link ไป source/project/session/decision ที่เกี่ยวข้อง และอัปเดต hub/index ถ้าโน้ตนี้ควรถูกค้นเจอในอนาคต
+
+> รายละเอียดทุกโฟลเดอร์ + decision rules → [[Vault Structure Map]]
+
+_(ยังว่าง — โน้ตในโฟลเดอร์นี้จะถูกลิงก์ที่นี่)_
+
+up:: [[Shared/_Index]]

package/second-brain/Shared/Operating-State/_Index.md

@@ -0,0 +1,30 @@
+---
+tags: [index, moc, operating-state]
+note_type: moc
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/_Index]]"
+---
+
+# Operating-State
+
+> live status/metrics ตอนนี้
+
+## ใส่ที่นี่
+current-state + health/queue + workbench
+
+## ไม่ใส่ที่นี่
+objective (→Goals)
+
+## AI Routing Contract
+
+- ก่อนเขียน: เช็กว่าเนื้อหาตรง "ใส่ที่นี่" และไม่เข้า "ไม่ใส่ที่นี่"; ถ้าก้ำกึ่งอ่าน [[Vault Structure Map]] ก่อน
+- ก่อนสร้างไฟล์ใหม่: ค้นหาโน้ตเดิมในโฟลเดอร์นี้และโฟลเดอร์ใกล้เคียงก่อน เพื่อ merge/update แทน append ซ้ำ
+- เมื่อสร้างโน้ตในโฟลเดอร์นี้: ตั้ง `parent: "[[Shared/Operating-State/_Index]]"` และท้ายไฟล์ `up:: [[Shared/Operating-State/_Index]]`
+- หลังเขียน: เชื่อม link ไป source/project/session/decision ที่เกี่ยวข้อง และอัปเดต hub/index ถ้าโน้ตนี้ควรถูกค้นเจอในอนาคต
+
+> รายละเอียดทุกโฟลเดอร์ + decision rules → [[Vault Structure Map]]
+
+_(ยังว่าง — โน้ตในโฟลเดอร์นี้จะถูกลิงก์ที่นี่)_
+
+up:: [[Shared/_Index]]

package/second-brain/Shared/Prompting/_Index.md

@@ -0,0 +1,30 @@
+---
+tags: [index, moc, prompting]
+note_type: moc
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/_Index]]"
+---
+
+# Prompting
+
+> prompt-engineering pattern (style/structure)
+
+## ใส่ที่นี่
+pattern การเขียน prompt ที่ reuse
+
+## ไม่ใส่ที่นี่
+prompt asset ต่อ task (→Prompts)
+
+## AI Routing Contract
+
+- ก่อนเขียน: เช็กว่าเนื้อหาตรง "ใส่ที่นี่" และไม่เข้า "ไม่ใส่ที่นี่"; ถ้าก้ำกึ่งอ่าน [[Vault Structure Map]] ก่อน
+- ก่อนสร้างไฟล์ใหม่: ค้นหาโน้ตเดิมในโฟลเดอร์นี้และโฟลเดอร์ใกล้เคียงก่อน เพื่อ merge/update แทน append ซ้ำ
+- เมื่อสร้างโน้ตในโฟลเดอร์นี้: ตั้ง `parent: "[[Shared/Prompting/_Index]]"` และท้ายไฟล์ `up:: [[Shared/Prompting/_Index]]`
+- หลังเขียน: เชื่อม link ไป source/project/session/decision ที่เกี่ยวข้อง และอัปเดต hub/index ถ้าโน้ตนี้ควรถูกค้นเจอในอนาคต
+
+> รายละเอียดทุกโฟลเดอร์ + decision rules → [[Vault Structure Map]]
+
+_(ยังว่าง — โน้ตในโฟลเดอร์นี้จะถูกลิงก์ที่นี่)_
+
+up:: [[Shared/_Index]]

package/second-brain/Shared/Provenance/_Index.md

@@ -0,0 +1,30 @@
+---
+tags: [index, moc, provenance]
+note_type: moc
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/_Index]]"
+---
+
+# Provenance
+
+> lineage ledger — ทุก claim ชี้ source:: ได้
+
+## ใส่ที่นี่
+บรรทัด ingest ต่อแหล่ง (ingest-log)
+
+## ไม่ใส่ที่นี่
+โน้ต derived (ใส่ source:: แทน)
+
+## AI Routing Contract
+
+- ก่อนเขียน: เช็กว่าเนื้อหาตรง "ใส่ที่นี่" และไม่เข้า "ไม่ใส่ที่นี่"; ถ้าก้ำกึ่งอ่าน [[Vault Structure Map]] ก่อน
+- ก่อนสร้างไฟล์ใหม่: ค้นหาโน้ตเดิมในโฟลเดอร์นี้และโฟลเดอร์ใกล้เคียงก่อน เพื่อ merge/update แทน append ซ้ำ
+- เมื่อสร้างโน้ตในโฟลเดอร์นี้: ตั้ง `parent: "[[Shared/Provenance/_Index]]"` และท้ายไฟล์ `up:: [[Shared/Provenance/_Index]]`
+- หลังเขียน: เชื่อม link ไป source/project/session/decision ที่เกี่ยวข้อง และอัปเดต hub/index ถ้าโน้ตนี้ควรถูกค้นเจอในอนาคต
+
+> รายละเอียดทุกโฟลเดอร์ + decision rules → [[Vault Structure Map]]
+
+_(ยังว่าง — โน้ตในโฟลเดอร์นี้จะถูกลิงก์ที่นี่)_
+
+up:: [[Shared/_Index]]

package/second-brain/Shared/Rules/_Index.md

@@ -0,0 +1,30 @@
+---
+tags: [index, moc, rules]
+note_type: moc
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/_Index]]"
+---
+
+# Rules
+
+> กฎ operating always-on
+
+## ใส่ที่นี่
+memory-write-protocol/frontmatter/context-assembly/formatting/staleness
+
+## ไม่ใส่ที่นี่
+how-to ทำงาน (→Runbooks)
+
+## AI Routing Contract
+
+- ก่อนเขียน: เช็กว่าเนื้อหาตรง "ใส่ที่นี่" และไม่เข้า "ไม่ใส่ที่นี่"; ถ้าก้ำกึ่งอ่าน [[Vault Structure Map]] ก่อน
+- ก่อนสร้างไฟล์ใหม่: ค้นหาโน้ตเดิมในโฟลเดอร์นี้และโฟลเดอร์ใกล้เคียงก่อน เพื่อ merge/update แทน append ซ้ำ
+- เมื่อสร้างโน้ตในโฟลเดอร์นี้: ตั้ง `parent: "[[Shared/Rules/_Index]]"` และท้ายไฟล์ `up:: [[Shared/Rules/_Index]]`
+- หลังเขียน: เชื่อม link ไป source/project/session/decision ที่เกี่ยวข้อง และอัปเดต hub/index ถ้าโน้ตนี้ควรถูกค้นเจอในอนาคต
+
+> รายละเอียดทุกโฟลเดอร์ + decision rules → [[Vault Structure Map]]
+
+_(ยังว่าง — โน้ตในโฟลเดอร์นี้จะถูกลิงก์ที่นี่)_
+
+up:: [[Shared/_Index]]

package/second-brain/Shared/Rules/contextual-note-rule.md

@@ -0,0 +1,30 @@
+---
+tags: [rule, context, notes]
+note_type: rule
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/Rules/_Index]]"
+ai_surface: hot
+---
+
+# Contextual Note Rule
+
+> Notes must explain why they exist, not just what they contain.
+
+## Required Context
+
+- Why this note was created.
+- What decision, task, entity, or source it connects to.
+- What would make the note stale or superseded.
+- Where the next reader should go next.
+
+## Routing Check
+
+Before creating a new note:
+
+1. Search for an existing canonical home.
+2. Check [[Vault Structure Map]] for the right folder.
+3. If uncertain, park in [[Shared/Memory-Inbox/memory-inbox]] with a short reason.
+4. Promote only after the context is clear.
+
+up:: [[Shared/Rules/_Index]]

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

@@ -13,6 +13,16 @@ parent: "[[Shared/Rules/_Index]]"
 ## Core fields (ทุกโน้ต)
 `tags` · `note_type` · `created` · `updated` · `parent` + ท้ายไฟล์ `up:: [[parent/_Index]]`
 
+## Note Type Taxonomy (allowed values — ห้ามมั่ว type ใหม่เอง)
+- **Project:** `project-overview` `context` `current-state` `session` `index` `reference`
+- **Memory:** `user-preferences` `decision-log` `operating-state` `response-examples` `working-patterns` `success-signals`
+- **Session/Knowledge:** `session-log` `retrospective` `learning-note` `distillation` `research-note` `moc`
+- **Durable:** `durable-index` `protocol` `registry` `standard-reference`
+- **System:** `template` `rule` `glossary` `runbook` `intake` `bug-report` `handoff` `weekly-review`
+- **Dashboard:** `homepage` `projects-dashboard`
+
+> ไม่มี type ที่ตรง → ใช้ `reference` (อย่าคิด type ใหม่)
+
 ## Bi-temporal validity (fact notes: Core-Facts / Decision-Memory / Entities)
 
 | field | ความหมาย |

package/second-brain/Shared/Rules/memory-write-protocol.md

@@ -0,0 +1,28 @@
+---
+tags: [rule, memory, protocol]
+note_type: rule
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/Rules/_Index]]"
+---
+
+# Memory-Write Protocol (ADD / UPDATE / DELETE / NOOP)
+
+> ทุกครั้งที่จะเขียน durable memory — เลือก operation ชัด (Mem0-style) แทนการ append มั่ว
+> หลักการแม่: **Merge, Don't Append**
+
+## ก่อนเขียน
+1. **diff กับ [[Shared/Core-Facts/protected-facts]]** (invariant) → ขัด = **หยุด + flag เจ้าของ** (ห้ามทับเงียบ)
+2. search ปลายทางหา entry หัวข้อเดียวกัน
+
+## เลือก operation
+| op | เมื่อ | ทำ |
+|---|---|---|
+| **ADD** | ของใหม่จริง (ไม่เจอเดิม) | เพิ่ม entry |
+| **UPDATE** | เจอ entry เดิม | แก้ + bump `updated:` (ห้ามเพิ่มซ้ำ) |
+| **DELETE** | fact เลิกจริง/ถูกแทน | bi-temporal supersede (ดู [[Shared/Rules/frontmatter-standard]]) ไม่ลบทิ้ง |
+| **NOOP** | รู้อยู่แล้ว | ไม่ต้องเขียน |
+
+> ขัดกัน (ไม่ใช่แค่ซ้ำ) → THESIS/ANTITHESIS/SYNTHESIS → บันทึก decision-log + `supersedes::`
+
+up:: [[Shared/Rules/_Index]]