# Second Brain Template Kit

ชุด Markdown สำหรับคนและ AI agents ใช้ร่วมกัน ตั้งแต่รับหลักฐาน จัดความรู้ ทำงานต่อ ไปจนถึงตรวจข้อมูลก่อนนำเข้า second brain

## เริ่มใช้ใน 5 ขั้น

1. อ่าน [กติกาที่ AI ต้องอ่านก่อน](01-READ-FIRST.md) และกำหนดพื้นที่เขียนกับผู้ดูแล
2. ใช้ [Source intake](02-source-intake.md) รับข้อมูล โดยคงหลักฐานต้นทางไว้
3. เลือก template ตามชนิดข้อมูล แล้วกรอกในไฟล์ใหม่ อย่าแก้ template ต้นฉบับ
4. ตรวจไฟล์ใหม่ด้วย [Publication checklist](10-publication-checklist.md)
5. เมื่อผ่าน ให้เปลี่ยนสถานะเป็น `published` เพิ่มลิงก์ใน index แล้วทำ indexing และตรวจการค้น ตามเครื่องมือที่ใช้

คำว่า **publish** ในชุดนี้หมายถึงนำไฟล์เข้า index ที่ agent ใช้ค้นและอ้างอิงได้ ไม่ได้หมายถึงเผยแพร่สู่เว็บสาธารณะ การตั้งสิทธิ์และการเชื่อมเครื่องมือจริงต้องทำในระบบที่เลือก

## ดาวน์โหลดตามส่วนของบทความ

| ส่วน | ไฟล์ | ใช้เมื่อ |
|---|---|---|
| Concept และกติกา | [01 READ FIRST](01-READ-FIRST.md) | ให้ AI รู้ขั้นตอน ขอบเขต และเงื่อนไขก่อนเขียน |
| รับหลักฐาน | [02 Source intake](02-source-intake.md) | รับเอกสาร บทสนทนา paper หรือผลทดสอบ |
| จัดความรู้ | [03 Knowledge page](03-knowledge-page.md) | เขียนความรู้ที่ใช้ซ้ำและมีหลักฐาน |
| เก็บเหตุผล | [04 Decision record](04-decision-record.md) | บันทึกการเลือกแนวทางและสิ่งที่ปฏิเสธ |
| เก็บความจำ | [05 Agent memory](05-agent-memory.md) | เก็บ preference บทเรียน และ gotcha |
| ทำงานต่อ | [06 Task handoff](06-task-handoff.md) | เปลี่ยน session หรือส่งงานให้ agent อีกตัว |
| ปฏิบัติงาน | [07 Runbook](07-runbook.md) | ให้ขั้นตอนที่ทำตามและตรวจผลได้ |
| เลือกเครื่องมือ | [08 Tool comparison](08-tool-comparison.md) | เทียบเครื่องมือกับความต้องการเดียวกัน |
| วัดผล | [09 Benchmark plan](09-benchmark-plan.md) | ทดลองว่าระบบช่วยงานจริงหรือไม่ |
| ตรวจเข้าคลัง | [10 Publication checklist](10-publication-checklist.md) | ตรวจทุกไฟล์ก่อน publish |
| ตัวอย่างครบวงจร | [11 Worked example](11-worked-example.md) | ดู dataflow และการส่งงานต่อที่กรอกแล้ว |
| แผนที่ความรู้ | [12 Knowledge index](12-knowledge-index.md) | สร้าง index ให้ agent เลือกอ่านตามงาน |
| เตรียมระบบค้น | [13 Indexing workflow](13-indexing-workflow.md) | กำหนด ingestion, chunking, search, update และการตรวจ |

## โครงสร้างคลังที่แนะนำ

```text
secondbrain/
  READ-FIRST.md
  index.md
  inbox/          # ข้อมูลเข้า ยังไม่รับรอง
  sources/        # หลักฐานต้นทางหรือรายการอ้างอิง
  knowledge/      # ความรู้ใช้ซ้ำ
  decisions/      # เหตุผลการตัดสินใจ
  memory/         # บทเรียนและ preference ที่มี scope
  tasks/          # สถานะงาน ต้องไม่ปะปนกับความรู้ถาวร
  runbooks/       # ขั้นตอนปฏิบัติ
  evaluations/   # การเปรียบเทียบและผลทดลอง
  reviews/        # บันทึกตรวจเข้าคลัง
  archive/        # รายการถูกแทนที่ ห้ามใช้เป็นข้อมูลปัจจุบัน
```

โครงสร้างนี้เป็นข้อเสนอ ไม่ใช่ schema มาตรฐานของ Obsidian, gbrain, Notion หรือระบบ memory ใด การนำเข้าอาจต้องแปลง metadata และ links ให้ตรงกับเครื่องมือ

## Index กับ Indexing

**Knowledge index** เป็นแผนที่ที่คนและ agent อ่าน เช่น `index.md` บอกว่าข้อมูลอยู่ไหน ใช้กับงานอะไร และควรอ่านอะไรก่อน ส่วน **indexing** เป็นกระบวนการเตรียมข้อมูลเข้าสู่โครงสร้างค้น เช่น keyword index, vector index หรือ graph ทั้งสองช่วยกัน แต่การมี `index.md` ไม่ได้สร้าง search index โดยอัตโนมัติ

## สถานะและการค้น

- `draft`: ยังเขียนไม่ครบ ห้ามใช้เป็นข้อเท็จจริงที่รับรองแล้ว
- `review`: กรอกครบ รอผ่านรายการตรวจ
- `published`: ผ่านรายการตรวจและอยู่ในขอบเขตที่อนุญาตให้เขียน
- `superseded`: มีฉบับใหม่แทน ต้องตามลิงก์ไปฉบับใหม่
- `archived`: เก็บเป็นประวัติ ไม่ใช้ยืนยันสถานะปัจจุบัน

ตั้ง search/index ให้แยก `draft`, `review` และตัวอย่างออกจากผลค้นที่รับรองแล้ว Markdown บอกสถานะได้ แต่ไม่ได้บังคับ retrieval หรือสิทธิ์ให้เอง

## หลักการกรอก

- ช่อง `{{...}}` ต้องแทนด้วยข้อมูลจริง ช่องที่ไม่มีข้อมูลให้เขียน `unknown` หรือ `not_applicable` พร้อมเหตุผล
- อย่าเปลี่ยน unknown เป็นข้อเท็จจริงจากการเดา
- วันที่ใช้ `YYYY-MM-DD` เวลาใช้ ISO 8601 พร้อม timezone
- ID ต้องคงเดิมเมื่อแก้รายการเดิม และต้องไม่ซ้ำกันในคลัง
- ตัวอย่างในชุดนี้เป็นข้อมูลสมมติ ห้ามนำเข้า index ของข้อมูลจริง

## Prompt เริ่มงาน

> อ่าน READ-FIRST.md และ index.md ก่อน รับข้อมูลตาม Source intake แล้วเลือก template ที่ตรงชนิดข้อมูล สร้าง draft พร้อมลิงก์หลักฐาน ตรวจด้วย Publication checklist หากผ่านและมีสิทธิ์ publish ให้เพิ่มเข้า index หากยังไม่ผ่าน ให้รายงานช่องที่ขาดโดยไม่เปลี่ยนสถานะเป็น published
