@warnyin/agents 0.4.0 → 0.5.1

package/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/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/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: <...>
+> (คัดลอกบล็อกด้านบน)

package/warnyin/template/stages/[topic]/verify.md

@@ -1,44 +1,44 @@
-# Verify Report — <ชื่อ change>
-
-> Output ของ VERIFY stage · playbook: `warnyin/workflow/stages/verify.md`
-> สรุปผลการ verify ตามจุดประสงค์ของ topic + การแก้ไขที่เกิดขึ้น
-
-| | |
-|---|---|
-| **Slug** | `<kebab-case>` |
-| **วันที่** | `YYYY-MM-DD` |
-| **ผลรวม** | ผ่าน / ไม่ผ่าน |
-| **จำนวนรอบการแก้ไข (fix iterations)** | __ รอบ |
-| **จำนวนจุดที่แก้** | __ จุด |
-
-## 1. จุดประสงค์ที่ verify (จาก spec/tasks)
--
-
-## 2. ผลการเทส
-| # | Test case / flow | ชนิด | ผล | หมายเหตุ |
-|---|---|---|---|---|
-| 1 | | functional / e2e / uxui | ✅ / ❌→✅ (แก้แล้ว) | |
-
-## 3. UX/UI verify (ถ้าเป็น FE)
-- [ ] layout / states / responsive / user-flow — ผล:
-
-## 4. รายการแก้ไข (สรุปการแก้ระหว่าง verify)
-> นับรวมเป็น "จำนวนการแก้ไข" ด้านบน
-
-| รอบ | ปัญหาที่เจอ | วิธีแก้ | ไฟล์ที่แก้ |
-|---|---|---|---|
-| 1 | | | |
-
-## 5. ปัญหายาก/ซ้ำ → troubleshooting
-- บันทึกไว้ที่ `./troubleshooting.md` (SHIP ยกขึ้น `docs/troubleshooting.md`): มี/ไม่มี
-
-## 6. หมายเหตุถึง user (ถ้าถามระหว่างทาง)
-> กรณีวนแก้นาน/หลายรอบ แล้วถาม user — สรุปคำถาม/คำตอบ/การตัดสินใจ
--
-
-## ✅ Gate → SHIP (ดู `warnyin/workflow/stages/verify.md` ข้อ 6)
-- [ ] เทสตามจุดประสงค์ครบ (functional)
-- [ ] FE: UX/UI verify ผ่าน
-- [ ] ทุกข้อที่ไม่ผ่านถูกแก้จนผ่าน
-- [ ] test.md + verify.md เขียนครบ
-- [ ] ปัญหายากบันทึก troubleshooting.md แล้ว
+# Verify Report — <ชื่อ change>
+
+> Output ของ VERIFY stage · playbook: `warnyin/workflow/stages/verify.md`
+> สรุปผลการ verify ตามจุดประสงค์ของ topic + การแก้ไขที่เกิดขึ้น
+
+| | |
+|---|---|
+| **Slug** | `<kebab-case>` |
+| **วันที่** | `YYYY-MM-DD` |
+| **ผลรวม** | ผ่าน / ไม่ผ่าน |
+| **จำนวนรอบการแก้ไข (fix iterations)** | __ รอบ |
+| **จำนวนจุดที่แก้** | __ จุด |
+
+## 1. จุดประสงค์ที่ verify (จาก spec/tasks)
+-
+
+## 2. ผลการเทส
+| # | Test case / flow | ชนิด | ผล | หมายเหตุ |
+|---|---|---|---|---|
+| 1 | | functional / e2e / uxui | ✅ / ❌→✅ (แก้แล้ว) | |
+
+## 3. UX/UI verify (ถ้าเป็น FE)
+- [ ] layout / states / responsive / user-flow — ผล:
+
+## 4. รายการแก้ไข (สรุปการแก้ระหว่าง verify)
+> นับรวมเป็น "จำนวนการแก้ไข" ด้านบน
+
+| รอบ | ปัญหาที่เจอ | วิธีแก้ | ไฟล์ที่แก้ |
+|---|---|---|---|
+| 1 | | | |
+
+## 5. ปัญหายาก/ซ้ำ → troubleshooting
+- บันทึกไว้ที่ `./troubleshooting.md` (SHIP ยกขึ้น `docs/troubleshooting.md`): มี/ไม่มี
+
+## 6. หมายเหตุถึง user (ถ้าถามระหว่างทาง)
+> กรณีวนแก้นาน/หลายรอบ แล้วถาม user — สรุปคำถาม/คำตอบ/การตัดสินใจ
+-
+
+## ✅ Gate → SHIP (ดู `warnyin/workflow/stages/verify.md` ข้อ 6)
+- [ ] เทสตามจุดประสงค์ครบ (functional)
+- [ ] FE: UX/UI verify ผ่าน
+- [ ] ทุกข้อที่ไม่ผ่านถูกแก้จนผ่าน
+- [ ] test.md + verify.md เขียนครบ
+- [ ] ปัญหายากบันทึก troubleshooting.md แล้ว

package/warnyin/workflow/README.md

@@ -1,92 +1,94 @@
-# 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>/`
+# 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
+    explore.md         #   playbook: EXPLORE — สำรวจ/ตอบคำถามแบบ read-only ไม่สร้าง artifact
+    next.md            #   playbook: NEXT — เช็คงานค้าง + แนะนำขั้นตอนถัดไป (read-only)
+    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/explore.md

@@ -0,0 +1,32 @@
+# EXPLORE — สำรวจ/ตอบคำถามแบบ read-only (ไม่สร้าง artifact)
+
+> **Playbook กลาง — AI ทุกเจ้าทำตามไฟล์นี้ชุดเดียวกัน** (Claude Code / Codex / Antigravity / อื่นๆ)
+> เป้าหมาย: ตอบคำถาม/สำรวจข้อมูล โค้ด และเอกสารของโปรเจกต์แบบ **grounded** โดย **ไม่สร้างหรือแก้ไฟล์ใดๆ** — จบที่คำตอบในแชท
+
+---
+
+## 1. EXPLORE คืออะไร / ใช้เมื่อไหร่
+
+EXPLORE คือโหมด **อ่านอย่างเดียว (read-only)** — ไม่ใช่ stage ใน workflow, ไม่มี gate, ไม่มี output ไฟล์
+
+- ใช้เมื่อ: อยากเข้าใจข้อมูล/โค้ด/พฤติกรรมระบบ, ถามเช็คความเข้าใจ, หาว่าอะไรอยู่ตรงไหน, เปรียบเทียบทางเลือกแบบเร็วๆ — **ยังไม่แน่ใจว่าจะกลายเป็นงานจริงหรือไม่**
+- ต่างจาก Discovery: Discovery เป็น stage ที่ผลิต `discovery.md` + `research.md` เพื่อเข้า DESIGN — EXPLORE แค่ตอบ ไม่จดอะไรลงไฟล์
+
+---
+
+## 2. Input ที่อ่านเพื่อ ground ตัวเอง (เท่าที่เกี่ยวกับคำถาม — ไม่ต้องครบทุกไฟล์)
+
+1. `docs/project.md` — โปรเจกต์นี้คืออะไร เป้าหมาย ขอบเขต
+2. `docs/codemap/index.md` — แผนที่โค้ด (ไปอ่านโค้ดจริงต่อได้)
+3. `docs/rule.md`, `docs/infra.md`, `docs/features/*`, `docs/techstack/*` — ตามที่คำถามแตะ
+4. `warnyin/stages/context.md` + topic ใน `warnyin/stages/` และ `achieved/` ที่ใกล้เคียง — งานที่เคยทำ/กำลังทำ
+
+---
+
+## 3. หลักการทำงาน
+
+1. **Read-only เด็ดขาด:** ใช้เฉพาะการอ่าน/ค้น (read, grep, glob, sub-agent แบบ read-only) — **ห้ามสร้าง แก้ หรือลบไฟล์ใดๆ** รวมถึงไฟล์ใน `warnyin/stages/` และ `docs/`
+2. **โค้ดตอบได้ → ไปอ่านโค้ด:** อ้างอิงคำตอบด้วย `path:line` หรือชื่อไฟล์จริงเสมอ ไม่ตอบจากการเดา
+3. **คำถามกว้าง → fan-out:** ถ้าต้องกวาดหลายพื้นที่ ให้กระจาย sub-agent แบบ read-only (เช่น Explore) ขนานกัน แล้วสังเคราะห์คำตอบเดียว
+4. **ตอบในแชทเท่านั้น:** สรุปกระชับ ชี้ไฟล์/บรรทัดให้ user ไปต่อเองได้
+5. **เจอประเด็นที่ควรเก็บเป็นงาน → เสนอ ไม่ทำเอง:** ถ้าการสำรวจชี้ว่าควรเปิด topic จริง ให้เสนอ `/warnyin:discovery <topic>` (scope ยังกว้าง) หรือ `/warnyin:design <slug> <change>` (scope ชัดแล้ว) — ให้ user เป็นคนตัดสินใจ