@warnyin/agents 0.2.0 → 0.5.0

package/bin/cli.mjs

@@ -24,8 +24,8 @@ if (args.has('--help') || args.has('-h')) {
 ใช้งาน:
   npx @warnyin/agents             ติดตั้ง (ข้ามไฟล์ที่มีอยู่แล้ว ไม่เขียนทับ)
   npx @warnyin/agents --update    อัปเดต playbook กลางเป็นเวอร์ชันล่าสุด
-                                  (เขียนทับเฉพาะ workflow/, .claude/commands/warnyin/,
-                                   template warnyin-stages/[topic] — ไม่แตะ docs/ และงานจริง)
+                                  (เขียนทับเฉพาะ warnyin/workflow/, .claude/commands/warnyin/,
+                                   template warnyin/template/stages/[topic] — ไม่แตะ docs/ และงานจริง)
   npx @warnyin/agents --dry-run   แสดงรายการไฟล์ที่จะสร้าง/อัปเดต โดยไม่เขียนจริง
 
 หลังติดตั้ง: เปิด Claude Code ในโปรเจกต์ แล้วรัน /warnyin:init ให้ agent วิเคราะห์โปรเจกต์ + เติม docs/`)
@@ -37,15 +37,28 @@ if (path.resolve(pkgRoot) === path.resolve(target)) {
   process.exit(1)
 }
 
-// core = playbook กลาง + command + template หน่วยงาน — เขียนทับได้เมื่อ --update
+// โครงเก่า (≤0.2.x): workflow/ + warnyin-stages/ ที่ root — เตือนให้ย้ายเอง ไม่แตะงานจริงของ user
+const legacy = ['workflow', 'warnyin-stages'].filter((d) => fs.existsSync(path.join(target, d)))
+if (legacy.length) {
+  console.warn(`⚠ พบโครงเลย์เอาต์เก่า (≤0.2.x): ${legacy.join(', ')}
+เวอร์ชันนี้ย้ายทุกอย่างไปใต้ warnyin/ — แนะนำย้ายด้วยตัวเองก่อน:
+  1. git mv warnyin-stages warnyin/stages          # งานจริงของคุณ (ปลอดภัย ไม่ถูกแตะโดย installer)
+  2. git rm -r workflow                            # playbook เก่า (เวอร์ชันใหม่จะอยู่ที่ warnyin/workflow)
+  3. ลบ template เก่าถ้ามี: "warnyin/stages/[topic]", "docs/techstack/[component]", "docs/features/[feature-name]"
+     (ย้ายไปรวมที่ warnyin/template/ แล้ว)
+แล้วรันคำสั่งนี้อีกครั้ง\n`)
+}
+
+// core = playbook กลาง + command + agent + template — เขียนทับได้เมื่อ --update
 const CORE = [
-  'workflow',
+  path.join('warnyin', 'workflow'),
+  path.join('warnyin', 'template'),
   path.join('.claude', 'commands', 'warnyin'),
   path.join('.claude', 'agents'),
-  path.join('warnyin-stages', '[topic]'),
 ]
-// scaffold = โครง docs/ + พื้นที่ทำงาน — เป็นข้อมูลของโปรเจกต์ ไม่เขียนทับเด็ดขาด
-const SCAFFOLD = ['docs', 'warnyin-stages']
+// scaffold = พื้นที่ทำงาน — เป็นข้อมูลของโปรเจกต์ ไม่เขียนทับเด็ดขาด
+// (เจาะจง warnyin/stages — warnyin/workflow + warnyin/template อยู่ใน CORE แล้ว ส่วน warnyin/installer เป็นของ installer ไม่ copy ไป target)
+const SCAFFOLD = [path.join('warnyin', 'stages')]
 
 const stats = { created: 0, updated: 0, skipped: 0 }
 
@@ -78,6 +91,33 @@ function copyTree(relDir, { overwrite }) {
   }
 }
 
+/** seed docs/ ของโปรเจกต์จาก warnyin/template/docs — ข้ามโฟลเดอร์ template `[...]` (ไว้ให้ /warnyin:init copy เป็นชื่อจริง) และไม่ทับไฟล์ที่มีอยู่ */
+const TEMPLATE_DOCS = path.join('warnyin', 'template', 'docs')
+function seedDocs(relDir = TEMPLATE_DOCS) {
+  const srcDir = path.join(pkgRoot, relDir)
+  if (!fs.existsSync(srcDir)) return
+  for (const entry of fs.readdirSync(srcDir, { withFileTypes: true })) {
+    if (entry.name.startsWith('[')) continue
+    const rel = path.join(relDir, entry.name)
+    if (entry.isDirectory()) {
+      seedDocs(rel)
+      continue
+    }
+    const destRel = path.join('docs', path.relative(TEMPLATE_DOCS, rel))
+    const dest = path.join(target, destRel)
+    if (fs.existsSync(dest)) {
+      stats.skipped++
+      continue
+    }
+    if (!DRY) {
+      fs.mkdirSync(path.dirname(dest), { recursive: true })
+      fs.copyFileSync(path.join(pkgRoot, rel), dest)
+    }
+    stats.created++
+    console.log(`  + ${destRel}`)
+  }
+}
+
 /** CLAUDE.md / AGENTS.md: ไม่มี → สร้างจาก template; มีอยู่แล้วแต่ยังไม่มี workflow → ต่อท้ายเป็น section */
 function installRootDoc(name, srcPath) {
   const dest = path.join(target, name)
@@ -89,7 +129,7 @@ function installRootDoc(name, srcPath) {
     return
   }
   const existing = fs.readFileSync(dest, 'utf8')
-  if (existing.includes('workflow/stages/')) {
+  if (existing.includes('warnyin/workflow/stages/')) {
     stats.skipped++
     return
   }
@@ -103,7 +143,8 @@ console.log(`Warnyin Standard Workflow → ${target}${DRY ? '  (dry-run)' : ''}\
 
 for (const dir of CORE) copyTree(dir, { overwrite: UPDATE })
 for (const dir of SCAFFOLD) copyTree(dir, { overwrite: false })
-installRootDoc('CLAUDE.md', path.join(pkgRoot, 'installer', 'templates', 'CLAUDE.md'))
+seedDocs()
+installRootDoc('CLAUDE.md', path.join(pkgRoot, 'warnyin', 'installer', 'templates', 'CLAUDE.md'))
 installRootDoc('AGENTS.md', path.join(pkgRoot, 'AGENTS.md'))
 
 console.log(`\nสรุป: สร้างใหม่ ${stats.created} · อัปเดต ${stats.updated} · ข้าม (มีอยู่แล้ว) ${stats.skipped}`)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warnyin/agents",
-  "version": "0.2.0",
+  "version": "0.5.0",
   "description": "Warnyin Standard Workflow installer — 5-stage ways of work (Discovery/DESIGN/BUILD/VERIFY/SHIP) สำหรับทุกโปรเจกต์",
   "type": "module",
   "license": "MIT",
@@ -12,10 +12,7 @@
   },
   "files": [
     "bin",
-    "installer",
-    "workflow",
-    "docs",
-    "warnyin-stages",
+    "warnyin",
     ".claude/commands",
     ".claude/agents",
     "CLAUDE.md",

package/warnyin/installer/templates/CLAUDE.md

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