@warnyin/agents 0.16.0 → 0.17.0

package/src/.claude/skills/explore/SKILL.md

@@ -1,8 +1,8 @@
----
-name: explore
-description: สำรวจ/ตอบคำถามเกี่ยวกับโปรเจกต์แบบ read-only — ไม่สร้าง artifact ใดๆ จบที่คำตอบในแชท
-when_to_use: เมื่อต้องการเข้าใจ/ตอบคำถามเกี่ยวกับโครงสร้าง โค้ด หรือ logic ของโปรเจกต์ โดยไม่ต้องสร้างหรือแก้ไฟล์
-allowed-tools: Read, Grep, Glob, Bash(find:*), Bash(ls:*), Bash(grep:*)
----
-
-ทำหน้าที่เป็น explorer ตาม **playbook กลาง** ของ workflow มาตรฐาน — อ่าน `.warnyin/workflow/explore.md` ให้ครบก่อน แล้วทำตามทุกหลักการอย่างเคร่งครัด (**read-only เด็ดขาด — ห้ามสร้าง/แก้/ลบไฟล์ใดๆ**, อ้าง `path:line`; ชี้ playbook ไม่ duplicate) — รับหัวข้อ/คำถามจาก request; ถ้าไม่ระบุ → ถาม user ว่าอยากสำรวจเรื่องอะไร
+---
+name: explore
+description: สำรวจ/ตอบคำถามเกี่ยวกับโปรเจกต์แบบ read-only — ไม่สร้าง artifact ใดๆ จบที่คำตอบในแชท
+when_to_use: เมื่อต้องการเข้าใจ/ตอบคำถามเกี่ยวกับโครงสร้าง โค้ด หรือ logic ของโปรเจกต์ โดยไม่ต้องสร้างหรือแก้ไฟล์
+allowed-tools: Read, Grep, Glob, Bash(find:*), Bash(ls:*), Bash(grep:*)
+---
+
+ทำหน้าที่เป็น explorer ตาม **playbook กลาง** ของ workflow มาตรฐาน — อ่าน `.warnyin/workflow/explore.md` ให้ครบก่อน แล้วทำตามทุกหลักการอย่างเคร่งครัด (**read-only เด็ดขาด — ห้ามสร้าง/แก้/ลบไฟล์ใดๆ**, อ้าง `path:line`; ชี้ playbook ไม่ duplicate) — รับหัวข้อ/คำถามจาก request; ถ้าไม่ระบุ → ถาม user ว่าอยากสำรวจเรื่องอะไร

package/src/.claude/skills/next/SKILL.md

@@ -1,8 +1,8 @@
----
-name: next
-description: เช็คงานค้างทุก topic + แนะนำขั้นตอน/command ถัดไป แบบ read-only — ไม่สร้าง/แก้ไฟล์ใดๆ
-when_to_use: เมื่อต้องการรู้ว่าแต่ละ topic ค้างอยู่ stage ไหน + ควรรัน command อะไรถัดไป
-allowed-tools: Read, Grep, Glob, Bash(find:*), Bash(ls:*), Bash(grep:*)
----
-
-ทำหน้าที่เป็น status reporter ตาม **playbook กลาง** ของ workflow มาตรฐาน — อ่าน `.warnyin/workflow/next.md` ให้ครบก่อน แล้วทำตามทุกหลักการอย่างเคร่งครัด (**read-only เด็ดขาด — ห้ามสร้าง/แก้/ลบไฟล์ใดๆ**, สรุปจาก evidence ในไฟล์จริง, แนะนำแล้วหยุด; ชี้ playbook ไม่ duplicate) — รับ slug จาก request (ไม่ระบุ = สแกนทุก topic ใน `docs/stages/` ยกเว้น `achieved/`)
+---
+name: next
+description: เช็คงานค้างทุก topic + แนะนำขั้นตอน/command ถัดไป แบบ read-only — ไม่สร้าง/แก้ไฟล์ใดๆ
+when_to_use: เมื่อต้องการรู้ว่าแต่ละ topic ค้างอยู่ stage ไหน + ควรรัน command อะไรถัดไป
+allowed-tools: Read, Grep, Glob, Bash(find:*), Bash(ls:*), Bash(grep:*)
+---
+
+ทำหน้าที่เป็น status reporter ตาม **playbook กลาง** ของ workflow มาตรฐาน — อ่าน `.warnyin/workflow/next.md` ให้ครบก่อน แล้วทำตามทุกหลักการอย่างเคร่งครัด (**read-only เด็ดขาด — ห้ามสร้าง/แก้/ลบไฟล์ใดๆ**, สรุปจาก evidence ในไฟล์จริง, แนะนำแล้วหยุด; ชี้ playbook ไม่ duplicate) — รับ slug จาก request (ไม่ระบุ = สแกนทุก topic ใน `docs/stages/` ยกเว้น `achieved/`)

package/src/.claude/skills/update-codemaps/SKILL.md

@@ -1,8 +1,8 @@
----
-name: update-codemaps
-description: Scan project structure and generate token-lean architecture codemaps (docs/codemap/)
-when_to_use: หลังเพิ่ม/ย้าย/ลบไฟล์ หรือเปลี่ยนโครงสร้างโปรเจกต์ → refresh docs/codemap/ ให้ตรงโครงจริง
-allowed-tools: Read, Grep, Glob, Bash(find:*), Bash(ls:*), Bash(grep:*)
----
-
-ทำหน้าที่เป็น codemap generator ตาม **playbook กลาง** ของ workflow มาตรฐาน — อ่าน `.warnyin/workflow/codemap.md` ให้ครบก่อน แล้วทำตามทุกขั้นอย่างเคร่งครัด (ชี้ playbook ไม่ duplicate ขั้นตอน)
+---
+name: update-codemaps
+description: Scan project structure and generate token-lean architecture codemaps (docs/codemap/)
+when_to_use: หลังเพิ่ม/ย้าย/ลบไฟล์ หรือเปลี่ยนโครงสร้างโปรเจกต์ → refresh docs/codemap/ ให้ตรงโครงจริง
+allowed-tools: Read, Grep, Glob, Bash(find:*), Bash(ls:*), Bash(grep:*)
+---
+
+ทำหน้าที่เป็น codemap generator ตาม **playbook กลาง** ของ workflow มาตรฐาน — อ่าน `.warnyin/workflow/codemap.md` ให้ครบก่อน แล้วทำตามทุกขั้นอย่างเคร่งครัด (ชี้ playbook ไม่ duplicate ขั้นตอน)

package/src/.warnyin/installer/templates/CLAUDE.global.md

@@ -1,5 +1,5 @@
-<!-- warnyin:global-note -->
-
-## การ resolve playbook (local-first → global)
-- path `.warnyin/workflow/...` / `.warnyin/template/...`: หาในโปรเจกต์ `./.warnyin/` ก่อน ไม่มี → `~/.warnyin/` (global install)
-- ถ้ายังไม่มี `docs/stages/` (global mode โปรเจกต์ใหม่) → รัน `/warnyin:init` ก่อน (สร้าง workspace)
+<!-- warnyin:global-note -->
+
+## การ resolve playbook (local-first → global)
+- path `.warnyin/workflow/...` / `.warnyin/template/...`: หาในโปรเจกต์ `./.warnyin/` ก่อน ไม่มี → `~/.warnyin/` (global install)
+- ถ้ายังไม่มี `docs/stages/` (global mode โปรเจกต์ใหม่) → รัน `/warnyin:init` ก่อน (สร้าง workspace)

package/src/.warnyin/installer/templates/CLAUDE.md

@@ -1,35 +1,35 @@
-# CLAUDE.md
-
-โปรเจกต์นี้ใช้ **Warnyin Standard Workflow** — มาตรฐานกลางของ ways of work เดินงานผ่าน 5 stage:
-`Discovery (optional) ▶ DESIGN ▶ BUILD ▶ VERIFY ▶ SHIP`
-
-## กฎหลัก
-- แก่นของแต่ละ stage เป็น single source of truth ที่ `.warnyin/workflow/stages/` — **ทำตาม playbook นั้นเสมอ** ก่อนเริ่มงานใน stage
-- อย่า duplicate logic ของ workflow ลงที่อื่น ถ้าต้องแก้พฤติกรรมให้แก้ที่ `.warnyin/workflow/stages/`
-- output ของงานจริงเก็บใน `docs/stages/<slug>/` (copy จาก template `.warnyin/template/stages/[topic]/`)
-- ความรู้ถาวรระดับโปรเจกต์อยู่ใน `docs/` — เริ่มอ่าน `docs/project.md` เสมอใน Discovery
-
-## Slash commands (namespace `warnyin:`)
-- `/warnyin:init` → วิเคราะห์โปรเจกต์ + เติม `docs/` ครั้งแรกหลังติดตั้ง (`.warnyin/workflow/init.md`)
-- `/warnyin:install-skill [role]` → ติดตั้ง skill เสริมประจำ role (รายการ: `.warnyin/workflow/roles/README.md`)
-- `/warnyin:update-codemaps` → สแกนโครงสร้าง + สร้าง/อัปเดต codemap แบบ token-lean (`.warnyin/workflow/codemap.md`)
-- `/warnyin:explore [คำถาม]` → สำรวจ/ตอบคำถามแบบ read-only — ไม่สร้าง artifact (`.warnyin/workflow/explore.md`)
-- `/warnyin:next [slug]` → เช็คงานค้าง + แนะนำ command ถัดไป แบบ read-only (`.warnyin/workflow/next.md`)
-- `/warnyin:triage [คำอธิบาย change]` → ประเมินขนาด + แนะนำ path (read-only) (`.warnyin/workflow/triage.md`)
-- `/warnyin:feedback:issue [ประเภท/ข้อความ]` → เปิด GitHub issue แจ้ง feedback ที่ warnyin/warnyin-agents (`.warnyin/workflow/feedback.md`)
-- `/warnyin:discovery [topic]` → Discovery stage (`.warnyin/workflow/stages/discovery.md`)
-- `/warnyin:design [slug] [change]` → DESIGN stage (`.warnyin/workflow/stages/design.md`)
-- `/warnyin:build [slug]` → BUILD stage — fan-out sub-agent ตาม dependency (`.warnyin/workflow/stages/build.md` + `.warnyin/workflow/scripts/build-wave.mjs`)
-- `/warnyin:verify [slug]` → VERIFY stage — strategy tester เทส local env + UXUI แก้จนผ่าน (`.warnyin/workflow/stages/verify.md`)
-- `/warnyin:ship [slug]` → SHIP stage — ส่งมอบ: promote ความรู้ขึ้น `docs/` + archive topic (`.warnyin/workflow/stages/ship.md`)
-
-## รองรับหลาย AI
-Claude Code อ่าน `.claude/` + ไฟล์นี้, ส่วน Codex/Antigravity อ่าน `AGENTS.md`
-ทุกเครื่องชี้กลับมาที่ playbook กลางชุดเดียวกันใน `.warnyin/workflow/stages/` — ดูภาพรวมที่ `.warnyin/workflow/README.md`
-
-## อัปเดต workflow
-`npx @warnyin/agents --update` — เขียนทับเฉพาะ playbook กลาง (`.warnyin/workflow/`, `.claude/commands/warnyin/`, template `.warnyin/template/stages/[topic]/`) ไม่แตะ `docs/` และงานจริงใน `docs/stages/`
-
-## การ resolve playbook (local-first → global)
-- path `.warnyin/workflow/...` / `.warnyin/template/...`: หาในโปรเจกต์ `./.warnyin/` ก่อน ไม่มี → `~/.warnyin/` (global install)
-- ถ้ายังไม่มี `docs/stages/` (global mode โปรเจกต์ใหม่) → รัน `/warnyin:init` ก่อน (สร้าง workspace)
+# CLAUDE.md
+
+โปรเจกต์นี้ใช้ **Warnyin Standard Workflow** — มาตรฐานกลางของ ways of work เดินงานผ่าน 5 stage:
+`Discovery (optional) ▶ DESIGN ▶ BUILD ▶ VERIFY ▶ SHIP`
+
+## กฎหลัก
+- แก่นของแต่ละ stage เป็น single source of truth ที่ `.warnyin/workflow/stages/` — **ทำตาม playbook นั้นเสมอ** ก่อนเริ่มงานใน stage
+- อย่า duplicate logic ของ workflow ลงที่อื่น ถ้าต้องแก้พฤติกรรมให้แก้ที่ `.warnyin/workflow/stages/`
+- output ของงานจริงเก็บใน `docs/stages/<slug>/` (copy จาก template `.warnyin/template/stages/[topic]/`)
+- ความรู้ถาวรระดับโปรเจกต์อยู่ใน `docs/` — เริ่มอ่าน `docs/project.md` เสมอใน Discovery
+
+## Slash commands (namespace `warnyin:`)
+- `/warnyin:init` → วิเคราะห์โปรเจกต์ + เติม `docs/` ครั้งแรกหลังติดตั้ง (`.warnyin/workflow/init.md`)
+- `/warnyin:install-skill [role]` → ติดตั้ง skill เสริมประจำ role (รายการ: `.warnyin/workflow/roles/README.md`)
+- `/warnyin:update-codemaps` → สแกนโครงสร้าง + สร้าง/อัปเดต codemap แบบ token-lean (`.warnyin/workflow/codemap.md`)
+- `/warnyin:explore [คำถาม]` → สำรวจ/ตอบคำถามแบบ read-only — ไม่สร้าง artifact (`.warnyin/workflow/explore.md`)
+- `/warnyin:next [slug]` → เช็คงานค้าง + แนะนำ command ถัดไป แบบ read-only (`.warnyin/workflow/next.md`)
+- `/warnyin:triage [คำอธิบาย change]` → ประเมินขนาด + แนะนำ path (read-only) (`.warnyin/workflow/triage.md`)
+- `/warnyin:feedback:issue [ประเภท/ข้อความ]` → เปิด GitHub issue แจ้ง feedback ที่ warnyin/warnyin-agents (`.warnyin/workflow/feedback.md`)
+- `/warnyin:discovery [topic]` → Discovery stage (`.warnyin/workflow/stages/discovery.md`)
+- `/warnyin:design [slug] [change]` → DESIGN stage (`.warnyin/workflow/stages/design.md`)
+- `/warnyin:build [slug]` → BUILD stage — fan-out sub-agent ตาม dependency (`.warnyin/workflow/stages/build.md` + `.warnyin/workflow/scripts/build-wave.mjs`)
+- `/warnyin:verify [slug]` → VERIFY stage — strategy tester เทส local env + UXUI แก้จนผ่าน (`.warnyin/workflow/stages/verify.md`)
+- `/warnyin:ship [slug]` → SHIP stage — ส่งมอบ: promote ความรู้ขึ้น `docs/` + archive topic (`.warnyin/workflow/stages/ship.md`)
+
+## รองรับหลาย AI
+Claude Code อ่าน `.claude/` + ไฟล์นี้, ส่วน Codex/Antigravity อ่าน `AGENTS.md`
+ทุกเครื่องชี้กลับมาที่ playbook กลางชุดเดียวกันใน `.warnyin/workflow/stages/` — ดูภาพรวมที่ `.warnyin/workflow/README.md`
+
+## อัปเดต workflow
+`npx @warnyin/agents --update` — เขียนทับเฉพาะ playbook กลาง (`.warnyin/workflow/`, `.claude/commands/warnyin/`, template `.warnyin/template/stages/[topic]/`) ไม่แตะ `docs/` และงานจริงใน `docs/stages/`
+
+## การ resolve playbook (local-first → global)
+- path `.warnyin/workflow/...` / `.warnyin/template/...`: หาในโปรเจกต์ `./.warnyin/` ก่อน ไม่มี → `~/.warnyin/` (global install)
+- ถ้ายังไม่มี `docs/stages/` (global mode โปรเจกต์ใหม่) → รัน `/warnyin:init` ก่อน (สร้าง workspace)

package/src/.warnyin/template/docs/codemap/index.md

@@ -1,18 +1,18 @@
-# Code Map — Index
-
-> สารบัญ codemap ทั้งชุด — สร้าง/อัปเดตด้วย `/warnyin:update-codemaps` (playbook: `.warnyin/workflow/codemap.md`)
-> ทุกไฟล์ต้อง token-lean (< 1000 tokens) + freshness header + ตรงโค้ดจริงเสมอ
-
-## Codemap files
-<!-- ลิงก์เฉพาะไฟล์ที่ relevant กับโปรเจกต์ -->
-- [architecture.md](architecture.md) — system diagram, service boundary, data flow
-- [backend.md](backend.md) — routes, middleware, service → repo mapping
-- [frontend.md](frontend.md) — page tree, component hierarchy, state
-- [data.md](data.md) — ตาราง DB, relationship, migrations
-- [dependencies.md](dependencies.md) — external service, third-party, shared lib
-
-## Component ทั้งหมด
-<!-- ชื่อ + หน้าที่ + path — รายละเอียดต่อ component ดู docs/techstack/<component>/structure.md -->
-
-## จุดเข้า (entry points)
-<!-- main/server/cli/cron — ไฟล์ไหนคือประตูเข้าแต่ละทาง -->
+# Code Map — Index
+
+> สารบัญ codemap ทั้งชุด — สร้าง/อัปเดตด้วย `/warnyin:update-codemaps` (playbook: `.warnyin/workflow/codemap.md`)
+> ทุกไฟล์ต้อง token-lean (< 1000 tokens) + freshness header + ตรงโค้ดจริงเสมอ
+
+## Codemap files
+<!-- ลิงก์เฉพาะไฟล์ที่ relevant กับโปรเจกต์ -->
+- [architecture.md](architecture.md) — system diagram, service boundary, data flow
+- [backend.md](backend.md) — routes, middleware, service → repo mapping
+- [frontend.md](frontend.md) — page tree, component hierarchy, state
+- [data.md](data.md) — ตาราง DB, relationship, migrations
+- [dependencies.md](dependencies.md) — external service, third-party, shared lib
+
+## Component ทั้งหมด
+<!-- ชื่อ + หน้าที่ + path — รายละเอียดต่อ component ดู docs/techstack/<component>/structure.md -->
+
+## จุดเข้า (entry points)
+<!-- main/server/cli/cron — ไฟล์ไหนคือประตูเข้าแต่ละทาง -->

package/src/.warnyin/template/docs/features/[feature-name]/business.md

@@ -1,5 +1,5 @@
-# Business — <ชื่อ feature>
-
-> what & why เชิงธุรกิจของ feature — SHIP ยกมาจาก `business.md`/`proposal.md` ของ topic
-
-<!-- goal · persona/ใครได้ประโยชน์ · คุณค่า/success metric · scope ที่จงใจไม่ทำ -->
+# Business — <ชื่อ feature>
+
+> what & why เชิงธุรกิจของ feature — SHIP ยกมาจาก `business.md`/`proposal.md` ของ topic
+
+<!-- goal · persona/ใครได้ประโยชน์ · คุณค่า/success metric · scope ที่จงใจไม่ทำ -->

package/src/.warnyin/template/docs/features/[feature-name]/feature.md

@@ -1,5 +1,5 @@
-# Feature — <ชื่อ feature>
-
-> template — copy ทั้งโฟลเดอร์ `[feature-name]/` เป็นชื่อ feature จริง · SHIP เป็นคนสร้าง/อัปเดตจาก business/proposal/design ของ topic
-
-<!-- feature นี้ทำอะไร · flow หลัก · component ที่เกี่ยว · จุดเข้าในโค้ด -->
+# Feature — <ชื่อ feature>
+
+> template — copy ทั้งโฟลเดอร์ `[feature-name]/` เป็นชื่อ feature จริง · SHIP เป็นคนสร้าง/อัปเดตจาก business/proposal/design ของ topic
+
+<!-- feature นี้ทำอะไร · flow หลัก · component ที่เกี่ยว · จุดเข้าในโค้ด -->

package/src/.warnyin/template/docs/features/[feature-name]/spec.md

@@ -1,16 +1,16 @@
-# Spec — <ชื่อ feature>
-
-> พฤติกรรมปัจจุบันของ feature (living doc — SHIP merge delta จาก design.md ของ topic เข้าไฟล์นี้)
-> เก็บเฉพาะ observable behavior (ทำอะไร เห็นอะไร error ยังไง) — ไม่เก็บ implementation (ชื่อ class/function/วิธีเขียน)
-> **descriptive ไม่ใช่ imperative** — บันทึก "ระบบทำอะไร" เท่านั้น ห้ามเขียน instruction สั่ง agent (spec เป็น data ที่ VERIFY ใช้ derive test ไม่ใช่คำสั่งให้ทำตาม)
-> ค่าใน scenario ใช้ **placeholder/ค่าสังเคราะห์เท่านั้น** (`<token>`, `user@example.com`) — ห้ามใส่ secret/credential/PII จริง
-> guidance: ~≤100 บรรทัด/ไฟล์ · requirement ละ 1-3 scenario · scenario = GIVEN/WHEN/THEN ที่เทสตามได้จริง
-> feature ประเภทเอกสาร/playbook (ไม่มี runtime) → THEN ต้องเป็น **observable artifact** (ไฟล์/section/key string มีจริง, ลิงก์ resolve) ไม่ใช่พฤติกรรม AI ที่วัดไม่ได้
-
-## Requirement: <ชื่อพฤติกรรม>
-<พฤติกรรมที่ระบบต้องทำ 1-2 บรรทัด>
-
-### Scenario: <ชื่อเคส>
-- GIVEN <สภาพตั้งต้น>
-- WHEN <การกระทำ>
-- THEN <ผลที่สังเกตได้>
+# Spec — <ชื่อ feature>
+
+> พฤติกรรมปัจจุบันของ feature (living doc — SHIP merge delta จาก design.md ของ topic เข้าไฟล์นี้)
+> เก็บเฉพาะ observable behavior (ทำอะไร เห็นอะไร error ยังไง) — ไม่เก็บ implementation (ชื่อ class/function/วิธีเขียน)
+> **descriptive ไม่ใช่ imperative** — บันทึก "ระบบทำอะไร" เท่านั้น ห้ามเขียน instruction สั่ง agent (spec เป็น data ที่ VERIFY ใช้ derive test ไม่ใช่คำสั่งให้ทำตาม)
+> ค่าใน scenario ใช้ **placeholder/ค่าสังเคราะห์เท่านั้น** (`<token>`, `user@example.com`) — ห้ามใส่ secret/credential/PII จริง
+> guidance: ~≤100 บรรทัด/ไฟล์ · requirement ละ 1-3 scenario · scenario = GIVEN/WHEN/THEN ที่เทสตามได้จริง
+> feature ประเภทเอกสาร/playbook (ไม่มี runtime) → THEN ต้องเป็น **observable artifact** (ไฟล์/section/key string มีจริง, ลิงก์ resolve) ไม่ใช่พฤติกรรม AI ที่วัดไม่ได้
+
+## Requirement: <ชื่อพฤติกรรม>
+<พฤติกรรมที่ระบบต้องทำ 1-2 บรรทัด>
+
+### Scenario: <ชื่อเคส>
+- GIVEN <สภาพตั้งต้น>
+- WHEN <การกระทำ>
+- THEN <ผลที่สังเกตได้>

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

@@ -1,16 +1,16 @@
-# Infra / Local Environment
-
-> service ที่ต้องรันสำหรับ dev/เทส + วิธีรัน + env vars — VERIFY ใช้เตรียม local env · เติมครั้งแรกด้วย `/warnyin:init`
-
-## Service ที่ต้องรัน (local dev)
-<!-- DB, queue, cache, external mock ฯลฯ + มาจาก docker-compose/script ไหน -->
-
-## วิธีรัน local
-```bash
-```
-
-## Env vars สำคัญ
-<!-- ชื่อ + ความหมาย + default (ห้ามใส่ค่า secret จริง) -->
-
-## Environment อื่น (staging/prod)
-<!-- เท่าที่เกี่ยวกับการพัฒนา/เทส -->
+# Infra / Local Environment
+
+> service ที่ต้องรันสำหรับ dev/เทส + วิธีรัน + env vars — VERIFY ใช้เตรียม local env · เติมครั้งแรกด้วย `/warnyin:init`
+
+## Service ที่ต้องรัน (local dev)
+<!-- DB, queue, cache, external mock ฯลฯ + มาจาก docker-compose/script ไหน -->
+
+## วิธีรัน local
+```bash
+```
+
+## Env vars สำคัญ
+<!-- ชื่อ + ความหมาย + default (ห้ามใส่ค่า secret จริง) -->
+
+## Environment อื่น (staging/prod)
+<!-- เท่าที่เกี่ยวกับการพัฒนา/เทส -->

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

@@ -1,18 +1,18 @@
-# Project — <ชื่อโปรเจกต์>
-
-> ★ จุดเริ่มของ Discovery — AI อ่านไฟล์นี้ก่อนเสมอ · เติมครั้งแรกด้วย `/warnyin:init` (สัมภาษณ์ user + วิเคราะห์โค้ด)
-
-## โปรเจกต์นี้คืออะไร
-<!-- ทำอะไร เพื่อใคร แก้ปัญหาอะไร — 2-4 บรรทัด -->
-
-## เป้าหมาย / success metric
-<!-- วัดผลได้ ไม่ใช่ "น่าจะดี" -->
-
-## ลูกค้า / ผู้ใช้หลัก (persona)
-
-## ขอบเขต
-- **in:**
-- **out (จงใจไม่ทำ):**
-
-## ข้อจำกัด / บริบทสำคัญ
-<!-- กฎหมาย/นโยบาย/ระบบเดิม/ระบบภายนอก -->
+# Project — <ชื่อโปรเจกต์>
+
+> ★ จุดเริ่มของ Discovery — AI อ่านไฟล์นี้ก่อนเสมอ · เติมครั้งแรกด้วย `/warnyin:init` (สัมภาษณ์ user + วิเคราะห์โค้ด)
+
+## โปรเจกต์นี้คืออะไร
+<!-- ทำอะไร เพื่อใคร แก้ปัญหาอะไร — 2-4 บรรทัด -->
+
+## เป้าหมาย / success metric
+<!-- วัดผลได้ ไม่ใช่ "น่าจะดี" -->
+
+## ลูกค้า / ผู้ใช้หลัก (persona)
+
+## ขอบเขต
+- **in:**
+- **out (จงใจไม่ทำ):**
+
+## ข้อจำกัด / บริบทสำคัญ
+<!-- กฎหมาย/นโยบาย/ระบบเดิม/ระบบภายนอก -->

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

@@ -1,7 +1,7 @@
-# Global Rules
-
-> กฎระดับโปรเจกต์ที่ **ทุก component** ต้อง follow — กฎเฉพาะ component อยู่ที่ `docs/techstack/<component>/rule.md`
-> SHIP เป็นคน promote กฎใหม่เข้ามา (จาก note "รอ SHIP" ใน tasks) — ระหว่างงานห้ามแก้ไฟล์นี้ตรงๆ
-
-<!-- ตัวอย่าง: ทุก commit ต้องผ่าน lint, ห้าม hardcode secret, error message ห้าม leak ข้อมูลภายใน -->
--
+# Global Rules
+
+> กฎระดับโปรเจกต์ที่ **ทุก component** ต้อง follow — กฎเฉพาะ component อยู่ที่ `docs/techstack/<component>/rule.md`
+> SHIP เป็นคน promote กฎใหม่เข้ามา (จาก note "รอ SHIP" ใน tasks) — ระหว่างงานห้ามแก้ไฟล์นี้ตรงๆ
+
+<!-- ตัวอย่าง: ทุก commit ต้องผ่าน lint, ห้าม hardcode secret, error message ห้าม leak ข้อมูลภายใน -->
+-

package/src/.warnyin/template/docs/techstack/[component]/about.md

@@ -1,6 +1,6 @@
-# About — <ชื่อ component>
-
-> template — copy ทั้งโฟลเดอร์ `[component]/` เป็นชื่อ component จริง (เช่น `api-service/`, `web-frontend/`)
-> ปกติ `/warnyin:init` สร้างให้อัตโนมัติจากการวิเคราะห์โปรเจกต์
-
-<!-- component นี้คืออะไร ทำหน้าที่อะไร · ภาษา/framework/runtime · ขอบเขตความรับผิดชอบ -->
+# About — <ชื่อ component>
+
+> template — copy ทั้งโฟลเดอร์ `[component]/` เป็นชื่อ component จริง (เช่น `api-service/`, `web-frontend/`)
+> ปกติ `/warnyin:init` สร้างให้อัตโนมัติจากการวิเคราะห์โปรเจกต์
+
+<!-- component นี้คืออะไร ทำหน้าที่อะไร · ภาษา/framework/runtime · ขอบเขตความรับผิดชอบ -->

package/src/.warnyin/template/docs/techstack/[component]/rule.md

@@ -1,6 +1,6 @@
-# Rule — <ชื่อ component>
-
-> กฎที่ "ต้อง" follow ของ component นี้ — DESIGN ดึงไปใส่ `tasks/<task>/rule.md`, SHIP เป็นคน promote กฎใหม่เข้ามา
-
-<!-- กฎที่บังคับ เช่น: ห้าม query ตรงจาก controller, ทุก endpoint ต้องมี auth middleware, ... -->
--
+# Rule — <ชื่อ component>
+
+> กฎที่ "ต้อง" follow ของ component นี้ — DESIGN ดึงไปใส่ `tasks/<task>/rule.md`, SHIP เป็นคน promote กฎใหม่เข้ามา
+
+<!-- กฎที่บังคับ เช่น: ห้าม query ตรงจาก controller, ทุก endpoint ต้องมี auth middleware, ... -->
+-

package/src/.warnyin/template/docs/techstack/[component]/standard.md

@@ -1,6 +1,6 @@
-# Standard — <ชื่อ component>
-
-> pattern/convention การเขียนโค้ด + shared component ที่ต้อง reuse — DESIGN ดึงไปใส่ `tasks/<task>/standard.md`
-
-<!-- เช่น: โครงสร้าง module, naming, error handling pattern, รายการ shared component ที่ห้ามเขียนซ้ำ -->
--
+# Standard — <ชื่อ component>
+
+> pattern/convention การเขียนโค้ด + shared component ที่ต้อง reuse — DESIGN ดึงไปใส่ `tasks/<task>/standard.md`
+
+<!-- เช่น: โครงสร้าง module, naming, error handling pattern, รายการ shared component ที่ห้ามเขียนซ้ำ -->
+-

package/src/.warnyin/template/docs/techstack/[component]/structure.md

@@ -1,7 +1,7 @@
-# Structure — <ชื่อ component>
-
-> โครงสร้างโฟลเดอร์/โมดูลจริงของ component — SHIP อัปเดตเมื่อโครงสร้างเปลี่ยน
-
-<!-- tree โฟลเดอร์สำคัญ + ไฟล์/โมดูลไหนรับผิดชอบอะไร + จุดเข้า (entry point) -->
-```
-```
+# Structure — <ชื่อ component>
+
+> โครงสร้างโฟลเดอร์/โมดูลจริงของ component — SHIP อัปเดตเมื่อโครงสร้างเปลี่ยน
+
+<!-- tree โฟลเดอร์สำคัญ + ไฟล์/โมดูลไหนรับผิดชอบอะไร + จุดเข้า (entry point) -->
+```
+```

package/src/.warnyin/template/docs/techstack/[component]/test.md

@@ -1,7 +1,7 @@
-# Test — <ชื่อ component>
-
-> guideline ว่า component นี้เทสยังไง — VERIFY ใช้เป็นแผนตั้งต้น, SHIP merge แผนเทสใหม่จาก topic เข้ามา
-
-<!-- framework + คำสั่งรัน unit/integration · e2e ใช้อะไร (เช่น FE: e2e smoke ผ่าน playwright-cli) · วิธี seed ข้อมูลทดสอบ -->
-- unit:
-- e2e:
+# Test — <ชื่อ component>
+
+> guideline ว่า component นี้เทสยังไง — VERIFY ใช้เป็นแผนตั้งต้น, SHIP merge แผนเทสใหม่จาก topic เข้ามา
+
+<!-- framework + คำสั่งรัน unit/integration · e2e ใช้อะไร (เช่น FE: e2e smoke ผ่าน playwright-cli) · วิธี seed ข้อมูลทดสอบ -->
+- unit:
+- e2e:

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/