@warnyin/agents 0.2.0 → 0.4.0

package/{installer → warnyin/installer}/templates/CLAUDE.md

@@ -4,23 +4,24 @@
 `Discovery (optional) ▶ DESIGN ▶ BUILD ▶ VERIFY ▶ SHIP`
 
 ## กฎหลัก
-- แก่นของแต่ละ stage เป็น single source of truth ที่ `workflow/stages/` — **ทำตาม playbook นั้นเสมอ** ก่อนเริ่มงานใน stage
-- อย่า duplicate logic ของ workflow ลงที่อื่น ถ้าต้องแก้พฤติกรรมให้แก้ที่ `workflow/stages/`
-- output ของงานจริงเก็บใน `warnyin-stages/<slug>/` (copy จาก template `warnyin-stages/[topic]/`)
+- แก่นของแต่ละ stage เป็น single source of truth ที่ `warnyin/workflow/stages/` — **ทำตาม playbook นั้นเสมอ** ก่อนเริ่มงานใน stage
+- อย่า duplicate logic ของ workflow ลงที่อื่น ถ้าต้องแก้พฤติกรรมให้แก้ที่ `warnyin/workflow/stages/`
+- output ของงานจริงเก็บใน `warnyin/stages/<slug>/` (copy จาก template `warnyin/template/stages/[topic]/`)
 - ความรู้ถาวรระดับโปรเจกต์อยู่ใน `docs/` — เริ่มอ่าน `docs/project.md` เสมอใน Discovery
 
 ## Slash commands (namespace `warnyin:`)
-- `/warnyin:init` → วิเคราะห์โปรเจกต์ + เติม `docs/` ครั้งแรกหลังติดตั้ง (`workflow/init.md`)
-- `/warnyin:install-skill [role]` → ติดตั้ง skill เสริมประจำ role (รายการ: `workflow/roles/README.md`)
-- `/warnyin:discovery [topic]` → Discovery stage (`workflow/stages/discovery.md`)
-- `/warnyin:design [slug] [change]` → DESIGN stage (`workflow/stages/design.md`)
-- `/warnyin:build [slug]` → BUILD stage — fan-out sub-agent ตาม dependency (`workflow/stages/build.md` + `workflow/scripts/build-wave.mjs`)
-- `/warnyin:verify [slug]` → VERIFY stage — strategy tester เทส local env + UXUI แก้จนผ่าน (`workflow/stages/verify.md`)
-- `/warnyin:ship [slug]` → SHIP stage — ส่งมอบ: promote ความรู้ขึ้น `docs/` + archive topic (`workflow/stages/ship.md`)
+- `/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: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 กลางชุดเดียวกันใน `workflow/stages/` — ดูภาพรวมที่ `workflow/README.md`
+ทุกเครื่องชี้กลับมาที่ playbook กลางชุดเดียวกันใน `warnyin/workflow/stages/` — ดูภาพรวมที่ `warnyin/workflow/README.md`
 
 ## อัปเดต workflow
-`npx @warnyin/agents --update` — เขียนทับเฉพาะ playbook กลาง (`workflow/`, `.claude/commands/warnyin/`, template `warnyin-stages/[topic]/`) ไม่แตะ `docs/` และงานจริงใน `warnyin-stages/`
+`npx @warnyin/agents --update` — เขียนทับเฉพาะ playbook กลาง (`warnyin/workflow/`, `.claude/commands/warnyin/`, template `warnyin/template/stages/[topic]/`) ไม่แตะ `docs/` และงานจริงใน `warnyin/stages/`

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

@@ -0,0 +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 — ไฟล์ไหนคือประตูเข้าแต่ละทาง -->

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

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

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

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

package/warnyin/template/docs/infra.md

@@ -0,0 +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)
+<!-- เท่าที่เกี่ยวกับการพัฒนา/เทส -->

package/warnyin/template/docs/project.md

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

package/warnyin/template/docs/rule.md

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

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

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

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

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

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

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

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

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

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

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

package/{docs → warnyin/template/docs}/troubleshooting.md

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

@@ -1,6 +1,6 @@
 # Build Report — <ชื่อ change>
 
-> Output ของ BUILD stage · playbook: `workflow/stages/build.md`
+> Output ของ BUILD stage · playbook: `warnyin/workflow/stages/build.md`
 > รายงานผลการ implement ต่อ task + การ integrate
 
 | | |
@@ -48,7 +48,7 @@ wave 3:            task-d  (ขึ้นกับ task-b, task-c)
 > บันทึกละเอียดที่ `./troubleshooting.md` (SHIP ยกขึ้น `docs/troubleshooting.md`)
 - ดู `./troubleshooting.md`
 
-## ✅ Gate → VERIFY (ดู `workflow/stages/build.md` ข้อ 7)
+## ✅ Gate → VERIFY (ดู `warnyin/workflow/stages/build.md` ข้อ 7)
 - [ ] ทุก task implement + merge เข้า build branch แล้ว
 - [ ] ทุก task `passed` (test/build เขียว) ไม่มี `failed` ค้าง
 - [ ] ไม่มี merge conflict ค้าง

package/{warnyin-stages → warnyin/template/stages}/[topic]/business.md

@@ -1,6 +1,6 @@
 # Business — <ชื่อ change>
 
-> Output ของ DESIGN stage · playbook: `workflow/stages/design.md`
+> Output ของ DESIGN stage · playbook: `warnyin/workflow/stages/design.md`
 > **optional** — ข้ามได้ถ้า change เล็ก (เช่น fix bug นิดหน่อย)
 
 ## 1. เป้าหมายเชิงธุรกิจ (what & why)

package/{warnyin-stages → warnyin/template/stages}/[topic]/design.md

@@ -1,6 +1,6 @@
 # Design (How) — <ชื่อ change>
 
-> Output ของ DESIGN stage · playbook: `workflow/stages/design.md`
+> Output ของ DESIGN stage · playbook: `warnyin/workflow/stages/design.md`
 > ออกแบบเชิงเทคนิคแบบ **vertical slice architecture** — แต่ละ slice ตัดผ่านทุก layer ทำงาน end-to-end
 
 ## 1. ภาพรวมสถาปัตยกรรม

package/{warnyin-stages → warnyin/template/stages}/[topic]/discovery.md

@@ -1,6 +1,6 @@
 # Discovery — <ชื่อหัวข้องาน>
 
-> Output ของ Discovery stage · playbook: `workflow/stages/discovery.md`
+> Output ของ Discovery stage · playbook: `warnyin/workflow/stages/discovery.md`
 
 | | |
 |---|---|
@@ -60,7 +60,7 @@
 
 ---
 
-## ✅ Gate → DESIGN (ดู `workflow/stages/discovery.md` ข้อ 6)
+## ✅ Gate → DESIGN (ดู `warnyin/workflow/stages/discovery.md` ข้อ 6)
 - [ ] Problem / why-now ชัด ผูกกับ project.md
 - [ ] Scope in/out ชัด
 - [ ] Decision log ปิดทุกประเด็นสำคัญ ไม่มี open question ที่ block

package/{warnyin-stages → warnyin/template/stages}/[topic]/proposal.md

@@ -1,6 +1,6 @@
 # Proposal — <ชื่อ change>
 
-> Output ของ DESIGN stage · playbook: `workflow/stages/design.md`
+> Output ของ DESIGN stage · playbook: `warnyin/workflow/stages/design.md`
 > **what & why** ของ change นี้
 
 | | |

package/{warnyin-stages → warnyin/template/stages}/[topic]/research.md

@@ -1,6 +1,6 @@
 # Research — <ชื่อหัวข้องาน>
 
-> Output ของ Discovery stage · playbook: `workflow/stages/discovery.md`
+> Output ของ Discovery stage · playbook: `warnyin/workflow/stages/discovery.md`
 > ที่เก็บ "ข้อมูลที่ค้นมา + หลักฐาน" สนับสนุนการตัดสินใจใน `discovery.md`
 
 | | |

package/{warnyin-stages → warnyin/template/stages}/[topic]/ship.md

@@ -1,7 +1,7 @@
 # Ship — <ชื่อ topic>
 
-> Output ของ SHIP stage · playbook: `workflow/stages/ship.md`
-> สรุปการส่งมอบ — เขียนหลังย้าย topic เข้า `warnyin-stages/achieved/<YYYY-MM-DD>-<slug>/` แล้ว
+> Output ของ SHIP stage · playbook: `warnyin/workflow/stages/ship.md`
+> สรุปการส่งมอบ — เขียนหลังย้าย topic เข้า `warnyin/stages/achieved/<YYYY-MM-DD>-<slug>/` แล้ว
 
 ## 1. สรุป topic
 - ทำอะไร: <!-- หนึ่งย่อหน้า: topic นี้ทำอะไร ทำอย่างไร -->
@@ -26,4 +26,4 @@
 | | |
 
 ## 4. Archive
-- ย้ายจาก `warnyin-stages/<slug>/` → `warnyin-stages/achieved/<YYYY-MM-DD>-<slug>/` เมื่อ <YYYY-MM-DD>
+- ย้ายจาก `warnyin/stages/<slug>/` → `warnyin/stages/achieved/<YYYY-MM-DD>-<slug>/` เมื่อ <YYYY-MM-DD>

package/{warnyin-stages → warnyin/template/stages}/[topic]/tasks/[task-name]/issue.md

@@ -1,6 +1,6 @@
 # Issue — <ชื่อ task>
 
-> Output ของ DESIGN dry-run · playbook: `workflow/stages/design.md` (ข้อ 4.9)
+> Output ของ DESIGN dry-run · playbook: `warnyin/workflow/stages/design.md` (ข้อ 4.9)
 > ผลสแกนหา defer/blocker ของ task นี้ก่อนเข้า BUILD — **สร้างเฉพาะเมื่อพบ issue**
 
 ## 1. สรุป

package/{warnyin-stages → warnyin/template/stages}/[topic]/tasks/[task-name]/rule.md

@@ -1,6 +1,6 @@
 # Rule — <ชื่อ task>
 
-> Output ของ DESIGN stage · playbook: `workflow/stages/design.md`
+> Output ของ DESIGN stage · playbook: `warnyin/workflow/stages/design.md`
 > rule ที่ task นี้ต้อง **focus/follow** + rule ใหม่ที่อยากเสนอเพิ่ม
 
 ## 1. Rule ที่ต้อง follow (จาก techstack)

package/{warnyin-stages → warnyin/template/stages}/[topic]/tasks/[task-name]/spec.md

@@ -1,6 +1,6 @@
 # Spec — <ชื่อ task>
 
-> Output ของ DESIGN stage · playbook: `workflow/stages/design.md`
+> Output ของ DESIGN stage · playbook: `warnyin/workflow/stages/design.md`
 > spec เฉพาะของ task นี้ — **ใส่เฉพาะหัวข้อที่เกี่ยวข้องกับชนิดของ task**
 
 ## 1. ชนิดของ task

package/{warnyin-stages → warnyin/template/stages}/[topic]/tasks/[task-name]/standard.md

@@ -1,6 +1,6 @@
 # Standard — <ชื่อ task>
 
-> Output ของ DESIGN stage · playbook: `workflow/stages/design.md`
+> Output ของ DESIGN stage · playbook: `warnyin/workflow/stages/design.md`
 > pattern การเขียนโค้ด / shared component ที่ task นี้ต้องยึด
 > **อิงจาก** `docs/techstack/<component>/standard.md` — เพิ่มเติมเฉพาะ task ได้
 

package/{warnyin-stages → warnyin/template/stages}/[topic]/tasks/[task-name]/task.md

@@ -1,6 +1,6 @@
 # Task — <ชื่อ task>
 
-> Output ของ DESIGN stage · playbook: `workflow/stages/design.md`
+> Output ของ DESIGN stage · playbook: `warnyin/workflow/stages/design.md`
 > หน่วยที่ **โยนให้ sub-agent ทำใน BUILD ได้** — self-contained แต่เชื่อมกับ task อื่นผ่าน dependency
 
 | | |

package/{warnyin-stages → warnyin/template/stages}/[topic]/test.md

@@ -1,6 +1,6 @@
 # Test Plan — <ชื่อ change>
 
-> Output ของ VERIFY stage · playbook: `workflow/stages/verify.md`
+> Output ของ VERIFY stage · playbook: `warnyin/workflow/stages/verify.md`
 > แผน/วิธีเทสของ topic นี้ — ตอน **SHIP** จะ merge เข้า `docs/techstack/<component>/test.md`
 > อิง guideline จาก `docs/techstack/<component>/test.md` (ถ้าไม่มี = เสนอวิธีใหม่ที่นี่)
 

package/{warnyin-stages → warnyin/template/stages}/[topic]/verify.md

@@ -1,6 +1,6 @@
 # Verify Report — <ชื่อ change>
 
-> Output ของ VERIFY stage · playbook: `workflow/stages/verify.md`
+> Output ของ VERIFY stage · playbook: `warnyin/workflow/stages/verify.md`
 > สรุปผลการ verify ตามจุดประสงค์ของ topic + การแก้ไขที่เกิดขึ้น
 
 | | |
@@ -36,7 +36,7 @@
 > กรณีวนแก้นาน/หลายรอบ แล้วถาม user — สรุปคำถาม/คำตอบ/การตัดสินใจ
 -
 
-## ✅ Gate → SHIP (ดู `workflow/stages/verify.md` ข้อ 6)
+## ✅ Gate → SHIP (ดู `warnyin/workflow/stages/verify.md` ข้อ 6)
 - [ ] เทสตามจุดประสงค์ครบ (functional)
 - [ ] FE: UX/UI verify ผ่าน
 - [ ] ทุกข้อที่ไม่ผ่านถูกแก้จนผ่าน

package/warnyin/workflow/README.md

@@ -0,0 +1,92 @@
+# Warnyin Standard Workflow
+
+มาตรฐานกลางของ "วิธีทำงาน" (ways of work) สำหรับทุกโปรเจกต์ — สร้างทีม ผลิตผลงานคุณภาพ และเร็ว
+โดยเดินผ่าน 5 stage:
+
+```
+Discovery (optional) ──▶ DESIGN ──▶ BUILD ──▶ VERIFY ──▶ SHIP
+```
+
+แต่ละ stage มี **playbook กลางหนึ่งชุด** เป็น single source of truth ที่ AI ทุกเจ้าอ่านเหมือนกัน
+
+---
+
+## หลักการออกแบบ: Tool-agnostic, single source of truth
+
+แก่นของ workflow (กฎ / ขั้นตอน / เกณฑ์ผ่าน) เขียน **ครั้งเดียว** เป็น markdown ใน `warnyin/workflow/stages/`
+ส่วน AI แต่ละเครื่องมีแค่ **adapter บางๆ** ที่ "ชี้กลับ" มาที่ playbook กลางชุดเดียวกัน
+
+| AI tool | Adapter (จุดเชื่อม) | อ่าน playbook จาก |
+|---|---|---|
+| **Claude Code** | `.claude/commands/*.md` + `CLAUDE.md` | `warnyin/workflow/stages/*.md` |
+| **Codex** | `AGENTS.md` | `warnyin/workflow/stages/*.md` |
+| **Antigravity** | `AGENTS.md` | `warnyin/workflow/stages/*.md` |
+| เครื่องอื่นๆ | ชี้มาที่ `warnyin/workflow/stages/` ได้ทันที | `warnyin/workflow/stages/*.md` |
+
+> แก้กฎที่ `warnyin/workflow/stages/` ที่เดียว → ทุกเครื่องได้เหมือนกันทันที
+> เพิ่ม AI เจ้าใหม่ = เพิ่ม adapter บางๆ อีกหนึ่งไฟล์ ไม่ต้องแตะ logic
+
+---
+
+## โครงสร้าง repo
+
+```
+bin/cli.mjs            # npx installer — ติดตั้ง workflow ลงโปรเจกต์อื่น
+
+warnyin/               # ★ ทุกอย่างของ workflow รวมใต้โฟลเดอร์เดียว
+  installer/templates/ #   template CLAUDE.md สำหรับโปรเจกต์ปลายทาง (installer ใช้เอง — ไม่ถูก copy ไป target)
+  workflow/            # playbook กลาง — single source of truth
+    README.md          #   ไฟล์นี้ — ภาพรวม + วิธีรองรับหลาย AI
+    init.md            #   playbook: INIT — วิเคราะห์โปรเจกต์ + เติม docs/ ครั้งแรก
+    codemap.md         #   playbook: CODEMAP — สแกน + สร้าง codemap แบบ token-lean
+    roles/             #   role card กลาง: ba, po, sa, tech-lead, developer, qa, security, infra
+    stages/            #   discovery ✅ · design ✅ · build ✅ · verify ✅ · ship ✅
+    scripts/
+      build-wave.mjs   #   Workflow script: fan-out sub-agent ต่อ task ใน wave (worktree)
+  template/            # ★ template ทั้งหมดรวมที่เดียว
+    stages/[topic]/    #   หนึ่งหน่วยงาน — copy เป็น warnyin/stages/<slug>
+      discovery.md  research.md            # output ของ Discovery
+      business.md  proposal.md  design.md  # output ของ DESIGN
+      tasks/[task-name]/...  build.md      # output ของ DESIGN (tasks) + BUILD
+      test.md  verify.md                   # output ของ VERIFY
+      troubleshooting.md  ship.md          # KB ระหว่างงาน + สรุปส่งมอบของ SHIP
+    docs/                                  #   โครง docs — installer seed เข้า docs/ ตอนติดตั้ง
+      project.md  rule.md  infra.md  troubleshooting.md  codemap/index.md
+      techstack/[component]/               #   copy เป็น docs/techstack/<component> (โดย /warnyin:init)
+      features/[feature-name]/             #   copy เป็น docs/features/<feature-name> (โดย SHIP)
+  stages/              # พื้นที่ทำงานจริง ตาม topic
+    context.md
+    achieved/          #   archive หลัง SHIP (<YYYY-MM-DD>-<slug>/)
+
+docs/                  # ความรู้ถาวรระดับโปรเจกต์ — ของจริงล้วน (seed จาก warnyin/template/docs)
+  project.md           # ★ จุดเริ่มของ Discovery — อ่านก่อนเสมอ
+  rule.md  infra.md
+  troubleshooting.md   # ★ KB ปัญหา-วิธีแก้ (อ่านก่อนเมื่อ build เจอ error; SHIP ป้อนเข้า)
+  codemap/  features/  techstack/
+```
+
+---
+
+## การติดตั้งไปโปรเจกต์อื่น
+
+```bash
+cd my-project
+npx @warnyin/agents             # ติดตั้ง (ข้ามไฟล์ที่มีอยู่ ไม่เขียนทับ)
+npx @warnyin/agents --update    # อัปเดต playbook กลางเป็นเวอร์ชันล่าสุด
+npx @warnyin/agents --dry-run   # ดูก่อนว่าจะสร้าง/อัปเดตอะไร
+# ทางสำรอง (ไม่ผ่าน npm): npx github:warnyin/warnyin-agents
+```
+
+- โปรเจกต์ที่มี `CLAUDE.md`/`AGENTS.md` อยู่แล้ว → installer ต่อท้ายเป็น section ไม่เขียนทับ
+- `--update` เขียนทับเฉพาะ core (`warnyin/workflow/`, `.claude/commands/warnyin/`, template ใน `warnyin/template/`) — ไม่แตะ `docs/` และงานจริง
+- หลังติดตั้ง → เปิด Claude Code แล้วรัน `/warnyin:init` ให้ agent วิเคราะห์โปรเจกต์ + เติม `docs/` (playbook: `warnyin/workflow/init.md`)
+
+## วิธีใช้
+
+1. เริ่มงานใหม่ → copy `warnyin/template/stages/[topic]/` เป็น `warnyin/stages/<ชื่อ-งาน-kebab-case>/`
+2. รัน stage ตามลำดับ (Discovery ข้ามได้ถ้าเข้าใจ scope ชัดแล้ว)
+   - Claude Code: `/warnyin:discovery <topic>`, `/warnyin:design <slug> <change>`
+   - Codex / Antigravity: บอกให้ทำตาม `warnyin/workflow/stages/<stage>.md`
+3. ผ่าน "gate" ของแต่ละ stage แล้วจึงไป stage ถัดไป
+4. เมื่อ SHIP (`/warnyin:ship <slug>`) → promote ความรู้ของ topic ขึ้นเอกสารกลางใน `docs/`
+   แล้วย้าย topic ไป `warnyin/stages/achieved/<YYYY-MM-DD>-<topic>/`

package/warnyin/workflow/codemap.md

@@ -0,0 +1,91 @@
+# CODEMAP — สแกนโครงสร้างโปรเจกต์ + สร้าง architecture codemap แบบ token-lean
+
+> **Playbook กลาง — AI ทุกเจ้าทำตามไฟล์นี้ชุดเดียวกัน** (Claude Code / Codex / Antigravity / อื่นๆ)
+> เป้าหมาย: `docs/codemap/` ที่ **ประหยัด token** สำหรับให้ AI โหลดเข้า context — โครงสร้างระดับสูง ไม่ใช่ implementation detail
+
+---
+
+## 1. ใช้เมื่อไหร่
+
+- หลังเพิ่ม feature ใหญ่ / refactor ครั้งสำคัญ
+- `/warnyin:init` ใช้ playbook นี้ตอนสร้าง codemap ครั้งแรก
+- **SHIP** ใช้ตอนขั้น "อัปเดต code map ทั้งหมด"
+
+---
+
+## 2. ขั้นตอน
+
+### Step 1: สแกนโครงสร้างโปรเจกต์
+- ระบุชนิดโปรเจกต์: monorepo / single app / library / microservice
+- หา source directory ทั้งหมด (`src/`, `lib/`, `app/`, `packages/`, ...)
+- map entry points (`main.ts`, `index.ts`, `app.py`, `main.go`, ...)
+- สแกนขนานได้: fan-out sub-agent (read-only) ต่อ component/พื้นที่ — เครื่องที่ไม่มี sub-agent → ไล่ทีละส่วน
+
+### Step 2: สร้าง/อัปเดต codemap ใน `docs/codemap/`
+
+| ไฟล์ | เนื้อหา |
+|---|---|
+| `index.md` | สารบัญทั้งชุด + ภาพรวม component + จุดเข้า |
+| `architecture.md` | system diagram ระดับสูง, service boundary, data flow |
+| `backend.md` | API routes, middleware chain, service → repository mapping |
+| `frontend.md` | page tree, component hierarchy, state management flow |
+| `data.md` | ตาราง DB, relationship, migration history |
+| `dependencies.md` | external service, third-party integration, shared library |
+
+**สร้างเฉพาะไฟล์ที่ relevant** — โปรเจกต์ไม่มี frontend → ไม่ต้องมี `frontend.md`
+
+#### รูปแบบ codemap (token-lean)
+
+```markdown
+# Backend Architecture
+
+## Routes
+POST /api/users → UserController.create → UserService.create → UserRepo.insert
+GET  /api/users/:id → UserController.get → UserService.findById → UserRepo.findById
+
+## Key Files
+src/services/user.ts (business logic, 120 lines)
+src/repos/user.ts (database access, 80 lines)
+
+## Dependencies
+- PostgreSQL (primary data store)
+- Redis (session cache, rate limiting)
+- Stripe (payment processing)
+```
+
+### Step 3: Diff detection
+- มี codemap เดิมอยู่ → คำนวณ % การเปลี่ยนแปลง
+- เปลี่ยน **> 30%** → แสดง diff + **ขอ user อนุมัติก่อนเขียนทับ**
+- เปลี่ยน **≤ 30%** → อัปเดต in place ได้เลย
+
+### Step 4: Metadata
+ใส่ freshness header บนสุดของทุกไฟล์:
+```html
+<!-- Generated: YYYY-MM-DD | Files scanned: N | Token estimate: ~X -->
+```
+
+### Step 5: Analysis report → `.reports/codemap-diff.txt`
+- ไฟล์ added / removed / modified ตั้งแต่สแกนครั้งล่าสุด
+- dependency ใหม่ที่ตรวจพบ
+- architecture changes (route ใหม่, service ใหม่ ฯลฯ)
+- คำเตือน staleness: doc ที่ไม่ถูกอัปเดต 90+ วัน
+
+---
+
+## 3. หลักการ (tips)
+
+- โฟกัสโครงสร้างระดับสูง — **ไม่ใช่** implementation detail
+- ใช้ file path + function signature แทน code block เต็ม
+- แต่ละ codemap **< 1000 tokens** เพื่อโหลดเข้า context ได้ถูก
+- ใช้ ASCII diagram แทนคำบรรยาย data flow ยืดยาว
+- **ทุกอย่างต้องมาจากโค้ดจริง ณ วันสแกน — ห้ามเดา/ห้ามเขียนจากความจำ**
+
+---
+
+## 4. Gate — จบเมื่อ
+
+- [ ] codemap ทุกไฟล์ตรงโค้ดจริง + มี freshness header
+- [ ] `index.md` ลิงก์ครบทุกไฟล์ codemap ที่มี
+- [ ] ทุกไฟล์ token-lean (< 1000 tokens)
+- [ ] diff > 30% ผ่านการอนุมัติจาก user แล้ว
+- [ ] `.reports/codemap-diff.txt` เขียนแล้ว

package/{workflow → warnyin/workflow}/init.md

@@ -36,6 +36,8 @@
 
 ## 4. Output (เขียน/เติมที่ `docs/`)
 
+> โฟลเดอร์ component จริงให้ copy จาก template `warnyin/template/docs/techstack/[component]/` เป็นชื่อจริง (เช่น `api-service/`) — ห้ามทิ้งโฟลเดอร์ `[component]` ว่างไว้เฉยๆ โดยไม่สร้างของจริง
+
 | ไฟล์ | เนื้อหา | แหล่งข้อมูล |
 |---|---|---|
 | `docs/project.md` | โปรเจกต์คืออะไร เป้าหมาย ลูกค้า ขอบเขต | สัมภาษณ์ user (+ README เดิมเป็น recommended) |
@@ -44,7 +46,7 @@
 | `docs/techstack/<component>/standard.md` | pattern/convention ที่พบจริงในโค้ด (ยืนยันกับ user) | โค้ดจริง + user |
 | `docs/techstack/<component>/rule.md` | กฎที่ user ต้องการบังคับ (ถามก่อน ห้ามเดา) | user |
 | `docs/techstack/<component>/test.md` | วิธีเทสที่ใช้อยู่ (framework, คำสั่ง, e2e) | โค้ด/config จริง |
-| `docs/codemap/index.md` | แผนที่โค้ดภาพรวม: component, จุดเข้า, โฟลเดอร์สำคัญ | โค้ดจริง |
+| `docs/codemap/` | แผนที่โค้ดทั้งชุด — สร้างตาม playbook `warnyin/workflow/codemap.md` (token-lean) | โค้ดจริง |
 | `docs/infra.md` | local env: service ที่ต้องรัน, วิธีรัน, env vars | config จริง |
 | `docs/rule.md`, `docs/troubleshooting.md` | วางโครงหัวข้อ รอเติมระหว่างใช้งานจริง | — |
 

package/{workflow → warnyin/workflow}/roles/developer.md

@@ -1,6 +1,6 @@
 # Role: Developer
 
-> ใช้ใน: **BUILD** — system prompt เสริมของ build sub-agent ทุกตัว (ผ่าน `workflow/scripts/build-wave.mjs`)
+> ใช้ใน: **BUILD** — system prompt เสริมของ build sub-agent ทุกตัว (ผ่าน `warnyin/workflow/scripts/build-wave.mjs`)
 
 ## Mission
 implement vertical slice ที่รับมอบให้ **เสร็จจริง เขียวจริง** ตาม standard — ไม่เกิน scope ไม่ต่ำกว่า spec