sanook-cli 0.5.1 → 0.5.2

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

@@ -0,0 +1,41 @@
+---
+tags: [context-pack, second-brain, maintenance]
+note_type: context-pack
+created: 2026-06-17
+updated: 2026-06-17
+parent: "[[Shared/Context-Packs/_Index]]"
+---
+
+# Context Pack: Second-Brain Maintenance
+
+> Use when editing vault structure, routing rules, memory policy, indexes, runbooks, or agent adapters.
+
+## Load Order
+
+1. [[Shared/AI-Context-Index]]
+2. [[Runbooks/ai-second-brain-operating-sequence]]
+3. [[Vault Structure Map]]
+4. [[Shared/Rules/context-assembly-policy]]
+5. Destination `_Index.md`
+6. [[Shared/Rules/memory-write-protocol]] if changing memory/facts
+7. [[Evals/second-brain-benchmarks]] before and after framework edits
+
+## Required Role
+
+- Primary: Librarian
+- Secondary: Scientist
+
+## Output Artifacts
+
+- Updated target note/index
+- Quality/evidence note when non-trivial: [[Evals/quality-ledger]] or [[Sessions/_Index]]
+- No new root folder unless [[Vault Structure Map]] is updated and drift tests are considered
+
+## Done Criteria
+
+- New/changed notes have `parent` and `up::`
+- Index links make the artifact discoverable
+- Benchmark or explicit verification is recorded
+- Context bloat is checked; do not preload every rule
+
+up:: [[Shared/Context-Packs/_Index]]

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

@@ -13,11 +13,24 @@ ai_surface: starter
 
 ## Now
 
-_(งาน/โฟกัสหลักตอนนี้ — ยังว่าง)_
+- 2026-06-17: ปรับ second-brain ให้ใช้ [[Runbooks/ai-second-brain-operating-sequence]] เป็น default AI operating sequence หลังทดลองเทียบ methods แล้ว
+- 2026-06-17: เพิ่ม [[Evals/second-brain-benchmarks]], [[Shared/User-Memory/response-examples]], และ context packs ใน [[Shared/Context-Packs/_Index]]
+- 2026-06-18: dogfood context packs กับงานจริง 3 task-family แล้ว: coding-release, second-brain-maintenance, research-to-framework
+- 2026-06-18: ตรวจ cli-args serve port UX change แล้ว; targeted/full tests, typecheck, build, diff check ผ่าน
+- 2026-06-18: วิจัย Hermes CLI second-brain expansion ไว้เป็น reference; เจ้าของ clarify ว่าเป้าจริงคือทำใน Sanook CLI
+- 2026-06-18: Sanook-native P0 implemented: `sanook brain doctor`, `sanook brain context`, `sanook brain eval`
+- 2026-06-18: เพิ่ม `sanook brain review` เป็น curator review แบบ read-only สำหรับ inbox/context-packs/sessions/evals/note hygiene
+- 2026-06-18: เพิ่ม [[Templates/final]] เป็น final gate / evidence matrix ก่อนปิดงาน non-trivial
+- 2026-06-18: เพิ่ม `sanook brain final`, [[Templates/final-lite]], final-gate validator ใน `brain review`, และ `SB-FINAL` ใน `brain eval` แล้ว
+- 2026-06-18: MCP P0 implemented ใน Sanook CLI แล้ว: registry-backed `mcp search/info/install/preset/test/doctor/list --tools`; verification ผ่าน และพบว่า GitLab remote ต้อง auth header ก่อน probe ผ่าน
+- 2026-06-18: เพิ่ม [[Research/2026-06-18-ai-token-reduction-frameworks]], default query-aware selective context compression, adaptive stale-tool budgets, และ optional Headroom framework mode ใน Sanook CLI
 
 ## Active Bets
 
-_(สิ่งที่กำลังลงแรง/ลงทุน)_
+- Scientific Loop Sequence: single retrieval path + JIT task rules + explicit write routing + eval/consolidation loop
+- AI จะเก่งขึ้นแบบวัดได้เมื่อมี benchmark + taste examples + reusable context packs
+- Final gate ที่มี evidence และ CLI scaffold จะลดการ claim done เกินจริงตอนปิดงาน
+- Token/cost จะลดได้อย่างปลอดภัยที่สุดจาก stale tool-output compression ก่อน ไม่ใช่บีบ user intent หรือ recent evidence
 
 ## Blockers
 
@@ -25,6 +38,12 @@ _(ติดอะไรอยู่)_
 
 ## Next Actions
 
-- [ ] _(เริ่มจดงานแรกที่นี่)_
+- [ ] Review remaining worktree diff before commit/release
+- [ ] Dogfood `sanook brain final --task "..." --from-diff` ในงาน implementation ถัดไป
+- [x] ทำ MCP P0: `sanook mcp search`, `sanook mcp info`, `sanook mcp install`, `sanook mcp test`
+- [ ] MCP follow-up: auth hints for hosted remotes that return `401`, risk labels, and richer install preview/cache
+- [ ] Token compression follow-up: benchmark real multi-step traces and smoke test Headroom mode with a real proxy/cloud setup
+- [ ] ถ้าจะต่อ second-brain CLI รอบถัดไป: ทำ `sanook brain pack list|show`, `sanook brain new <type>`, หรือ `sanook brain repair`
+- [ ] เพิ่ม good/bad examples ใหม่ใน [[Shared/User-Memory/response-examples]] เมื่อมี feedback จริงรอบถัดไป
 
 up:: [[Shared/Operating-State/_Index]]

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

@@ -25,6 +25,8 @@ one-off ที่ retired (→Scripts-Archive)
 
 > รายละเอียดทุกโฟลเดอร์ + decision rules → [[Vault Structure Map]]
 
-_(ยังว่าง — โน้ตในโฟลเดอร์นี้จะถูกลิงก์ที่นี่)_
+## Scripts
+
+- `Shared/Scripts/ai-second-brain-method-eval.mjs` — reproducible eval เปรียบเทียบ AI second-brain operating methods; ใช้เป็น evidence ของ [[Research/2026-06-17-ai-second-brain-method-experiment]]
 
 up:: [[Shared/_Index]]

package/second-brain/Shared/Scripts/ai-second-brain-method-eval.mjs

@@ -0,0 +1,198 @@
+#!/usr/bin/env node
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+const vault = process.argv[2] ?? 'second-brain';
+
+const files = {
+  aiIndex: 'Shared/AI-Context-Index.md',
+  user: 'USER.md',
+  currentState: 'Shared/Operating-State/current-state.md',
+  preferences: 'Shared/User-Memory/user-preferences.md',
+  decisions: 'Shared/Decision-Memory/decision-log.md',
+  structureMap: 'Vault Structure Map.md',
+  contextPolicy: 'Shared/Rules/context-assembly-policy.md',
+  noteRule: 'Shared/Rules/contextual-note-rule.md',
+  formatting: 'Shared/Rules/rules-formatting.md',
+  memoryWrite: 'Shared/Rules/memory-write-protocol.md',
+  frontmatter: 'Shared/Rules/frontmatter-standard.md',
+  ingest: 'Runbooks/ingest-quarantine.md',
+  sleep: 'Runbooks/sleep-time-consolidation.md',
+  evalLoop: 'Runbooks/eval-loop.md',
+  retrievalEval: 'Evals/retrieval-eval.md',
+  qualityLedger: 'Evals/quality-ledger.md',
+  verification: 'Shared/Tech-Standards/verification-standard.md',
+  coordinationNow: 'Shared/Coordination/NOW.md',
+  taskBoard: 'Shared/Coordination/task-board.md',
+  agentRegistry: 'Shared/Coordination/agent-registry.md',
+  sessionsIndex: 'Sessions/_Index.md',
+  runbooksIndex: 'Runbooks/_Index.md',
+  scriptsIndex: 'Shared/Scripts/_Index.md',
+};
+
+function fileTokens(path) {
+  const full = join(vault, path);
+  if (!existsSync(full)) return { exists: false, tokens: 0 };
+  return { exists: true, tokens: Math.ceil(readFileSync(full, 'utf8').length / 4) };
+}
+
+const scenarios = [
+  {
+    id: 'start-session',
+    label: 'เริ่มงานกับ AI โดยไม่หลุด source of truth',
+    required: [files.aiIndex, files.user, files.currentState, files.preferences, files.decisions],
+    capabilities: ['retrieval', 'state', 'preference'],
+  },
+  {
+    id: 'write-durable-note',
+    label: 'สร้าง/แก้ durable note ให้ถูกที่และค้นเจอภายหลัง',
+    required: [files.aiIndex, files.structureMap, files.contextPolicy, files.noteRule, files.formatting],
+    capabilities: ['retrieval', 'routing', 'write-contract', 'graph-linking'],
+  },
+  {
+    id: 'write-memory',
+    label: 'บันทึก preference/decision/fact โดยไม่ append ซ้ำ',
+    required: [files.aiIndex, files.memoryWrite, files.frontmatter, files.preferences, files.decisions],
+    capabilities: ['memory-op', 'dedupe', 'verification'],
+  },
+  {
+    id: 'ingest-source',
+    label: 'นำข้อมูลภายนอกเข้า vault แบบปลอด prompt injection',
+    required: [files.aiIndex, files.ingest, files.frontmatter, files.structureMap],
+    capabilities: ['ingest-safety', 'provenance', 'routing'],
+  },
+  {
+    id: 'consolidate',
+    label: 'ทำ sleep-time consolidation และปิด loop ความจำ',
+    required: [files.aiIndex, files.sleep, files.memoryWrite, files.retrievalEval, files.qualityLedger],
+    capabilities: ['consolidation', 'memory-op', 'eval'],
+  },
+  {
+    id: 'multi-agent',
+    label: 'กันหลาย agent ชนกันและส่งต่องานได้',
+    required: [files.aiIndex, files.coordinationNow, files.taskBoard, files.agentRegistry, files.sessionsIndex],
+    capabilities: ['coordination', 'handoff', 'session-log'],
+  },
+  {
+    id: 'technical-work',
+    label: 'งานเทคนิคที่ต้อง verify ก่อนสรุป',
+    required: [files.aiIndex, files.verification, files.evalLoop, files.sessionsIndex],
+    capabilities: ['verification', 'eval', 'session-log'],
+  },
+];
+
+const methods = [
+  {
+    id: 'session-log-only',
+    label: 'Session-log only',
+    filesFor: () => [files.sessionsIndex],
+    capabilities: ['session-log'],
+  },
+  {
+    id: 'folder-map-only',
+    label: 'Folder map + destination indexes',
+    filesFor: (scenario) => [files.structureMap, files.sessionsIndex, ...scenario.required.filter((p) => p.endsWith('_Index.md'))],
+    capabilities: ['routing', 'session-log'],
+  },
+  {
+    id: 'single-context-index',
+    label: 'Single retrieval index',
+    filesFor: () => [files.aiIndex, files.user, files.currentState, files.preferences, files.decisions],
+    capabilities: ['retrieval', 'state', 'preference'],
+  },
+  {
+    id: 'jit-context-policy',
+    label: 'Index + JIT context policy',
+    filesFor: (scenario) => [files.aiIndex, files.contextPolicy, ...scenario.required.slice(0, 3)],
+    capabilities: ['retrieval', 'state', 'preference', 'routing', 'write-contract', 'graph-linking', 'verification'],
+  },
+  {
+    id: 'scientific-loop-sequence',
+    label: 'Scientific loop sequence',
+    filesFor: (scenario) => [files.aiIndex, files.contextPolicy, ...scenario.required],
+    capabilities: [
+      'retrieval',
+      'state',
+      'preference',
+      'routing',
+      'write-contract',
+      'graph-linking',
+      'memory-op',
+      'dedupe',
+      'verification',
+      'ingest-safety',
+      'provenance',
+      'consolidation',
+      'eval',
+      'coordination',
+      'handoff',
+      'session-log',
+    ],
+  },
+];
+
+function uniq(items) {
+  return [...new Set(items.filter(Boolean))];
+}
+
+function scoreScenario(method, scenario) {
+  const contextFiles = uniq(method.filesFor(scenario));
+  const fileStats = contextFiles.map((path) => ({ path, ...fileTokens(path) }));
+  const tokens = fileStats.reduce((sum, stat) => sum + stat.tokens, 0);
+  const requiredHits = scenario.required.filter((path) => contextFiles.includes(path) && fileTokens(path).exists).length;
+  const existingRequired = scenario.required.filter((path) => fileTokens(path).exists).length;
+  const fileCoverage = existingRequired ? requiredHits / existingRequired : 1;
+  const capabilityHits = scenario.capabilities.filter((cap) => method.capabilities.includes(cap)).length;
+  const capabilityCoverage = scenario.capabilities.length ? capabilityHits / scenario.capabilities.length : 1;
+  const economy = tokens <= 2200 ? 1 : Math.max(0, 1 - (tokens - 2200) / 2200);
+  const score = Math.round((fileCoverage * 70 + capabilityCoverage * 20 + economy * 10) * 10) / 10;
+  return { score, fileCoverage, capabilityCoverage, economy, tokens, contextFiles };
+}
+
+const rows = methods.map((method) => {
+  const perScenario = scenarios.map((scenario) => scoreScenario(method, scenario));
+  const avgScore = perScenario.reduce((sum, s) => sum + s.score, 0) / perScenario.length;
+  const avgTokens = perScenario.reduce((sum, s) => sum + s.tokens, 0) / perScenario.length;
+  const avgFileCoverage = perScenario.reduce((sum, s) => sum + s.fileCoverage, 0) / perScenario.length;
+  const avgCapabilityCoverage = perScenario.reduce((sum, s) => sum + s.capabilityCoverage, 0) / perScenario.length;
+  return {
+    method,
+    avgScore: Math.round(avgScore * 10) / 10,
+    avgTokens: Math.round(avgTokens),
+    avgFileCoverage: Math.round(avgFileCoverage * 100),
+    avgCapabilityCoverage: Math.round(avgCapabilityCoverage * 100),
+    perScenario,
+  };
+});
+
+rows.sort((a, b) => b.avgScore - a.avgScore);
+
+console.log('# AI Second-Brain Method Eval');
+console.log('');
+console.log(`vault: ${vault}`);
+console.log(`scenarios: ${scenarios.length}`);
+console.log('');
+console.log('| rank | method | score | file coverage | capability coverage | avg tokens |');
+console.log('|---:|---|---:|---:|---:|---:|');
+rows.forEach((row, idx) => {
+  console.log(
+    `| ${idx + 1} | ${row.method.label} | ${row.avgScore} | ${row.avgFileCoverage}% | ${row.avgCapabilityCoverage}% | ~${row.avgTokens} |`,
+  );
+});
+console.log('');
+console.log('## Scenario Detail');
+console.log('');
+for (const row of rows) {
+  console.log(`### ${row.method.label}`);
+  console.log('| scenario | score | tokens |');
+  console.log('|---|---:|---:|');
+  row.perScenario.forEach((result, idx) => {
+    console.log(`| ${scenarios[idx].label} | ${result.score} | ~${result.tokens} |`);
+  });
+  console.log('');
+}
+
+const best = rows[0];
+console.log('## Winner');
+console.log('');
+console.log(`${best.method.label} (${best.method.id})`);

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

@@ -25,6 +25,9 @@ MCP/stack/DoD/verification rulebook
 
 > รายละเอียดทุกโฟลเดอร์ + decision rules → [[Vault Structure Map]]
 
-_(ยังว่าง — โน้ตในโฟลเดอร์นี้จะถูกลิงก์ที่นี่)_
+## Standards
+
+- [[Shared/Tech-Standards/verification-standard]] — verification ladder, evidence format, and final gate contract
+- [[Shared/Tech-Standards/mcp-integration-roadmap]] — MCP registry/install/test UX roadmap
 
 up:: [[Shared/_Index]]

package/second-brain/Shared/Tech-Standards/mcp-integration-roadmap.md

@@ -0,0 +1,86 @@
+---
+tags: [standard, mcp, integration, roadmap]
+note_type: standard-reference
+created: 2026-06-18
+updated: 2026-06-18
+parent: "[[Shared/Tech-Standards/_Index]]"
+source:
+  - "[[Research/2026-06-18-sanook-mcp-ecosystem-and-ux-roadmap]]"
+---
+
+# MCP Integration Roadmap
+
+> Technical roadmap for making MCP easier and safer to use inside Sanook CLI.
+
+## Current Baseline
+
+- `src/mcp.ts` supports stdio MCP and remote Streamable HTTP.
+- `src/mcp-server.ts` exposes Sanook's brain as an MCP server.
+- `src/bin.ts` supports `mcp add/list/remove`, `mcp serve`, registry-backed `mcp search/info/install`, curated `mcp preset`, and `mcp test/doctor`.
+- `src/mcp-registry.ts` maps official registry remotes/packages into Sanook `mcp.json`.
+- Project MCP config remains behind `sanook trust`.
+
+## Target UX
+
+```text
+sanook mcp search github
+sanook mcp info com.gitlab/mcp
+sanook mcp install com.gitlab/mcp --name gitlab
+sanook mcp test gitlab
+sanook mcp doctor
+```
+
+## P0 Requirements
+
+1. Registry search - implemented
+   - Query official registry.
+   - Show latest versions only by default.
+   - Show server name, description, version, transport, package runtime, and source URL.
+2. Server info - implemented
+   - Show remotes/packages.
+   - Show required env/header inputs.
+   - Mark secret inputs.
+   - Show install command preview.
+3. Install - implemented
+   - Convert selected remote/package into Sanook `mcp.json`.
+   - Write explicit user-requested config only.
+   - Preserve `0600` permissions.
+   - Never inherit ambient provider API keys into MCP child env.
+4. Test - implemented
+   - Initialize one server.
+   - Run `tools/list`.
+   - Report tool count and tool names.
+   - Print clear failure reason and setup hints.
+
+## P1 Requirements
+
+- `sanook mcp doctor`: validate config shape, missing commands, missing env, unreachable remote, duplicate tool names.
+- `sanook mcp list --tools`: grouped tools by server.
+- `sanook mcp remove` should support exact server names and show config path.
+- Support `--project` install only if project is trusted.
+- Add auth hints when hosted remotes return `401 Unauthorized`.
+- Add registry result caching and risk labels for write-capable servers.
+
+## Safety Policy
+
+- Default to read-only where a server offers read-only or scoped modes.
+- Show risk class before enabling:
+  - read-only
+  - file-write
+  - network-write
+  - database-write
+  - infra/admin
+- Dangerous servers must remain subject to existing approval gates in ask mode.
+- Do not run package installs implicitly during `search` or `info`.
+- For package metadata with `fileSha256`, verify downloaded MCPB packages before running.
+
+## First Presets
+
+| Preset | Servers to consider | Use case |
+|---|---|---|
+| `dev` | GitHub/GitLab, Sentry, Context7/docs | coding, PRs, releases, error debugging |
+| `research` | fetch, Brave/web search, docs, Obsidian/GDrive | grounded external research |
+| `pm` | Linear/Jira, Slack/Discord, Notion | task and team workflows |
+| `ops` | Postgres read-only, Docker/Kubernetes, Sentry | operational debugging |
+
+up:: [[Shared/Tech-Standards/_Index]]

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

@@ -31,6 +31,30 @@ Verification:
 - Smoke: <command/result>
 ```
 
+## Final Gate
+
+For non-trivial work, multi-file changes, framework changes, releases, or anything the owner may later audit, instantiate [[Templates/final]] before the final owner-facing answer. Use [[Templates/final-lite]] for smaller tasks that still need evidence, or run:
+
+```text
+sanook brain final --task "<objective>" --from-diff
+sanook brain final --task "<objective>" --lite
+```
+
+The final gate must prove all eight closeout requirements:
+
+1. Objective / DoD is restated and matched.
+2. Checklist items have evidence, not only checked boxes.
+3. Status uses `PASS`, `PARTIAL`, `FAIL`, `N/A`, or `BLOCKED`.
+4. Evidence matrix lists commands, files, artifacts, and sources.
+5. Residual risk and skipped checks are explicit.
+6. Change summary distinguishes changed vs untouched work.
+7. Final answer draft does not overclaim beyond evidence.
+8. Second-brain routing / memory closeout is handled.
+
+If a row has no evidence, it cannot be `PASS`.
+
+`sanook brain review` checks final-gate notes in `Sessions/` for missing sections, unfilled placeholders, `TODO` rows, and `PASS` rows without evidence. `sanook brain eval` checks that the final-gate templates remain bundled and wired into this standard.
+
 ## Never Claim Done If
 
 - Tests were skipped without saying why.

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

@@ -25,6 +25,9 @@ identity static (→User-Persona)
 
 > รายละเอียดทุกโฟลเดอร์ + decision rules → [[Vault Structure Map]]
 
-_(ยังว่าง — โน้ตในโฟลเดอร์นี้จะถูกลิงก์ที่นี่)_
+## User-Memory Notes
+
+- [[Shared/User-Memory/user-preferences]] — durable preferences ของเจ้าของ
+- [[Shared/User-Memory/response-examples]] — examples/taste signals ว่าคำตอบ AI แบบไหนดีหรือไม่ดี
 
 up:: [[Shared/_Index]]

package/second-brain/Shared/User-Memory/response-examples.md

@@ -0,0 +1,98 @@
+---
+tags: [user-memory, response-examples, taste]
+note_type: response-examples
+created: 2026-06-17
+updated: 2026-06-17
+parent: "[[Shared/User-Memory/_Index]]"
+related:: [[Shared/User-Memory/user-preferences]]
+---
+
+# Response Examples & Taste Signals
+
+> Mutable examples of what "good AI behavior" feels like for {{OWNER_NAME}}. These examples are initial working defaults inferred from current vault work; update when the owner gives stronger feedback.
+
+## Preferred Shape
+
+- Thai first, with natural tech English where useful.
+- Lead with the answer or status.
+- Be proactive when the action is safe; ask only when the next step is genuinely risky or ambiguous.
+- Summarize verification evidence without dumping full logs.
+- For framework work, think like Scientist first, then implement like Operator/Librarian.
+
+## Good Pattern: Work Completed
+
+```text
+เสร็จแล้วครับ ผมเพิ่ม benchmark, taste examples, และ context packs เข้า framework แล้ว
+
+หลัก ๆ คือ:
+- Evals/second-brain-benchmarks.md สำหรับวัดคุณภาพ AI
+- Shared/User-Memory/response-examples.md สำหรับ style/taste
+- Shared/Context-Packs/... สำหรับโหลด context ตามงานซ้ำ
+
+ตรวจแล้ว: script/runbook links อยู่ใน index และ git diff --check ผ่าน
+```
+
+Why good:
+
+- Starts with status.
+- Names files.
+- Mentions verification.
+- Does not over-explain unless asked.
+
+## Bad Pattern: Too Vague
+
+```text
+ผมได้ปรับปรุงระบบให้ดีขึ้นแล้ว มีหลายส่วนที่ช่วยให้ AI ทำงานดีขึ้น และน่าจะใช้งานได้ดีมากขึ้นในอนาคต
+```
+
+Why bad:
+
+- No files.
+- No evidence.
+- No next action.
+
+## Good Pattern: Recommendation Before Edit
+
+```text
+ผมไม่แนะนำให้เพิ่ม root folder ใหม่ตอนนี้ครับ เพราะ vault มี zone รองรับอยู่แล้ว
+ทางที่คุ้มกว่าคือเติม benchmark ใน Evals, taste examples ใน User-Memory, และ context packs ใน Shared/Context-Packs
+```
+
+Why good:
+
+- Gives a point of view.
+- Protects the framework from unnecessary complexity.
+- Offers concrete implementation path.
+
+## Good Pattern: Act On All Clear Recommendations
+
+```text
+รับครับ ผมจะทำครบตาม 4 ข้อที่แนะนำไว้: ตรวจ worktree, รัน tests, ใช้ benchmark/framework จริง, แล้วอัปเดต memory/session evidence ให้ครบ
+```
+
+Why good:
+
+- Mirrors the requested scope.
+- Commits to action when the work is safe and clear.
+- Keeps the owner looped in without asking for unnecessary confirmation.
+
+## Good Pattern: Uncertainty
+
+```text
+ผมยังยืนยัน claim นี้ไม่ได้จาก vault ปัจจุบันครับ หลักฐานที่มีบอกได้แค่ว่า X ผ่าน แต่ยังไม่ได้พิสูจน์ Y
+```
+
+Why good:
+
+- Does not pretend certainty.
+- Separates evidence from inference.
+
+## Update Rule
+
+When owner reacts positively/negatively to a response:
+
+1. Classify the signal as style, autonomy, detail level, or evidence expectation.
+2. Update this file or [[Shared/User-Memory/user-preferences]] with ADD/UPDATE/NOOP.
+3. Do not duplicate the same preference in multiple places.
+
+up:: [[Shared/User-Memory/_Index]]

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

@@ -15,6 +15,7 @@ parent: "[[Shared/User-Memory/_Index]]"
 
 ## Execution
 - Autonomy: {{AUTONOMY}}
+- เมื่อมีรายการแนะนำที่ scope ชัดและปลอดภัย เจ้าของมักต้องการให้ลงมือทำครบได้เลย ไม่ต้องถามยืนยันซ้ำ
 
 ## Likes
 _(เพิ่มเมื่อเจ้าของบอกว่าชอบอะไรชัดเจน)_

package/second-brain/Templates/_Index.md

@@ -16,6 +16,15 @@ template ไว้ instantiate (session/bug/handoff/project)
 ## ไม่ใส่ที่นี่
 โน้ตจริง
 
+## Templates
+
+- [[Templates/session]] — session log หลังจบงานหรือ checkpoint สำคัญ
+- [[Templates/handoff]] — ส่งต่องานค้างให้ session/agent ถัดไป
+- [[Templates/project]] — project overview
+- [[Templates/bug]] — bug report
+- [[Templates/final]] — final gate เต็มก่อนบอกว่าเสร็จแล้ว; checklist ต้องมี evidence
+- [[Templates/final-lite]] — final gate แบบสั้นสำหรับงานเล็กถึงกลาง; ใช้เกณฑ์ evidence เดียวกัน
+
 ## AI Routing Contract
 
 - ก่อนเขียน: เช็กว่าเนื้อหาตรง "ใส่ที่นี่" และไม่เข้า "ไม่ใส่ที่นี่"; ถ้าก้ำกึ่งอ่าน [[Vault Structure Map]] ก่อน

package/second-brain/Templates/final-lite.md

@@ -0,0 +1,111 @@
+---
+tags: [template, final-gate, verification, lite]
+note_type: template
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+parent: "[[Templates/_Index]]"
+---
+
+# YYYY-MM-DD - <task/topic> - Final Gate Lite
+
+> Final gate แบบสั้นสำหรับงานเล็กถึงกลาง: ยังต้องล็อก objective, evidence, risk, final answer, และ memory routing; ถ้า row ไม่มี evidence ห้าม mark `PASS`
+
+## 0. Final Gate Rule
+
+- [ ] Created before the owner-facing final answer.
+- [ ] Every `PASS` has evidence.
+- [ ] If a row has no evidence, it cannot be `PASS`.
+
+Status: `PASS`, `PARTIAL`, `FAIL`, `N/A`, `BLOCKED`, `TODO`.
+
+## 1. Objective / DoD Lock
+
+Original request:
+
+```text
+<paste owner request or goal text here>
+```
+
+| DoD item | Status | Evidence |
+|---|---|---|
+| Objective is concrete. | TODO |  |
+| Deliverable exists in the right place. | TODO |  |
+| Owner-facing answer can be backed by evidence. | TODO |  |
+
+## 2. Evidence-Backed Checklist
+
+| Gate | Status | Evidence |
+|---|---|---|
+| Relevant context was read. | TODO |  |
+| No unrelated worktree changes were reverted. | TODO |  |
+| Verification ran at the right scope. | TODO |  |
+
+## 3. Status Matrix
+
+| Work item / phase | Status | Evidence |
+|---|---|---|
+| Implement/write/edit | TODO |  |
+| Verify | TODO |  |
+| Close memory/session if needed | TODO |  |
+
+## 4. Evidence Matrix
+
+Commands:
+
+| Command | Status | Important output | Scope proven |
+|---|---|---|---|
+| `<command>` | TODO |  |  |
+
+Changed files:
+
+| File | Change summary | Evidence |
+|---|---|---|
+| `<file>` |  |  |
+
+## 5. Residual Risk
+
+| Risk or skipped check | Status | Evidence / reason |
+|---|---|---|
+| `<risk>` | TODO |  |
+
+## 6. Change Summary Audit
+
+What changed:
+
+- <short summary>
+
+What did not change:
+
+- <important non-change or unrelated worktree file>
+
+## 7. Final Answer Draft
+
+```text
+<short final answer>
+
+Verified:
+- <command/result>
+
+Residual risk:
+- <risk or "none known">
+```
+
+## 8. Second-Brain Routing / Memory Closeout
+
+| Routing item | Status | Evidence |
+|---|---|---|
+| Session/index/current-state update needed? | TODO |  |
+| Durable memory/decision update needed? | TODO |  |
+| Search/index refresh needed? | TODO |  |
+
+## Final Verdict
+
+| Verdict | Status | Evidence |
+|---|---|---|
+| Ready to close / caveat / blocked | TODO |  |
+
+One-line final state:
+
+> <state + evidence>
+
+up:: [[Templates/_Index]]