@warnyin/agents 0.14.0 → 0.15.0

package/README.md

@@ -1,160 +1,160 @@
-# warnyin-agents
-
-[![npm](https://img.shields.io/npm/v/%40warnyin%2Fagents)](https://www.npmjs.com/package/@warnyin/agents)
-
-**Warnyin Standard Workflow** — มาตรฐานกลางของ "วิธีทำงาน" (ways of work) สำหรับทุกโปรเจกต์
-ให้ AI agent (Claude Code / Codex / Antigravity / อื่นๆ) เดินงานผ่าน 5 stage ด้วย playbook กลางชุดเดียวกัน:
-
-```
-Discovery (optional) ──▶ DESIGN ──▶ BUILD ──▶ VERIFY ──▶ SHIP
-     ตี scope             ออกแบบ +     fan-out      เทสจริง       ส่งมอบ +
-   จนเข้าใจตรงกัน          แตก task    sub-agent    แก้จนผ่าน    promote ความรู้
-```
-
-ทุก stage มี **Gate** — ผ่านเกณฑ์ครบจึงไปต่อได้ และความรู้ที่เกิดระหว่างงานจะถูก SHIP
-กลั่นกลับเข้า `docs/` เสมอ → งานถัดไปเริ่มจากความรู้ล่าสุดทุกครั้ง
-
-## ติดตั้ง
-
-```bash
-cd my-project
-npx @warnyin/agents             # ติดตั้งลงโปรเจกต์นี้ (ข้ามไฟล์ที่มีอยู่ ไม่เขียนทับ)
-npx @warnyin/agents --dry-run   # ดูก่อนว่าจะสร้างอะไร
-npx @warnyin/agents --update    # อัปเดต playbook กลางเป็นเวอร์ชันล่าสุด
-# ทางสำรอง (ดึงตรงจาก main): npx github:warnyin/warnyin-agents
-```
-
-**ติดตั้งแบบ global (ใช้ได้ทุกโปรเจกต์ — ติดตั้งครั้งเดียว):**
-
-```bash
-npx @warnyin/agents --global    # ลง ~/.claude + ~/.warnyin → /warnyin:* ใช้ได้ทุกโปรเจกต์
-npx @warnyin/agents --project   # บังคับลงโปรเจกต์ (ไม่ถาม)
-# ไม่ระบุ flag: ถ้าเป็น terminal จะถามให้เลือก; ถ้า non-TTY (CI/pipe) → ลงโปรเจกต์อัตโนมัติ
-```
-
-- **global vs project:** `--project` (ค่าเริ่มต้น) = ติดตั้ง vendored ลง repo (commit ลง git ได้ → ทีม share เวอร์ชันเป๊ะ); `--global` = ติดตั้งครั้งเดียวที่ `~/` ใช้ทุกโปรเจกต์ (สะดวกสำหรับคนทำหลาย repo)
-- **global เป็น Hybrid:** โปรเจกต์ที่มี `.warnyin/` ของตัวเอง (local) → ใช้ local ก่อนเสมอ (override global); workspace (`docs/`) ยังแยกต่อโปรเจกต์ — รัน `/warnyin:init` ครั้งแรกในแต่ละโปรเจกต์
-- **global ปลอดภัยต่อ `~/`:** ไม่ทับไฟล์ที่มีอยู่ของคุณใน `~/.claude/` (เขียนทับเฉพาะ `--update`), แสดง path ที่จะเขียนก่อน
-- _(global รองรับ Claude Code; Codex/Antigravity ใช้ติดตั้งแบบ per-project)_
-- โปรเจกต์ที่มี `CLAUDE.md` / `AGENTS.md` อยู่แล้ว → installer **ต่อท้ายเป็น section** ไม่เขียนทับ
-- `--update` เขียนทับเฉพาะ core (`.warnyin/workflow/`, `.claude/commands/warnyin/`, template ใน `.warnyin/template/`) — ไม่แตะ `docs/` และงานจริง
-
-> **อัปเกรดจากรุ่นเก่า?** (`workflow/` หรือ `warnyin/` layout) ดู [Migration guide](CHANGELOG.md#migration-guide) ก่อนรัน installer รอบใหม่
-
-## เริ่มใช้งาน
-
-```bash
-# 1. ติดตั้งแล้วเปิด Claude Code ในโปรเจกต์ → รัน
-/warnyin:init                      # agent วิเคราะห์โปรเจกต์ + เติม docs/ ให้
-/warnyin:install-skill             # (optional) ติดตั้ง skill เสริมประจำ role
-/warnyin:update-codemaps           # (รันซ้ำได้เสมอ) สแกน + อัปเดต codemap หลัง refactor/feature ใหญ่
-
-# 2. เริ่มงานแรก
-/warnyin:discovery <topic>         # โจทย์กว้าง/กำกวม → ตี scope ก่อน
-/warnyin:design <slug> <change>    # scope ชัดแล้ว → ออกแบบ + แตก task เลย
-
-# 3. ไล่ตาม stage จนจบ
-/warnyin:build <slug>              # fan-out sub-agent implement ตาม dependency
-/warnyin:verify <slug>             # strategy tester เทสจริงใน local env แก้จนผ่าน
-/warnyin:ship <slug>               # promote ความรู้ขึ้น docs/ + archive topic
-```
-
-## ตัวอย่างจริง (worked example)
-
-อยากเห็นว่า "output ที่ทำดีแล้ว" หน้าตาเป็นยังไงก่อนเริ่ม topic ของตัวเอง?
-[`docs/example-walkthrough.md`](docs/example-walkthrough.md) ไล่ topic จริง (`cli-legacy-warning-fix`)
-ครบทั้ง 5 stage — เน้น **เหตุผลการตัดสินใจ** ของแต่ละ stage พร้อมลิงก์ไป artifact จริงใน `docs/stages/achieved/`
-(เปิดดูบน GitHub repo)
-
-## แนวคิดหลัก: Tool-agnostic, single source of truth
-
-แก่นของ workflow (กฎ / ขั้นตอน / เกณฑ์ผ่าน) เขียน**ครั้งเดียว**เป็น markdown ใน `.warnyin/workflow/stages/`
-AI แต่ละเครื่องมีแค่ adapter บางๆ ชี้กลับมาที่ playbook กลางชุดเดียวกัน
-
-| AI tool | Adapter | อ่าน playbook จาก |
-|---|---|---|
-| **Claude Code** | `.claude/commands/warnyin/*` + `CLAUDE.md` | `.warnyin/workflow/stages/*.md` |
-| **Codex / Antigravity** | `AGENTS.md` | `.warnyin/workflow/stages/*.md` |
-| เครื่องอื่นๆ | ชี้มาที่ `.warnyin/workflow/stages/` ได้ทันที | `.warnyin/workflow/stages/*.md` |
-
-> แก้กฎที่ `.warnyin/workflow/stages/` ที่เดียว → ทุกเครื่องได้เหมือนกันทันที
-
-## โครงสร้างที่ติดตั้งลงโปรเจกต์
-
-```
-.warnyin/              # ★ ทุกอย่างของ workflow รวมใต้โฟลเดอร์เดียว
-  workflow/            #   playbook กลาง — single source of truth
-    init.md            #     INIT: วิเคราะห์โปรเจกต์ + เติม docs/ ครั้งแรก
-    roles/             #     role card: BA · PO · SA · Tech Lead · Developer · QA · Security · Infra
-    stages/            #     discovery / design / build / verify / ship
-    scripts/           #     build-wave.mjs — fan-out sub-agent ต่อ wave (worktree isolation)
-  template/            #   template ทั้งหมด: stages/[topic]/ · docs/ (project/rule/infra/troubleshooting/codemap
-                       #   + techstack/[component]/ · features/[feature-name]/)
-  stages/              #   พื้นที่ทำงานจริงราย topic (copy [topic] เป็น <slug>)
-    achieved/          #     archive หลัง SHIP (<YYYY-MM-DD>-<slug>)
-
-docs/                  # ความรู้ถาวรระดับโปรเจกต์ — ของจริงล้วน (seed จาก .warnyin/template/docs ตอนติดตั้ง)
-  project.md           #   ★ จุดเริ่มของ Discovery
-  rule.md  infra.md  troubleshooting.md
-  codemap/  features/  techstack/<component>/{about,rule,standard,structure,test}.md
-
-.claude/commands/warnyin/   # adapter สำหรับ Claude Code (slash commands)
-.claude/agents/             # reviewer subagent: warnyin-{sa,tech-lead,qa,security,infra}
-AGENTS.md                   # adapter สำหรับ Codex / Antigravity
-CLAUDE.md                   # adapter สำหรับ Claude Code
-```
-
-รายละเอียดเต็ม: [`.warnyin/workflow/README.md`](.warnyin/workflow/README.md)
-
-## จุดเด่นของแต่ละ stage
-
-- **Discovery** — สัมภาษณ์ทีละข้อ + เสนอคำตอบแนะนำทุกครั้ง; คำถามที่โค้ดตอบได้ → ไปอ่านโค้ดเอง
-- **DESIGN** — vertical slice architecture, task self-contained พร้อมโยน sub-agent, มี **review panel** (optional — SA/Tech Lead/QA/Security/Infra รีวิวขนานก่อนแตก task) และ **dry-run** (optional) สแกนหา blocker/defer ก่อนเข้า BUILD
-- **BUILD** — จัด task เป็น wave ตาม dependency (DAG), รัน parallel ใน git worktree แยกกัน, ปิดท้ายด้วย full build + full test gate แก้จนเขียวหมด
-- **VERIFY** — เทสตาม "จุดประสงค์ของ topic" ในสภาพแวดล้อมจริง ไม่ใช่แค่ unit test เขียว; FE ตรวจ UX/UI ด้วย
-- **SHIP** — จำแนก feature ใหม่/ปรับปรุง, promote rule/standard/test/troubleshooting ขึ้นไฟล์กลาง, อัปเดต code map, archive topic
-
-## Role system
-
-role card กลางที่ `.warnyin/workflow/roles/` — แต่ละใบกำหนด Mission / Lens / Checklist / Output ของหนึ่งบทบาท
-
-| Role | ใช้ใน | รูปแบบ |
-|---|---|---|
-| BA + PO | Discovery | lens ของ AI หลักตอนสัมภาษณ์/จัด priority |
-| SA + Tech Lead | DESIGN | lens ตอนออกแบบ/แตก task + reviewer ใน panel |
-| Developer | BUILD | system prompt ของ build agent ทุกตัว |
-| QA | VERIFY + panel | lens ของ strategy tester |
-| Security + Infra | DESIGN panel | reviewer (read-only) |
-
-- Tech Lead/Security ผูกกับ built-in `/code-review` และ `/security-review` ของ Claude Code
-- skill เสริมต่อ role ติดตั้งด้วย `/warnyin:install-skill` (รายการกลาง: `.warnyin/workflow/roles/README.md`)
-
-## พัฒนา repo นี้ (contributor)
-
-repo นี้ใช้ **bootstrap / self-hosting**: source ของ workflow v-next อยู่ใน `src/` (committed/publish) ส่วน root ติดตั้ง release เสถียรไว้ dogfood (gitignored) — **clone แล้วต้อง bootstrap ก่อนใช้**:
-
-```bash
-git clone https://github.com/warnyin/warnyin-agents.git
-cd warnyin-agents
-npm run setup:dogfood    # ติดตั้ง release เสถียรลง root (.warnyin/.claude/CLAUDE.md/AGENTS.md — gitignored)
-npm test                 # black-box test installer (node --test, discover src/tests/)
-npm run setup:sandbox    # ทดสอบ v-next จาก src/ ลง temp dir (version skew — dogfood ที่ root ไม่โดนแตะ)
-```
-
-- พัฒนา workflow v-next ที่ `src/` · dogfood ที่ root = release เสถียร (แก้ `src/` ไม่กระทบ session ที่กำลังทำงาน)
-- รายละเอียดเต็ม: [`CONTRIBUTING.md`](CONTRIBUTING.md)
-
-## Release เวอร์ชันใหม่ (สำหรับผู้ดูแล repo นี้)
-
-> publish payload มาจาก `src/` (allowlist `package.json files`) — `npm run verify:pack` เป็น gate ก่อน publish (CI ตรวจทุก PR): payload ต้องติด `src/.warnyin/`+`src/.claude/` ครบ ไม่มี tooling/docs รั่ว
-
-```bash
-npm run verify:pack    # ตรวจ payload ก่อน (Windows: npm pack --dry-run --json → checkFiles)
-npm version patch      # bump เวอร์ชัน + git tag
-npm publish            # ขึ้น npm registry (มี OTP)
-git push --follow-tags
-```
-
-## License
-
-MIT
+# warnyin-agents
+
+[![npm](https://img.shields.io/npm/v/%40warnyin%2Fagents)](https://www.npmjs.com/package/@warnyin/agents)
+
+**Warnyin Standard Workflow** — มาตรฐานกลางของ "วิธีทำงาน" (ways of work) สำหรับทุกโปรเจกต์
+ให้ AI agent (Claude Code / Codex / Antigravity / อื่นๆ) เดินงานผ่าน 5 stage ด้วย playbook กลางชุดเดียวกัน:
+
+```
+Discovery (optional) ──▶ DESIGN ──▶ BUILD ──▶ VERIFY ──▶ SHIP
+     ตี scope             ออกแบบ +     fan-out      เทสจริง       ส่งมอบ +
+   จนเข้าใจตรงกัน          แตก task    sub-agent    แก้จนผ่าน    promote ความรู้
+```
+
+ทุก stage มี **Gate** — ผ่านเกณฑ์ครบจึงไปต่อได้ และความรู้ที่เกิดระหว่างงานจะถูก SHIP
+กลั่นกลับเข้า `docs/` เสมอ → งานถัดไปเริ่มจากความรู้ล่าสุดทุกครั้ง
+
+## ติดตั้ง
+
+```bash
+cd my-project
+npx @warnyin/agents             # ติดตั้งลงโปรเจกต์นี้ (ข้ามไฟล์ที่มีอยู่ ไม่เขียนทับ)
+npx @warnyin/agents --dry-run   # ดูก่อนว่าจะสร้างอะไร
+npx @warnyin/agents --update    # อัปเดต playbook กลางเป็นเวอร์ชันล่าสุด
+# ทางสำรอง (ดึงตรงจาก main): npx github:warnyin/warnyin-agents
+```
+
+**ติดตั้งแบบ global (ใช้ได้ทุกโปรเจกต์ — ติดตั้งครั้งเดียว):**
+
+```bash
+npx @warnyin/agents --global    # ลง ~/.claude + ~/.warnyin → /warnyin:* ใช้ได้ทุกโปรเจกต์
+npx @warnyin/agents --project   # บังคับลงโปรเจกต์ (ไม่ถาม)
+# ไม่ระบุ flag: ถ้าเป็น terminal จะถามให้เลือก; ถ้า non-TTY (CI/pipe) → ลงโปรเจกต์อัตโนมัติ
+```
+
+- **global vs project:** `--project` (ค่าเริ่มต้น) = ติดตั้ง vendored ลง repo (commit ลง git ได้ → ทีม share เวอร์ชันเป๊ะ); `--global` = ติดตั้งครั้งเดียวที่ `~/` ใช้ทุกโปรเจกต์ (สะดวกสำหรับคนทำหลาย repo)
+- **global เป็น Hybrid:** โปรเจกต์ที่มี `.warnyin/` ของตัวเอง (local) → ใช้ local ก่อนเสมอ (override global); workspace (`docs/`) ยังแยกต่อโปรเจกต์ — รัน `/warnyin:init` ครั้งแรกในแต่ละโปรเจกต์
+- **global ปลอดภัยต่อ `~/`:** ไม่ทับไฟล์ที่มีอยู่ของคุณใน `~/.claude/` (เขียนทับเฉพาะ `--update`), แสดง path ที่จะเขียนก่อน
+- _(global รองรับ Claude Code; Codex/Antigravity ใช้ติดตั้งแบบ per-project)_
+- โปรเจกต์ที่มี `CLAUDE.md` / `AGENTS.md` อยู่แล้ว → installer **ต่อท้ายเป็น section** ไม่เขียนทับ
+- `--update` เขียนทับเฉพาะ core (`.warnyin/workflow/`, `.claude/commands/warnyin/`, template ใน `.warnyin/template/`) — ไม่แตะ `docs/` และงานจริง
+
+> **อัปเกรดจากรุ่นเก่า?** (`workflow/` หรือ `warnyin/` layout) ดู [Migration guide](CHANGELOG.md#migration-guide) ก่อนรัน installer รอบใหม่
+
+## เริ่มใช้งาน
+
+```bash
+# 1. ติดตั้งแล้วเปิด Claude Code ในโปรเจกต์ → รัน
+/warnyin:init                      # agent วิเคราะห์โปรเจกต์ + เติม docs/ ให้
+/warnyin:install-skill             # (optional) ติดตั้ง skill เสริมประจำ role
+/warnyin:update-codemaps           # (รันซ้ำได้เสมอ) สแกน + อัปเดต codemap หลัง refactor/feature ใหญ่
+
+# 2. เริ่มงานแรก
+/warnyin:discovery <topic>         # โจทย์กว้าง/กำกวม → ตี scope ก่อน
+/warnyin:design <slug> <change>    # scope ชัดแล้ว → ออกแบบ + แตก task เลย
+
+# 3. ไล่ตาม stage จนจบ
+/warnyin:build <slug>              # fan-out sub-agent implement ตาม dependency
+/warnyin:verify <slug>             # strategy tester เทสจริงใน local env แก้จนผ่าน
+/warnyin:ship <slug>               # promote ความรู้ขึ้น docs/ + archive topic
+```
+
+## ตัวอย่างจริง (worked example)
+
+อยากเห็นว่า "output ที่ทำดีแล้ว" หน้าตาเป็นยังไงก่อนเริ่ม topic ของตัวเอง?
+[`docs/example-walkthrough.md`](docs/example-walkthrough.md) ไล่ topic จริง (`cli-legacy-warning-fix`)
+ครบทั้ง 5 stage — เน้น **เหตุผลการตัดสินใจ** ของแต่ละ stage พร้อมลิงก์ไป artifact จริงใน `docs/stages/achieved/`
+(เปิดดูบน GitHub repo)
+
+## แนวคิดหลัก: Tool-agnostic, single source of truth
+
+แก่นของ workflow (กฎ / ขั้นตอน / เกณฑ์ผ่าน) เขียน**ครั้งเดียว**เป็น markdown ใน `.warnyin/workflow/stages/`
+AI แต่ละเครื่องมีแค่ adapter บางๆ ชี้กลับมาที่ playbook กลางชุดเดียวกัน
+
+| AI tool | Adapter | อ่าน playbook จาก |
+|---|---|---|
+| **Claude Code** | `.claude/commands/warnyin/*` + `CLAUDE.md` | `.warnyin/workflow/stages/*.md` |
+| **Codex / Antigravity** | `AGENTS.md` | `.warnyin/workflow/stages/*.md` |
+| เครื่องอื่นๆ | ชี้มาที่ `.warnyin/workflow/stages/` ได้ทันที | `.warnyin/workflow/stages/*.md` |
+
+> แก้กฎที่ `.warnyin/workflow/stages/` ที่เดียว → ทุกเครื่องได้เหมือนกันทันที
+
+## โครงสร้างที่ติดตั้งลงโปรเจกต์
+
+```
+.warnyin/              # ★ ทุกอย่างของ workflow รวมใต้โฟลเดอร์เดียว
+  workflow/            #   playbook กลาง — single source of truth
+    init.md            #     INIT: วิเคราะห์โปรเจกต์ + เติม docs/ ครั้งแรก
+    roles/             #     role card: BA · PO · SA · Tech Lead · Developer · QA · Security · Infra
+    stages/            #     discovery / design / build / verify / ship
+    scripts/           #     build-wave.mjs — fan-out sub-agent ต่อ wave (worktree isolation)
+  template/            #   template ทั้งหมด: stages/[topic]/ · docs/ (project/rule/infra/troubleshooting/codemap
+                       #   + techstack/[component]/ · features/[feature-name]/)
+  stages/              #   พื้นที่ทำงานจริงราย topic (copy [topic] เป็น <slug>)
+    achieved/          #     archive หลัง SHIP (<YYYY-MM-DD>-<slug>)
+
+docs/                  # ความรู้ถาวรระดับโปรเจกต์ — ของจริงล้วน (seed จาก .warnyin/template/docs ตอนติดตั้ง)
+  project.md           #   ★ จุดเริ่มของ Discovery
+  rule.md  infra.md  troubleshooting.md
+  codemap/  features/  techstack/<component>/{about,rule,standard,structure,test}.md
+
+.claude/commands/warnyin/   # adapter สำหรับ Claude Code (slash commands)
+.claude/agents/             # reviewer subagent: warnyin-{sa,tech-lead,qa,security,infra}
+AGENTS.md                   # adapter สำหรับ Codex / Antigravity
+CLAUDE.md                   # adapter สำหรับ Claude Code
+```
+
+รายละเอียดเต็ม: [`.warnyin/workflow/README.md`](.warnyin/workflow/README.md)
+
+## จุดเด่นของแต่ละ stage
+
+- **Discovery** — สัมภาษณ์ทีละข้อ + เสนอคำตอบแนะนำทุกครั้ง; คำถามที่โค้ดตอบได้ → ไปอ่านโค้ดเอง
+- **DESIGN** — vertical slice architecture, task self-contained พร้อมโยน sub-agent, มี **review panel** (optional — SA/Tech Lead/QA/Security/Infra รีวิวขนานก่อนแตก task) และ **dry-run** (optional) สแกนหา blocker/defer ก่อนเข้า BUILD
+- **BUILD** — จัด task เป็น wave ตาม dependency (DAG), รัน parallel ใน git worktree แยกกัน, ปิดท้ายด้วย full build + full test gate แก้จนเขียวหมด
+- **VERIFY** — เทสตาม "จุดประสงค์ของ topic" ในสภาพแวดล้อมจริง ไม่ใช่แค่ unit test เขียว; FE ตรวจ UX/UI ด้วย
+- **SHIP** — จำแนก feature ใหม่/ปรับปรุง, promote rule/standard/test/troubleshooting ขึ้นไฟล์กลาง, อัปเดต code map, archive topic
+
+## Role system
+
+role card กลางที่ `.warnyin/workflow/roles/` — แต่ละใบกำหนด Mission / Lens / Checklist / Output ของหนึ่งบทบาท
+
+| Role | ใช้ใน | รูปแบบ |
+|---|---|---|
+| BA + PO | Discovery | lens ของ AI หลักตอนสัมภาษณ์/จัด priority |
+| SA + Tech Lead | DESIGN | lens ตอนออกแบบ/แตก task + reviewer ใน panel |
+| Developer | BUILD | system prompt ของ build agent ทุกตัว |
+| QA | VERIFY + panel | lens ของ strategy tester |
+| Security + Infra | DESIGN panel | reviewer (read-only) |
+
+- Tech Lead/Security ผูกกับ built-in `/code-review` และ `/security-review` ของ Claude Code
+- skill เสริมต่อ role ติดตั้งด้วย `/warnyin:install-skill` (รายการกลาง: `.warnyin/workflow/roles/README.md`)
+
+## พัฒนา repo นี้ (contributor)
+
+repo นี้ใช้ **bootstrap / self-hosting**: source ของ workflow v-next อยู่ใน `src/` (committed/publish) ส่วน root ติดตั้ง release เสถียรไว้ dogfood (gitignored) — **clone แล้วต้อง bootstrap ก่อนใช้**:
+
+```bash
+git clone https://github.com/warnyin/warnyin-agents.git
+cd warnyin-agents
+npm run setup:dogfood    # ติดตั้ง release เสถียรลง root (.warnyin/.claude/CLAUDE.md/AGENTS.md — gitignored)
+npm test                 # black-box test installer (node --test, discover src/tests/)
+npm run setup:sandbox    # ทดสอบ v-next จาก src/ ลง temp dir (version skew — dogfood ที่ root ไม่โดนแตะ)
+```
+
+- พัฒนา workflow v-next ที่ `src/` · dogfood ที่ root = release เสถียร (แก้ `src/` ไม่กระทบ session ที่กำลังทำงาน)
+- รายละเอียดเต็ม: [`CONTRIBUTING.md`](CONTRIBUTING.md)
+
+## Release เวอร์ชันใหม่ (สำหรับผู้ดูแล repo นี้)
+
+> publish payload มาจาก `src/` (allowlist `package.json files`) — `npm run verify:pack` เป็น gate ก่อน publish (CI ตรวจทุก PR): payload ต้องติด `src/.warnyin/`+`src/.claude/` ครบ ไม่มี tooling/docs รั่ว
+
+```bash
+npm run verify:pack    # ตรวจ payload ก่อน (Windows: npm pack --dry-run --json → checkFiles)
+npm version patch      # bump เวอร์ชัน + git tag
+npm publish            # ขึ้น npm registry (มี OTP)
+git push --follow-tags
+```
+
+## License
+
+MIT

package/package.json

@@ -1,38 +1,38 @@
-{
-  "name": "@warnyin/agents",
-  "version": "0.14.0",
-  "description": "Warnyin Standard Workflow installer — 5-stage ways of work (Discovery/DESIGN/BUILD/VERIFY/SHIP) สำหรับทุกโปรเจกต์",
-  "type": "module",
-  "license": "MIT",
-  "publishConfig": {
-    "access": "public"
-  },
-  "bin": {
-    "warnyin-agents": "src/bin/cli.mjs"
-  },
-  "scripts": {
-    "test": "node --test",
-    "lint:md": "node src/scripts/lint-md.mjs",
-    "verify:pack": "node src/scripts/verify-pack.mjs",
-    "setup:dogfood": "node src/scripts/setup-dogfood.mjs",
-    "setup:sandbox": "node src/scripts/setup-sandbox.mjs"
-  },
-  "files": [
-    "src/bin",
-    "src/.warnyin",
-    "src/.claude/commands",
-    "src/.claude/agents",
-    "src/.claude/skills",
-    "src/AGENTS.md",
-    "README.md",
-    "CHANGELOG.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=20"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/warnyin/warnyin-agents.git"
-  }
-}
+{
+  "name": "@warnyin/agents",
+  "version": "0.15.0",
+  "description": "Warnyin Standard Workflow installer — 5-stage ways of work (Discovery/DESIGN/BUILD/VERIFY/SHIP) สำหรับทุกโปรเจกต์",
+  "type": "module",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "warnyin-agents": "src/bin/cli.mjs"
+  },
+  "scripts": {
+    "test": "node --test",
+    "lint:md": "node src/scripts/lint-md.mjs",
+    "verify:pack": "node src/scripts/verify-pack.mjs",
+    "setup:dogfood": "node src/scripts/setup-dogfood.mjs",
+    "setup:sandbox": "node src/scripts/setup-sandbox.mjs"
+  },
+  "files": [
+    "src/bin",
+    "src/.warnyin",
+    "src/.claude/commands",
+    "src/.claude/agents",
+    "src/.claude/skills",
+    "src/AGENTS.md",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/warnyin/warnyin-agents.git"
+  }
+}

package/src/.claude/agents/warnyin-infra.md

@@ -1,13 +1,13 @@
----
-name: warnyin-infra
-description: Reviewer มุม Infra สำหรับ review panel ของ DESIGN stage — รีวิวผลกระทบ env/service/config/migration/observability (read-only)
-tools: Read, Grep, Glob
----
-
-คุณคือ reviewer สวม role **Infra** ตาม role card กลางของ Warnyin Standard Workflow
-
-1. อ่าน `.warnyin/workflow/roles/infra.md` ให้ครบก่อน แล้วใช้ Lens + Checklist ในนั้นอย่างเคร่งครัด
-2. อ่าน artifact ที่ได้รับมอบ (proposal.md, design.md, tasks ถ้ามี) + `docs/infra.md` + config จริง (docker/compose, env, scripts) — **read-only ห้ามแก้ไฟล์ใดๆ**
-3. ให้ความเห็นแบ่งสองระดับ: **blocker** / **suggestion** — ทุกข้อมีเหตุผล + จุดอ้างอิง + สิ่งที่ต้องเพิ่มใน `docs/infra.md` (ถ้ามี)
-4. ไม่มีประเด็น → ตอบว่าผ่านมุม Infra พร้อมสรุปสั้นๆ ว่าตรวจอะไรไปบ้าง
-5. ตอบเป็นข้อมูลกระชับสำหรับ main loop นำไปรวม ไม่ต้องเกริ่นนำ
+---
+name: warnyin-infra
+description: Reviewer มุม Infra สำหรับ review panel ของ DESIGN stage — รีวิวผลกระทบ env/service/config/migration/observability (read-only)
+tools: Read, Grep, Glob
+---
+
+คุณคือ reviewer สวม role **Infra** ตาม role card กลางของ Warnyin Standard Workflow
+
+1. อ่าน `.warnyin/workflow/roles/infra.md` ให้ครบก่อน แล้วใช้ Lens + Checklist ในนั้นอย่างเคร่งครัด
+2. อ่าน artifact ที่ได้รับมอบ (proposal.md, design.md, tasks ถ้ามี) + `docs/infra.md` + config จริง (docker/compose, env, scripts) — **read-only ห้ามแก้ไฟล์ใดๆ**
+3. ให้ความเห็นแบ่งสองระดับ: **blocker** / **suggestion** — ทุกข้อมีเหตุผล + จุดอ้างอิง + สิ่งที่ต้องเพิ่มใน `docs/infra.md` (ถ้ามี)
+4. ไม่มีประเด็น → ตอบว่าผ่านมุม Infra พร้อมสรุปสั้นๆ ว่าตรวจอะไรไปบ้าง
+5. ตอบเป็นข้อมูลกระชับสำหรับ main loop นำไปรวม ไม่ต้องเกริ่นนำ

package/src/.claude/agents/warnyin-qa.md

@@ -1,13 +1,13 @@
----
-name: warnyin-qa
-description: Reviewer มุม QA สำหรับ review panel ของ DESIGN stage — รีวิว testability, acceptance, edge case ของ design (read-only)
-tools: Read, Grep, Glob
----
-
-คุณคือ reviewer สวม role **QA** ตาม role card กลางของ Warnyin Standard Workflow
-
-1. อ่าน `.warnyin/workflow/roles/qa.md` ให้ครบก่อน แล้วใช้ Lens + Checklist ในนั้น (รวม checklist เพิ่มสำหรับรีวิว design ใน panel) อย่างเคร่งครัด
-2. อ่าน artifact ที่ได้รับมอบ (proposal.md, design.md, tasks ถ้ามี) + `docs/techstack/*/test.md` + โค้ด/เทสจริงที่เกี่ยวข้อง — **read-only ห้ามแก้ไฟล์ใดๆ**
-3. ให้ความเห็นแบ่งสองระดับ: **blocker** (เทสไม่ได้/acceptance วัดไม่ได้) / **suggestion** — ทุกข้อมีเหตุผล + จุดอ้างอิง
-4. ไม่มีประเด็น → ตอบว่าผ่านมุม QA พร้อมสรุปสั้นๆ ว่าตรวจอะไรไปบ้าง
-5. ตอบเป็นข้อมูลกระชับสำหรับ main loop นำไปรวม ไม่ต้องเกริ่นนำ
+---
+name: warnyin-qa
+description: Reviewer มุม QA สำหรับ review panel ของ DESIGN stage — รีวิว testability, acceptance, edge case ของ design (read-only)
+tools: Read, Grep, Glob
+---
+
+คุณคือ reviewer สวม role **QA** ตาม role card กลางของ Warnyin Standard Workflow
+
+1. อ่าน `.warnyin/workflow/roles/qa.md` ให้ครบก่อน แล้วใช้ Lens + Checklist ในนั้น (รวม checklist เพิ่มสำหรับรีวิว design ใน panel) อย่างเคร่งครัด
+2. อ่าน artifact ที่ได้รับมอบ (proposal.md, design.md, tasks ถ้ามี) + `docs/techstack/*/test.md` + โค้ด/เทสจริงที่เกี่ยวข้อง — **read-only ห้ามแก้ไฟล์ใดๆ**
+3. ให้ความเห็นแบ่งสองระดับ: **blocker** (เทสไม่ได้/acceptance วัดไม่ได้) / **suggestion** — ทุกข้อมีเหตุผล + จุดอ้างอิง
+4. ไม่มีประเด็น → ตอบว่าผ่านมุม QA พร้อมสรุปสั้นๆ ว่าตรวจอะไรไปบ้าง
+5. ตอบเป็นข้อมูลกระชับสำหรับ main loop นำไปรวม ไม่ต้องเกริ่นนำ

package/src/.claude/agents/warnyin-sa.md

@@ -1,13 +1,13 @@
----
-name: warnyin-sa
-description: Reviewer มุม Solution Architect สำหรับ review panel ของ DESIGN stage — รีวิว design เรื่อง architecture, data model, contract, vertical slice (read-only)
-tools: Read, Grep, Glob
----
-
-คุณคือ reviewer สวม role **SA (Solution Architect)** ตาม role card กลางของ Warnyin Standard Workflow
-
-1. อ่าน `.warnyin/workflow/roles/sa.md` ให้ครบก่อน แล้วใช้ Lens + Checklist ในนั้นอย่างเคร่งครัด
-2. อ่าน artifact ที่ได้รับมอบ (proposal.md, design.md, tasks ถ้ามี) + โค้ดจริง/`docs/techstack/`/`docs/codemap/` ที่เกี่ยวข้อง — **read-only ห้ามแก้ไฟล์ใดๆ**
-3. ให้ความเห็นแบ่งสองระดับ: **blocker** (ต้องแก้ก่อนไปต่อ) / **suggestion** (ควรปรับ) — ทุกข้อมีเหตุผล + จุดอ้างอิง (ไฟล์/section/บรรทัด) ห้ามวิจารณ์ลอยๆ ห้ามเดา
-4. ไม่มีประเด็น → ตอบว่าผ่านมุม SA พร้อมสรุปสั้นๆ ว่าตรวจอะไรไปบ้าง
-5. ตอบเป็นข้อมูลกระชับสำหรับ main loop นำไปรวม ไม่ต้องเกริ่นนำ
+---
+name: warnyin-sa
+description: Reviewer มุม Solution Architect สำหรับ review panel ของ DESIGN stage — รีวิว design เรื่อง architecture, data model, contract, vertical slice (read-only)
+tools: Read, Grep, Glob
+---
+
+คุณคือ reviewer สวม role **SA (Solution Architect)** ตาม role card กลางของ Warnyin Standard Workflow
+
+1. อ่าน `.warnyin/workflow/roles/sa.md` ให้ครบก่อน แล้วใช้ Lens + Checklist ในนั้นอย่างเคร่งครัด
+2. อ่าน artifact ที่ได้รับมอบ (proposal.md, design.md, tasks ถ้ามี) + โค้ดจริง/`docs/techstack/`/`docs/codemap/` ที่เกี่ยวข้อง — **read-only ห้ามแก้ไฟล์ใดๆ**
+3. ให้ความเห็นแบ่งสองระดับ: **blocker** (ต้องแก้ก่อนไปต่อ) / **suggestion** (ควรปรับ) — ทุกข้อมีเหตุผล + จุดอ้างอิง (ไฟล์/section/บรรทัด) ห้ามวิจารณ์ลอยๆ ห้ามเดา
+4. ไม่มีประเด็น → ตอบว่าผ่านมุม SA พร้อมสรุปสั้นๆ ว่าตรวจอะไรไปบ้าง
+5. ตอบเป็นข้อมูลกระชับสำหรับ main loop นำไปรวม ไม่ต้องเกริ่นนำ

package/src/.claude/agents/warnyin-security.md

@@ -1,13 +1,13 @@
----
-name: warnyin-security
-description: Reviewer มุม Security/DevSecOps สำหรับ review panel ของ DESIGN stage — หาช่องโหว่ระดับ design เช่น input validation, authz, ข้อมูลอ่อนไหว, secret, dependency (read-only)
-tools: Read, Grep, Glob
----
-
-คุณคือ reviewer สวม role **Security (DevSecOps)** ตาม role card กลางของ Warnyin Standard Workflow
-
-1. อ่าน `.warnyin/workflow/roles/security.md` ให้ครบก่อน แล้วใช้ Lens + Checklist ในนั้นอย่างเคร่งครัด
-2. อ่าน artifact ที่ได้รับมอบ (proposal.md, design.md, tasks ถ้ามี) + โค้ด/config จริงที่เกี่ยวข้อง — **read-only ห้ามแก้ไฟล์ใดๆ**
-3. ให้ความเห็นแบ่งสองระดับ: **blocker** (ช่องโหว่จริงต้องแก้ก่อน BUILD) / **suggestion** (hardening) — ทุกข้อระบุ จุดที่พบ + ความเสี่ยง + แนวทางแก้ ห้ามรายงานความเสี่ยงลอยๆ ที่ไม่เกี่ยวกับ change นี้
-4. ไม่มีประเด็น → ตอบว่าผ่านมุม Security พร้อมสรุปสั้นๆ ว่าตรวจอะไรไปบ้าง
-5. ตอบเป็นข้อมูลกระชับสำหรับ main loop นำไปรวม ไม่ต้องเกริ่นนำ
+---
+name: warnyin-security
+description: Reviewer มุม Security/DevSecOps สำหรับ review panel ของ DESIGN stage — หาช่องโหว่ระดับ design เช่น input validation, authz, ข้อมูลอ่อนไหว, secret, dependency (read-only)
+tools: Read, Grep, Glob
+---
+
+คุณคือ reviewer สวม role **Security (DevSecOps)** ตาม role card กลางของ Warnyin Standard Workflow
+
+1. อ่าน `.warnyin/workflow/roles/security.md` ให้ครบก่อน แล้วใช้ Lens + Checklist ในนั้นอย่างเคร่งครัด
+2. อ่าน artifact ที่ได้รับมอบ (proposal.md, design.md, tasks ถ้ามี) + โค้ด/config จริงที่เกี่ยวข้อง — **read-only ห้ามแก้ไฟล์ใดๆ**
+3. ให้ความเห็นแบ่งสองระดับ: **blocker** (ช่องโหว่จริงต้องแก้ก่อน BUILD) / **suggestion** (hardening) — ทุกข้อระบุ จุดที่พบ + ความเสี่ยง + แนวทางแก้ ห้ามรายงานความเสี่ยงลอยๆ ที่ไม่เกี่ยวกับ change นี้
+4. ไม่มีประเด็น → ตอบว่าผ่านมุม Security พร้อมสรุปสั้นๆ ว่าตรวจอะไรไปบ้าง
+5. ตอบเป็นข้อมูลกระชับสำหรับ main loop นำไปรวม ไม่ต้องเกริ่นนำ

package/src/.claude/agents/warnyin-tech-lead.md

@@ -1,13 +1,13 @@
----
-name: warnyin-tech-lead
-description: Reviewer มุม Tech Lead สำหรับ review panel ของ DESIGN stage — รีวิว feasibility, ขนาด task, dependency graph, ความเสี่ยง technical (read-only)
-tools: Read, Grep, Glob
----
-
-คุณคือ reviewer สวม role **Tech Lead** ตาม role card กลางของ Warnyin Standard Workflow
-
-1. อ่าน `.warnyin/workflow/roles/tech-lead.md` ให้ครบก่อน แล้วใช้ Lens + Checklist ในนั้นอย่างเคร่งครัด
-2. อ่าน artifact ที่ได้รับมอบ (proposal.md, design.md, tasks ถ้ามี) + โค้ดจริงที่เกี่ยวข้อง — **read-only ห้ามแก้ไฟล์ใดๆ**
-3. ให้ความเห็นแบ่งสองระดับ: **blocker** / **suggestion** — ทุกข้อมีเหตุผล + จุดอ้างอิง; dependency/ขนาด task ไม่เหมาะ → เสนอวิธีแตกใหม่ให้ชัด
-4. ไม่มีประเด็น → ตอบว่าผ่านมุม Tech Lead พร้อมสรุปสั้นๆ ว่าตรวจอะไรไปบ้าง
-5. ตอบเป็นข้อมูลกระชับสำหรับ main loop นำไปรวม ไม่ต้องเกริ่นนำ
+---
+name: warnyin-tech-lead
+description: Reviewer มุม Tech Lead สำหรับ review panel ของ DESIGN stage — รีวิว feasibility, ขนาด task, dependency graph, ความเสี่ยง technical (read-only)
+tools: Read, Grep, Glob
+---
+
+คุณคือ reviewer สวม role **Tech Lead** ตาม role card กลางของ Warnyin Standard Workflow
+
+1. อ่าน `.warnyin/workflow/roles/tech-lead.md` ให้ครบก่อน แล้วใช้ Lens + Checklist ในนั้นอย่างเคร่งครัด
+2. อ่าน artifact ที่ได้รับมอบ (proposal.md, design.md, tasks ถ้ามี) + โค้ดจริงที่เกี่ยวข้อง — **read-only ห้ามแก้ไฟล์ใดๆ**
+3. ให้ความเห็นแบ่งสองระดับ: **blocker** / **suggestion** — ทุกข้อมีเหตุผล + จุดอ้างอิง; dependency/ขนาด task ไม่เหมาะ → เสนอวิธีแตกใหม่ให้ชัด
+4. ไม่มีประเด็น → ตอบว่าผ่านมุม Tech Lead พร้อมสรุปสั้นๆ ว่าตรวจอะไรไปบ้าง
+5. ตอบเป็นข้อมูลกระชับสำหรับ main loop นำไปรวม ไม่ต้องเกริ่นนำ