@warnyin/agents 0.9.0 → 0.10.0

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

@@ -1,49 +1,49 @@
-# Research — <ชื่อหัวข้องาน>
-
-> Output ของ Discovery stage · playbook: `.warnyin/workflow/stages/discovery.md`
-> ที่เก็บ "ข้อมูลที่ค้นมา + หลักฐาน" สนับสนุนการตัดสินใจใน `discovery.md`
-
-| | |
-|---|---|
-| **Slug** | `<kebab-case>` |
-| **วันที่** | `YYYY-MM-DD` |
-
----
-
-## 1. คำถามวิจัย (research questions)
-> สิ่งที่ "ยังไม่รู้" และต้องค้นให้ได้คำตอบก่อนออกแบบ
-- [ ] RQ1:
-- [ ] RQ2:
-
-## 2. วิธี & แหล่งข้อมูล
-- [ ] อ่านโค้ด/เอกสารในโปรเจกต์ (code inspection)
-- [ ] ค้นเว็บ / เอกสารภายนอก
-- [ ] prior art / วิธีที่ทีม/คนอื่นทำ
-
-## 3. Findings (ผลการค้นต่อคำถาม)
-> ทุก finding ต้องมี evidence/link อ้างอิงได้
-
-### RQ1: <คำถาม>
-- พบว่า:
-- หลักฐาน:
-- สรุป/นัยต่อการออกแบบ:
-
-### RQ2: <คำถาม>
--
-
-## 4. Code inspection (สิ่งที่ตอบได้จากโค้ดเอง โดยไม่ต้องถาม user)
-| ไฟล์ / ส่วนของโค้ด | สิ่งที่พบ | นัยต่องาน |
-|---|---|---|
-| | | |
-
-## 5. ทางเลือก & เปรียบเทียบ (ถ้ามี)
-| ทางเลือก | ข้อดี | ข้อเสีย | เหมาะกับเคสนี้? |
-|---|---|---|---|
-| | | | |
-
-## 6. ความเสี่ยง / unknown ที่ยังเหลือ
--
-
-## 7. ข้อสรุป → ส่งต่อ
-- คำแนะนำจาก research:
-- การตัดสินใจที่ป้อนกลับเข้า `discovery.md` (Decision Log):
+# Research — <ชื่อหัวข้องาน>
+
+> Output ของ Discovery stage · playbook: `.warnyin/workflow/stages/discovery.md`
+> ที่เก็บ "ข้อมูลที่ค้นมา + หลักฐาน" สนับสนุนการตัดสินใจใน `discovery.md`
+
+| | |
+|---|---|
+| **Slug** | `<kebab-case>` |
+| **วันที่** | `YYYY-MM-DD` |
+
+---
+
+## 1. คำถามวิจัย (research questions)
+> สิ่งที่ "ยังไม่รู้" และต้องค้นให้ได้คำตอบก่อนออกแบบ
+- [ ] RQ1:
+- [ ] RQ2:
+
+## 2. วิธี & แหล่งข้อมูล
+- [ ] อ่านโค้ด/เอกสารในโปรเจกต์ (code inspection)
+- [ ] ค้นเว็บ / เอกสารภายนอก
+- [ ] prior art / วิธีที่ทีม/คนอื่นทำ
+
+## 3. Findings (ผลการค้นต่อคำถาม)
+> ทุก finding ต้องมี evidence/link อ้างอิงได้
+
+### RQ1: <คำถาม>
+- พบว่า:
+- หลักฐาน:
+- สรุป/นัยต่อการออกแบบ:
+
+### RQ2: <คำถาม>
+-
+
+## 4. Code inspection (สิ่งที่ตอบได้จากโค้ดเอง โดยไม่ต้องถาม user)
+| ไฟล์ / ส่วนของโค้ด | สิ่งที่พบ | นัยต่องาน |
+|---|---|---|
+| | | |
+
+## 5. ทางเลือก & เปรียบเทียบ (ถ้ามี)
+| ทางเลือก | ข้อดี | ข้อเสีย | เหมาะกับเคสนี้? |
+|---|---|---|---|
+| | | | |
+
+## 6. ความเสี่ยง / unknown ที่ยังเหลือ
+-
+
+## 7. ข้อสรุป → ส่งต่อ
+- คำแนะนำจาก research:
+- การตัดสินใจที่ป้อนกลับเข้า `discovery.md` (Decision Log):

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

@@ -1,32 +1,32 @@
-# Ship — <ชื่อ topic>
-
-> Output ของ SHIP stage · playbook: `.warnyin/workflow/stages/ship.md`
-> สรุปการส่งมอบ — เขียนหลังย้าย topic เข้า `docs/stages/achieved/<YYYY-MM-DD>-<slug>/` แล้ว
-
-## 1. สรุป topic
-- ทำอะไร: <!-- หนึ่งย่อหน้า: topic นี้ทำอะไร ทำอย่างไร -->
-- ประเภท: ☐ feature ใหม่ / ☐ ปรับปรุง feature เดิม → `docs/features/<feature-name>/`
-
-## 2. เอกสารกลางที่อัปเดต
-| ไฟล์ | สาระที่ promote |
-|---|---|
-| `docs/features/<feature-name>/` | |
-| `docs/features/<feature-name>/spec.md` | <!-- merge Spec delta จาก design.md §9 --> |
-| `docs/techstack/<component>/rule.md` | |
-| `docs/techstack/<component>/standard.md` | |
-| `docs/techstack/<component>/structure.md` | |
-| `docs/techstack/<component>/test.md` | |
-| `docs/rule.md` | |
-| `docs/troubleshooting.md` | |
-| `docs/infra.md` / `docs/project.md` | <!-- ถ้าเกี่ยวข้อง --> |
-| `docs/codemap/` | |
-
-## 3. Learned rules (planned + emergent)
-> กฎ generalize ที่จับจาก topic นี้ — planned (`tasks/*/rule.md` §2) + emergent (บทเรียนตอน build/verify/troubleshooting). evidence บังคับ; ไม่มี evidence = ไม่ promote. ครอบทั้งที่ promote และที่ตัด.
-
-| rule (generalize) | evidence (pointer + artifact) | scope (`component:<c>` / `project`) | promote? (✅ / ✂️ + เหตุผล) |
-|---|---|---|---|
-| | | | |
-
-## 4. Archive
-- ย้ายจาก `docs/stages/<slug>/` → `docs/stages/achieved/<YYYY-MM-DD>-<slug>/` เมื่อ <YYYY-MM-DD>
+# Ship — <ชื่อ topic>
+
+> Output ของ SHIP stage · playbook: `.warnyin/workflow/stages/ship.md`
+> สรุปการส่งมอบ — เขียนหลังย้าย topic เข้า `docs/stages/achieved/<YYYY-MM-DD>-<slug>/` แล้ว
+
+## 1. สรุป topic
+- ทำอะไร: <!-- หนึ่งย่อหน้า: topic นี้ทำอะไร ทำอย่างไร -->
+- ประเภท: ☐ feature ใหม่ / ☐ ปรับปรุง feature เดิม → `docs/features/<feature-name>/`
+
+## 2. เอกสารกลางที่อัปเดต
+| ไฟล์ | สาระที่ promote |
+|---|---|
+| `docs/features/<feature-name>/` | |
+| `docs/features/<feature-name>/spec.md` | <!-- merge Spec delta จาก design.md §9 --> |
+| `docs/techstack/<component>/rule.md` | |
+| `docs/techstack/<component>/standard.md` | |
+| `docs/techstack/<component>/structure.md` | |
+| `docs/techstack/<component>/test.md` | |
+| `docs/rule.md` | |
+| `docs/troubleshooting.md` | |
+| `docs/infra.md` / `docs/project.md` | <!-- ถ้าเกี่ยวข้อง --> |
+| `docs/codemap/` | |
+
+## 3. Learned rules (planned + emergent)
+> กฎ generalize ที่จับจาก topic นี้ — planned (`tasks/*/rule.md` §2) + emergent (บทเรียนตอน build/verify/troubleshooting). evidence บังคับ; ไม่มี evidence = ไม่ promote. ครอบทั้งที่ promote และที่ตัด.
+
+| rule (generalize) | evidence (pointer + artifact) | scope (`component:<c>` / `project`) | promote? (✅ / ✂️ + เหตุผล) |
+|---|---|---|---|
+| | | | |
+
+## 4. Archive
+- ย้ายจาก `docs/stages/<slug>/` → `docs/stages/achieved/<YYYY-MM-DD>-<slug>/` เมื่อ <YYYY-MM-DD>

package/src/.warnyin/template/stages/[topic]/tasks/[task-name]/issue.md

@@ -1,19 +1,19 @@
-# Issue — <ชื่อ task>
-
-> Output ของ DESIGN dry-run · playbook: `.warnyin/workflow/stages/design.md` (ข้อ 4.9)
-> ผลสแกนหา defer/blocker ของ task นี้ก่อนเข้า BUILD — **สร้างเฉพาะเมื่อพบ issue**
-
-## 1. สรุป
-- ผลสแกน: blocker __ ข้อ · defer __ ข้อ
-- สถานะรวม: ☐ แก้ครบ ไม่มี blocker ค้าง / ☐ มี blocker ค้าง (ห้ามเข้า BUILD)
-
-## 2. รายการ issue
-| # | ประเภท | จุดที่พบ (ไฟล์/spec/โค้ด) | รายละเอียด | แนวทางแก้ / ข้อสรุป | สถานะ |
-|---|---|---|---|---|---|
-| 1 | blocker / defer | | | | open / resolved |
-
-> - **blocker** — ทำให้ implement ตาม spec ไม่ได้ (ขัดแย้งกับโค้ดจริง/task อื่น, ข้อมูลขาด, dependency ผิด) → ต้องแก้ DESIGN ก่อนเข้า BUILD
-> - **defer** — ตัดสินใจ/ทำทีหลังได้ ไม่ block การเริ่ม BUILD แต่ต้องบันทึกและให้ user รับทราบ
-
-## 3. ผลการแก้ไข
-<!-- แก้อะไรใน design.md / task ไหนบ้าง + ผล rerun dry-run; ข้อสรุปจากการสัมภาษณ์ user (ถ้ามี) -->
+# Issue — <ชื่อ task>
+
+> Output ของ DESIGN dry-run · playbook: `.warnyin/workflow/stages/design.md` (ข้อ 4.9)
+> ผลสแกนหา defer/blocker ของ task นี้ก่อนเข้า BUILD — **สร้างเฉพาะเมื่อพบ issue**
+
+## 1. สรุป
+- ผลสแกน: blocker __ ข้อ · defer __ ข้อ
+- สถานะรวม: ☐ แก้ครบ ไม่มี blocker ค้าง / ☐ มี blocker ค้าง (ห้ามเข้า BUILD)
+
+## 2. รายการ issue
+| # | ประเภท | จุดที่พบ (ไฟล์/spec/โค้ด) | รายละเอียด | แนวทางแก้ / ข้อสรุป | สถานะ |
+|---|---|---|---|---|---|
+| 1 | blocker / defer | | | | open / resolved |
+
+> - **blocker** — ทำให้ implement ตาม spec ไม่ได้ (ขัดแย้งกับโค้ดจริง/task อื่น, ข้อมูลขาด, dependency ผิด) → ต้องแก้ DESIGN ก่อนเข้า BUILD
+> - **defer** — ตัดสินใจ/ทำทีหลังได้ ไม่ block การเริ่ม BUILD แต่ต้องบันทึกและให้ user รับทราบ
+
+## 3. ผลการแก้ไข
+<!-- แก้อะไรใน design.md / task ไหนบ้าง + ผล rerun dry-run; ข้อสรุปจากการสัมภาษณ์ user (ถ้ามี) -->

package/src/.warnyin/template/stages/[topic]/tasks/[task-name]/rule.md

@@ -1,13 +1,13 @@
-# Rule — <ชื่อ task>
-
-> Output ของ DESIGN stage · playbook: `.warnyin/workflow/stages/design.md`
-> rule ที่ task นี้ต้อง **focus/follow** + rule ใหม่ที่อยากเสนอเพิ่ม
-
-## 1. Rule ที่ต้อง follow (จาก techstack)
-> ดึงจาก `docs/techstack/<component>/rule.md` และ `docs/rule.md` — เฉพาะข้อที่เกี่ยวกับ task นี้
-- [ ]
-- [ ]
-
-## 2. เสนอเพิ่ม rule ใหม่ (⏳ รอ SHIP ค่อยอัปเดต rule กลาง)
-> ห้ามแก้ `docs/techstack/.../rule.md` ตอนนี้ — แค่ note ไว้ก่อน ถึง SHIP ค่อยพิจารณาย้ายขึ้นไป
-- [ ] rule ที่เสนอ: _____ — เหตุผล: _____
+# Rule — <ชื่อ task>
+
+> Output ของ DESIGN stage · playbook: `.warnyin/workflow/stages/design.md`
+> rule ที่ task นี้ต้อง **focus/follow** + rule ใหม่ที่อยากเสนอเพิ่ม
+
+## 1. Rule ที่ต้อง follow (จาก techstack)
+> ดึงจาก `docs/techstack/<component>/rule.md` และ `docs/rule.md` — เฉพาะข้อที่เกี่ยวกับ task นี้
+- [ ]
+- [ ]
+
+## 2. เสนอเพิ่ม rule ใหม่ (⏳ รอ SHIP ค่อยอัปเดต rule กลาง)
+> ห้ามแก้ `docs/techstack/.../rule.md` ตอนนี้ — แค่ note ไว้ก่อน ถึง SHIP ค่อยพิจารณาย้ายขึ้นไป
+- [ ] rule ที่เสนอ: _____ — เหตุผล: _____

package/src/.warnyin/template/stages/[topic]/tasks/[task-name]/spec.md

@@ -1,36 +1,36 @@
-# Spec — <ชื่อ task>
-
-> Output ของ DESIGN stage · playbook: `.warnyin/workflow/stages/design.md`
-> spec เฉพาะของ task นี้ — **ใส่เฉพาะหัวข้อที่เกี่ยวข้องกับชนิดของ task**
-
-## 1. ชนิดของ task
-`API` / `UX-UI` / `data` / `logic` / `infra` / ...
-
----
-
-## 2. API SPEC (ถ้าเป็น API — ตามมาตรฐาน)
-| | |
-|---|---|
-| Endpoint | `METHOD /path` |
-| Auth | |
-| Request | schema / body / params |
-| Response | schema + ตัวอย่าง |
-| Status / Error | 200 / 4xx / 5xx + error shape |
-
-## 3. UX/UI SPEC (ถ้าเป็นงาน UI)
-- Wireframe / Figma ref: `<ลิงก์ ถ้ามี>`
-- States: default / loading / empty / error / success
-- Responsive / accessibility:
-
-## 4. Data-flow
-> ข้อมูลไหลจากไหน → ผ่านอะไร → ไปไหน
-
-## 5. User-flow
-> ผู้ใช้เดินผ่านขั้นตอนไหนบ้าง
-
-## 6. Persona
-> task นี้ทำเพื่อใคร
-
-## 7. Test-flow
-> จะทดสอบ/ยืนยันความถูกต้องยังไง (เคสที่ต้องผ่าน, edge case)
-- [ ]
+# Spec — <ชื่อ task>
+
+> Output ของ DESIGN stage · playbook: `.warnyin/workflow/stages/design.md`
+> spec เฉพาะของ task นี้ — **ใส่เฉพาะหัวข้อที่เกี่ยวข้องกับชนิดของ task**
+
+## 1. ชนิดของ task
+`API` / `UX-UI` / `data` / `logic` / `infra` / ...
+
+---
+
+## 2. API SPEC (ถ้าเป็น API — ตามมาตรฐาน)
+| | |
+|---|---|
+| Endpoint | `METHOD /path` |
+| Auth | |
+| Request | schema / body / params |
+| Response | schema + ตัวอย่าง |
+| Status / Error | 200 / 4xx / 5xx + error shape |
+
+## 3. UX/UI SPEC (ถ้าเป็นงาน UI)
+- Wireframe / Figma ref: `<ลิงก์ ถ้ามี>`
+- States: default / loading / empty / error / success
+- Responsive / accessibility:
+
+## 4. Data-flow
+> ข้อมูลไหลจากไหน → ผ่านอะไร → ไปไหน
+
+## 5. User-flow
+> ผู้ใช้เดินผ่านขั้นตอนไหนบ้าง
+
+## 6. Persona
+> task นี้ทำเพื่อใคร
+
+## 7. Test-flow
+> จะทดสอบ/ยืนยันความถูกต้องยังไง (เคสที่ต้องผ่าน, edge case)
+- [ ]

package/src/.warnyin/template/stages/[topic]/tasks/[task-name]/standard.md

@@ -1,21 +1,21 @@
-# Standard — <ชื่อ task>
-
-> Output ของ DESIGN stage · playbook: `.warnyin/workflow/stages/design.md`
-> pattern การเขียนโค้ด / shared component ที่ task นี้ต้องยึด
-> **อิงจาก** `docs/techstack/<component>/standard.md` — เพิ่มเติมเฉพาะ task ได้
-
-## 1. Standard กลางที่ยึด (จาก techstack)
-> อ้างอิง `docs/techstack/<component>/standard.md` — ข้อไหนเกี่ยวกับ task นี้
--
-
-## 2. Pattern การเขียนโค้ดของ task นี้
-- โครงสร้าง/naming:
-- error handling:
-- การจัดการ state/data:
-
-## 3. Shared component / utility ที่ต้องใช้ (อย่าเขียนซ้ำ)
-- component/hook/helper ที่มีอยู่แล้ว:
-
-## 4. เพิ่มเติมเฉพาะ task (ถ้ามี)
-> pattern ใหม่ที่ task นี้แนะนำ — ถ้าควรเป็นมาตรฐานกลาง ให้ note ใน `rule.md` (รอ SHIP อัปเดต standard กลาง)
--
+# Standard — <ชื่อ task>
+
+> Output ของ DESIGN stage · playbook: `.warnyin/workflow/stages/design.md`
+> pattern การเขียนโค้ด / shared component ที่ task นี้ต้องยึด
+> **อิงจาก** `docs/techstack/<component>/standard.md` — เพิ่มเติมเฉพาะ task ได้
+
+## 1. Standard กลางที่ยึด (จาก techstack)
+> อ้างอิง `docs/techstack/<component>/standard.md` — ข้อไหนเกี่ยวกับ task นี้
+-
+
+## 2. Pattern การเขียนโค้ดของ task นี้
+- โครงสร้าง/naming:
+- error handling:
+- การจัดการ state/data:
+
+## 3. Shared component / utility ที่ต้องใช้ (อย่าเขียนซ้ำ)
+- component/hook/helper ที่มีอยู่แล้ว:
+
+## 4. เพิ่มเติมเฉพาะ task (ถ้ามี)
+> pattern ใหม่ที่ task นี้แนะนำ — ถ้าควรเป็นมาตรฐานกลาง ให้ note ใน `rule.md` (รอ SHIP อัปเดต standard กลาง)
+-

package/src/.warnyin/template/stages/[topic]/tasks/[task-name]/task.md

@@ -1,39 +1,39 @@
-# Task — <ชื่อ task>
-
-> Output ของ DESIGN stage · playbook: `.warnyin/workflow/stages/design.md`
-> หน่วยที่ **โยนให้ sub-agent ทำใน BUILD ได้** — self-contained แต่เชื่อมกับ task อื่นผ่าน dependency
-
-| | |
-|---|---|
-| **Task** | `<kebab-case>` |
-| **Slice อ้างอิง** | `design.md` slice #__ |
-| **Component** | `admin-console` / `api-service` / ... |
-| **สถานะ** | `รอ build` / `กำลังทำ` / `เสร็จ` |
-
-## 1. เป้าหมายของ task (vertical slice)
-> task นี้ส่งมอบคุณค่า end-to-end อะไร
-
-## 2. Dependency (เชื่อมต่อกับ task อื่น)
-- ต้องทำหลัง: `tasks/<...>` (เพราะ ...)
-- ปลดล็อกให้: `tasks/<...>`
-- ส่ง output อะไรต่อให้ task ถัดไป:
-
-## 3. Sub-tasks (แตกย่อยถ้าซับซ้อน)
-> sub-task ต้องเชื่อมต่อกัน — ระบุลำดับ/สิ่งที่ส่งต่อกัน
-
-- [ ] 1. <sub-task> — _ผลลัพธ์:_
-- [ ] 2. <sub-task> — _ขึ้นกับ 1:_
-- [ ] 3. <sub-task>
-
-## 4. ขอบเขตไฟล์/โค้ดที่จะแตะ
-- ไฟล์/โมดูล:
-
-## 5. Acceptance criteria (เกณฑ์ว่า task เสร็จ)
-- [ ]
-- [ ] ผ่าน test ตาม `spec.md` (test-flow)
-- [ ] ทำตาม `rule.md` และ `standard.md`
-
-## 6. อ้างอิงในโฟลเดอร์ task นี้
-- Spec: `./spec.md`
-- Standard (pattern โค้ด): `./standard.md`
-- Rule ที่ต้อง follow: `./rule.md`
+# Task — <ชื่อ task>
+
+> Output ของ DESIGN stage · playbook: `.warnyin/workflow/stages/design.md`
+> หน่วยที่ **โยนให้ sub-agent ทำใน BUILD ได้** — self-contained แต่เชื่อมกับ task อื่นผ่าน dependency
+
+| | |
+|---|---|
+| **Task** | `<kebab-case>` |
+| **Slice อ้างอิง** | `design.md` slice #__ |
+| **Component** | `admin-console` / `api-service` / ... |
+| **สถานะ** | `รอ build` / `กำลังทำ` / `เสร็จ` |
+
+## 1. เป้าหมายของ task (vertical slice)
+> task นี้ส่งมอบคุณค่า end-to-end อะไร
+
+## 2. Dependency (เชื่อมต่อกับ task อื่น)
+- ต้องทำหลัง: `tasks/<...>` (เพราะ ...)
+- ปลดล็อกให้: `tasks/<...>`
+- ส่ง output อะไรต่อให้ task ถัดไป:
+
+## 3. Sub-tasks (แตกย่อยถ้าซับซ้อน)
+> sub-task ต้องเชื่อมต่อกัน — ระบุลำดับ/สิ่งที่ส่งต่อกัน
+
+- [ ] 1. <sub-task> — _ผลลัพธ์:_
+- [ ] 2. <sub-task> — _ขึ้นกับ 1:_
+- [ ] 3. <sub-task>
+
+## 4. ขอบเขตไฟล์/โค้ดที่จะแตะ
+- ไฟล์/โมดูล:
+
+## 5. Acceptance criteria (เกณฑ์ว่า task เสร็จ)
+- [ ]
+- [ ] ผ่าน test ตาม `spec.md` (test-flow)
+- [ ] ทำตาม `rule.md` และ `standard.md`
+
+## 6. อ้างอิงในโฟลเดอร์ task นี้
+- Spec: `./spec.md`
+- Standard (pattern โค้ด): `./standard.md`
+- Rule ที่ต้อง follow: `./rule.md`

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

@@ -1,46 +1,46 @@
-# Test Plan — <ชื่อ change>
-
-> Output ของ VERIFY stage · playbook: `.warnyin/workflow/stages/verify.md`
-> แผน/วิธีเทสของ topic นี้ — ตอน **SHIP** จะ merge เข้า `docs/techstack/<component>/test.md`
-> อิง guideline จาก `docs/techstack/<component>/test.md` (ถ้าไม่มี = เสนอวิธีใหม่ที่นี่)
-
-| | |
-|---|---|
-| **Slug** | `<kebab-case>` |
-| **Component** | `api-service` / `admin-console` |
-| **จุดประสงค์ที่ต้อง verify** | (สรุปจาก spec/tasks) |
-
-## 1. ขอบเขตการเทส (ตามจุดประสงค์ topic)
-- สิ่งที่ต้องยืนยันว่าทำงานถูก:
-
-## 2. ชนิดการเทส
-- [ ] Functional (ตาม test-flow ใน `tasks/*/spec.md`)
-- [ ] E2E smoke — เครื่องมือ: `playwright-cli` (ถ้าเป็น FE)
-- [ ] Integration / API
-- [ ] UX/UI verify (ถ้าเป็น FE)
-- [ ] อื่นๆ:
-
-## 3. Local env ที่ต้องรัน (จาก `docs/infra.md`)
-| Service | คำสั่งรัน | port / หมายเหตุ |
-|---|---|---|
-| | | |
-
-## 4. Test cases
-| # | สถานการณ์ (อิงจุดประสงค์) | ขั้นตอน | ผลที่คาดหวัง |
-|---|---|---|---|
-| 1 | | | |
-
-## 5. E2E smoke (FE)
-- flow ที่ smoke:
-- คำสั่ง playwright-cli:
-
-## 6. UX/UI checklist (FE)
-- [ ] layout ตรงตาม spec/wireframe
-- [ ] states: loading / empty / error / success
-- [ ] responsive
-- [ ] interaction / user-flow ลื่นไหล
-
-## 7. วิธีรันเทส (reproducible)
-```
-<คำสั่ง / ขั้นตอน>
-```
+# Test Plan — <ชื่อ change>
+
+> Output ของ VERIFY stage · playbook: `.warnyin/workflow/stages/verify.md`
+> แผน/วิธีเทสของ topic นี้ — ตอน **SHIP** จะ merge เข้า `docs/techstack/<component>/test.md`
+> อิง guideline จาก `docs/techstack/<component>/test.md` (ถ้าไม่มี = เสนอวิธีใหม่ที่นี่)
+
+| | |
+|---|---|
+| **Slug** | `<kebab-case>` |
+| **Component** | `api-service` / `admin-console` |
+| **จุดประสงค์ที่ต้อง verify** | (สรุปจาก spec/tasks) |
+
+## 1. ขอบเขตการเทส (ตามจุดประสงค์ topic)
+- สิ่งที่ต้องยืนยันว่าทำงานถูก:
+
+## 2. ชนิดการเทส
+- [ ] Functional (ตาม test-flow ใน `tasks/*/spec.md`)
+- [ ] E2E smoke — เครื่องมือ: `playwright-cli` (ถ้าเป็น FE)
+- [ ] Integration / API
+- [ ] UX/UI verify (ถ้าเป็น FE)
+- [ ] อื่นๆ:
+
+## 3. Local env ที่ต้องรัน (จาก `docs/infra.md`)
+| Service | คำสั่งรัน | port / หมายเหตุ |
+|---|---|---|
+| | | |
+
+## 4. Test cases
+| # | สถานการณ์ (อิงจุดประสงค์) | ขั้นตอน | ผลที่คาดหวัง |
+|---|---|---|---|
+| 1 | | | |
+
+## 5. E2E smoke (FE)
+- flow ที่ smoke:
+- คำสั่ง playwright-cli:
+
+## 6. UX/UI checklist (FE)
+- [ ] layout ตรงตาม spec/wireframe
+- [ ] states: loading / empty / error / success
+- [ ] responsive
+- [ ] interaction / user-flow ลื่นไหล
+
+## 7. วิธีรันเทส (reproducible)
+```
+<คำสั่ง / ขั้นตอน>
+```

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

@@ -1,34 +1,34 @@
-# Troubleshooting — <ชื่อ change>
-
-> Log ปัญหา **ยาก/ซ้ำ** ที่เจอระหว่างทำงาน topic นี้ (ส่วนใหญ่ตอน BUILD) แล้วแก้สำเร็จ
-> ตอน **SHIP** จะยกรายการที่มีค่าขึ้นไปรวมที่ KB กลาง `docs/troubleshooting.md`
-> เจอปัญหาใหม่ → อ่าน `docs/troubleshooting.md` ก่อนเสมอ เผื่อเคยแก้แล้ว
-
----
-
-## วิธีบันทึก
-บันทึกเฉพาะปัญหาที่ **ยากจะแก้** หรือ **เจอซ้ำ** (ไม่ใช่ทุก error เล็กน้อย) — หนึ่งปัญหา = หนึ่ง entry
-
----
-
-### TS-1: <ชื่อปัญหาสั้นๆ>
-| | |
-|---|---|
-| **วันที่** | `YYYY-MM-DD` |
-| **Component / Task** | `api-service` / `tasks/<task>` |
-| **ความถี่** | เจอครั้งเดียว (ยากมาก) / เจอซ้ำ __ ครั้ง |
-| **ยกขึ้น KB กลางตอน SHIP?** | ✅ / ❌ |
-
-- **อาการ / error message:**
-  ```
-  <paste error>
-  ```
-- **บริบทที่ทำให้เกิด (trigger):**
-- **สาเหตุที่แท้จริง (root cause):**
-- **วิธีแก้ที่ได้ผล (solution):**
-- **วิธีสังเกต/ป้องกันไม่ให้เกิดซ้ำ:**
-
----
-
-### TS-2: <...>
-> (คัดลอกบล็อกด้านบน)
+# Troubleshooting — <ชื่อ change>
+
+> Log ปัญหา **ยาก/ซ้ำ** ที่เจอระหว่างทำงาน topic นี้ (ส่วนใหญ่ตอน BUILD) แล้วแก้สำเร็จ
+> ตอน **SHIP** จะยกรายการที่มีค่าขึ้นไปรวมที่ KB กลาง `docs/troubleshooting.md`
+> เจอปัญหาใหม่ → อ่าน `docs/troubleshooting.md` ก่อนเสมอ เผื่อเคยแก้แล้ว
+
+---
+
+## วิธีบันทึก
+บันทึกเฉพาะปัญหาที่ **ยากจะแก้** หรือ **เจอซ้ำ** (ไม่ใช่ทุก error เล็กน้อย) — หนึ่งปัญหา = หนึ่ง entry
+
+---
+
+### TS-1: <ชื่อปัญหาสั้นๆ>
+| | |
+|---|---|
+| **วันที่** | `YYYY-MM-DD` |
+| **Component / Task** | `api-service` / `tasks/<task>` |
+| **ความถี่** | เจอครั้งเดียว (ยากมาก) / เจอซ้ำ __ ครั้ง |
+| **ยกขึ้น KB กลางตอน SHIP?** | ✅ / ❌ |
+
+- **อาการ / error message:**
+  ```
+  <paste error>
+  ```
+- **บริบทที่ทำให้เกิด (trigger):**
+- **สาเหตุที่แท้จริง (root cause):**
+- **วิธีแก้ที่ได้ผล (solution):**
+- **วิธีสังเกต/ป้องกันไม่ให้เกิดซ้ำ:**
+
+---
+
+### TS-2: <...>
+> (คัดลอกบล็อกด้านบน)