@warnyin/agents 0.8.4 → 0.8.5
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.
package/CHANGELOG.md
CHANGED
|
@@ -23,6 +23,12 @@
|
|
|
23
23
|
|
|
24
24
|
## [Unreleased]
|
|
25
25
|
|
|
26
|
+
## [0.8.5] - 2026-06-07
|
|
27
|
+
|
|
28
|
+
### Added
|
|
29
|
+
- **Model-tier guidance ใน context profile** — `src/.warnyin/workflow/contexts/{research,build,review}.md` เพิ่มบรรทัด "Model tier" ใน section Tool preference (generic: `research`→`deepest reasoning` · `build`→`balanced`/fan-out worker เชิงกลไก→`cheap` · `review`→`balanced+`) + ตาราง legend ใน `contexts/README.md` — แนะนำ model tier ตาม posture เพื่อคุม token/cost; **tool-agnostic** ไม่ผูกชื่อรุ่น (harness map เอง) · global `docs/rule.md` §1 payload-guidance-generic — `.md` ล้วน, ติดมากับ `--update` รอบถัดไป
|
|
30
|
+
- **Worked-example pointer ใน README** — section "ตัวอย่างจริง (worked example)" ชี้ `docs/example-walkthrough.md` (เดิน topic จริง `cli-legacy-warning-fix` ครบ 5 stage บน repo) ให้ผู้ใช้ใหม่เห็น artifact จริง
|
|
31
|
+
|
|
26
32
|
## [0.8.4] - 2026-06-07
|
|
27
33
|
|
|
28
34
|
### Added
|
package/README.md
CHANGED
|
@@ -47,6 +47,13 @@ npx @warnyin/agents --update # อัปเดต playbook กลางเป
|
|
|
47
47
|
/warnyin:ship <slug> # promote ความรู้ขึ้น docs/ + archive topic
|
|
48
48
|
```
|
|
49
49
|
|
|
50
|
+
## ตัวอย่างจริง (worked example)
|
|
51
|
+
|
|
52
|
+
อยากเห็นว่า "output ที่ทำดีแล้ว" หน้าตาเป็นยังไงก่อนเริ่ม topic ของตัวเอง?
|
|
53
|
+
[`docs/example-walkthrough.md`](docs/example-walkthrough.md) ไล่ topic จริง (`cli-legacy-warning-fix`)
|
|
54
|
+
ครบทั้ง 5 stage — เน้น **เหตุผลการตัดสินใจ** ของแต่ละ stage พร้อมลิงก์ไป artifact จริงใน `docs/stages/achieved/`
|
|
55
|
+
(เปิดดูบน GitHub repo)
|
|
56
|
+
|
|
50
57
|
## แนวคิดหลัก: Tool-agnostic, single source of truth
|
|
51
58
|
|
|
52
59
|
แก่นของ workflow (กฎ / ขั้นตอน / เกณฑ์ผ่าน) เขียน**ครั้งเดียว**เป็น markdown ใน `.warnyin/workflow/stages/`
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@warnyin/agents",
|
|
3
|
-
"version": "0.8.
|
|
3
|
+
"version": "0.8.5",
|
|
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",
|
|
@@ -12,6 +12,7 @@
|
|
|
12
12
|
},
|
|
13
13
|
"scripts": {
|
|
14
14
|
"test": "node --test",
|
|
15
|
+
"lint:md": "node src/scripts/lint-md.mjs",
|
|
15
16
|
"verify:pack": "node src/scripts/verify-pack.mjs",
|
|
16
17
|
"setup:dogfood": "node src/scripts/setup-dogfood.mjs",
|
|
17
18
|
"setup:sandbox": "node src/scripts/setup-sandbox.mjs"
|
|
@@ -30,8 +30,20 @@
|
|
|
30
30
|
|
|
31
31
|
1. **Mindset** — วิธีคิดรวมของ session โหมดนี้ (2–4 บรรทัด)
|
|
32
32
|
2. **Do / Don't** — bullet สั้น 2 ฝั่ง: ทำ vs ห้าม
|
|
33
|
-
3. **Tool preference** — เครื่องมือที่ควรใช้ / เลี่ยง (read-only vs edit vs run)
|
|
33
|
+
3. **Tool preference** — เครื่องมือที่ควรใช้ / เลี่ยง (read-only vs edit vs run) + **Model tier** (generic: deepest/balanced/cheap)
|
|
34
34
|
4. **ใช้คู่ stage ไหน** — ชี้ playbook stage ที่เข้าคู่ (→ ลิงก์)
|
|
35
35
|
|
|
36
36
|
> เพิ่ม context ใหม่ = เพิ่มไฟล์ที่นี่ + ใส่ callout ใน playbook stage ที่เข้าคู่ + อัปเดตตารางด้านบน
|
|
37
37
|
> (เก็บให้บาง opinionated — 3 context พอ; อย่าให้ไหลเป็น catalog)
|
|
38
|
+
|
|
39
|
+
## Model tier (generic — harness ตีเป็นรุ่นจริงเอง)
|
|
40
|
+
|
|
41
|
+
แต่ละ context แนะนำ **model tier** ใน section "Tool preference" เพื่อคุม token/cost ตาม posture:
|
|
42
|
+
|
|
43
|
+
| Context | Tier | งาน |
|
|
44
|
+
|---|---|---|
|
|
45
|
+
| `research` | `deepest reasoning` | สำรวจ / architecture / ตัดสินใจ trade-off |
|
|
46
|
+
| `build` | `balanced` (worker เชิงกลไก → `cheap`) | implement vertical slice ตาม spec |
|
|
47
|
+
| `review` | `balanced+` | ตรวจ/จับ bug — ไม่ลด (พลาดแพงกว่า token) |
|
|
48
|
+
|
|
49
|
+
> **tool-agnostic:** ใช้ vocab generic **ไม่ผูกชื่อรุ่น/ผลิตภัณฑ์ของ harness ใด ๆ** — แต่ละ harness map tier → รุ่นเอง (เทียบแนวทาง model selection ของ harness เช่นไฟล์ rules ฝั่ง performance); เป็น **guidance** ไม่ใช่ enforce
|
|
@@ -18,6 +18,7 @@ slice เล็กจบในตัว, "เขียว" ต้องเขี
|
|
|
18
18
|
## Tool preference
|
|
19
19
|
- **ควรใช้:** Edit / Write / Bash, sub-agent fan-out, `build-wave`
|
|
20
20
|
- **เลี่ยง:** แก้นอก scope task, แตะ rule/standard กลางใน `docs/`
|
|
21
|
+
- **Model tier:** `balanced` (orchestrator/main loop ที่ตัดสินใจ integrate); **fan-out worker** ที่ทำ task ชัด/เชิงกลไกตาม spec → ลดเป็น `cheap` ได้ (คุม cost — งานกำหนดไว้แล้ว)
|
|
21
22
|
|
|
22
23
|
## ใช้คู่ stage ไหน
|
|
23
24
|
- ปลาย DESIGN (แตก task) → [`stages/design.md`](../stages/design.md)
|
|
@@ -17,6 +17,7 @@
|
|
|
17
17
|
## Tool preference
|
|
18
18
|
- **ควรใช้:** read-only — Read / Grep / Glob / fast-context, `/warnyin:explore`
|
|
19
19
|
- **เลี่ยง:** Edit / Write โค้ดจริง, คำสั่งที่เปลี่ยน state
|
|
20
|
+
- **Model tier:** `deepest reasoning` — สำรวจ/architecture/ตัดสินใจ trade-off = งานคิดหนัก คุ้มใช้ตัวลึกสุด
|
|
20
21
|
|
|
21
22
|
## ใช้คู่ stage ไหน
|
|
22
23
|
- Discovery → [`stages/discovery.md`](../stages/discovery.md)
|
|
@@ -17,6 +17,7 @@
|
|
|
17
17
|
## Tool preference
|
|
18
18
|
- **ควรใช้:** Read + Bash (รัน test/verify), reviewer sub-agents, `/code-review` `/security-review`
|
|
19
19
|
- **เลี่ยง:** เขียน feature ใหม่ระหว่าง review, แก้ scope กว้างๆ
|
|
20
|
+
- **Model tier:** `balanced+` — skeptical จับ bug/regression/edge case = **ไม่ควรลด tier** (พลาดของจริงแพงกว่าค่า token)
|
|
20
21
|
|
|
21
22
|
## ใช้คู่ stage ไหน
|
|
22
23
|
- VERIFY → [`stages/verify.md`](../stages/verify.md)
|