@warnyin/agents 0.4.0 → 0.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. package/.claude/commands/warnyin/build.md +29 -29
  2. package/.claude/commands/warnyin/design.md +24 -24
  3. package/.claude/commands/warnyin/discovery.md +17 -17
  4. package/.claude/commands/warnyin/explore.md +14 -0
  5. package/.claude/commands/warnyin/init.md +1 -1
  6. package/.claude/commands/warnyin/next.md +16 -0
  7. package/.claude/commands/warnyin/verify.md +19 -19
  8. package/AGENTS.md +48 -38
  9. package/CLAUDE.md +40 -38
  10. package/package.json +1 -1
  11. package/warnyin/installer/templates/CLAUDE.md +2 -0
  12. package/warnyin/template/stages/[topic]/build.md +58 -58
  13. package/warnyin/template/stages/[topic]/business.md +21 -21
  14. package/warnyin/template/stages/[topic]/design.md +42 -42
  15. package/warnyin/template/stages/[topic]/discovery.md +69 -69
  16. package/warnyin/template/stages/[topic]/proposal.md +43 -43
  17. package/warnyin/template/stages/[topic]/research.md +49 -49
  18. package/warnyin/template/stages/[topic]/tasks/[task-name]/rule.md +13 -13
  19. package/warnyin/template/stages/[topic]/tasks/[task-name]/spec.md +36 -36
  20. package/warnyin/template/stages/[topic]/tasks/[task-name]/standard.md +21 -21
  21. package/warnyin/template/stages/[topic]/tasks/[task-name]/task.md +39 -39
  22. package/warnyin/template/stages/[topic]/test.md +46 -46
  23. package/warnyin/template/stages/[topic]/troubleshooting.md +34 -34
  24. package/warnyin/template/stages/[topic]/verify.md +44 -44
  25. package/warnyin/workflow/README.md +94 -92
  26. package/warnyin/workflow/explore.md +32 -0
  27. package/warnyin/workflow/init.md +45 -4
  28. package/warnyin/workflow/next.md +47 -0
  29. package/warnyin/workflow/scripts/build-wave.mjs +107 -107
  30. package/warnyin/workflow/stages/build.md +94 -94
  31. package/warnyin/workflow/stages/design.md +116 -116
  32. package/warnyin/workflow/stages/discovery.md +77 -77
  33. package/warnyin/workflow/stages/verify.md +71 -71
@@ -1,29 +1,29 @@
1
- ---
2
- description: รัน BUILD stage — fan-out sub-agent ต่อ task ตาม dependency (Workflow + worktree) แล้ว integrate
3
- argument-hint: "[slug ของ topic]"
4
- ---
5
-
6
- ทำหน้าที่เป็น BUILD orchestrator ตาม **playbook กลาง** ของ workflow มาตรฐาน
7
-
8
- 0. **★ เช็ค context window ก่อนเริ่ม:** ถ้า context ของ session ถูกใช้ไปเยอะหรือ**เกินครึ่ง** → เสนอ user ให้ `/compact` หรือ `/clear` ก่อนเสมอ แล้วค่อยรัน `/warnyin:build <slug>` ใหม่ใน context ที่โล่ง (สถานะงานอยู่ในไฟล์ `warnyin/stages/<slug>/` ครบ) — อย่าเริ่ม fan-out ทั้งที่ context ใกล้เต็ม
9
- 1. อ่าน `warnyin/workflow/stages/build.md` ให้ครบก่อน แล้วทำตามทุกหลักการอย่างเคร่งครัด
10
- 2. slug: $ARGUMENTS — ถ้าไม่ระบุให้ถามก่อน ว่าจะ build topic ไหน (ดูโฟลเดอร์ใน `warnyin/stages/`)
11
- 3. **อ่าน task ทั้งหมด** ใน `warnyin/stages/<slug>/tasks/*/task.md` + `design.md` → ดึง dependency → สร้าง DAG → จัด **wave** ด้วย topological order
12
- 4. **Pre-check:** target เป็น git repo ไหม (จำเป็นสำหรับ worktree isolation) — ถ้าไม่ใช่ → fallback sequential shared-tree (`isolate:false`) และแจ้ง user. สร้าง build branch ใหม่ก่อนเริ่ม
13
- 5. **ขออนุมัติครั้งเดียว** — ใช้ AskUserQuestion แสดง execution plan: แต่ละ wave มี task อะไร, อันไหน parallel, isolation mode, build branch → รอ go/no-go (อย่าเริ่มก่อนได้ไฟเขียว)
14
- 6. **เดินทีละ wave** (หลังอนุมัติ):
15
- - เรียก **Workflow** ด้วย `{ scriptPath: "warnyin/workflow/scripts/build-wave.mjs", args: { slug, tasks: [<task ใน wave นี้>], isolate } }`
16
- - เมื่อ workflow คืนผล: ถ้า `isolate` → **merge** branch ที่แต่ละ agent รายงาน (`result.branch`) เข้า build branch ทีละอัน, แก้ conflict ถ้ามี; ถ้า shared-tree → review + commit ให้
17
- - ถ้ามี task `failed` หรือ `skipped` → **หยุด** รายงาน user ก่อนไป wave ถัดไป
18
- - **รวม troubleshooting:** ดึงฟิลด์ `troubleshooting` จากผลของทุก agent ในรอบนี้ → เขียนรวมลง `warnyin/stages/<slug>/troubleshooting.md` (main loop เขียนเอง กันไฟล์ชนกันใน worktree)
19
- 7. **★ Full build & test gate (หลัง merge ทุก wave):** บน build branch ที่ integrate แล้ว รัน build ทั้งหมด + test suite ทั้งหมด (รวม unit test) ของทุก component ที่กระทบ
20
- - **เจอ error → อ่าน `docs/troubleshooting.md` ก่อน** เผื่อเคยแก้แล้ว
21
- - มี build error / test แดง → **แก้จนเขียวหมด (loop)**: วิเคราะห์ error, แก้ (จะ delegate fix ให้ sub-agent ทีละจุดก็ได้), rerun build/test ใหม่ ทำซ้ำจนผ่าน
22
- - ปัญหา **ยาก/เจอซ้ำ** ที่แก้สำเร็จในรอบนี้ → บันทึกลง `warnyin/stages/<slug>/troubleshooting.md`
23
- - ห้ามปิด BUILD ถ้ายังแดง; ถ้าวนหลายรอบยังไม่ผ่าน → หยุด รายงาน user พร้อม error log
24
- 8. **ปิดงาน:** เขียน `warnyin/stages/<slug>/build.md` (ผลต่อ task + ผล full build/test + integration notes), อัปเดตสถานะใน `task.md` แต่ละใบ → เสนอเข้า VERIFY ด้วย `/warnyin:verify`
25
-
26
- หมายเหตุ:
27
- - ห้ามแก้ rule/standard กลางใน `docs/` (rule ใหม่ที่เสนอถูก note ไว้ใน `tasks/<task>/rule.md` รอ SHIP)
28
- - ปัญหายาก/ซ้ำที่แก้ได้ → `warnyin/stages/<slug>/troubleshooting.md` (SHIP จะยกขึ้น `docs/troubleshooting.md`)
29
- - เกณฑ์ปิด BUILD ดู Gate ข้อ 7 ของ playbook
1
+ ---
2
+ description: รัน BUILD stage — fan-out sub-agent ต่อ task ตาม dependency (Workflow + worktree) แล้ว integrate
3
+ argument-hint: "[slug ของ topic]"
4
+ ---
5
+
6
+ ทำหน้าที่เป็น BUILD orchestrator ตาม **playbook กลาง** ของ workflow มาตรฐาน
7
+
8
+ 0. **★ เช็ค context window ก่อนเริ่ม:** ถ้า context ของ session ถูกใช้ไปเยอะหรือ**เกินครึ่ง** → เสนอ user ให้ `/compact` หรือ `/clear` ก่อนเสมอ แล้วค่อยรัน `/warnyin:build <slug>` ใหม่ใน context ที่โล่ง (สถานะงานอยู่ในไฟล์ `warnyin/stages/<slug>/` ครบ) — อย่าเริ่ม fan-out ทั้งที่ context ใกล้เต็ม
9
+ 1. อ่าน `warnyin/workflow/stages/build.md` ให้ครบก่อน แล้วทำตามทุกหลักการอย่างเคร่งครัด
10
+ 2. slug: $ARGUMENTS — ถ้าไม่ระบุให้ถามก่อน ว่าจะ build topic ไหน (ดูโฟลเดอร์ใน `warnyin/stages/`)
11
+ 3. **อ่าน task ทั้งหมด** ใน `warnyin/stages/<slug>/tasks/*/task.md` + `design.md` → ดึง dependency → สร้าง DAG → จัด **wave** ด้วย topological order
12
+ 4. **Pre-check:** target เป็น git repo ไหม (จำเป็นสำหรับ worktree isolation) — ถ้าไม่ใช่ → fallback sequential shared-tree (`isolate:false`) และแจ้ง user. สร้าง build branch ใหม่ก่อนเริ่ม
13
+ 5. **ขออนุมัติครั้งเดียว** — ใช้ AskUserQuestion แสดง execution plan: แต่ละ wave มี task อะไร, อันไหน parallel, isolation mode, build branch → รอ go/no-go (อย่าเริ่มก่อนได้ไฟเขียว)
14
+ 6. **เดินทีละ wave** (หลังอนุมัติ):
15
+ - เรียก **Workflow** ด้วย `{ scriptPath: "warnyin/workflow/scripts/build-wave.mjs", args: { slug, tasks: [<task ใน wave นี้>], isolate } }`
16
+ - เมื่อ workflow คืนผล: ถ้า `isolate` → **merge** branch ที่แต่ละ agent รายงาน (`result.branch`) เข้า build branch ทีละอัน, แก้ conflict ถ้ามี; ถ้า shared-tree → review + commit ให้
17
+ - ถ้ามี task `failed` หรือ `skipped` → **หยุด** รายงาน user ก่อนไป wave ถัดไป
18
+ - **รวม troubleshooting:** ดึงฟิลด์ `troubleshooting` จากผลของทุก agent ในรอบนี้ → เขียนรวมลง `warnyin/stages/<slug>/troubleshooting.md` (main loop เขียนเอง กันไฟล์ชนกันใน worktree)
19
+ 7. **★ Full build & test gate (หลัง merge ทุก wave):** บน build branch ที่ integrate แล้ว รัน build ทั้งหมด + test suite ทั้งหมด (รวม unit test) ของทุก component ที่กระทบ
20
+ - **เจอ error → อ่าน `docs/troubleshooting.md` ก่อน** เผื่อเคยแก้แล้ว
21
+ - มี build error / test แดง → **แก้จนเขียวหมด (loop)**: วิเคราะห์ error, แก้ (จะ delegate fix ให้ sub-agent ทีละจุดก็ได้), rerun build/test ใหม่ ทำซ้ำจนผ่าน
22
+ - ปัญหา **ยาก/เจอซ้ำ** ที่แก้สำเร็จในรอบนี้ → บันทึกลง `warnyin/stages/<slug>/troubleshooting.md`
23
+ - ห้ามปิด BUILD ถ้ายังแดง; ถ้าวนหลายรอบยังไม่ผ่าน → หยุด รายงาน user พร้อม error log
24
+ 8. **ปิดงาน:** เขียน `warnyin/stages/<slug>/build.md` (ผลต่อ task + ผล full build/test + integration notes), อัปเดตสถานะใน `task.md` แต่ละใบ → เสนอเข้า VERIFY ด้วย `/warnyin:verify`
25
+
26
+ หมายเหตุ:
27
+ - ห้ามแก้ rule/standard กลางใน `docs/` (rule ใหม่ที่เสนอถูก note ไว้ใน `tasks/<task>/rule.md` รอ SHIP)
28
+ - ปัญหายาก/ซ้ำที่แก้ได้ → `warnyin/stages/<slug>/troubleshooting.md` (SHIP จะยกขึ้น `docs/troubleshooting.md`)
29
+ - เกณฑ์ปิด BUILD ดู Gate ข้อ 7 ของ playbook
@@ -1,24 +1,24 @@
1
- ---
2
- description: รัน DESIGN stage — เสนอ change พร้อมผลิต proposal/design/tasks ครบในขั้นเดียว
3
- argument-hint: "[slug ของ topic] [อธิบาย change สั้นๆ]"
4
- ---
5
-
6
- ทำหน้าที่เป็น DESIGN architect ตาม **playbook กลาง** ของ workflow มาตรฐาน
7
-
8
- 1. อ่าน `warnyin/workflow/stages/design.md` ให้ครบก่อน แล้วทำตามทุกหลักการอย่างเคร่งครัด
9
- - **ห้ามเดาเอง** — ไม่ชัดให้ถามทีละข้อ + เสนอคำตอบที่แนะนำทุกข้อ
10
- - ออกแบบแบบ **vertical slice architecture**
11
- - **Gate ก่อนเขียนไฟล์ task** แล้วค่อยโยนให้ sub-agent
12
- 2. อ่าน Input ตามข้อ 2 ของ playbook — โดยเฉพาะ `docs/techstack/<component>/rule.md` และ `standard.md`
13
- 3. งาน: $ARGUMENTS
14
- - ระบุ slug → ใช้/สร้าง `warnyin/stages/<slug>/` (ถ้ามาจาก Discovery ใช้โฟลเดอร์เดิม)
15
- - ถ้าเป็นคำถาม/ยังไม่มั่นใจเรื่อง design → แนะนำ `/warnyin:discovery` ก่อน
16
- 4. ผลิต artifact โดยใช้ template ใน `warnyin/template/stages/[topic]/` เป็นโครง: `business.md` (ข้ามได้ถ้า change เล็ก), `proposal.md`, `design.md` (lens `warnyin/workflow/roles/sa.md`), แล้วแตก `tasks/<task-name>/` (lens `warnyin/workflow/roles/tech-lead.md`) แต่ละใบมี `spec.md` `standard.md` `rule.md` `task.md`
17
- - **Review panel (ถาม user ก่อน):** หลัง `design.md` เสร็จ ก่อนแตก task — ใช้ AskUserQuestion ถามว่าจะให้ panel รีวิวไหม ถ้า ok → fan-out subagent `warnyin-sa`, `warnyin-tech-lead`, `warnyin-qa`, `warnyin-security`, `warnyin-infra` (Agent tool, ขนาน, read-only) รีวิว proposal+design → รวมความเห็น สรุปให้ user → แก้ blocker ให้ครบ (ห้ามเดา) → บันทึก section "Design review" ท้าย `design.md`
18
- 5. ตอน generate ไฟล์ task หลายใบ สามารถใช้ sub-agent (Task/Agent tool) fan-out หนึ่ง agent ต่อหนึ่ง task ได้ — **แต่ต้องผ่าน Gate (ข้อ 8 ของ playbook) ก่อน**
19
- 6. **Dry-run (ถาม user ก่อนเสมอ):** หลังเขียนไฟล์ task ครบ ใช้ AskUserQuestion ถามว่าต้องการ dry-run ทั้งหมดเพื่อหาจุดบกพร่องก่อนเข้า BUILD ไหม — ถ้า ok ทำตามข้อ 4.9 ของ playbook:
20
- - fan-out agent (Agent tool) **หนึ่งตัวต่อหนึ่ง task แบบขนาน, read-only** — อ่าน task ทั้ง 4 ไฟล์ + design/proposal + โค้ดจริงที่เกี่ยว เดิน implement ในหัว หา **blocker** (implement ตาม spec ไม่ได้ — ต้องแก้ก่อน BUILD) และ **defer** (ทำ/ตัดสินใจทีหลังได้ แต่ต้อง track)
21
- - task ที่พบ issue → เขียน `warnyin/stages/<slug>/tasks/<task>/issue.md` (ตาม template); รันครบทุก task → **สรุปผลรวม** ให้ user
22
- - **หาวิธีแก้ DESIGN ตาม issue โดยห้ามเดา ห้ามคิดขึ้นเอง** — ติดจริงๆ → สัมภาษณ์ user ทีละข้อ + เสนอคำตอบแนะนำทุกครั้ง; คำถามที่โค้ดตอบได้ → ไปอ่านโค้ดเอง
23
- - แก้แล้ว rerun dry-run เฉพาะ task ที่กระทบ วนจน **ไม่มี blocker ค้าง**
24
- 7. เมื่อพร้อม implement → บอกให้รัน `/warnyin:build`
1
+ ---
2
+ description: รัน DESIGN stage — เสนอ change พร้อมผลิต proposal/design/tasks ครบในขั้นเดียว
3
+ argument-hint: "[slug ของ topic] [อธิบาย change สั้นๆ]"
4
+ ---
5
+
6
+ ทำหน้าที่เป็น DESIGN architect ตาม **playbook กลาง** ของ workflow มาตรฐาน
7
+
8
+ 1. อ่าน `warnyin/workflow/stages/design.md` ให้ครบก่อน แล้วทำตามทุกหลักการอย่างเคร่งครัด
9
+ - **ห้ามเดาเอง** — ไม่ชัดให้ถามทีละข้อ + เสนอคำตอบที่แนะนำทุกข้อ
10
+ - ออกแบบแบบ **vertical slice architecture**
11
+ - **Gate ก่อนเขียนไฟล์ task** แล้วค่อยโยนให้ sub-agent
12
+ 2. อ่าน Input ตามข้อ 2 ของ playbook — โดยเฉพาะ `docs/techstack/<component>/rule.md` และ `standard.md`
13
+ 3. งาน: $ARGUMENTS
14
+ - ระบุ slug → ใช้/สร้าง `warnyin/stages/<slug>/` (ถ้ามาจาก Discovery ใช้โฟลเดอร์เดิม)
15
+ - ถ้าเป็นคำถาม/ยังไม่มั่นใจเรื่อง design → แนะนำ `/warnyin:discovery` ก่อน
16
+ 4. ผลิต artifact โดยใช้ template ใน `warnyin/template/stages/[topic]/` เป็นโครง: `business.md` (ข้ามได้ถ้า change เล็ก), `proposal.md`, `design.md` (lens `warnyin/workflow/roles/sa.md`), แล้วแตก `tasks/<task-name>/` (lens `warnyin/workflow/roles/tech-lead.md`) แต่ละใบมี `spec.md` `standard.md` `rule.md` `task.md`
17
+ - **Review panel (ถาม user ก่อน):** หลัง `design.md` เสร็จ ก่อนแตก task — ใช้ AskUserQuestion ถามว่าจะให้ panel รีวิวไหม ถ้า ok → fan-out subagent `warnyin-sa`, `warnyin-tech-lead`, `warnyin-qa`, `warnyin-security`, `warnyin-infra` (Agent tool, ขนาน, read-only) รีวิว proposal+design → รวมความเห็น สรุปให้ user → แก้ blocker ให้ครบ (ห้ามเดา) → บันทึก section "Design review" ท้าย `design.md`
18
+ 5. ตอน generate ไฟล์ task หลายใบ สามารถใช้ sub-agent (Task/Agent tool) fan-out หนึ่ง agent ต่อหนึ่ง task ได้ — **แต่ต้องผ่าน Gate (ข้อ 8 ของ playbook) ก่อน**
19
+ 6. **Dry-run (ถาม user ก่อนเสมอ):** หลังเขียนไฟล์ task ครบ ใช้ AskUserQuestion ถามว่าต้องการ dry-run ทั้งหมดเพื่อหาจุดบกพร่องก่อนเข้า BUILD ไหม — ถ้า ok ทำตามข้อ 4.9 ของ playbook:
20
+ - fan-out agent (Agent tool) **หนึ่งตัวต่อหนึ่ง task แบบขนาน, read-only** — อ่าน task ทั้ง 4 ไฟล์ + design/proposal + โค้ดจริงที่เกี่ยว เดิน implement ในหัว หา **blocker** (implement ตาม spec ไม่ได้ — ต้องแก้ก่อน BUILD) และ **defer** (ทำ/ตัดสินใจทีหลังได้ แต่ต้อง track)
21
+ - task ที่พบ issue → เขียน `warnyin/stages/<slug>/tasks/<task>/issue.md` (ตาม template); รันครบทุก task → **สรุปผลรวม** ให้ user
22
+ - **หาวิธีแก้ DESIGN ตาม issue โดยห้ามเดา ห้ามคิดขึ้นเอง** — ติดจริงๆ → สัมภาษณ์ user ทีละข้อ + เสนอคำตอบแนะนำทุกครั้ง; คำถามที่โค้ดตอบได้ → ไปอ่านโค้ดเอง
23
+ - แก้แล้ว rerun dry-run เฉพาะ task ที่กระทบ วนจน **ไม่มี blocker ค้าง**
24
+ 7. เมื่อพร้อม implement → บอกให้รัน `/warnyin:build`
@@ -1,17 +1,17 @@
1
- ---
2
- description: รัน Discovery stage — research + สัมภาษณ์ผู้ใช้เพื่อตี scope จนเข้าใจตรงกัน
3
- argument-hint: "[ชื่อหัวข้องาน / slug]"
4
- ---
5
-
6
- ทำหน้าที่เป็น Discovery facilitator ตาม **playbook กลาง** ของ workflow มาตรฐาน
7
-
8
- 1. อ่าน `warnyin/workflow/stages/discovery.md` ให้ครบก่อน แล้วทำตามทุกหลักการในนั้นอย่างเคร่งครัด
9
- (กว้าง→แคบ, ถามทีละข้อ + เสนอคำตอบที่แนะนำ, โค้ดตอบได้ให้ไปอ่านเอง, เดินทีละกิ่ง decision tree)
10
- 2. อ่าน Input ตามข้อ 2 ของ playbook — เริ่มที่ `docs/project.md` เสมอ
11
- 3. หัวข้องาน: $ARGUMENTS
12
- - ถ้าระบุมา → ใช้เป็น slug ของ topic (kebab-case) สร้าง/ใช้โฟลเดอร์ `warnyin/stages/<slug>/`
13
- - ถ้าไม่ระบุ → ถาม user ก่อนว่าหัวข้องานคืออะไร
14
- 4. เขียน output ลง `warnyin/stages/<slug>/discovery.md` และ `research.md` โดยใช้ template ในโฟลเดอร์ `warnyin/template/stages/[topic]/` เป็นโครง
15
- 5. ปิดงานเมื่อผ่าน Gate (ข้อ 6 ของ playbook) แล้วเสนอว่าพร้อมเข้า DESIGN ด้วย `/warnyin:design`
16
-
17
- หมายเหตุ: ถ้า user พิมพ์ "ซักถามฉันหน่อย" / "grill me" → เข้าโหมด grill ตาม playbook
1
+ ---
2
+ description: รัน Discovery stage — research + สัมภาษณ์ผู้ใช้เพื่อตี scope จนเข้าใจตรงกัน
3
+ argument-hint: "[ชื่อหัวข้องาน / slug]"
4
+ ---
5
+
6
+ ทำหน้าที่เป็น Discovery facilitator ตาม **playbook กลาง** ของ workflow มาตรฐาน
7
+
8
+ 1. อ่าน `warnyin/workflow/stages/discovery.md` ให้ครบก่อน แล้วทำตามทุกหลักการในนั้นอย่างเคร่งครัด
9
+ (กว้าง→แคบ, ถามทีละข้อ + เสนอคำตอบที่แนะนำ, โค้ดตอบได้ให้ไปอ่านเอง, เดินทีละกิ่ง decision tree)
10
+ 2. อ่าน Input ตามข้อ 2 ของ playbook — เริ่มที่ `docs/project.md` เสมอ
11
+ 3. หัวข้องาน: $ARGUMENTS
12
+ - ถ้าระบุมา → ใช้เป็น slug ของ topic (kebab-case) สร้าง/ใช้โฟลเดอร์ `warnyin/stages/<slug>/`
13
+ - ถ้าไม่ระบุ → ถาม user ก่อนว่าหัวข้องานคืออะไร
14
+ 4. เขียน output ลง `warnyin/stages/<slug>/discovery.md` และ `research.md` โดยใช้ template ในโฟลเดอร์ `warnyin/template/stages/[topic]/` เป็นโครง
15
+ 5. ปิดงานเมื่อผ่าน Gate (ข้อ 6 ของ playbook) แล้วเสนอว่าพร้อมเข้า DESIGN ด้วย `/warnyin:design`
16
+
17
+ หมายเหตุ: ถ้า user พิมพ์ "ซักถามฉันหน่อย" / "grill me" → เข้าโหมด grill ตาม playbook
@@ -0,0 +1,14 @@
1
+ ---
2
+ description: สำรวจ/ตอบคำถามเกี่ยวกับโปรเจกต์แบบ read-only — ไม่สร้าง artifact ใดๆ จบที่คำตอบในแชท
3
+ argument-hint: "[คำถาม / สิ่งที่อยากสำรวจ]"
4
+ ---
5
+
6
+ ทำหน้าที่เป็น explorer ตาม **playbook กลาง** ของ workflow มาตรฐาน
7
+
8
+ 1. อ่าน `warnyin/workflow/explore.md` ให้ครบก่อน แล้วทำตามทุกหลักการในนั้นอย่างเคร่งครัด
9
+ (**read-only เด็ดขาด — ห้ามสร้าง/แก้/ลบไฟล์ใดๆ**, โค้ดตอบได้ให้ไปอ่านโค้ด, อ้าง `path:line`)
10
+ 2. Ground ตัวเองด้วย Input ตามข้อ 2 ของ playbook — อ่านเฉพาะส่วนที่เกี่ยวกับคำถาม
11
+ 3. คำถาม/หัวข้อ: $ARGUMENTS
12
+ - ถ้าไม่ระบุ → ถาม user ว่าอยากสำรวจ/รู้เรื่องอะไร
13
+ 4. คำถามกว้างที่ต้องกวาดหลายพื้นที่ → fan-out sub-agent แบบ read-only (Explore) ขนาน แล้วสังเคราะห์เป็นคำตอบเดียว
14
+ 5. ตอบในแชทเท่านั้น — ถ้าพบว่าควรเปิดเป็นงานจริง ให้เสนอ `/warnyin:discovery` หรือ `/warnyin:design` ให้ user ตัดสินใจ
@@ -7,6 +7,6 @@ description: รัน INIT — วิเคราะห์โปรเจกต
7
7
  1. อ่าน `warnyin/workflow/init.md` ให้ครบก่อน แล้วทำตามทุกหลักการอย่างเคร่งครัด
8
8
  2. **สแกนภาพรวม repo:** โครงสร้าง, manifest, ภาษา/framework → ระบุว่าแบ่งเป็น component อะไรบ้าง
9
9
  3. **วิเคราะห์ลึกต่อ component แบบขนาน:** fan-out sub-agent (Agent tool, read-only) หนึ่งตัวต่อหนึ่ง component — โครงสร้าง, pattern/convention ที่ใช้จริง, วิธี build/test; วิเคราะห์ infra จาก config จริง (docker/compose, env, scripts)
10
- 4. **ข้อมูลธุรกิจที่โค้ดตอบไม่ได้** (เป้าหมาย, ลูกค้า, ขอบเขต) → สัมภาษณ์ user **ทีละข้อ + เสนอคำตอบแนะนำทุกครั้ง** (ใช้ README/โค้ดเป็น recommended); กฎใน `rule.md` → ถาม user ห้ามเดา
10
+ 4. **ข้อมูลธุรกิจที่โค้ดตอบไม่ได้** (เป้าหมาย, ลูกค้า, ขอบเขต) → สัมภาษณ์ user โดย**สวม BA + PO lens** (`warnyin/workflow/roles/ba.md` + `po.md`) ใช้ checklist ของทั้งสองเป็นชุดคำถาม — **ถามทีละข้อ + เสนอคำตอบแนะนำทุกครั้ง** (ใช้ README/โค้ดเป็น recommended, ถามเฉพาะที่ยังขาดหาย); เป็น lens ของ AI หลัก **ห้าม fan-out sub-agent มาสัมภาษณ์**; กฎใน `rule.md` → ถาม user ห้ามเดา
11
11
  5. **เสนอ summary** (สิ่งที่วิเคราะห์ได้ + รายการไฟล์ docs/ ที่จะเขียน) → ขอ user ยืนยัน**ครั้งเดียว** → เขียน/เติมไฟล์ตามตาราง Output ข้อ 4 ของ playbook — **ไฟล์ที่มีเนื้อหาอยู่แล้วให้เติม ไม่เขียนทับทิ้ง**
12
12
  6. **รายงานปิดท้าย:** ส่วนที่ยังว่าง/ไม่แน่ใจ (ระบุ "ยังว่าง รอเติม" ในไฟล์ ห้ามแต่งขึ้นเอง) → เสนอเริ่มงานแรกด้วย `/warnyin:discovery` หรือ `/warnyin:design`
@@ -0,0 +1,16 @@
1
+ ---
2
+ description: เช็คงานค้างทุก topic + แนะนำขั้นตอน/command ถัดไป แบบ read-only — ไม่สร้าง/แก้ไฟล์ใดๆ
3
+ argument-hint: "[slug (optional — ไม่ระบุ = สแกนทุก topic)]"
4
+ ---
5
+
6
+ ทำหน้าที่เป็น status reporter ตาม **playbook กลาง** ของ workflow มาตรฐาน
7
+
8
+ 1. อ่าน `warnyin/workflow/next.md` ให้ครบก่อน แล้วทำตามทุกหลักการในนั้นอย่างเคร่งครัด
9
+ (**read-only เด็ดขาด — ห้ามสร้าง/แก้/ลบไฟล์ใดๆ**, สรุปจาก evidence ในไฟล์จริง, แนะนำแล้วหยุด)
10
+ 2. ขอบเขต: $ARGUMENTS
11
+ - ระบุ slug → เช็คเฉพาะ `warnyin/stages/<slug>/`
12
+ - ไม่ระบุ → สแกนทุก topic ใน `warnyin/stages/` (ยกเว้น `achieved/`)
13
+ 3. ต่อ topic: ระบุ stage ปัจจุบันจาก artifact ที่ถูกเติมจริง (ไฟล์ที่ยังเป็นโครง template = ยังไม่ทำ)
14
+ + ไล่ gate ของ playbook stage นั้น + สถานะ task ใน `tasks/*/task.md`
15
+ 4. รายงานในแชท: ตารางภาพรวม (topic · stage · งานค้าง · command ถัดไป) + รายละเอียดงานค้าง + ลำดับงานที่แนะนำ
16
+ 5. ไม่รัน stage ต่อให้เอง — เสนอ command ให้ user ตัดสินใจ
@@ -1,19 +1,19 @@
1
- ---
2
- description: รัน VERIFY stage — strategy tester: เทสตามจุดประสงค์ใน local env (FE: e2e smoke + UXUI) แก้จนผ่าน
3
- argument-hint: "[slug ของ topic]"
4
- ---
5
-
6
- ทำหน้าที่เป็น strategy tester ตาม **playbook กลาง** ของ workflow มาตรฐาน
7
-
8
- 0. **★ เช็ค context window ก่อนเริ่ม:** ถ้า context ของ session ถูกใช้ไปเยอะหรือ**เกินครึ่ง** → เสนอ user ให้ `/compact` หรือ `/clear` ก่อนเสมอ แล้วค่อยรัน `/warnyin:verify <slug>` ใหม่ใน context ที่โล่ง (สถานะงานอยู่ในไฟล์ `warnyin/stages/<slug>/` ครบ) — อย่าเริ่มลูปเทส-แก้ทั้งที่ context ใกล้เต็ม
9
- 1. อ่าน `warnyin/workflow/stages/verify.md` ให้ครบก่อน แล้วทำตามทุกหลักการอย่างเคร่งครัด
10
- 2. slug: $ARGUMENTS — ถ้าไม่ระบุให้ถามก่อน ว่าจะ verify topic ไหน
11
- 3. **เข้าใจจุดประสงค์ก่อนเทส:** อ่าน `tasks/*/spec.md` + `task.md`, `design.md`, `proposal.md` ทั้งหมดให้เข้าใจดี แล้วค่อยเทสตามเจตนาของ topic
12
- 4. **guideline:** อ่าน `docs/techstack/<component>/test.md` ว่าเทสยังไง (เช่น FE: e2e smoke ผ่าน playwright-cli) — ไม่มีก็เสนอวิธีแล้วเขียนแผนเอง; ดู `docs/infra.md` สำหรับ local env
13
- 5. **เขียนแผนลง** `warnyin/stages/<slug>/test.md`
14
- 6. **เทสจริงใน local env:** รัน service ที่เกี่ยวข้อง (ใช้ skill `run`/`verify` ช่วย launch ได้) → รันเทสตามแผน; FE → e2e smoke + ตรวจ UX/UI
15
- 7. **ข้อไหนไม่ผ่าน → แก้ → rerun** วนจนผ่าน **นับจำนวนการแก้ไข**; เจอปัญหา → อ่าน `docs/troubleshooting.md` ก่อน, ปัญหายาก/ซ้ำที่แก้ได้ → บันทึก `warnyin/stages/<slug>/troubleshooting.md`
16
- 8. **ถ้านาน/วนหลายรอบเกินไป → ถาม user ทีละข้อ + เสนอคำตอบที่แนะนำ** (อย่าวนเงียบไม่จบ)
17
- 9. **เขียนสรุป** `warnyin/stages/<slug>/verify.md` (ผลเทส + รายการแก้ไข + จำนวนรอบ + ผล UXUI) → เสนอเข้า SHIP ด้วย `/warnyin:ship`
18
-
19
- หมายเหตุ: ห้ามแตะไฟล์กลางใน `docs/` — `test.md` เขียนระดับ topic ก่อน รอ SHIP merge. เกณฑ์ปิดดู Gate ข้อ 6 ของ playbook
1
+ ---
2
+ description: รัน VERIFY stage — strategy tester: เทสตามจุดประสงค์ใน local env (FE: e2e smoke + UXUI) แก้จนผ่าน
3
+ argument-hint: "[slug ของ topic]"
4
+ ---
5
+
6
+ ทำหน้าที่เป็น strategy tester ตาม **playbook กลาง** ของ workflow มาตรฐาน
7
+
8
+ 0. **★ เช็ค context window ก่อนเริ่ม:** ถ้า context ของ session ถูกใช้ไปเยอะหรือ**เกินครึ่ง** → เสนอ user ให้ `/compact` หรือ `/clear` ก่อนเสมอ แล้วค่อยรัน `/warnyin:verify <slug>` ใหม่ใน context ที่โล่ง (สถานะงานอยู่ในไฟล์ `warnyin/stages/<slug>/` ครบ) — อย่าเริ่มลูปเทส-แก้ทั้งที่ context ใกล้เต็ม
9
+ 1. อ่าน `warnyin/workflow/stages/verify.md` ให้ครบก่อน แล้วทำตามทุกหลักการอย่างเคร่งครัด
10
+ 2. slug: $ARGUMENTS — ถ้าไม่ระบุให้ถามก่อน ว่าจะ verify topic ไหน
11
+ 3. **เข้าใจจุดประสงค์ก่อนเทส:** อ่าน `tasks/*/spec.md` + `task.md`, `design.md`, `proposal.md` ทั้งหมดให้เข้าใจดี แล้วค่อยเทสตามเจตนาของ topic
12
+ 4. **guideline:** อ่าน `docs/techstack/<component>/test.md` ว่าเทสยังไง (เช่น FE: e2e smoke ผ่าน playwright-cli) — ไม่มีก็เสนอวิธีแล้วเขียนแผนเอง; ดู `docs/infra.md` สำหรับ local env
13
+ 5. **เขียนแผนลง** `warnyin/stages/<slug>/test.md`
14
+ 6. **เทสจริงใน local env:** รัน service ที่เกี่ยวข้อง (ใช้ skill `run`/`verify` ช่วย launch ได้) → รันเทสตามแผน; FE → e2e smoke + ตรวจ UX/UI
15
+ 7. **ข้อไหนไม่ผ่าน → แก้ → rerun** วนจนผ่าน **นับจำนวนการแก้ไข**; เจอปัญหา → อ่าน `docs/troubleshooting.md` ก่อน, ปัญหายาก/ซ้ำที่แก้ได้ → บันทึก `warnyin/stages/<slug>/troubleshooting.md`
16
+ 8. **ถ้านาน/วนหลายรอบเกินไป → ถาม user ทีละข้อ + เสนอคำตอบที่แนะนำ** (อย่าวนเงียบไม่จบ)
17
+ 9. **เขียนสรุป** `warnyin/stages/<slug>/verify.md` (ผลเทส + รายการแก้ไข + จำนวนรอบ + ผล UXUI) → เสนอเข้า SHIP ด้วย `/warnyin:ship`
18
+
19
+ หมายเหตุ: ห้ามแตะไฟล์กลางใน `docs/` — `test.md` เขียนระดับ topic ก่อน รอ SHIP merge. เกณฑ์ปิดดู Gate ข้อ 6 ของ playbook
package/AGENTS.md CHANGED
@@ -1,38 +1,48 @@
1
- # AGENTS.md
2
-
3
- มาตรฐานเปิดสำหรับ AI agent ทุกเจ้าที่อ่านไฟล์นี้ (Codex, Antigravity, และเครื่องมืออื่นที่รองรับ `AGENTS.md`)
4
-
5
- ## repo นี้คืออะไร
6
-
7
- repo มาตรฐานกลางของ **ways of work** สำหรับทุกโปรเจกต์ — เดินงานผ่าน 5 stage:
8
-
9
- ```
10
- Discovery (optional) ──▶ DESIGN ──▶ BUILD ──▶ VERIFY ──▶ SHIP
11
- ```
12
-
13
- ## กฎสำคัญ: ทำตาม playbook กลางเสมอ
14
-
15
- แก่นของแต่ละ stage คือ **single source of truth** อยู่ที่ `warnyin/workflow/stages/`
16
- ก่อนทำงานใน stage ใด ให้เปิดอ่านไฟล์ playbook ของ stage นั้นแล้วทำตามอย่างเคร่งครัด
17
-
18
- | Stage | playbook | สถานะ |
19
- |---|---|---|
20
- | Discovery | `warnyin/workflow/stages/discovery.md` | ✅ พร้อมใช้ |
21
- | DESIGN | `warnyin/workflow/stages/design.md` | ✅ พร้อมใช้ |
22
- | BUILD | `warnyin/workflow/stages/build.md` | ✅ พร้อมใช้ |
23
- | VERIFY | `warnyin/workflow/stages/verify.md` | ✅ พร้อมใช้ |
24
- | SHIP | `warnyin/workflow/stages/ship.md` | ✅ พร้อมใช้ |
25
-
26
- ## วิธีเริ่ม
27
-
28
- 0. ครั้งแรกในโปรเจกต์ (docs/ ยังว่าง) → ทำตาม `warnyin/workflow/init.md` เพื่อวิเคราะห์โปรเจกต์ + เติม `docs/` ก่อน
29
- 1. อ่าน `warnyin/workflow/README.md` เพื่อเข้าใจภาพรวมและโครงสร้าง
30
- 2. งานใหม่ → copy `warnyin/template/stages/[topic]/` เป็น `warnyin/stages/<slug>/`
31
- 3. รัน stage ตามลำดับ โดยทำตาม playbook ของแต่ละ stage
32
- 4. output ของงานเก็บใน `warnyin/stages/<slug>/`, ความรู้ถาวรระดับโปรเจกต์อยู่ใน `docs/`
33
-
34
- ## รัน Discovery
35
-
36
- ทำตาม `warnyin/workflow/stages/discovery.md` — เริ่มอ่าน `docs/project.md`, ตี scope กว้าง→แคบ,
37
- ถามทีละข้อพร้อมเสนอคำตอบที่แนะนำ, คำถามที่ตอบได้ด้วยโค้ดให้ไปอ่านโค้ดเอง,
38
- เขียน output ลง `warnyin/stages/<slug>/discovery.md` และ `research.md`
1
+ # AGENTS.md
2
+
3
+ มาตรฐานเปิดสำหรับ AI agent ทุกเจ้าที่อ่านไฟล์นี้ (Codex, Antigravity, และเครื่องมืออื่นที่รองรับ `AGENTS.md`)
4
+
5
+ ## repo นี้คืออะไร
6
+
7
+ repo มาตรฐานกลางของ **ways of work** สำหรับทุกโปรเจกต์ — เดินงานผ่าน 5 stage:
8
+
9
+ ```
10
+ Discovery (optional) ──▶ DESIGN ──▶ BUILD ──▶ VERIFY ──▶ SHIP
11
+ ```
12
+
13
+ ## กฎสำคัญ: ทำตาม playbook กลางเสมอ
14
+
15
+ แก่นของแต่ละ stage คือ **single source of truth** อยู่ที่ `warnyin/workflow/stages/`
16
+ ก่อนทำงานใน stage ใด ให้เปิดอ่านไฟล์ playbook ของ stage นั้นแล้วทำตามอย่างเคร่งครัด
17
+
18
+ | Stage | playbook | สถานะ |
19
+ |---|---|---|
20
+ | Discovery | `warnyin/workflow/stages/discovery.md` | ✅ พร้อมใช้ |
21
+ | DESIGN | `warnyin/workflow/stages/design.md` | ✅ พร้อมใช้ |
22
+ | BUILD | `warnyin/workflow/stages/build.md` | ✅ พร้อมใช้ |
23
+ | VERIFY | `warnyin/workflow/stages/verify.md` | ✅ พร้อมใช้ |
24
+ | SHIP | `warnyin/workflow/stages/ship.md` | ✅ พร้อมใช้ |
25
+
26
+ ## วิธีเริ่ม
27
+
28
+ 0. ครั้งแรกในโปรเจกต์ (docs/ ยังว่าง) → ทำตาม `warnyin/workflow/init.md` เพื่อวิเคราะห์โปรเจกต์ + เติม `docs/` ก่อน
29
+ 1. อ่าน `warnyin/workflow/README.md` เพื่อเข้าใจภาพรวมและโครงสร้าง
30
+ 2. งานใหม่ → copy `warnyin/template/stages/[topic]/` เป็น `warnyin/stages/<slug>/`
31
+ 3. รัน stage ตามลำดับ โดยทำตาม playbook ของแต่ละ stage
32
+ 4. output ของงานเก็บใน `warnyin/stages/<slug>/`, ความรู้ถาวรระดับโปรเจกต์อยู่ใน `docs/`
33
+
34
+ ## สำรวจโดยไม่สร้าง artifact (EXPLORE)
35
+
36
+ อยากถาม/สำรวจข้อมูลเฉยๆ โดยไม่เปิด topic → ทำตาม `warnyin/workflow/explore.md`
37
+ (read-only เด็ดขาด — ไม่สร้าง/แก้ไฟล์ใดๆ จบที่คำตอบในแชท)
38
+
39
+ ## เช็คงานค้าง / หาขั้นตอนถัดไป (NEXT)
40
+
41
+ อยากรู้ว่ามีงานอะไรค้างและควรไปต่อยังไง → ทำตาม `warnyin/workflow/next.md`
42
+ (สแกน `warnyin/stages/*` ระบุ stage ปัจจุบันจาก artifact จริง + gate ที่ขาด — read-only ไม่แก้ไฟล์)
43
+
44
+ ## รัน Discovery
45
+
46
+ ทำตาม `warnyin/workflow/stages/discovery.md` — เริ่มอ่าน `docs/project.md`, ตี scope กว้าง→แคบ,
47
+ ถามทีละข้อพร้อมเสนอคำตอบที่แนะนำ, คำถามที่ตอบได้ด้วยโค้ดให้ไปอ่านโค้ดเอง,
48
+ เขียน output ลง `warnyin/stages/<slug>/discovery.md` และ `research.md`
package/CLAUDE.md CHANGED
@@ -1,38 +1,40 @@
1
- # CLAUDE.md
2
-
3
- repo มาตรฐานกลางของ **ways of work** สำหรับทุกโปรเจกต์ เดินงานผ่าน 5 stage:
4
- `Discovery (optional) ▶ DESIGN ▶ BUILD ▶ VERIFY ▶ SHIP`
5
-
6
- ## กฎหลัก
7
- - แก่นของแต่ละ stage เป็น single source of truth ที่ `warnyin/workflow/stages/` — **ทำตาม playbook นั้นเสมอ** ก่อนเริ่มงานใน stage
8
- - อย่า duplicate logic ของ workflow ลงที่อื่น ถ้าต้องแก้พฤติกรรมให้แก้ที่ `warnyin/workflow/stages/`
9
- - output ของงานจริงเก็บใน `warnyin/stages/<slug>/` (copy จาก template `warnyin/template/stages/[topic]/`)
10
- - ความรู้ถาวรระดับโปรเจกต์อยู่ใน `docs/` — เริ่มอ่าน `docs/project.md` เสมอใน Discovery
11
- - role card กลางอยู่ที่ `warnyin/workflow/roles/` (BA/PO/SA/Tech Lead/Developer/QA/Security/Infra) — stage ไหนใช้ role ไหนดูใน playbook; reviewer subagent ของ Claude Code อยู่ที่ `.claude/agents/warnyin-*`
12
-
13
- ## Slash commands (namespace `warnyin:`)
14
- - `/warnyin:init` → วิเคราะห์โปรเจกต์ + เติม `docs/` ครั้งแรกหลังติดตั้ง (`.claude/commands/warnyin/init.md` → `warnyin/workflow/init.md`)
15
- - `/warnyin:install-skill [role]` → ติดตั้ง skill เสริมประจำ role (รายการอยู่ที่ตารางใน `warnyin/workflow/roles/README.md`)
16
- - `/warnyin:update-codemaps` → สแกนโครงสร้าง + สร้าง/อัปเดต codemap แบบ token-lean ใน `docs/codemap/` (`warnyin/workflow/codemap.md`)
17
- - `/warnyin:discovery [topic]` → Discovery stage (`.claude/commands/warnyin/discovery.md` `warnyin/workflow/stages/discovery.md`)
18
- - `/warnyin:design [slug] [change]` → DESIGN stage (`.claude/commands/warnyin/design.md` `warnyin/workflow/stages/design.md`)
19
- - `/warnyin:build [slug]` → BUILD stage — fan-out sub-agent ตาม dependency (`warnyin/workflow/stages/build.md` + `warnyin/workflow/scripts/build-wave.mjs`)
20
- - `/warnyin:verify [slug]` → VERIFY stage strategy tester เทส local env + UXUI แก้จนผ่าน (`warnyin/workflow/stages/verify.md`)
21
- - `/warnyin:ship [slug]` → SHIP stage — ส่งมอบ: promote ความรู้ขึ้น `docs/` + archive topic (`warnyin/workflow/stages/ship.md`)
22
-
23
- ## การติดตั้งไปโปรเจกต์อื่น (npx installer)
24
- - `npx @warnyin/agents` (หรือสำรอง `npx github:warnyin/warnyin-agents`) → copy โครงทั้งหมดลงโปรเจกต์ปลายทาง (ข้ามไฟล์ที่มีอยู่, CLAUDE.md/AGENTS.md ที่มีอยู่จะต่อท้ายเป็น section)
25
- - `--update` → เขียนทับเฉพาะ core (`warnyin/workflow/`, `.claude/commands/warnyin/`, template ใน `warnyin/template/`) ไม่แตะ `docs/`/งานจริง
26
- - ตัว installer: `bin/cli.mjs` + template CLAUDE.md ของโปรเจกต์ปลายทางที่ `warnyin/installer/templates/CLAUDE.md` (แก้ commands list ที่ไหน ให้แก้ template นี้ด้วย; โฟลเดอร์นี้ไม่ถูก copy ไป target)
27
- - หลังติดตั้งรัน `/warnyin:init` เพื่อเติม `docs/`
28
-
29
- ## รองรับหลาย AI
30
- repo นี้ tool-agnostic: Claude Code อ่าน `.claude/` + ไฟล์นี้, ส่วน Codex/Antigravity อ่าน `AGENTS.md`
31
- ทุกเครื่องชี้กลับมาที่ playbook กลางชุดเดียวกันใน `warnyin/workflow/stages/` — ดูภาพรวมที่ `warnyin/workflow/README.md`
32
-
33
- ## สถานะการสร้าง workflow (อัปเดต 2026-06-04)
34
- ครบทั้ง 5 stage: Discovery ✅ · DESIGN ✅ · BUILD ✅ · VERIFY ✅ · SHIP ✅
35
- (playbook + command + template + build-wave.mjs ครบทุก stage)
36
-
37
- แพทเทิร์นการเติม/แก้ stage: playbook `warnyin/workflow/stages/<stage>.md` + command `.claude/commands/warnyin/<stage>.md` + อัปเดตตาราง stage ใน `AGENTS.md`/`CLAUDE.md`/`warnyin/workflow/README.md` + output template ใน `warnyin/template/stages/[topic]/`
38
- **สำคัญ: การเปลี่ยนพฤติกรรม stage ใดๆ ให้ user เป็นคนอธิบาย/ยืนยันก่อน อย่าเดาเอง**
1
+ # CLAUDE.md
2
+
3
+ repo มาตรฐานกลางของ **ways of work** สำหรับทุกโปรเจกต์ เดินงานผ่าน 5 stage:
4
+ `Discovery (optional) ▶ DESIGN ▶ BUILD ▶ VERIFY ▶ SHIP`
5
+
6
+ ## กฎหลัก
7
+ - แก่นของแต่ละ stage เป็น single source of truth ที่ `warnyin/workflow/stages/` — **ทำตาม playbook นั้นเสมอ** ก่อนเริ่มงานใน stage
8
+ - อย่า duplicate logic ของ workflow ลงที่อื่น ถ้าต้องแก้พฤติกรรมให้แก้ที่ `warnyin/workflow/stages/`
9
+ - output ของงานจริงเก็บใน `warnyin/stages/<slug>/` (copy จาก template `warnyin/template/stages/[topic]/`)
10
+ - ความรู้ถาวรระดับโปรเจกต์อยู่ใน `docs/` — เริ่มอ่าน `docs/project.md` เสมอใน Discovery
11
+ - role card กลางอยู่ที่ `warnyin/workflow/roles/` (BA/PO/SA/Tech Lead/Developer/QA/Security/Infra) — stage ไหนใช้ role ไหนดูใน playbook; reviewer subagent ของ Claude Code อยู่ที่ `.claude/agents/warnyin-*`
12
+
13
+ ## Slash commands (namespace `warnyin:`)
14
+ - `/warnyin:init` → วิเคราะห์โปรเจกต์ + เติม `docs/` ครั้งแรกหลังติดตั้ง (`.claude/commands/warnyin/init.md` → `warnyin/workflow/init.md`)
15
+ - `/warnyin:install-skill [role]` → ติดตั้ง skill เสริมประจำ role (รายการอยู่ที่ตารางใน `warnyin/workflow/roles/README.md`)
16
+ - `/warnyin:update-codemaps` → สแกนโครงสร้าง + สร้าง/อัปเดต codemap แบบ token-lean ใน `docs/codemap/` (`warnyin/workflow/codemap.md`)
17
+ - `/warnyin:explore [คำถาม]` → สำรวจ/ตอบคำถามแบบ read-only ไม่สร้าง artifact ใดๆ จบที่คำตอบในแชท (`warnyin/workflow/explore.md`)
18
+ - `/warnyin:next [slug]` → เช็คงานค้างทุก topic + แนะนำ command ถัดไป แบบ read-only (`warnyin/workflow/next.md`)
19
+ - `/warnyin:discovery [topic]` → Discovery stage (`.claude/commands/warnyin/discovery.md` `warnyin/workflow/stages/discovery.md`)
20
+ - `/warnyin:design [slug] [change]` → DESIGN stage (`.claude/commands/warnyin/design.md` `warnyin/workflow/stages/design.md`)
21
+ - `/warnyin:build [slug]` → BUILD stage — fan-out sub-agent ตาม dependency (`warnyin/workflow/stages/build.md` + `warnyin/workflow/scripts/build-wave.mjs`)
22
+ - `/warnyin:verify [slug]` → VERIFY stage — strategy tester เทส local env + UXUI แก้จนผ่าน (`warnyin/workflow/stages/verify.md`)
23
+ - `/warnyin:ship [slug]` → SHIP stage — ส่งมอบ: promote ความรู้ขึ้น `docs/` + archive topic (`warnyin/workflow/stages/ship.md`)
24
+
25
+ ## การติดตั้งไปโปรเจกต์อื่น (npx installer)
26
+ - `npx @warnyin/agents` (หรือสำรอง `npx github:warnyin/warnyin-agents`) copy โครงทั้งหมดลงโปรเจกต์ปลายทาง (ข้ามไฟล์ที่มีอยู่, CLAUDE.md/AGENTS.md ที่มีอยู่จะต่อท้ายเป็น section)
27
+ - `--update`เขียนทับเฉพาะ core (`warnyin/workflow/`, `.claude/commands/warnyin/`, template ใน `warnyin/template/`) ไม่แตะ `docs/`/งานจริง
28
+ - ตัว installer: `bin/cli.mjs` + template CLAUDE.md ของโปรเจกต์ปลายทางที่ `warnyin/installer/templates/CLAUDE.md` (แก้ commands list ที่ไหน ให้แก้ template นี้ด้วย; โฟลเดอร์นี้ไม่ถูก copy ไป target)
29
+ - หลังติดตั้ง → รัน `/warnyin:init` เพื่อเติม `docs/`
30
+
31
+ ## รองรับหลาย AI
32
+ repo นี้ tool-agnostic: Claude Code อ่าน `.claude/` + ไฟล์นี้, ส่วน Codex/Antigravity อ่าน `AGENTS.md`
33
+ ทุกเครื่องชี้กลับมาที่ playbook กลางชุดเดียวกันใน `warnyin/workflow/stages/` ดูภาพรวมที่ `warnyin/workflow/README.md`
34
+
35
+ ## สถานะการสร้าง workflow (อัปเดต 2026-06-04)
36
+ ครบทั้ง 5 stage: Discovery ✅ · DESIGN ✅ · BUILD ✅ · VERIFY ✅ · SHIP ✅
37
+ (playbook + command + template + build-wave.mjs ครบทุก stage)
38
+
39
+ แพทเทิร์นการเติม/แก้ stage: playbook `warnyin/workflow/stages/<stage>.md` + command `.claude/commands/warnyin/<stage>.md` + อัปเดตตาราง stage ใน `AGENTS.md`/`CLAUDE.md`/`warnyin/workflow/README.md` + output template ใน `warnyin/template/stages/[topic]/`
40
+ **สำคัญ: การเปลี่ยนพฤติกรรม stage ใดๆ ให้ user เป็นคนอธิบาย/ยืนยันก่อน อย่าเดาเอง**
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@warnyin/agents",
3
- "version": "0.4.0",
3
+ "version": "0.5.1",
4
4
  "description": "Warnyin Standard Workflow installer — 5-stage ways of work (Discovery/DESIGN/BUILD/VERIFY/SHIP) สำหรับทุกโปรเจกต์",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -13,6 +13,8 @@
13
13
  - `/warnyin:init` → วิเคราะห์โปรเจกต์ + เติม `docs/` ครั้งแรกหลังติดตั้ง (`warnyin/workflow/init.md`)
14
14
  - `/warnyin:install-skill [role]` → ติดตั้ง skill เสริมประจำ role (รายการ: `warnyin/workflow/roles/README.md`)
15
15
  - `/warnyin:update-codemaps` → สแกนโครงสร้าง + สร้าง/อัปเดต codemap แบบ token-lean (`warnyin/workflow/codemap.md`)
16
+ - `/warnyin:explore [คำถาม]` → สำรวจ/ตอบคำถามแบบ read-only — ไม่สร้าง artifact (`warnyin/workflow/explore.md`)
17
+ - `/warnyin:next [slug]` → เช็คงานค้าง + แนะนำ command ถัดไป แบบ read-only (`warnyin/workflow/next.md`)
16
18
  - `/warnyin:discovery [topic]` → Discovery stage (`warnyin/workflow/stages/discovery.md`)
17
19
  - `/warnyin:design [slug] [change]` → DESIGN stage (`warnyin/workflow/stages/design.md`)
18
20
  - `/warnyin:build [slug]` → BUILD stage — fan-out sub-agent ตาม dependency (`warnyin/workflow/stages/build.md` + `warnyin/workflow/scripts/build-wave.mjs`)
@@ -1,58 +1,58 @@
1
- # Build Report — <ชื่อ change>
2
-
3
- > Output ของ BUILD stage · playbook: `warnyin/workflow/stages/build.md`
4
- > รายงานผลการ implement ต่อ task + การ integrate
5
-
6
- | | |
7
- |---|---|
8
- | **Slug** | `<kebab-case>` |
9
- | **Build branch** | `<branch>` |
10
- | **Isolation** | `worktree` / `shared-tree` |
11
- | **วันที่** | `YYYY-MM-DD` |
12
- | **ผลรวม** | ผ่าน __ / ล้ม __ / ทั้งหมด __ task |
13
-
14
- ## 1. Execution plan (waves ตาม dependency)
15
- ```
16
- wave 1 (parallel): task-a, task-b
17
- wave 2: task-c (ขึ้นกับ task-a)
18
- wave 3: task-d (ขึ้นกับ task-b, task-c)
19
- ```
20
-
21
- ## 2. ผลต่อ task
22
- | Wave | Task | สถานะ | Test/Lint | ไฟล์ที่แก้ | Branch | หมายเหตุ |
23
- |---|---|---|---|---|---|---|
24
- | 1 | task-a | ✅ passed | | | | |
25
- | 1 | task-b | ❌ failed | | | | เหตุผล... |
26
-
27
- ## 3. Integration notes
28
- - การ merge แต่ละ wave / conflict ที่เจอและวิธีแก้:
29
-
30
- ## 3.5 Full build & test gate (หลัง integrate ทุก wave)
31
- > รัน build ทั้งหมด + test suite ทั้งหมด (รวม unit test) บน build branch — ต้องเขียวหมดก่อนปิด BUILD
32
-
33
- | Component | Build | Unit test | Test อื่น | รอบที่แก้ |
34
- |---|---|---|---|---|
35
- | api-service | ✅ / ❌ | ผ่าน __/__ | | |
36
- | admin-console | | | | |
37
-
38
- - error ที่เจอตอนรวม + วิธีแก้:
39
-
40
- ## 4. ปัญหา/ค้าง (ถ้ามี)
41
- - task ที่ล้ม + สาเหตุ + แผนแก้:
42
-
43
- ## 5. Rule/standard ใหม่ที่ note ไว้ (รอ SHIP)
44
- > รวบรวมจาก `tasks/<task>/rule.md` และ `standard.md` — รอ SHIP อัปเดตไฟล์กลางใน `docs/`
45
- -
46
-
47
- ## 6. ปัญหายาก/ซ้ำที่เจอ
48
- > บันทึกละเอียดที่ `./troubleshooting.md` (SHIP ยกขึ้น `docs/troubleshooting.md`)
49
- - ดู `./troubleshooting.md`
50
-
51
- ## ✅ Gate → VERIFY (ดู `warnyin/workflow/stages/build.md` ข้อ 7)
52
- - [ ] ทุก task implement + merge เข้า build branch แล้ว
53
- - [ ] ทุก task `passed` (test/build เขียว) ไม่มี `failed` ค้าง
54
- - [ ] ไม่มี merge conflict ค้าง
55
- - [ ] Full build ของทุก component ผ่าน (ไม่มี build error)
56
- - [ ] test suite ทั้งหมด (รวม unit test) เขียวหมดบน build branch
57
- - [ ] build.md สรุปครบทุก task + ผล full build/test
58
- - [ ] ไม่แตะ rule/standard กลางใน docs/
1
+ # Build Report — <ชื่อ change>
2
+
3
+ > Output ของ BUILD stage · playbook: `warnyin/workflow/stages/build.md`
4
+ > รายงานผลการ implement ต่อ task + การ integrate
5
+
6
+ | | |
7
+ |---|---|
8
+ | **Slug** | `<kebab-case>` |
9
+ | **Build branch** | `<branch>` |
10
+ | **Isolation** | `worktree` / `shared-tree` |
11
+ | **วันที่** | `YYYY-MM-DD` |
12
+ | **ผลรวม** | ผ่าน __ / ล้ม __ / ทั้งหมด __ task |
13
+
14
+ ## 1. Execution plan (waves ตาม dependency)
15
+ ```
16
+ wave 1 (parallel): task-a, task-b
17
+ wave 2: task-c (ขึ้นกับ task-a)
18
+ wave 3: task-d (ขึ้นกับ task-b, task-c)
19
+ ```
20
+
21
+ ## 2. ผลต่อ task
22
+ | Wave | Task | สถานะ | Test/Lint | ไฟล์ที่แก้ | Branch | หมายเหตุ |
23
+ |---|---|---|---|---|---|---|
24
+ | 1 | task-a | ✅ passed | | | | |
25
+ | 1 | task-b | ❌ failed | | | | เหตุผล... |
26
+
27
+ ## 3. Integration notes
28
+ - การ merge แต่ละ wave / conflict ที่เจอและวิธีแก้:
29
+
30
+ ## 3.5 Full build & test gate (หลัง integrate ทุก wave)
31
+ > รัน build ทั้งหมด + test suite ทั้งหมด (รวม unit test) บน build branch — ต้องเขียวหมดก่อนปิด BUILD
32
+
33
+ | Component | Build | Unit test | Test อื่น | รอบที่แก้ |
34
+ |---|---|---|---|---|
35
+ | api-service | ✅ / ❌ | ผ่าน __/__ | | |
36
+ | admin-console | | | | |
37
+
38
+ - error ที่เจอตอนรวม + วิธีแก้:
39
+
40
+ ## 4. ปัญหา/ค้าง (ถ้ามี)
41
+ - task ที่ล้ม + สาเหตุ + แผนแก้:
42
+
43
+ ## 5. Rule/standard ใหม่ที่ note ไว้ (รอ SHIP)
44
+ > รวบรวมจาก `tasks/<task>/rule.md` และ `standard.md` — รอ SHIP อัปเดตไฟล์กลางใน `docs/`
45
+ -
46
+
47
+ ## 6. ปัญหายาก/ซ้ำที่เจอ
48
+ > บันทึกละเอียดที่ `./troubleshooting.md` (SHIP ยกขึ้น `docs/troubleshooting.md`)
49
+ - ดู `./troubleshooting.md`
50
+
51
+ ## ✅ Gate → VERIFY (ดู `warnyin/workflow/stages/build.md` ข้อ 7)
52
+ - [ ] ทุก task implement + merge เข้า build branch แล้ว
53
+ - [ ] ทุก task `passed` (test/build เขียว) ไม่มี `failed` ค้าง
54
+ - [ ] ไม่มี merge conflict ค้าง
55
+ - [ ] Full build ของทุก component ผ่าน (ไม่มี build error)
56
+ - [ ] test suite ทั้งหมด (รวม unit test) เขียวหมดบน build branch
57
+ - [ ] build.md สรุปครบทุก task + ผล full build/test
58
+ - [ ] ไม่แตะ rule/standard กลางใน docs/