@warnyin/agents 0.9.1 → 0.10.0

package/src/.warnyin/template/docs/troubleshooting.md

@@ -1,32 +1,32 @@
-# Troubleshooting KB (กลาง)
-
-> คลังความรู้ปัญหา-วิธีแก้ของทั้งโปรเจกต์ — สะสมจากทุก topic
-> **อ่านไฟล์นี้ก่อนเสมอเมื่อเจอ build error / ปัญหาระหว่างทำงาน** เผื่อเคยแก้แล้ว
-> ป้อนเข้ามาตอน **SHIP**: ยก entry ที่มีค่าจาก `docs/stages/<topic>/troubleshooting.md` มารวมที่นี่ (ลบของซ้ำ/รวมที่คล้ายกัน)
-
----
-
-## วิธีค้น
-ค้นด้วย error message, component, หรือ keyword อาการ — entry เรียงตาม component แล้วตามความถี่
-
-## สารบัญตาม component
-<!-- เพิ่ม section ต่อ component เมื่อมี entry แรก เช่น - [api-service](#api-service) -->
-- [ทั่วไป / cross-cutting](#ทั่วไป--cross-cutting)
-
----
-
-## ทั่วไป / cross-cutting
-<!-- ยังไม่มี entry — เพิ่มตอน SHIP จาก topic troubleshooting.md -->
-
----
-
-## รูปแบบ entry (ใช้ตอนเพิ่มจาก SHIP)
-```markdown
-### <ชื่อปัญหา>  ·  เจอ N ครั้ง  ·  อัปเดต YYYY-MM-DD
-- **อาการ/error:** ...
-- **trigger:** ...
-- **root cause:** ...
-- **วิธีแก้:** ...
-- **ป้องกันซ้ำ:** ...
-- **มาจาก topic:** <slug>
-```
+# Troubleshooting KB (กลาง)
+
+> คลังความรู้ปัญหา-วิธีแก้ของทั้งโปรเจกต์ — สะสมจากทุก topic
+> **อ่านไฟล์นี้ก่อนเสมอเมื่อเจอ build error / ปัญหาระหว่างทำงาน** เผื่อเคยแก้แล้ว
+> ป้อนเข้ามาตอน **SHIP**: ยก entry ที่มีค่าจาก `docs/stages/<topic>/troubleshooting.md` มารวมที่นี่ (ลบของซ้ำ/รวมที่คล้ายกัน)
+
+---
+
+## วิธีค้น
+ค้นด้วย error message, component, หรือ keyword อาการ — entry เรียงตาม component แล้วตามความถี่
+
+## สารบัญตาม component
+<!-- เพิ่ม section ต่อ component เมื่อมี entry แรก เช่น - [api-service](#api-service) -->
+- [ทั่วไป / cross-cutting](#ทั่วไป--cross-cutting)
+
+---
+
+## ทั่วไป / cross-cutting
+<!-- ยังไม่มี entry — เพิ่มตอน SHIP จาก topic troubleshooting.md -->
+
+---
+
+## รูปแบบ entry (ใช้ตอนเพิ่มจาก SHIP)
+```markdown
+### <ชื่อปัญหา>  ·  เจอ N ครั้ง  ·  อัปเดต YYYY-MM-DD
+- **อาการ/error:** ...
+- **trigger:** ...
+- **root cause:** ...
+- **วิธีแก้:** ...
+- **ป้องกันซ้ำ:** ...
+- **มาจาก topic:** <slug>
+```

package/src/.warnyin/template/stages/[topic]/build.md

@@ -1,58 +1,58 @@
-# Build Report — <ชื่อ change>
-
-> Output ของ BUILD stage · playbook: `.warnyin/workflow/stages/build.md`
-> รายงานผลการ implement ต่อ task + การ integrate
-
-| | |
-|---|---|
-| **Slug** | `<kebab-case>` |
-| **Build branch** | `<branch>` |
-| **Isolation** | `worktree` / `shared-tree` |
-| **วันที่** | `YYYY-MM-DD` |
-| **ผลรวม** | ผ่าน __ / ล้ม __ / ทั้งหมด __ task |
-
-## 1. Execution plan (waves ตาม dependency)
-```
-wave 1 (parallel): task-a, task-b
-wave 2:            task-c  (ขึ้นกับ task-a)
-wave 3:            task-d  (ขึ้นกับ task-b, task-c)
-```
-
-## 2. ผลต่อ task
-| Wave | Task | สถานะ | Test/Lint | ไฟล์ที่แก้ | Branch | หมายเหตุ |
-|---|---|---|---|---|---|---|
-| 1 | task-a | ✅ passed | | | | |
-| 1 | task-b | ❌ failed | | | | เหตุผล... |
-
-## 3. Integration notes
-- การ merge แต่ละ wave / conflict ที่เจอและวิธีแก้:
-
-## 3.5 Full build & test gate (หลัง integrate ทุก wave)
-> รัน build ทั้งหมด + test suite ทั้งหมด (รวม unit test) บน build branch — ต้องเขียวหมดก่อนปิด BUILD
-
-| Component | Build | Unit test | Test อื่น | รอบที่แก้ |
-|---|---|---|---|---|
-| api-service | ✅ / ❌ | ผ่าน __/__ | | |
-| admin-console | | | | |
-
-- error ที่เจอตอนรวม + วิธีแก้:
-
-## 4. ปัญหา/ค้าง (ถ้ามี)
-- task ที่ล้ม + สาเหตุ + แผนแก้:
-
-## 5. Rule/standard ใหม่ที่ note ไว้ (รอ SHIP)
-> รวบรวมจาก `tasks/<task>/rule.md` และ `standard.md` — รอ SHIP อัปเดตไฟล์กลางใน `docs/`
--
-
-## 6. ปัญหายาก/ซ้ำที่เจอ
-> บันทึกละเอียดที่ `./troubleshooting.md` (SHIP ยกขึ้น `docs/troubleshooting.md`)
-- ดู `./troubleshooting.md`
-
-## ✅ Gate → VERIFY (ดู `.warnyin/workflow/stages/build.md` ข้อ 7)
-- [ ] ทุก task implement + merge เข้า build branch แล้ว
-- [ ] ทุก task `passed` (test/build เขียว) ไม่มี `failed` ค้าง
-- [ ] ไม่มี merge conflict ค้าง
-- [ ] Full build ของทุก component ผ่าน (ไม่มี build error)
-- [ ] test suite ทั้งหมด (รวม unit test) เขียวหมดบน build branch
-- [ ] build.md สรุปครบทุก task + ผล full build/test
-- [ ] ไม่แตะ rule/standard กลางใน docs/
+# Build Report — <ชื่อ change>
+
+> Output ของ BUILD stage · playbook: `.warnyin/workflow/stages/build.md`
+> รายงานผลการ implement ต่อ task + การ integrate
+
+| | |
+|---|---|
+| **Slug** | `<kebab-case>` |
+| **Build branch** | `<branch>` |
+| **Isolation** | `worktree` / `shared-tree` |
+| **วันที่** | `YYYY-MM-DD` |
+| **ผลรวม** | ผ่าน __ / ล้ม __ / ทั้งหมด __ task |
+
+## 1. Execution plan (waves ตาม dependency)
+```
+wave 1 (parallel): task-a, task-b
+wave 2:            task-c  (ขึ้นกับ task-a)
+wave 3:            task-d  (ขึ้นกับ task-b, task-c)
+```
+
+## 2. ผลต่อ task
+| Wave | Task | สถานะ | Test/Lint | ไฟล์ที่แก้ | Branch | หมายเหตุ |
+|---|---|---|---|---|---|---|
+| 1 | task-a | ✅ passed | | | | |
+| 1 | task-b | ❌ failed | | | | เหตุผล... |
+
+## 3. Integration notes
+- การ merge แต่ละ wave / conflict ที่เจอและวิธีแก้:
+
+## 3.5 Full build & test gate (หลัง integrate ทุก wave)
+> รัน build ทั้งหมด + test suite ทั้งหมด (รวม unit test) บน build branch — ต้องเขียวหมดก่อนปิด BUILD
+
+| Component | Build | Unit test | Test อื่น | รอบที่แก้ |
+|---|---|---|---|---|
+| api-service | ✅ / ❌ | ผ่าน __/__ | | |
+| admin-console | | | | |
+
+- error ที่เจอตอนรวม + วิธีแก้:
+
+## 4. ปัญหา/ค้าง (ถ้ามี)
+- task ที่ล้ม + สาเหตุ + แผนแก้:
+
+## 5. Rule/standard ใหม่ที่ note ไว้ (รอ SHIP)
+> รวบรวมจาก `tasks/<task>/rule.md` และ `standard.md` — รอ SHIP อัปเดตไฟล์กลางใน `docs/`
+-
+
+## 6. ปัญหายาก/ซ้ำที่เจอ
+> บันทึกละเอียดที่ `./troubleshooting.md` (SHIP ยกขึ้น `docs/troubleshooting.md`)
+- ดู `./troubleshooting.md`
+
+## ✅ Gate → VERIFY (ดู `.warnyin/workflow/stages/build.md` ข้อ 7)
+- [ ] ทุก task implement + merge เข้า build branch แล้ว
+- [ ] ทุก task `passed` (test/build เขียว) ไม่มี `failed` ค้าง
+- [ ] ไม่มี merge conflict ค้าง
+- [ ] Full build ของทุก component ผ่าน (ไม่มี build error)
+- [ ] test suite ทั้งหมด (รวม unit test) เขียวหมดบน build branch
+- [ ] build.md สรุปครบทุก task + ผล full build/test
+- [ ] ไม่แตะ rule/standard กลางใน docs/

package/src/.warnyin/template/stages/[topic]/business.md

@@ -1,21 +1,21 @@
-# Business — <ชื่อ change>
-
-> Output ของ DESIGN stage · playbook: `.warnyin/workflow/stages/design.md`
-> **optional** — ข้ามได้ถ้า change เล็ก (เช่น fix bug นิดหน่อย)
-
-## 1. เป้าหมายเชิงธุรกิจ (what & why)
-- ทำ change นี้เพื่ออะไร / แก้ปัญหาธุรกิจอะไร:
-- ผูกกับเป้าหมายโปรเจกต์ (`docs/project.md`) อย่างไร:
-
-## 2. Persona / ใครได้ประโยชน์
-- ผู้ใช้/ผู้มีส่วนได้ส่วนเสีย:
-- คุณค่าที่เขาได้รับ:
-
-## 3. Success metric (วัดผลได้)
-- ตัวชี้วัดความสำเร็จ:
-- เป้าหมายตัวเลข (ถ้ามี):
-
-## 4. ขอบเขตเชิงธุรกิจ / ข้อจำกัด
-- in scope:
-- out of scope:
-- ข้อจำกัด (compliance, เวลา, งบ ฯลฯ):
+# Business — <ชื่อ change>
+
+> Output ของ DESIGN stage · playbook: `.warnyin/workflow/stages/design.md`
+> **optional** — ข้ามได้ถ้า change เล็ก (เช่น fix bug นิดหน่อย)
+
+## 1. เป้าหมายเชิงธุรกิจ (what & why)
+- ทำ change นี้เพื่ออะไร / แก้ปัญหาธุรกิจอะไร:
+- ผูกกับเป้าหมายโปรเจกต์ (`docs/project.md`) อย่างไร:
+
+## 2. Persona / ใครได้ประโยชน์
+- ผู้ใช้/ผู้มีส่วนได้ส่วนเสีย:
+- คุณค่าที่เขาได้รับ:
+
+## 3. Success metric (วัดผลได้)
+- ตัวชี้วัดความสำเร็จ:
+- เป้าหมายตัวเลข (ถ้ามี):
+
+## 4. ขอบเขตเชิงธุรกิจ / ข้อจำกัด
+- in scope:
+- out of scope:
+- ข้อจำกัด (compliance, เวลา, งบ ฯลฯ):

package/src/.warnyin/template/stages/[topic]/design.md

@@ -1,57 +1,57 @@
-# Design (How) — <ชื่อ change>
-
-> Output ของ DESIGN stage · playbook: `.warnyin/workflow/stages/design.md`
-> ออกแบบเชิงเทคนิคแบบ **vertical slice architecture** — แต่ละ slice ตัดผ่านทุก layer ทำงาน end-to-end
-
-## 1. ภาพรวมสถาปัตยกรรม
-- component/service ที่เกี่ยวข้อง (อิง `docs/techstack/*`):
-- แนวทางหลัก:
-
-## 2. Vertical slices
-> หนึ่ง slice = หนึ่งหน่วยคุณค่า end-to-end (UI → API → domain → data → test) → จะกลายเป็น 1 task
-> **ไม่แบ่งตาม layer แนวนอน**
-
-| # | Slice (ส่งมอบคุณค่าอะไร) | ตัดผ่าน layer ไหน | → task |
-|---|---|---|---|
-| 1 | | UI · API · domain · data · test | `tasks/<task-1>/` |
-| 2 | | | `tasks/<task-2>/` |
-
-## 3. Data model / schema
-- entity / ตาราง / field ที่เพิ่มหรือแก้:
-- migration (ถ้ามี):
-
-## 4. Interface / contract
-- API contract / event / interface ระหว่าง component:
-
-## 5. Flow
-- data-flow:
-- user-flow:
-
-## 6. ผลกระทบต่อระบบเดิม
-- จุดที่ต้องระวัง / backward compatibility:
-
-## 7. Dependency ระหว่าง slice/task
-> slice/task เชื่อมกันยังไง ลำดับการทำ
-
-```
-task-1 ──▶ task-2 ──▶ task-3
-              └──▶ task-4
-```
-
-## 8. Test strategy ระดับ design
-- จะยืนยันว่า design ทำงานถูกอย่างไร (ภาพรวม — รายละเอียดอยู่ใน task spec):
-
-## 9. Spec delta (เทียบ docs/features/<name>/spec.md ปัจจุบัน)
-> พฤติกรรมที่ change นี้ เพิ่ม/แก้/ลบ — SHIP จะ merge ตามนี้แบบกึ่ง mechanical
-> change ไม่แตะพฤติกรรม feature (refactor/docs/tooling) → เขียน "ไม่มี delta" บรรทัดเดียวพอ
-
-### ADDED
-#### Requirement: <ชื่อ> (→ feature: <feature-name>)
-<พฤติกรรม + scenario ตาม format ของ spec.md>
-
-### MODIFIED
-#### Requirement: <ชื่อใหม่> (→ feature: <feature-name>) [เดิมชื่อ: <ชื่อเก่า> — ใส่เฉพาะกรณี rename]
-<เวอร์ชันใหม่เต็ม> _(เดิม: <สรุปสั้น>)_
-
-### REMOVED
-#### Requirement: <ชื่อเดิมใน spec> (→ feature: <feature-name>) — เหตุผลที่เลิก
+# Design (How) — <ชื่อ change>
+
+> Output ของ DESIGN stage · playbook: `.warnyin/workflow/stages/design.md`
+> ออกแบบเชิงเทคนิคแบบ **vertical slice architecture** — แต่ละ slice ตัดผ่านทุก layer ทำงาน end-to-end
+
+## 1. ภาพรวมสถาปัตยกรรม
+- component/service ที่เกี่ยวข้อง (อิง `docs/techstack/*`):
+- แนวทางหลัก:
+
+## 2. Vertical slices
+> หนึ่ง slice = หนึ่งหน่วยคุณค่า end-to-end (UI → API → domain → data → test) → จะกลายเป็น 1 task
+> **ไม่แบ่งตาม layer แนวนอน**
+
+| # | Slice (ส่งมอบคุณค่าอะไร) | ตัดผ่าน layer ไหน | → task |
+|---|---|---|---|
+| 1 | | UI · API · domain · data · test | `tasks/<task-1>/` |
+| 2 | | | `tasks/<task-2>/` |
+
+## 3. Data model / schema
+- entity / ตาราง / field ที่เพิ่มหรือแก้:
+- migration (ถ้ามี):
+
+## 4. Interface / contract
+- API contract / event / interface ระหว่าง component:
+
+## 5. Flow
+- data-flow:
+- user-flow:
+
+## 6. ผลกระทบต่อระบบเดิม
+- จุดที่ต้องระวัง / backward compatibility:
+
+## 7. Dependency ระหว่าง slice/task
+> slice/task เชื่อมกันยังไง ลำดับการทำ
+
+```
+task-1 ──▶ task-2 ──▶ task-3
+              └──▶ task-4
+```
+
+## 8. Test strategy ระดับ design
+- จะยืนยันว่า design ทำงานถูกอย่างไร (ภาพรวม — รายละเอียดอยู่ใน task spec):
+
+## 9. Spec delta (เทียบ docs/features/<name>/spec.md ปัจจุบัน)
+> พฤติกรรมที่ change นี้ เพิ่ม/แก้/ลบ — SHIP จะ merge ตามนี้แบบกึ่ง mechanical
+> change ไม่แตะพฤติกรรม feature (refactor/docs/tooling) → เขียน "ไม่มี delta" บรรทัดเดียวพอ
+
+### ADDED
+#### Requirement: <ชื่อ> (→ feature: <feature-name>)
+<พฤติกรรม + scenario ตาม format ของ spec.md>
+
+### MODIFIED
+#### Requirement: <ชื่อใหม่> (→ feature: <feature-name>) [เดิมชื่อ: <ชื่อเก่า> — ใส่เฉพาะกรณี rename]
+<เวอร์ชันใหม่เต็ม> _(เดิม: <สรุปสั้น>)_
+
+### REMOVED
+#### Requirement: <ชื่อเดิมใน spec> (→ feature: <feature-name>) — เหตุผลที่เลิก

package/src/.warnyin/template/stages/[topic]/discovery.md

@@ -1,69 +1,69 @@
-# Discovery — <ชื่อหัวข้องาน>
-
-> Output ของ Discovery stage · playbook: `.warnyin/workflow/stages/discovery.md`
-
-| | |
-|---|---|
-| **Slug** | `<kebab-case>` |
-| **สถานะ** | `กำลังทำ` / `ผ่าน gate แล้ว` |
-| **วันที่** | `YYYY-MM-DD` |
-| **ผู้ร่วมตัดสินใจ** | `<ชื่อ>` |
-| **เริ่มจาก** | อ้างอิง `docs/project.md` ส่วนไหน |
-
----
-
-## 1. สรุปความเข้าใจร่วมกัน (one-liner)
-> เราจะทำ **อะไร** ให้ **ใคร** เพื่อแก้ปัญหา **อะไร** — สรุปได้ใน 1-3 บรรทัด
-
-## 2. Problem & Why now
-- ปัญหา / โอกาส:
-- ทำไมต้องทำตอนนี้:
-- ผูกกับเป้าหมายโปรเจกต์ (จาก `docs/project.md`) อย่างไร:
-
-## 3. Scope (กว้าง → แคบ)
-**In scope (จะทำ)**
--
-
-**Out of scope (จะไม่ทำในรอบนี้)**
--
-
-## 4. Decision Log (เดินทีละกิ่งของ decision tree)
-> หนึ่งแถว = หนึ่งการตัดสินใจ บันทึกทันทีที่ตกลงได้
-
-| # | คำถาม / ประเด็น | ทางเลือก | คำตอบที่แนะนำ | ที่เลือกจริง | เหตุผล |
-|---|---|---|---|---|---|
-| 1 | | | | | |
-| 2 | | | | | |
-
-## 5. สมมติฐาน & ข้อจำกัด
-- สมมติฐาน:
-- ข้อจำกัด (เทคนิค/เวลา/ทรัพยากร/ระบบเดิม):
-
-## 6. เกณฑ์ความสำเร็จ (วัดผลได้)
--
-
-## 7. Feature ideas / ทางเลือกของวิธีแก้
-> ไอเดียคร่าวๆ ที่จะส่งต่อให้ DESIGN พิจารณา (ยังไม่ลงรายละเอียดออกแบบ)
--
-
-## 8. Open questions (ที่ยังค้าง)
-> ต้องปิดทุกข้อที่ block การออกแบบ ก่อนผ่าน gate
-- [ ]
-
-## 9. ความเสี่ยงหลัก
--
-
-## 10. ลิงก์ที่เกี่ยวข้อง
-- Research: `./research.md`
-- เอกสารโปรเจกต์: `docs/project.md`, `docs/...`
-- โค้ด/ไฟล์ที่ตรวจสอบ:
-
----
-
-## ✅ Gate → DESIGN (ดู `.warnyin/workflow/stages/discovery.md` ข้อ 6)
-- [ ] Problem / why-now ชัด ผูกกับ project.md
-- [ ] Scope in/out ชัด
-- [ ] Decision log ปิดทุกประเด็นสำคัญ ไม่มี open question ที่ block
-- [ ] success criteria วัดผลได้
-- [ ] สมมติฐาน/ข้อจำกัด/ความเสี่ยง บันทึกครบ
-- [ ] user ยืนยัน "เข้าใจตรงกันแล้ว"
+# Discovery — <ชื่อหัวข้องาน>
+
+> Output ของ Discovery stage · playbook: `.warnyin/workflow/stages/discovery.md`
+
+| | |
+|---|---|
+| **Slug** | `<kebab-case>` |
+| **สถานะ** | `กำลังทำ` / `ผ่าน gate แล้ว` |
+| **วันที่** | `YYYY-MM-DD` |
+| **ผู้ร่วมตัดสินใจ** | `<ชื่อ>` |
+| **เริ่มจาก** | อ้างอิง `docs/project.md` ส่วนไหน |
+
+---
+
+## 1. สรุปความเข้าใจร่วมกัน (one-liner)
+> เราจะทำ **อะไร** ให้ **ใคร** เพื่อแก้ปัญหา **อะไร** — สรุปได้ใน 1-3 บรรทัด
+
+## 2. Problem & Why now
+- ปัญหา / โอกาส:
+- ทำไมต้องทำตอนนี้:
+- ผูกกับเป้าหมายโปรเจกต์ (จาก `docs/project.md`) อย่างไร:
+
+## 3. Scope (กว้าง → แคบ)
+**In scope (จะทำ)**
+-
+
+**Out of scope (จะไม่ทำในรอบนี้)**
+-
+
+## 4. Decision Log (เดินทีละกิ่งของ decision tree)
+> หนึ่งแถว = หนึ่งการตัดสินใจ บันทึกทันทีที่ตกลงได้
+
+| # | คำถาม / ประเด็น | ทางเลือก | คำตอบที่แนะนำ | ที่เลือกจริง | เหตุผล |
+|---|---|---|---|---|---|
+| 1 | | | | | |
+| 2 | | | | | |
+
+## 5. สมมติฐาน & ข้อจำกัด
+- สมมติฐาน:
+- ข้อจำกัด (เทคนิค/เวลา/ทรัพยากร/ระบบเดิม):
+
+## 6. เกณฑ์ความสำเร็จ (วัดผลได้)
+-
+
+## 7. Feature ideas / ทางเลือกของวิธีแก้
+> ไอเดียคร่าวๆ ที่จะส่งต่อให้ DESIGN พิจารณา (ยังไม่ลงรายละเอียดออกแบบ)
+-
+
+## 8. Open questions (ที่ยังค้าง)
+> ต้องปิดทุกข้อที่ block การออกแบบ ก่อนผ่าน gate
+- [ ]
+
+## 9. ความเสี่ยงหลัก
+-
+
+## 10. ลิงก์ที่เกี่ยวข้อง
+- Research: `./research.md`
+- เอกสารโปรเจกต์: `docs/project.md`, `docs/...`
+- โค้ด/ไฟล์ที่ตรวจสอบ:
+
+---
+
+## ✅ Gate → DESIGN (ดู `.warnyin/workflow/stages/discovery.md` ข้อ 6)
+- [ ] Problem / why-now ชัด ผูกกับ project.md
+- [ ] Scope in/out ชัด
+- [ ] Decision log ปิดทุกประเด็นสำคัญ ไม่มี open question ที่ block
+- [ ] success criteria วัดผลได้
+- [ ] สมมติฐาน/ข้อจำกัด/ความเสี่ยง บันทึกครบ
+- [ ] user ยืนยัน "เข้าใจตรงกันแล้ว"

package/src/.warnyin/template/stages/[topic]/proposal.md

@@ -1,43 +1,43 @@
-# Proposal — <ชื่อ change>
-
-> Output ของ DESIGN stage · playbook: `.warnyin/workflow/stages/design.md`
-> **what & why** ของ change นี้
-
-| | |
-|---|---|
-| **Slug** | `<kebab-case>` |
-| **ประเภท** | `feature` / `bugfix` / `refactor` / `docs` |
-| **ขนาด** | `เล็ก` / `กลาง` / `ใหญ่` |
-| **วันที่** | `YYYY-MM-DD` |
-| **มาจาก Discovery?** | `./discovery.md` หรือ `ไม่มี` |
-
-## 1. สรุป change (what)
-> เราจะเปลี่ยน/สร้าง/แก้อะไร — 1-3 บรรทัด
-
-## 2. ทำไม (why)
-- ปัญหา/โอกาส:
-- ผลถ้าไม่ทำ:
-
-## 3. ทางเลือกที่พิจารณา
-| ทางเลือก | ข้อดี | ข้อเสีย | เลือก? |
-|---|---|---|---|
-| A (แนะนำ) | | | ✅ |
-| B | | | |
-
-- เหตุผลที่เลือก:
-
-## 4. Scope
-**In scope**
--
-
-**Out of scope**
--
-
-## 5. ผลกระทบ & ความเสี่ยง
-- ระบบ/ฟีเจอร์เดิมที่กระทบ:
-- ความเสี่ยง + วิธีลดความเสี่ยง:
-
-## 6. ลิงก์
-- Design (how): `./design.md`
-- Tasks: `./tasks/`
-- Business: `./business.md` (ถ้ามี)
+# Proposal — <ชื่อ change>
+
+> Output ของ DESIGN stage · playbook: `.warnyin/workflow/stages/design.md`
+> **what & why** ของ change นี้
+
+| | |
+|---|---|
+| **Slug** | `<kebab-case>` |
+| **ประเภท** | `feature` / `bugfix` / `refactor` / `docs` |
+| **ขนาด** | `เล็ก` / `กลาง` / `ใหญ่` |
+| **วันที่** | `YYYY-MM-DD` |
+| **มาจาก Discovery?** | `./discovery.md` หรือ `ไม่มี` |
+
+## 1. สรุป change (what)
+> เราจะเปลี่ยน/สร้าง/แก้อะไร — 1-3 บรรทัด
+
+## 2. ทำไม (why)
+- ปัญหา/โอกาส:
+- ผลถ้าไม่ทำ:
+
+## 3. ทางเลือกที่พิจารณา
+| ทางเลือก | ข้อดี | ข้อเสีย | เลือก? |
+|---|---|---|---|
+| A (แนะนำ) | | | ✅ |
+| B | | | |
+
+- เหตุผลที่เลือก:
+
+## 4. Scope
+**In scope**
+-
+
+**Out of scope**
+-
+
+## 5. ผลกระทบ & ความเสี่ยง
+- ระบบ/ฟีเจอร์เดิมที่กระทบ:
+- ความเสี่ยง + วิธีลดความเสี่ยง:
+
+## 6. ลิงก์
+- Design (how): `./design.md`
+- Tasks: `./tasks/`
+- Business: `./business.md` (ถ้ามี)