@warnyin/agents 0.18.1 → 0.20.0

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

@@ -1,104 +1,104 @@
-# Wireframe — <ชื่อ change / กลุ่มหน้าจอ>
-
-> Output ของ DESIGN stage · playbook: `.warnyin/workflow/stages/design.md`
-> **low-fidelity wireframe** ของ change ที่มี UI surface — วาดก่อนเขียน technical design (`design.md` §5 UI layer) แล้วแตก task
-> วาดโดย role/agent `warnyin-ux` (read-only generator) หรือ AI หลักสวม lens `.warnyin/workflow/roles/ux.md` (fallback) — main loop เขียนไฟล์นี้
-
-| | |
-|---|---|
-| **Slug** | `<kebab-case ของ topic — ตรงกับ docs/stages/<slug>/>` |
-| **วันที่** | `YYYY-MM-DD` |
-| **Status** | `draft` / `approved` _(★ approve gate — user ต้องยืนยันให้เป็น `approved` ก่อนแตก task)_ |
-
-<!--
-วิธีกรอกไฟล์นี้ (อ่านก่อนเริ่ม):
-- wireframe เป็น low-fidelity เท่านั้น — กล่อง/label generic พอให้เห็นโครงหน้าจอ ไม่ต้องสวย ไม่ใช่ pixel-perfect
-- ★ privacy: ใช้ placeholder generic — ห้ามใส่ secret/token/credential/internal path/PII จริงลงในภาพ (ไฟล์นี้ commit ลง repo)
-- แทนที่ทุก <...> และ [LABEL] ด้วยของจริงของ change นี้ แล้วลบ comment <!-- ... --> ที่เป็นคำสั่งกรอกออก
-- 4 section ด้านล่าง (§1-§4) ชื่อตายตัวตาม contract — design.md/task อ้างชื่อนี้ ห้ามเปลี่ยนชื่อ/ลบ section
--->
-
-## 1. User flow
-
-> เส้นทาง screen-to-screen — ผู้ใช้เดินจากจอไหนไปจอไหน (ทำอะไร → เห็นอะไร)
-> วาดเป็น ASCII arrow flow; แตกแขนง (branch) ได้ตาม action/เงื่อนไข
-
-```
-<!-- ตัวอย่าง — แทนที่ด้วย flow จริงของ change นี้ -->
-[Entry / Landing]
-      │ กดปุ่มหลัก
-      ▼
-[Form / Input screen] ──ใส่ข้อมูลไม่ครบ──▶ [Validation error inline]
-      │ submit สำเร็จ
-      ▼
-[Result / Success screen]
-      │ กดย้อนกลับ
-      ▼
-[Entry / Landing]
-```
-
-## 2. Wireframe ต่อ screen
-
-> ASCII box หนึ่งกล่องต่อหนึ่ง screen — low-fidelity (กล่อง + label generic)
-> ★ **ทำซ้ำ block "### Screen: ..." ด้านล่างได้หลายอัน** — หนึ่ง block ต่อหนึ่งหน้าจอใน user flow §1
-
-### Screen: <ชื่อจอ A — เช่น Landing>
-
-```
-┌─────────────────────────────────────────┐
-│  [LOGO]                      [User menu] │  <- header / nav
-├─────────────────────────────────────────┤
-│                                          │
-│   <หัวข้อจอ / คำอธิบายสั้น>               │
-│                                          │
-│   ┌─────────────────────────────────┐    │
-│   │  [Primary content / list item]  │    │
-│   │  [Primary content / list item]  │    │
-│   └─────────────────────────────────┘    │
-│                                          │
-│                     [ ปุ่มหลัก / CTA ]    │  <- action
-│                                          │
-└─────────────────────────────────────────┘
-```
-
-### Screen: <ชื่อจอ B — เช่น Form>
-
-<!-- ทำซ้ำ block นี้ต่อหนึ่งหน้าจอ; ลบ block ตัวอย่างที่ไม่ใช้ออก -->
-
-```
-┌─────────────────────────────────────────┐
-│  ◀ กลับ            <หัวข้อจอ>            │
-├─────────────────────────────────────────┤
-│                                          │
-│   <Field 1 label>                        │
-│   [____________________________]         │  <- input
-│                                          │
-│   <Field 2 label>                        │
-│   [____________________________]         │
-│   ( ) ตัวเลือก A   ( ) ตัวเลือก B         │  <- radio/option
-│                                          │
-│              [ ยกเลิก ]   [ ยืนยัน ]       │
-│                                          │
-└─────────────────────────────────────────┘
-```
-
-## 3. Screen states
-
-> ต่อหนึ่ง screen ใน §2 ระบุหน้าตาแต่ละ state — empty / loading / error / success
-> state ไหนไม่มีจริงสำหรับจอนั้น ใส่ `N/A` พร้อมเหตุผลสั้น
-
-| Screen | empty | loading | error | success |
-|---|---|---|---|---|
-| `<ชื่อจอ A>` | `<ไม่มี item — แสดงอะไร>` | `<skeleton / spinner>` | `<โหลด list ไม่ได้ — แสดงอะไร>` | `<มี item — แสดงอะไร>` |
-| `<ชื่อจอ B>` | `N/A (form ไม่มี empty)` | `<ขณะ submit — disable ปุ่ม>` | `<validation/server error inline>` | `<submit สำเร็จ → ไปจอไหน>` |
-
-## 4. Design-honor note
-
-> สิ่งที่ `design.md` (§5 UI layer) + task ใน BUILD **ต้องทำตาม** wireframe นี้ — กัน implementation หลุดจากที่ user approve
-> เขียนเป็นข้อผูกมัด (constraint) ที่ตรวจได้ ไม่ใช่คำอธิบายลอย ๆ
-
-- [ ] design.md §5 (UI layer) **อ้าง wireframe นี้** + ทุก screen ใน §2 มี task รองรับ
-- [ ] ลำดับ screen ใน task ตรงกับ user flow §1 (entry → ... → result)
-- [ ] ทุก screen implement ครบ 4 state ตาม §3 (ไม่ข้าม error/empty)
-- [ ] `<constraint เฉพาะ change นี้ — เช่น "ปุ่ม CTA ต้องอยู่ขวาล่างเสมอ", "field บังคับมี inline validation">`
-- [ ] เปลี่ยน layout/flow จาก wireframe นี้ → ต้อง rerun approve gate (กลับ status เป็น `draft` แล้วให้ user ยืนยันใหม่)
+# Wireframe — <ชื่อ change / กลุ่มหน้าจอ>
+
+> Output ของ DESIGN stage · playbook: `.warnyin/workflow/stages/design.md`
+> **low-fidelity wireframe** ของ change ที่มี UI surface — วาดก่อนเขียน technical design (`design.md` §5 UI layer) แล้วแตก task
+> วาดโดย role/agent `warnyin-ux` (read-only generator) หรือ AI หลักสวม lens `.warnyin/workflow/roles/ux.md` (fallback) — main loop เขียนไฟล์นี้
+
+| | |
+|---|---|
+| **Slug** | `<kebab-case ของ topic — ตรงกับ docs/stages/<slug>/>` |
+| **วันที่** | `YYYY-MM-DD` |
+| **Status** | `draft` / `approved` _(★ approve gate — user ต้องยืนยันให้เป็น `approved` ก่อนแตก task)_ |
+
+<!--
+วิธีกรอกไฟล์นี้ (อ่านก่อนเริ่ม):
+- wireframe เป็น low-fidelity เท่านั้น — กล่อง/label generic พอให้เห็นโครงหน้าจอ ไม่ต้องสวย ไม่ใช่ pixel-perfect
+- ★ privacy: ใช้ placeholder generic — ห้ามใส่ secret/token/credential/internal path/PII จริงลงในภาพ (ไฟล์นี้ commit ลง repo)
+- แทนที่ทุก <...> และ [LABEL] ด้วยของจริงของ change นี้ แล้วลบ comment <!-- ... --> ที่เป็นคำสั่งกรอกออก
+- 4 section ด้านล่าง (§1-§4) ชื่อตายตัวตาม contract — design.md/task อ้างชื่อนี้ ห้ามเปลี่ยนชื่อ/ลบ section
+-->
+
+## 1. User flow
+
+> เส้นทาง screen-to-screen — ผู้ใช้เดินจากจอไหนไปจอไหน (ทำอะไร → เห็นอะไร)
+> วาดเป็น ASCII arrow flow; แตกแขนง (branch) ได้ตาม action/เงื่อนไข
+
+```
+<!-- ตัวอย่าง — แทนที่ด้วย flow จริงของ change นี้ -->
+[Entry / Landing]
+      │ กดปุ่มหลัก
+      ▼
+[Form / Input screen] ──ใส่ข้อมูลไม่ครบ──▶ [Validation error inline]
+      │ submit สำเร็จ
+      ▼
+[Result / Success screen]
+      │ กดย้อนกลับ
+      ▼
+[Entry / Landing]
+```
+
+## 2. Wireframe ต่อ screen
+
+> ASCII box หนึ่งกล่องต่อหนึ่ง screen — low-fidelity (กล่อง + label generic)
+> ★ **ทำซ้ำ block "### Screen: ..." ด้านล่างได้หลายอัน** — หนึ่ง block ต่อหนึ่งหน้าจอใน user flow §1
+
+### Screen: <ชื่อจอ A — เช่น Landing>
+
+```
+┌─────────────────────────────────────────┐
+│  [LOGO]                      [User menu] │  <- header / nav
+├─────────────────────────────────────────┤
+│                                          │
+│   <หัวข้อจอ / คำอธิบายสั้น>               │
+│                                          │
+│   ┌─────────────────────────────────┐    │
+│   │  [Primary content / list item]  │    │
+│   │  [Primary content / list item]  │    │
+│   └─────────────────────────────────┘    │
+│                                          │
+│                     [ ปุ่มหลัก / CTA ]    │  <- action
+│                                          │
+└─────────────────────────────────────────┘
+```
+
+### Screen: <ชื่อจอ B — เช่น Form>
+
+<!-- ทำซ้ำ block นี้ต่อหนึ่งหน้าจอ; ลบ block ตัวอย่างที่ไม่ใช้ออก -->
+
+```
+┌─────────────────────────────────────────┐
+│  ◀ กลับ            <หัวข้อจอ>            │
+├─────────────────────────────────────────┤
+│                                          │
+│   <Field 1 label>                        │
+│   [____________________________]         │  <- input
+│                                          │
+│   <Field 2 label>                        │
+│   [____________________________]         │
+│   ( ) ตัวเลือก A   ( ) ตัวเลือก B         │  <- radio/option
+│                                          │
+│              [ ยกเลิก ]   [ ยืนยัน ]       │
+│                                          │
+└─────────────────────────────────────────┘
+```
+
+## 3. Screen states
+
+> ต่อหนึ่ง screen ใน §2 ระบุหน้าตาแต่ละ state — empty / loading / error / success
+> state ไหนไม่มีจริงสำหรับจอนั้น ใส่ `N/A` พร้อมเหตุผลสั้น
+
+| Screen | empty | loading | error | success |
+|---|---|---|---|---|
+| `<ชื่อจอ A>` | `<ไม่มี item — แสดงอะไร>` | `<skeleton / spinner>` | `<โหลด list ไม่ได้ — แสดงอะไร>` | `<มี item — แสดงอะไร>` |
+| `<ชื่อจอ B>` | `N/A (form ไม่มี empty)` | `<ขณะ submit — disable ปุ่ม>` | `<validation/server error inline>` | `<submit สำเร็จ → ไปจอไหน>` |
+
+## 4. Design-honor note
+
+> สิ่งที่ `design.md` (§5 UI layer) + task ใน BUILD **ต้องทำตาม** wireframe นี้ — กัน implementation หลุดจากที่ user approve
+> เขียนเป็นข้อผูกมัด (constraint) ที่ตรวจได้ ไม่ใช่คำอธิบายลอย ๆ
+
+- [ ] design.md §5 (UI layer) **อ้าง wireframe นี้** + ทุก screen ใน §2 มี task รองรับ
+- [ ] ลำดับ screen ใน task ตรงกับ user flow §1 (entry → ... → result)
+- [ ] ทุก screen implement ครบ 4 state ตาม §3 (ไม่ข้าม error/empty)
+- [ ] `<constraint เฉพาะ change นี้ — เช่น "ปุ่ม CTA ต้องอยู่ขวาล่างเสมอ", "field บังคับมี inline validation">`
+- [ ] เปลี่ยน layout/flow จาก wireframe นี้ → ต้อง rerun approve gate (กลับ status เป็น `draft` แล้วให้ user ยืนยันใหม่)

package/src/.warnyin/workflow/README.md

@@ -1,106 +1,108 @@
-# 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
-
-> โครงนี้คือสิ่งที่อยู่ใน **โปรเจกต์ที่ติดตั้งแล้ว** (installer วาง `.warnyin/`+`.claude/` ให้)
-> ตัว repo `warnyin-agents` เองเก็บ source ที่จะ publish ไว้ใต้ `src/` (เช่น `src/bin/cli.mjs`, `src/.warnyin/`) — ดู `CONTRIBUTING.md`
-
-```
-.warnyin/              # ★ แก่นกลาง workflow (installer วางให้ — อัปเดตได้ด้วย --update)
-  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)
-    triage.md          #   capability: TRIAGE — ประเมินขนาด change → tier + route (read-only)
-    api-doc.md         #   capability: API-DOC — adaptive OpenAPI 3.1 contract (DESIGN/VERIFY/SHIP เรียกเอง)
-    feedback.md        #   capability: FEEDBACK — เปิด GitHub issue แจ้ง feedback (gh + fallback URL)
-    stages/            #   discovery ✅ · design ✅ · build ✅ · verify ✅ · ship ✅
-      # discovery: mode ปรับความเข้ม {ไว|สมดุล|ละเอียด|โต้วาที|ไต่สวน} + auto-suggest + debate
-      # → taxonomy + behavior + auto-suggest signal อยู่ใน section "Discovery modes (ความเข้มของ Discovery)" ของ discovery.md
-    roles/             #   role card กลาง (task-level lens): ba, po, sa, tech-lead, developer, qa, security, infra
-    contexts/          #   context profile กลาง (session-level posture): research, build, review + README
-    scripts/
-      build-wave.mjs   #   Workflow script: fan-out sub-agent ต่อ task ใน wave (worktree)
-  template/            # ★ template ทั้งหมดรวมที่เดียว
-    stages/[topic]/    #   หนึ่งหน่วยงาน — copy เป็น docs/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) — มี spec.md (living behavior spec)
-  installer/templates/ #   template CLAUDE.md ของ target (installer ใช้เอง — ไม่ถูก copy ไป target)
-
-.claude/               # adapter Claude Code (ชี้กลับ playbook กลาง)
-  commands/warnyin/    #   slash command /warnyin:*
-  agents/              #   reviewer subagent warnyin-{sa,tech-lead,qa,security,infra} + warnyin-ux (generator — วาด wireframe ที่ step 4.5; แยกจาก reviewer 5 ตัว ไม่ใช่ reviewer ที่ 6)
-CLAUDE.md  AGENTS.md   # adapter + pointer ของ Claude / Codex·Antigravity
-
-docs/                  # ความรู้ถาวรระดับโปรเจกต์ + งานจริง — ของจริงล้วน (seed จาก template/docs)
-  project.md           # ★ จุดเริ่มของ Discovery — อ่านก่อนเสมอ
-  rule.md  infra.md
-  troubleshooting.md   # ★ KB ปัญหา-วิธีแก้ (อ่านก่อนเมื่อ build เจอ error; SHIP ป้อนเข้า)
-  codemap/  features/  techstack/
-  stages/              #   พื้นที่ทำงานจริง ตาม topic (<slug>/) + achieved/<YYYY-MM-DD>-<slug>/ หลัง SHIP
-```
-```
-
----
-
-## การติดตั้งไปโปรเจกต์อื่น
-
-```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]/` เป็น `docs/stages/<ชื่อ-งาน-kebab-case>/`
-2. รัน stage ตามลำดับ (Discovery ข้ามได้ถ้าเข้าใจ scope ชัดแล้ว)
-   - Claude Code: `/warnyin:discovery <topic> [mode]`, `/warnyin:design <slug> <change>`
-     - mode (ความเข้ม Discovery): `ไว` | `สมดุล` | `ละเอียด` | `โต้วาที` | `ไต่สวน` — ไม่ระบุ → auto-suggest (ดู playbook `discovery.md` section "Discovery modes (ความเข้มของ Discovery)")
-   - Codex / Antigravity: บอกให้ทำตาม `.warnyin/workflow/stages/<stage>.md`
-3. ผ่าน "gate" ของแต่ละ stage แล้วจึงไป stage ถัดไป
-4. เมื่อ SHIP (`/warnyin:ship <slug>`) → promote ความรู้ของ topic ขึ้นเอกสารกลางใน `docs/`
-   แล้วย้าย topic ไป `docs/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
+
+> โครงนี้คือสิ่งที่อยู่ใน **โปรเจกต์ที่ติดตั้งแล้ว** (installer วาง `.warnyin/`+`.claude/` ให้)
+> ตัว repo `warnyin-agents` เองเก็บ source ที่จะ publish ไว้ใต้ `src/` (เช่น `src/bin/cli.mjs`, `src/.warnyin/`) — ดู `CONTRIBUTING.md`
+
+```
+.warnyin/              # ★ แก่นกลาง workflow (installer วางให้ — อัปเดตได้ด้วย --update)
+  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)
+    triage.md          #   capability: TRIAGE — ประเมินขนาด change → tier + route (read-only)
+    api-doc.md         #   capability: API-DOC — adaptive OpenAPI 3.1 contract (DESIGN/VERIFY/SHIP เรียกเอง)
+    minimalism.md      #   principle: MINIMALISM — decision hierarchy "เขียนน้อยที่สุด" + guardrail lazy-not-negligent (single source; surface ทั้งหมด pointer กลับมาที่นี่)
+    interop.md         #   capability: INTEROP — companion tool consult-if-present convention + inclusion bar 4 ข้อ + UA entry (stage pointer conditional; trust-boundary guard)
+    feedback.md        #   capability: FEEDBACK — เปิด GitHub issue แจ้ง feedback (gh + fallback URL)
+    stages/            #   discovery ✅ · design ✅ · build ✅ · verify ✅ · ship ✅
+      # discovery: mode ปรับความเข้ม {ไว|สมดุล|ละเอียด|โต้วาที|ไต่สวน} + auto-suggest + debate
+      # → taxonomy + behavior + auto-suggest signal อยู่ใน section "Discovery modes (ความเข้มของ Discovery)" ของ discovery.md
+    roles/             #   role card กลาง (task-level lens): ba, po, sa, tech-lead, developer, qa, security, infra
+    contexts/          #   context profile กลาง (session-level posture): research, build, review + README
+    scripts/
+      build-wave.mjs   #   Workflow script: fan-out sub-agent ต่อ task ใน wave (worktree)
+  template/            # ★ template ทั้งหมดรวมที่เดียว
+    stages/[topic]/    #   หนึ่งหน่วยงาน — copy เป็น docs/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) — มี spec.md (living behavior spec)
+  installer/templates/ #   template CLAUDE.md ของ target (installer ใช้เอง — ไม่ถูก copy ไป target)
+
+.claude/               # adapter Claude Code (ชี้กลับ playbook กลาง)
+  commands/warnyin/    #   slash command /warnyin:*
+  agents/              #   reviewer subagent warnyin-{sa,tech-lead,qa,security,infra} + warnyin-ux (generator — วาด wireframe ที่ step 4.5; แยกจาก reviewer 5 ตัว ไม่ใช่ reviewer ที่ 6)
+CLAUDE.md  AGENTS.md   # adapter + pointer ของ Claude / Codex·Antigravity
+
+docs/                  # ความรู้ถาวรระดับโปรเจกต์ + งานจริง — ของจริงล้วน (seed จาก template/docs)
+  project.md           # ★ จุดเริ่มของ Discovery — อ่านก่อนเสมอ
+  rule.md  infra.md
+  troubleshooting.md   # ★ KB ปัญหา-วิธีแก้ (อ่านก่อนเมื่อ build เจอ error; SHIP ป้อนเข้า)
+  codemap/  features/  techstack/
+  stages/              #   พื้นที่ทำงานจริง ตาม topic (<slug>/) + achieved/<YYYY-MM-DD>-<slug>/ หลัง SHIP
+```
+```
+
+---
+
+## การติดตั้งไปโปรเจกต์อื่น
+
+```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]/` เป็น `docs/stages/<ชื่อ-งาน-kebab-case>/`
+2. รัน stage ตามลำดับ (Discovery ข้ามได้ถ้าเข้าใจ scope ชัดแล้ว)
+   - Claude Code: `/warnyin:discovery <topic> [mode]`, `/warnyin:design <slug> <change>`
+     - mode (ความเข้ม Discovery): `ไว` | `สมดุล` | `ละเอียด` | `โต้วาที` | `ไต่สวน` — ไม่ระบุ → auto-suggest (ดู playbook `discovery.md` section "Discovery modes (ความเข้มของ Discovery)")
+   - Codex / Antigravity: บอกให้ทำตาม `.warnyin/workflow/stages/<stage>.md`
+3. ผ่าน "gate" ของแต่ละ stage แล้วจึงไป stage ถัดไป
+4. เมื่อ SHIP (`/warnyin:ship <slug>`) → promote ความรู้ของ topic ขึ้นเอกสารกลางใน `docs/`
+   แล้วย้าย topic ไป `docs/stages/achieved/<YYYY-MM-DD>-<topic>/`