sanook-cli 0.4.0 → 0.5.1

package/second-brain/Shared/Rules/procedural-runbook-header.md

@@ -0,0 +1,40 @@
+---
+tags: [rule, runbook, procedure]
+note_type: rule
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/Rules/_Index]]"
+---
+
+# Procedural Runbook Header
+
+> Minimum header for any reusable procedure in `Runbooks/`.
+
+```yaml
+---
+tags: [runbook]
+note_type: runbook
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+parent: "[[Runbooks/_Index]]"
+status: active
+success_rate: unknown
+runs: 0
+---
+```
+
+## Required Sections
+
+1. Purpose
+2. Preconditions
+3. Steps
+4. Verification
+5. Rollback / Recovery
+6. Known Failure Modes
+7. Change Log
+
+## Promotion Rule
+
+If a runbook becomes executable and has a reliable verification command, promote the executable unit to `Skills/` and leave the explanatory prose here.
+
+up:: [[Shared/Rules/_Index]]

package/second-brain/Shared/Rules/review-and-staleness-policy.md

@@ -0,0 +1,22 @@
+---
+tags: [rule, review, staleness]
+note_type: rule
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/Rules/_Index]]"
+---
+
+# Review & Staleness Policy
+
+> เมื่อไหร่ทบทวน + เมื่อไหร่โน้ต "หมดอายุ" → ปิด decay loop (ดู [[Runbooks/sleep-time-consolidation]])
+
+## Cadence
+- **Daily:** session log เฉพาะวันมีงาน
+- **Weekly:** เคลียร์ Memory-Inbox · promote durable · lint (orphan/dead-link/frontmatter)
+- **Monthly:** vault health audit + เก็บกวาด stale
+
+## Staleness
+- โน้ตควรมี `review_date` / `stale_after` (โน้ตที่เปลี่ยนตามเวลา)
+- เลย `stale_after` + ไม่ถูกแตะนาน + low-action → **flag → ถามก่อน → ย้าย [[Shared/Archive]]** (ไม่ลบ · Core-Facts ยกเว้น)
+
+up:: [[Shared/Rules/_Index]]

package/second-brain/Shared/Rules/rules-formatting.md

@@ -0,0 +1,34 @@
+---
+tags: [rule, formatting, output]
+note_type: rule
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/Rules/_Index]]"
+ai_surface: hot
+---
+
+# Rules Formatting
+
+> Output shape rules for notes and replies. Use this before creating durable notes or changing owner-facing docs.
+
+## Durable Notes
+
+- Use clear headings; avoid one giant paragraph.
+- Keep one canonical topic per note.
+- Put routing metadata in frontmatter, then a short purpose statement.
+- End every durable note with `up:: [[...]]`.
+
+## Owner-Facing Replies
+
+- Lead with the answer or status.
+- Keep summaries short unless the owner asks for detail.
+- Use Thai + tech English terms naturally.
+- Mention verification commands only when useful.
+
+## Avoid
+
+- Empty checklist theater.
+- Unverified claims about files, paths, dates, or commands.
+- Duplicate notes when an existing canonical note can be updated.
+
+up:: [[Shared/Rules/_Index]]

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

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

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

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

package/second-brain/Shared/Tech-Standards/_Index.md

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

package/second-brain/Shared/Tech-Standards/verification-standard.md

@@ -0,0 +1,40 @@
+---
+tags: [standard, verification, dod]
+note_type: standard-reference
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/Tech-Standards/_Index]]"
+ai_surface: hot
+---
+
+# Verification Standard
+
+> Definition of done for technical changes made with this vault.
+
+## Default Verification Ladder
+
+1. Read the relevant source before editing.
+2. Run the narrowest meaningful check first.
+3. Run the broader suite when touching shared behavior.
+4. Build/package smoke when the change affects release output.
+5. Record residual risk if a check cannot be run.
+
+## Evidence Format
+
+Use this shape in session logs and handoffs:
+
+```text
+Verification:
+- npm run typecheck: PASS
+- npm test: PASS
+- npm run build: PASS
+- Smoke: <command/result>
+```
+
+## Never Claim Done If
+
+- Tests were skipped without saying why.
+- The changed behavior was not exercised.
+- A generated artifact was not opened/rendered when visual layout matters.
+
+up:: [[Shared/Tech-Standards/_Index]]

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

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

package/second-brain/Shared/User-Persona/_Index.md

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

package/second-brain/Shared/User-Persona/owner-profile.md

@@ -0,0 +1,25 @@
+---
+tags: [persona, owner, profile]
+note_type: reference
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Shared/User-Persona/_Index]]"
+ai_surface: warm
+---
+
+# Owner Profile
+
+> Static profile for identity-level context. Keep mutable preferences in [[Shared/User-Memory/user-preferences]] instead.
+
+## Identity
+
+- Name: {{OWNER_NAME}}
+- Address as: {{OWNER_ADDRESS}}
+- Preferred language: {{LANGUAGE}}
+- Preferred tone: {{TONE}}
+
+## Durable Context
+
+_(Owner-controlled facts go here. Agents should not infer sensitive identity details.)_
+
+up:: [[Shared/User-Persona/_Index]]

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

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

package/second-brain/Shared/_Index.md

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

package/second-brain/Shared/mcp-servers/_Index.md

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

package/second-brain/Skills/_Index.md

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

package/second-brain/Templates/_Index.md

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

package/second-brain/Templates/bug.md

@@ -9,6 +9,8 @@ parent: "[[Bugs/_Index]]"
 
 # YYYY-MM-DD — <bug>
 
+> ใช้เมื่อ bug reproduce ได้หรือมีหลักฐานพอให้ debug ต่อ; ต้องแยก symptom, repro, root cause, fix, prevention เพื่อไม่ให้ AI แก้ซ้ำแบบเดิม
+
 ## อาการ (Symptom)
 
 ## Repro (ทำซ้ำยังไง)

package/second-brain/Templates/handoff.md

@@ -8,6 +8,8 @@ parent: "[[Handoffs/_Index]]"
 
 # <project> — Handoff
 
+> ใช้ส่งต่อ state ของงานค้างให้ session/agent ถัดไป โดยสรุป current state, done, in progress, next steps และไฟล์ที่เกี่ยวข้อง; ไม่ใช้เป็น session log ย้อนหลัง
+
 ## Current State
 
 ## Done

package/second-brain/Templates/session.md

@@ -9,6 +9,8 @@ ai_surface: history
 
 # YYYY-MM-DD — <topic>
 
+> ใช้เมื่อจบงานหรือ checkpoint สำคัญ เพื่อบันทึกสิ่งที่ทำจริง หลักฐานที่ verify แล้ว decision และ next step; ไม่ใช้แทน project overview หรือ handoff
+
 ## Summary
 
 ## What Was Tried

package/second-brain/Tools/_Index.md

@@ -0,0 +1,30 @@
+---
+tags: [index, moc, tools]
+note_type: moc
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Home]]"
+---
+
+# Tools
+
+> utility/tooling เฉพาะเครื่องหรือเฉพาะ vault
+
+## ใส่ที่นี่
+local helper, binary wrapper, one-off utility ที่ยังใช้อยู่
+
+## ไม่ใส่ที่นี่
+durable knowledge (→Learning/Runbooks) · verified executable skill (→Skills)
+
+## AI Routing Contract
+
+- ก่อนเขียน: เช็กว่าเนื้อหาตรง "ใส่ที่นี่" และไม่เข้า "ไม่ใส่ที่นี่"; ถ้าก้ำกึ่งอ่าน [[Vault Structure Map]] ก่อน
+- ก่อนสร้างไฟล์ใหม่: ค้นหาโน้ตเดิมในโฟลเดอร์นี้และโฟลเดอร์ใกล้เคียงก่อน เพื่อ merge/update แทน append ซ้ำ
+- เมื่อสร้างโน้ตในโฟลเดอร์นี้: ตั้ง `parent: "[[Tools/_Index]]"` และท้ายไฟล์ `up:: [[Tools/_Index]]`
+- หลังเขียน: เชื่อม link ไป source/project/session/decision ที่เกี่ยวข้อง และอัปเดต hub/index ถ้าโน้ตนี้ควรถูกค้นเจอในอนาคต
+
+> รายละเอียดทุกโฟลเดอร์ + decision rules → [[Vault Structure Map]]
+
+_(ยังว่าง — โน้ตในโฟลเดอร์นี้จะถูกลิงก์ที่นี่)_
+
+up:: [[Home]]

package/second-brain/Traces/_Index.md

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

package/second-brain/Vault Structure Map.md

@@ -20,15 +20,22 @@ ai_surface: hot
 | log งานที่ทำ | `Sessions/` | `YYYY-MM-DD-<topic>.md` |
 | preference ของเจ้าของ | `Shared/User-Memory/` | |
 | การตัดสินใจสำคัญ | `Shared/Decision-Memory/` | |
+| priority/current focus เปลี่ยน | `Shared/Operating-State/current-state.md` | update existing |
 | ยังไม่ชัด/ขัดกัน | `Shared/Memory-Inbox/` | |
 | content จากเว็บ/paste | `Intake/_Quarantine/` | (scan ก่อน) |
 | ต้นฉบับดิบ read-only | `Intake/Raw Sources/` | |
+| finding ที่มี source | `Research/` | ใส่ `source::` |
+| scratch ชั่วคราวระหว่างงาน | `Shared/Working-Memory/` | ลบทิ้ง/โปรโมทหลังจบ |
 | script ที่ผ่าน test | `Skills/` | |
 | how-to อ่านแล้วทำเอง | `Runbooks/` | |
 | กลยุทธ์ที่ปรับดีขึ้น | `Playbooks/` | |
+| fixture expected output | `Acceptance/` | input→expected |
+| pre/postflight gate | `Checklists/` | ticklist |
 | page ของคน/องค์กร/concept | `Entities/` | |
 | bug | `Bugs/` | `YYYY-MM-DD-<bug>.md` |
+| bug ระบบ/OS/toolchain | `Bugs/System-OS/` | `YYYY-MM-DD-<bug>.md` |
 | ส่งมอบงานค้าง | `Handoffs/` | |
+| multi-agent task card | `Shared/Coordination/task-board/` | `<id>.md` |
 
 ## §2 Full Reference (ครบทุกโฟลเดอร์ — ใส่อะไร / ห้ามใส่)
 
@@ -44,6 +51,7 @@ ai_surface: hot
 | `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 |
+| `Bugs/System-OS/` | bug ระบบ/OS/toolchain | OS, shell, package manager, permission, filesystem, app-runtime bugs | bug ของ project เฉพาะ |
 | `Handoffs/` | ส่งมอบงานค้าง (snapshot) | state + next steps ส่งต่อ | live coordination (→Coordination) |
 
 ### Direction
@@ -81,13 +89,35 @@ ai_surface: hot
 | `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/Tech-Standards/` | มาตรฐานเทคนิค | MCP/stack/DoD/verification | กฎ memory/format (→Rules) |
 | `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/Coordination/task-board/` | file-Kanban task cards | task ต่อชิ้นงาน มี `claimed_by`/`status` | session narrative หรือ handoff snapshot |
 | `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 | ของที่ยังใช้ |
+| `Shared/Scripts/` | automation maintenance | lint/graph-audit/metrics script | one-off retired (→Scripts-Archive) |
+| `Shared/Scripts-Archive/` | สคริปต์ one-off retired | script เก่า (ประวัติ) | script ที่ยังใช้ (→Scripts) |
+| `Shared/mcp-servers/` | vendored MCP server bundle | code/README ของ MCP server | config การต่อ (→Tech-Standards) |
+| `Shared/Context-Packs/` | full-context bundle | pack รวม context พร้อมโหลด | โน้ตเดี่ยว |
+| `Shared/Context7-Docs/` | cached lib doc (regenerable) | cache context7/lib doc | durable knowledge (→Learning) |
+| `Shared/AI-Threads/` | saved AI reasoning trail | thread review/resume/promote | durable decision (→Decision-Memory) |
+| `Shared/Prompting/` | prompt-engineering pattern | pattern การเขียน prompt | prompt asset (→Prompts) |
+| `Shared/Glossary/` | vocabulary กลาง | term + นิยาม | entity page (→Entities) |
+| `Shared/Assets/` | รูป/logo/binary | image/logo/asset | โน้ต .md |
+
+### AI agent config / vendor (root-level)
+| Folder | Role | ใส่ที่นี่ | ห้ามใส่ |
+|---|---|---|---|
+| `.agents/` `.agents/skills/` | skill folders (SKILL.md) | SKILL.md ที่ agent โหลด on-demand | prose how-to (→Runbooks) |
+| `.agents/workflows/` | workflow guides | multi-step orchestration ที่ทำซ้ำ | one-off task |
+| `copilot/` | vendor export (review/promote) | export จาก Copilot | durable (promote เข้า durable layer) |
+
+### Optional / Machine-local
+| Folder | Role | ใส่ที่นี่ | ห้ามใส่ |
+|---|---|---|---|
+| `Tools/` | utility เฉพาะเครื่อง/vault | local helper, wrapper, utility ที่ยังใช้ | durable knowledge หรือ verified skill |
 
 ## §3 Decision Rules (เคสกำกวม)
 
@@ -98,6 +128,8 @@ ai_surface: hot
 - **sourced vs self-derived:** มี external source→`Research` · กลั่นเอง→`Learning`
 - **finite vs ongoing:** มีวันจบ→`Goals` · ไม่จบ→`Areas`
 - **event vs cadence vs metric:** หลังงาน→`Retrospectives` · ตามรอบ→`Reviews` · วัดคุณภาพ→`Evals`
+- **system bug vs project bug:** OS/toolchain/runtime กว้างๆ→`Bugs/System-OS` · bug ของงานหนึ่ง→`Bugs`/`Projects/<proj>`
+- **coordination task vs narrative:** claimable task card→`Shared/Coordination/task-board` · เล่า session→`Sessions` · ส่งต่อ state→`Handoffs`
 
 ## §4 Footer