# {{ชื่อคลัง}} Knowledge Index

คัดลอกไฟล์นี้เป็น `index.md` ของคลังแล้วกรอกข้อมูลจริง เป็นแผนที่ให้คนและ agent เลือกอ่าน ไม่ใช่ search database และไม่ควรใส่เนื้อหาทุกหน้าไว้ที่นี่

## อ่านก่อนเริ่มงาน

1. กติกาและสิทธิ์: {{ลิงก์ READ-FIRST.md}}
2. ภาพรวมระบบหรือ domain: {{ลิงก์ overview}}
3. สถานะงานปัจจุบัน: {{ลิงก์ tasks index หรือระบบงาน}}

ผู้ดูแล index: {{ชื่อหรือทีม}} · ตรวจล่าสุด: {{วันที่}} · Scope: {{ขอบเขตคลัง}}

## เลือกอ่านตามงาน

| งานของ agent | อ่านก่อน | อ่านเพิ่มเมื่อจำเป็น | ตรวจข้อมูลสดจาก |
|---|---|---|---|
| ทำหรือแก้ feature | {{spec + architecture}} | {{decisions + domain rules}} | {{code + schema + tests}} |
| แก้ incident | {{runbook}} | {{postmortem + gotchas}} | {{logs + metrics + config}} |
| รับงานต่อ | {{active task}} | {{spec + decisions}} | {{branch + diff + CI}} |
| เลือกเครื่องมือ | {{requirements}} | {{comparison + evaluation}} | {{official docs + ราคา}} |
| ทำรายงานทีม | {{report guide}} | {{accepted decisions}} | {{issues + project status}} |

## หมวดความรู้

| หมวด | Index ย่อยหรือหน้าหลัก | ขอบเขต | เจ้าของ |
|---|---|---|---|
| Domain | {{link}} | {{scope}} | {{owner}} |
| Architecture | {{link}} | {{scope}} | {{owner}} |
| Decisions | {{link}} | {{scope}} | {{owner}} |
| Runbooks | {{link}} | {{scope}} | {{owner}} |
| Memory | {{link}} | {{scope}} | {{owner}} |
| Tasks | {{link}} | {{scope}} | {{owner}} |

เมื่อรายการเยอะให้แตก index ย่อยตามระบบหรือหมวด และคง index หลักเป็นจุดนำทาง ไม่จำเป็นต้องโหลดทุกหน้าหรือทุก index เข้า context พร้อมกัน

## รายการในหมวดนี้

| ID | ชื่อและลิงก์ | ใช้ตอบคำถามอะไร | Status | Scope | ตรวจล่าสุด |
|---|---|---|---|---|---|
| {{stable-id}} | {{ชื่อ + link}} | {{ประโยคเดียว}} | {{published}} | {{scope}} | {{วันที่}} |

ค่า status ตรงนี้ต้องตรงกับเอกสารต้นทาง รายการ published ยังอาจมี decision_state เป็น proposed ต้องตรวจสถานะการตัดสินใจแยกต่างหาก

## คำศัพท์และชื่อเรียกอื่น

| คำที่คนหรือ agent ใช้ | ความหมาย | หน้าหลัก |
|---|---|---|
| {{คำย่อ / alias ไทยหรืออังกฤษ}} | {{ความหมายใน domain นี้}} | {{link}} |

## ข้อมูลที่เปลี่ยนหรือมีข้อขัดแย้ง

- ถูกแทนที่: {{หน้าเดิม → หน้าใหม่ / ไม่มี}}
- ยังขัดแย้ง: {{แหล่งที่ขัดกัน + สิ่งที่ยังไม่ยุติ / ไม่มี}}
- ต้องตรวจข้อมูลสด: {{หัวข้อ + ระบบต้นทาง}}

## กติกาสำหรับ agent

1. เลือกเส้นทางตามงานจากตาราง ไม่อ่านทั้งคลังโดยไม่มีเหตุผล
2. เปิดหน้าจริง ตรวจ scope, status, version และหลักฐานก่อนใช้
3. ถ้าไม่พบใน index ให้ค้นด้วยคำตรงและ alias ภายในพื้นที่ที่มีสิทธิ์
4. ถ้าค้นยังไม่พบ อย่าสรุปทันทีว่าไม่มีข้อมูล ตรวจ index ย่อยหรือแหล่งต้นทางที่เกี่ยวข้อง
5. เมื่อข้อมูลยังไม่พอให้รายงานสิ่งที่ตรวจแล้วและคำถามที่ขาด

## วิธีดูแล index

- เพิ่ม: ลงรายการหลังผ่าน Publication checklist
- แก้: ปรับคำอธิบาย scope และวันที่ตรวจให้ตรงกับหน้าจริง
- ย้าย: คง ID เดิม ปรับ path และลิงก์ที่ชี้มา
- แทนที่: ชี้หน้าใหม่และระบุสถานะของหน้าเดิม
- ลบหรือถอนสิทธิ์: เอาออกจาก index ของผู้ที่ไม่มีสิทธิ์ พร้อมจัดการ search index
- ตรวจเป็นรอบ: หา broken links, ID ซ้ำ, หน้าที่ไม่มีลิงก์เข้า และรายการที่ metadata ไม่ตรง

Knowledge index เป็นข้อมูลที่ผู้ใช้มองเห็นได้ ต้องแบ่งตาม access ของคลัง การซ่อนเนื้อหาอย่างเดียวแต่เปิดชื่อหรือ snippet อาจยังเปิดเผยข้อมูล