sanook-cli 0.4.0 → 0.5.1

package/second-brain/Evals/self-eval-rubric.md

@@ -0,0 +1,23 @@
+---
+tags: [eval, rubric, self-eval]
+note_type: reference
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Evals/_Index]]"
+---
+
+# Self-Eval Rubric (binary)
+
+> เกณฑ์ที่ AI ใช้ตรวจงานตัวเองก่อน ship — ตอบ y/n ต่อข้อ (ไม่ใช่คะแนน 1-10 — binary ชัดกว่า)
+
+## ก่อน ship เช็ก
+
+- [ ] grounded — คำตอบอิงโน้ต/ไฟล์จริงที่อ่าน (ไม่แต่ง)?
+- [ ] retrieval_hit — โหลด context ที่ต้องใช้ครบ?
+- [ ] verified — path/link/fact ที่อ้าง verify แล้ว (§11)?
+- [ ] scope — ตอบตรงที่ถาม ไม่เกิน/ไม่ขาด?
+- [ ] format — ตรง preference เจ้าของ (กระชับ/ตาราง)?
+
+> ข้อไหนตอบ "n" → แก้ก่อน ship · failure ซ้ำ → จัดเข้า [[Evals/failure-taxonomy]] + [[Evals/correction-pairs]]
+
+up:: [[Evals/_Index]]

package/second-brain/GEMINI.md

@@ -7,9 +7,9 @@
 
 ## 🔴 Red Lines
 1. อ่าน `Shared/AI-Context-Index.md` ก่อนตอบ (vault = source of truth)
-2. verify ก่อนอ้าง ไม่แน่ใจบอกตรงๆ ห้ามแต่ง
-3. ถามก่อนรัน destructive (`rm -rf` / `reset --hard` / `push --force` / drop data)
-4. ห้ามเขียน secret ลงไฟล์ → `<secret:VAR>`
-5. ห้ามลบ durable note โดยไม่ถาม
+2. ก่อนสร้าง/ย้ายโน้ต อ่าน `Vault Structure Map.md` + `_Index.md` ของโฟลเดอร์ปลายทาง แล้วทำตาม AI Routing Contract
+3. verify ก่อนอ้าง ไม่แน่ใจบอกตรงๆ ห้ามแต่ง
+4. ถามก่อนรัน destructive (`rm -rf` / `reset --hard` / `push --force` / drop data)
+5. ห้ามเขียน secret ลงไฟล์ → `<secret:VAR>` · ห้ามลบ durable note โดยไม่ถาม
 
 > รายละเอียด §1–§18 → `CLAUDE.md`

package/second-brain/Goals/_Index.md

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

package/second-brain/Handoffs/_Index.md

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

package/second-brain/Home.md

@@ -20,6 +20,13 @@ ai_surface: starter
 | งานทั้งหมด | [[Projects/_Index]] |
 | ประวัติงาน | [[Sessions/_Index]] |
 
+## AI Operating Loop
+
+1. อ่าน [[Shared/AI-Context-Index]] ก่อนตอบหรือเขียนไฟล์
+2. ถ้าต้องสร้าง/ย้ายโน้ต ให้เลือกปลายทางจาก [[Vault Structure Map]]
+3. ก่อนเขียนในโฟลเดอร์ใด ให้เปิด `_Index.md` ของโฟลเดอร์นั้นและทำตาม **AI Routing Contract**
+4. หลังจบงานสำคัญ ให้บันทึก session/decision/memory ตาม routing ไม่ปล่อยความรู้ค้างใน chat
+
 ## Core Hubs
 
 - [[Projects/_Index]] · [[Goals/_Index]] · [[Areas/_Index]]

package/second-brain/Intake/Raw Sources/_Index.md

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

package/second-brain/Intake/_Index.md

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

package/second-brain/Intake/_Quarantine/_Index.md

@@ -0,0 +1,30 @@
+---
+tags: [index, moc, -quarantine]
+note_type: moc
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Intake/_Index]]"
+---
+
+# _Quarantine
+
+> external content (web/paste) ที่ยัง untrusted
+
+## ใส่ที่นี่
+web clip/paste/email ก่อน scan injection (ดู Runbooks/ingest-quarantine)
+
+## ไม่ใส่ที่นี่
+content ที่ scan ผ่านแล้ว (→Raw Sources)
+
+## AI Routing Contract
+
+- ก่อนเขียน: เช็กว่าเนื้อหาตรง "ใส่ที่นี่" และไม่เข้า "ไม่ใส่ที่นี่"; ถ้าก้ำกึ่งอ่าน [[Vault Structure Map]] ก่อน
+- ก่อนสร้างไฟล์ใหม่: ค้นหาโน้ตเดิมในโฟลเดอร์นี้และโฟลเดอร์ใกล้เคียงก่อน เพื่อ merge/update แทน append ซ้ำ
+- เมื่อสร้างโน้ตในโฟลเดอร์นี้: ตั้ง `parent: "[[Intake/_Quarantine/_Index]]"` และท้ายไฟล์ `up:: [[Intake/_Quarantine/_Index]]`
+- หลังเขียน: เชื่อม link ไป source/project/session/decision ที่เกี่ยวข้อง และอัปเดต hub/index ถ้าโน้ตนี้ควรถูกค้นเจอในอนาคต
+
+> รายละเอียดทุกโฟลเดอร์ + decision rules → [[Vault Structure Map]]
+
+_(ยังว่าง — โน้ตในโฟลเดอร์นี้จะถูกลิงก์ที่นี่)_
+
+up:: [[Intake/_Index]]

package/second-brain/Learning/_Index.md

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

package/second-brain/Playbooks/_Index.md

@@ -0,0 +1,30 @@
+---
+tags: [index, moc, playbooks]
+note_type: moc
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Home]]"
+---
+
+# Playbooks
+
+> กลยุทธ์/ลำดับการตัดสินใจที่ปรับดีขึ้นจากผลจริง (ACE)
+
+## ใส่ที่นี่
+tactic/heuristic ที่ดีขึ้นจากผล (counter [H/W])
+
+## ไม่ใส่ที่นี่
+prompt text (→Prompts) · runnable (→Skills)
+
+## AI Routing Contract
+
+- ก่อนเขียน: เช็กว่าเนื้อหาตรง "ใส่ที่นี่" และไม่เข้า "ไม่ใส่ที่นี่"; ถ้าก้ำกึ่งอ่าน [[Vault Structure Map]] ก่อน
+- ก่อนสร้างไฟล์ใหม่: ค้นหาโน้ตเดิมในโฟลเดอร์นี้และโฟลเดอร์ใกล้เคียงก่อน เพื่อ merge/update แทน append ซ้ำ
+- เมื่อสร้างโน้ตในโฟลเดอร์นี้: ตั้ง `parent: "[[Playbooks/_Index]]"` และท้ายไฟล์ `up:: [[Playbooks/_Index]]`
+- หลังเขียน: เชื่อม link ไป source/project/session/decision ที่เกี่ยวข้อง และอัปเดต hub/index ถ้าโน้ตนี้ควรถูกค้นเจอในอนาคต
+
+> รายละเอียดทุกโฟลเดอร์ + decision rules → [[Vault Structure Map]]
+
+_(ยังว่าง — โน้ตในโฟลเดอร์นี้จะถูกลิงก์ที่นี่)_
+
+up:: [[Home]]

package/second-brain/Playbooks/playbook-template.md

@@ -0,0 +1,23 @@
+---
+tags: [playbook, template]
+note_type: reference
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Playbooks/_Index]]"
+---
+
+# Playbook: <task-family>
+
+> กลยุทธ์/ลำดับการตัดสินใจสำหรับงานตระกูลนี้ ที่ปรับดีขึ้นจากผลจริง (ACE) — โหลดก่อนงาน family นี้
+> counter `[H/W]` = helpful/harmful (อัปเดตหลังใช้แต่ละครั้ง)
+
+## Tactics
+
+- `[0/0]` <tactic 1 — ทำ X เมื่อ Y>
+- `[0/0]` <tactic 2 — หลีกเลี่ยง Z>
+
+## อัปเดต
+ใช้ tactic แล้วได้ผล → `[H+1]` · ทำให้แย่ลง → `[W+1]` · harmful > helpful นานๆ → ตัดทิ้ง
+บทเรียนใหม่จาก [[Evals/correction-pairs]] → เพิ่ม tactic ที่นี่
+
+up:: [[Playbooks/_Index]]

package/second-brain/Projects/_Index.md

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

package/second-brain/Prompts/_Index.md

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

package/second-brain/README.md

@@ -22,7 +22,8 @@
 
 1. เปิดโฟลเดอร์นี้ใน **Obsidian** (Open folder as vault)
 2. ให้ AI agent อ่าน `Shared/AI-Context-Index.md` ก่อนทำงานเสมอ
-3. constitution อยู่ที่ `CLAUDE.md` / `GEMINI.md` / `AGENTS.md` — กฎปฏิบัติของ AI
+3. ก่อนสร้างหรือย้ายโน้ต ให้เลือกปลายทางจาก `Vault Structure Map.md` แล้วอ่าน `_Index.md` ของโฟลเดอร์นั้นเพื่อทำตาม **AI Routing Contract**
+4. constitution อยู่ที่ `CLAUDE.md` / `GEMINI.md` / `AGENTS.md` — กฎปฏิบัติของ AI
 
 ## ปรับให้เป็นของคุณ
 

package/second-brain/Research/_Index.md

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

package/second-brain/Retrospectives/_Index.md

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

package/second-brain/Reviews/_Index.md

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

package/second-brain/Runbooks/_Index.md

@@ -0,0 +1,30 @@
+---
+tags: [index, moc, runbooks]
+note_type: moc
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Home]]"
+---
+
+# Runbooks
+
+> prose how-to ที่อ่านแล้วทำตามเอง
+
+## ใส่ที่นี่
+ขั้นตอน setup/deploy/maintain + loop driver
+
+## ไม่ใส่ที่นี่
+runnable unit (→Skills)
+
+## AI Routing Contract
+
+- ก่อนเขียน: เช็กว่าเนื้อหาตรง "ใส่ที่นี่" และไม่เข้า "ไม่ใส่ที่นี่"; ถ้าก้ำกึ่งอ่าน [[Vault Structure Map]] ก่อน
+- ก่อนสร้างไฟล์ใหม่: ค้นหาโน้ตเดิมในโฟลเดอร์นี้และโฟลเดอร์ใกล้เคียงก่อน เพื่อ merge/update แทน append ซ้ำ
+- เมื่อสร้างโน้ตในโฟลเดอร์นี้: ตั้ง `parent: "[[Runbooks/_Index]]"` และท้ายไฟล์ `up:: [[Runbooks/_Index]]`
+- หลังเขียน: เชื่อม link ไป source/project/session/decision ที่เกี่ยวข้อง และอัปเดต hub/index ถ้าโน้ตนี้ควรถูกค้นเจอในอนาคต
+
+> รายละเอียดทุกโฟลเดอร์ + decision rules → [[Vault Structure Map]]
+
+_(ยังว่าง — โน้ตในโฟลเดอร์นี้จะถูกลิงก์ที่นี่)_
+
+up:: [[Home]]

package/second-brain/Runbooks/eval-loop.md

@@ -0,0 +1,24 @@
+---
+tags: [runbook, eval, loop]
+note_type: runbook
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Runbooks/_Index]]"
+---
+
+# Runbook: Eval Loop (driver ของ Evals/)
+
+> รัน quality loop — error-analysis + binary self-eval + Reflexion → ของที่ Evals/ เก็บไว้ถูกใช้จริง
+
+## Steps
+
+1. **Self-eval** — หลังงานไม่ trivial: ตอบ [[Evals/self-eval-rubric]] (binary y/n)
+2. **Log** — บันทึกผลลง [[Evals/quality-ledger]] (append)
+3. **Classify failure** — ข้อที่ "n" → จัดเข้า [[Evals/failure-taxonomy]] (หรือเพิ่มหมวด)
+4. **Correction pair** — เขียน ❌→✅ + บทเรียนลง [[Evals/correction-pairs]]
+5. **Promote** — บทเรียนที่เห็น ≥3 ครั้ง → [[Playbooks/_Index]] (tactic) หรือ [[Distillations/_Index]] (principle)
+6. **Regression** — เทียบกับ [[Evals/golden-set]] ว่าไม่ทำพังของที่เคยถูก
+
+> ทำเป็นส่วนหนึ่งของ [[Runbooks/sleep-time-consolidation]] (รอบ) หรือ ad-hoc หลังงานสำคัญ
+
+up:: [[Runbooks/_Index]]

package/second-brain/Sessions/_Index.md

@@ -0,0 +1,30 @@
+---
+tags: [index, moc, sessions]
+note_type: moc
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Home]]"
+---
+
+# Sessions
+
+> flat chronological log ของงาน (YYYY-MM-DD-<topic>.md)
+
+## ใส่ที่นี่
+session log 7 หัวข้อ + checkpoint
+
+## ไม่ใส่ที่นี่
+code/config · subfolder (Sessions = flat เสมอ)
+
+## AI Routing Contract
+
+- ก่อนเขียน: เช็กว่าเนื้อหาตรง "ใส่ที่นี่" และไม่เข้า "ไม่ใส่ที่นี่"; ถ้าก้ำกึ่งอ่าน [[Vault Structure Map]] ก่อน
+- ก่อนสร้างไฟล์ใหม่: ค้นหาโน้ตเดิมในโฟลเดอร์นี้และโฟลเดอร์ใกล้เคียงก่อน เพื่อ merge/update แทน append ซ้ำ
+- เมื่อสร้างโน้ตในโฟลเดอร์นี้: ตั้ง `parent: "[[Sessions/_Index]]"` และท้ายไฟล์ `up:: [[Sessions/_Index]]`
+- หลังเขียน: เชื่อม link ไป source/project/session/decision ที่เกี่ยวข้อง และอัปเดต hub/index ถ้าโน้ตนี้ควรถูกค้นเจอในอนาคต
+
+> รายละเอียดทุกโฟลเดอร์ + decision rules → [[Vault Structure Map]]
+
+_(ยังว่าง — โน้ตในโฟลเดอร์นี้จะถูกลิงก์ที่นี่)_
+
+up:: [[Home]]

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

@@ -28,14 +28,28 @@ ai_surface: hot
 4. [[Shared/Decision-Memory/decision-log]] — ตัดสินใจอะไรไปแล้ว
 5. งาน project → [[Projects/_Index]] → overview → context → current-state
 
+## Default Write Path (ก่อนสร้าง/แก้โน้ต)
+
+1. Classify artifact: project work, session log, decision, preference, source, reusable skill, runbook, or temporary scratch
+2. อ่าน [[Vault Structure Map]] เพื่อเลือก canonical home เพียงที่เดียว
+3. เปิด `_Index.md` ของโฟลเดอร์ปลายทาง แล้วทำตาม **AI Routing Contract**
+4. Search ก่อนเขียน: ถ้า note เดิมมีอยู่แล้วให้ merge/update ไม่ append ซ้ำ
+5. หลังเขียน: ใส่ `parent` + `up::`, link กลับ project/session/source/decision ที่เกี่ยวข้อง, แล้วบันทึก evidence ที่ verify แล้ว
+
 ## Memory Routing (เจออะไร เก็บที่ไหน — §4)
 
 | สิ่งที่พบ | → |
 |---|---|
 | preference ใหม่ | [[Shared/User-Memory/user-preferences]] |
 | decision สำคัญ | [[Shared/Decision-Memory/decision-log]] |
+| priority/current focus เปลี่ยน | [[Shared/Operating-State/current-state]] |
+| session checkpoint / งานจบ | `Sessions/YYYY-MM-DD-<topic>.md` |
 | ยังไม่ชัด/ขัดกัน | [[Shared/Memory-Inbox/memory-inbox]] |
 | invariant truth | [[Shared/Core-Facts/protected-facts]] |
+| finding ที่อิง source ภายนอก | `Research/<topic>.md` + `source::` |
+| scratch ระหว่างงานเดียว | `Shared/Working-Memory/<topic>.md` |
+| expected output fixture | [[Acceptance/golden-case-template]] |
+| pre/postflight gate | [[Checklists/preflight-postflight-template]] |
 | entity/person/org page | `Entities/<name>.md` |
 | อื่นๆ / ไม่แน่ใจว่าโฟลเดอร์ไหน | [[Vault Structure Map]] |
 
@@ -44,6 +58,12 @@ ai_surface: hot
 - **ก่อนประกอบ 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]]
+- หลาย agent ทำพร้อมกัน → อ่าน [[Shared/Coordination/NOW]] ก่อนแตะ vault · เขียน/แก้ fact → [[Shared/Rules/memory-write-protocol]] (ADD/UPDATE/DELETE/NOOP)
+- สร้าง durable note ใหม่ → [[Shared/Rules/contextual-note-rule]] + [[Shared/Rules/rules-formatting]]
+- ทำ runbook/procedure → [[Shared/Rules/procedural-runbook-header]]
+- งาน technical/release → [[Shared/Tech-Standards/verification-standard]]
+- งานหลาย session/หลาย agent → overview [[Shared/Coordination/task-board]] · task cards [[Shared/Coordination/task-board/_Index]] · registry [[Shared/Coordination/agent-registry]]
+- acceptance/checklist/entity ใหม่ → [[Acceptance/golden-case-template]] · [[Checklists/preflight-postflight-template]] · [[Entities/entity-template]]
 
 ## Current Snapshot
 

package/second-brain/Shared/AI-Threads/_Index.md

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