@warnyin/agents 0.2.0 → 0.5.0

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 (92) hide show
  1. package/.claude/agents/warnyin-infra.md +1 -1
  2. package/.claude/agents/warnyin-qa.md +1 -1
  3. package/.claude/agents/warnyin-sa.md +1 -1
  4. package/.claude/agents/warnyin-security.md +1 -1
  5. package/.claude/agents/warnyin-tech-lead.md +1 -1
  6. package/.claude/commands/warnyin/build.md +9 -9
  7. package/.claude/commands/warnyin/design.md +4 -4
  8. package/.claude/commands/warnyin/discovery.md +3 -3
  9. package/.claude/commands/warnyin/explore.md +14 -0
  10. package/.claude/commands/warnyin/init.md +1 -1
  11. package/.claude/commands/warnyin/install-skill.md +2 -2
  12. package/.claude/commands/warnyin/next.md +16 -0
  13. package/.claude/commands/warnyin/ship.md +5 -5
  14. package/.claude/commands/warnyin/update-codemaps.md +12 -0
  15. package/.claude/commands/warnyin/verify.md +5 -5
  16. package/AGENTS.md +22 -12
  17. package/CLAUDE.md +18 -15
  18. package/README.md +25 -23
  19. package/bin/cli.mjs +50 -9
  20. package/package.json +2 -5
  21. package/warnyin/installer/templates/CLAUDE.md +29 -0
  22. package/warnyin/template/docs/codemap/index.md +18 -0
  23. package/warnyin/template/docs/features/[feature-name]/business.md +5 -0
  24. package/warnyin/template/docs/features/[feature-name]/feature.md +5 -0
  25. package/warnyin/template/docs/infra.md +16 -0
  26. package/warnyin/template/docs/project.md +18 -0
  27. package/warnyin/template/docs/rule.md +7 -0
  28. package/warnyin/template/docs/techstack/[component]/about.md +6 -0
  29. package/warnyin/template/docs/techstack/[component]/rule.md +6 -0
  30. package/warnyin/template/docs/techstack/[component]/standard.md +6 -0
  31. package/warnyin/template/docs/techstack/[component]/structure.md +7 -0
  32. package/warnyin/template/docs/techstack/[component]/test.md +7 -0
  33. package/{docs → warnyin/template/docs}/troubleshooting.md +32 -39
  34. package/{warnyin-stages → warnyin/template/stages}/[topic]/build.md +2 -2
  35. package/{warnyin-stages → warnyin/template/stages}/[topic]/business.md +1 -1
  36. package/{warnyin-stages → warnyin/template/stages}/[topic]/design.md +1 -1
  37. package/{warnyin-stages → warnyin/template/stages}/[topic]/discovery.md +2 -2
  38. package/{warnyin-stages → warnyin/template/stages}/[topic]/proposal.md +1 -1
  39. package/{warnyin-stages → warnyin/template/stages}/[topic]/research.md +1 -1
  40. package/{warnyin-stages → warnyin/template/stages}/[topic]/ship.md +3 -3
  41. package/{warnyin-stages → warnyin/template/stages}/[topic]/tasks/[task-name]/issue.md +1 -1
  42. package/{warnyin-stages → warnyin/template/stages}/[topic]/tasks/[task-name]/rule.md +1 -1
  43. package/{warnyin-stages → warnyin/template/stages}/[topic]/tasks/[task-name]/spec.md +1 -1
  44. package/{warnyin-stages → warnyin/template/stages}/[topic]/tasks/[task-name]/standard.md +1 -1
  45. package/{warnyin-stages → warnyin/template/stages}/[topic]/tasks/[task-name]/task.md +1 -1
  46. package/{warnyin-stages → warnyin/template/stages}/[topic]/test.md +1 -1
  47. package/{warnyin-stages → warnyin/template/stages}/[topic]/verify.md +2 -2
  48. package/warnyin/workflow/README.md +94 -0
  49. package/warnyin/workflow/codemap.md +91 -0
  50. package/warnyin/workflow/explore.md +32 -0
  51. package/{workflow → warnyin/workflow}/init.md +3 -1
  52. package/warnyin/workflow/next.md +47 -0
  53. package/{workflow → warnyin/workflow}/roles/developer.md +1 -1
  54. package/{workflow → warnyin/workflow}/scripts/build-wave.mjs +5 -5
  55. package/{workflow → warnyin/workflow}/stages/build.md +10 -10
  56. package/{workflow → warnyin/workflow}/stages/design.md +17 -17
  57. package/{workflow → warnyin/workflow}/stages/discovery.md +7 -7
  58. package/{workflow → warnyin/workflow}/stages/ship.md +8 -8
  59. package/{workflow → warnyin/workflow}/stages/verify.md +5 -5
  60. package/docs/features/[feature-name]/business.md +0 -0
  61. package/docs/features/[feature-name]/feature.md +0 -0
  62. package/docs/infra.md +0 -0
  63. package/docs/project.md +0 -0
  64. package/docs/rule.md +0 -0
  65. package/docs/techstack/admin-console/about.md +0 -0
  66. package/docs/techstack/admin-console/rule.md +0 -0
  67. package/docs/techstack/admin-console/standard.md +0 -0
  68. package/docs/techstack/admin-console/structure.md +0 -0
  69. package/docs/techstack/admin-console/test.md +0 -0
  70. package/docs/techstack/api-service/about.md +0 -0
  71. package/docs/techstack/api-service/rule.md +0 -0
  72. package/docs/techstack/api-service/standard.md +0 -0
  73. package/docs/techstack/api-service/structure.md +0 -0
  74. package/docs/techstack/api-service/test.md +0 -0
  75. package/installer/templates/CLAUDE.md +0 -26
  76. package/warnyin-stages/achieved/[YYYY-MM-DD-topic]/business.md +0 -0
  77. package/warnyin-stages/achieved/[YYYY-MM-DD-topic]/design.md +0 -0
  78. package/warnyin-stages/achieved/[YYYY-MM-DD-topic]/discovery.md +0 -0
  79. package/warnyin-stages/achieved/[YYYY-MM-DD-topic]/proposal.md +0 -0
  80. package/warnyin-stages/achieved/[YYYY-MM-DD-topic]/research.md +0 -0
  81. package/workflow/README.md +0 -91
  82. /package/{docs/codemap/index.md → warnyin/stages/achieved/.gitkeep} +0 -0
  83. /package/{warnyin-stages → warnyin/stages}/context.md +0 -0
  84. /package/{warnyin-stages → warnyin/template/stages}/[topic]/troubleshooting.md +0 -0
  85. /package/{workflow → warnyin/workflow}/roles/README.md +0 -0
  86. /package/{workflow → warnyin/workflow}/roles/ba.md +0 -0
  87. /package/{workflow → warnyin/workflow}/roles/infra.md +0 -0
  88. /package/{workflow → warnyin/workflow}/roles/po.md +0 -0
  89. /package/{workflow → warnyin/workflow}/roles/qa.md +0 -0
  90. /package/{workflow → warnyin/workflow}/roles/sa.md +0 -0
  91. /package/{workflow → warnyin/workflow}/roles/security.md +0 -0
  92. /package/{workflow → warnyin/workflow}/roles/tech-lead.md +0 -0
File without changes
File without changes
@@ -1,26 +0,0 @@
1
- # CLAUDE.md
2
-
3
- โปรเจกต์นี้ใช้ **Warnyin Standard Workflow** — มาตรฐานกลางของ ways of work เดินงานผ่าน 5 stage:
4
- `Discovery (optional) ▶ DESIGN ▶ BUILD ▶ VERIFY ▶ SHIP`
5
-
6
- ## กฎหลัก
7
- - แก่นของแต่ละ stage เป็น single source of truth ที่ `workflow/stages/` — **ทำตาม playbook นั้นเสมอ** ก่อนเริ่มงานใน stage
8
- - อย่า duplicate logic ของ workflow ลงที่อื่น ถ้าต้องแก้พฤติกรรมให้แก้ที่ `workflow/stages/`
9
- - output ของงานจริงเก็บใน `warnyin-stages/<slug>/` (copy จาก template `warnyin-stages/[topic]/`)
10
- - ความรู้ถาวรระดับโปรเจกต์อยู่ใน `docs/` — เริ่มอ่าน `docs/project.md` เสมอใน Discovery
11
-
12
- ## Slash commands (namespace `warnyin:`)
13
- - `/warnyin:init` → วิเคราะห์โปรเจกต์ + เติม `docs/` ครั้งแรกหลังติดตั้ง (`workflow/init.md`)
14
- - `/warnyin:install-skill [role]` → ติดตั้ง skill เสริมประจำ role (รายการ: `workflow/roles/README.md`)
15
- - `/warnyin:discovery [topic]` → Discovery stage (`workflow/stages/discovery.md`)
16
- - `/warnyin:design [slug] [change]` → DESIGN stage (`workflow/stages/design.md`)
17
- - `/warnyin:build [slug]` → BUILD stage — fan-out sub-agent ตาม dependency (`workflow/stages/build.md` + `workflow/scripts/build-wave.mjs`)
18
- - `/warnyin:verify [slug]` → VERIFY stage — strategy tester เทส local env + UXUI แก้จนผ่าน (`workflow/stages/verify.md`)
19
- - `/warnyin:ship [slug]` → SHIP stage — ส่งมอบ: promote ความรู้ขึ้น `docs/` + archive topic (`workflow/stages/ship.md`)
20
-
21
- ## รองรับหลาย AI
22
- Claude Code อ่าน `.claude/` + ไฟล์นี้, ส่วน Codex/Antigravity อ่าน `AGENTS.md`
23
- ทุกเครื่องชี้กลับมาที่ playbook กลางชุดเดียวกันใน `workflow/stages/` — ดูภาพรวมที่ `workflow/README.md`
24
-
25
- ## อัปเดต workflow
26
- `npx @warnyin/agents --update` — เขียนทับเฉพาะ playbook กลาง (`workflow/`, `.claude/commands/warnyin/`, template `warnyin-stages/[topic]/`) ไม่แตะ `docs/` และงานจริงใน `warnyin-stages/`
@@ -1,91 +0,0 @@
1
- # Warnyin Standard Workflow
2
-
3
- มาตรฐานกลางของ "วิธีทำงาน" (ways of work) สำหรับทุกโปรเจกต์ — สร้างทีม ผลิตผลงานคุณภาพ และเร็ว
4
- โดยเดินผ่าน 5 stage:
5
-
6
- ```
7
- Discovery (optional) ──▶ DESIGN ──▶ BUILD ──▶ VERIFY ──▶ SHIP
8
- ```
9
-
10
- แต่ละ stage มี **playbook กลางหนึ่งชุด** เป็น single source of truth ที่ AI ทุกเจ้าอ่านเหมือนกัน
11
-
12
- ---
13
-
14
- ## หลักการออกแบบ: Tool-agnostic, single source of truth
15
-
16
- แก่นของ workflow (กฎ / ขั้นตอน / เกณฑ์ผ่าน) เขียน **ครั้งเดียว** เป็น markdown ใน `workflow/stages/`
17
- ส่วน AI แต่ละเครื่องมีแค่ **adapter บางๆ** ที่ "ชี้กลับ" มาที่ playbook กลางชุดเดียวกัน
18
-
19
- | AI tool | Adapter (จุดเชื่อม) | อ่าน playbook จาก |
20
- |---|---|---|
21
- | **Claude Code** | `.claude/commands/*.md` + `CLAUDE.md` | `workflow/stages/*.md` |
22
- | **Codex** | `AGENTS.md` | `workflow/stages/*.md` |
23
- | **Antigravity** | `AGENTS.md` | `workflow/stages/*.md` |
24
- | เครื่องอื่นๆ | ชี้มาที่ `workflow/stages/` ได้ทันที | `workflow/stages/*.md` |
25
-
26
- > แก้กฎที่ `workflow/stages/` ที่เดียว → ทุกเครื่องได้เหมือนกันทันที
27
- > เพิ่ม AI เจ้าใหม่ = เพิ่ม adapter บางๆ อีกหนึ่งไฟล์ ไม่ต้องแตะ logic
28
-
29
- ---
30
-
31
- ## โครงสร้าง repo
32
-
33
- ```
34
- bin/cli.mjs # npx installer — ติดตั้ง workflow ลงโปรเจกต์อื่น
35
- installer/templates/ # template CLAUDE.md สำหรับโปรเจกต์ปลายทาง
36
-
37
- workflow/
38
- README.md # ไฟล์นี้ — ภาพรวม + วิธีรองรับหลาย AI
39
- init.md # playbook: INIT — วิเคราะห์โปรเจกต์ + เติม docs/ ครั้งแรก
40
- roles/ # ★ role card กลาง: ba, po, sa, tech-lead, developer, qa, security, infra
41
- stages/
42
- discovery.md # playbook: Discovery (optional) ✅
43
- design.md # playbook: DESIGN ✅
44
- build.md # playbook: BUILD ✅
45
- verify.md # playbook: VERIFY ✅
46
- ship.md # playbook: SHIP ✅
47
- scripts/
48
- build-wave.mjs # Workflow script: fan-out sub-agent ต่อ task ใน wave (worktree)
49
-
50
- docs/ # ความรู้ถาวรระดับโปรเจกต์ (อ้างอิงข้ามงาน)
51
- project.md # ★ จุดเริ่มของ Discovery — อ่านก่อนเสมอ
52
- rule.md infra.md
53
- troubleshooting.md # ★ KB ปัญหา-วิธีแก้ (อ่านก่อนเมื่อ build เจอ error; SHIP ป้อนเข้า)
54
- codemap/ features/ techstack/
55
-
56
- warnyin-stages/ # พื้นที่ทำงานจริง ตาม topic
57
- context.md
58
- [topic]/ # ★ template ของหนึ่งหน่วยงาน — copy ไปตั้งชื่อจริง
59
- discovery.md research.md # output ของ Discovery
60
- business.md proposal.md design.md # output ของ DESIGN
61
- tasks/[task-name]/... build.md # output ของ DESIGN (tasks) + BUILD (build.md)
62
- test.md verify.md # output ของ VERIFY
63
- troubleshooting.md ship.md # KB ระหว่างงาน + สรุปส่งมอบของ SHIP
64
- achieved/[YYYY-MM-DD-topic]/ # archive หลัง SHIP
65
- ```
66
-
67
- ---
68
-
69
- ## การติดตั้งไปโปรเจกต์อื่น
70
-
71
- ```bash
72
- cd my-project
73
- npx @warnyin/agents # ติดตั้ง (ข้ามไฟล์ที่มีอยู่ ไม่เขียนทับ)
74
- npx @warnyin/agents --update # อัปเดต playbook กลางเป็นเวอร์ชันล่าสุด
75
- npx @warnyin/agents --dry-run # ดูก่อนว่าจะสร้าง/อัปเดตอะไร
76
- # ทางสำรอง (ไม่ผ่าน npm): npx github:warnyin/warnyin-agents
77
- ```
78
-
79
- - โปรเจกต์ที่มี `CLAUDE.md`/`AGENTS.md` อยู่แล้ว → installer ต่อท้ายเป็น section ไม่เขียนทับ
80
- - `--update` เขียนทับเฉพาะ core (`workflow/`, `.claude/commands/warnyin/`, template `[topic]`) — ไม่แตะ `docs/` และงานจริง
81
- - หลังติดตั้ง → เปิด Claude Code แล้วรัน `/warnyin:init` ให้ agent วิเคราะห์โปรเจกต์ + เติม `docs/` (playbook: `workflow/init.md`)
82
-
83
- ## วิธีใช้
84
-
85
- 1. เริ่มงานใหม่ → copy `warnyin-stages/[topic]/` เป็น `warnyin-stages/<ชื่อ-งาน-kebab-case>/`
86
- 2. รัน stage ตามลำดับ (Discovery ข้ามได้ถ้าเข้าใจ scope ชัดแล้ว)
87
- - Claude Code: `/warnyin:discovery <topic>`, `/warnyin:design <slug> <change>`
88
- - Codex / Antigravity: บอกให้ทำตาม `workflow/stages/<stage>.md`
89
- 3. ผ่าน "gate" ของแต่ละ stage แล้วจึงไป stage ถัดไป
90
- 4. เมื่อ SHIP (`/warnyin:ship <slug>`) → promote ความรู้ของ topic ขึ้นเอกสารกลางใน `docs/`
91
- แล้วย้าย topic ไป `warnyin-stages/achieved/<YYYY-MM-DD>-<topic>/`
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes