@champpaba/claude-agent-kit 3.5.0 → 3.5.2
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/.claude/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,66 @@
|
|
|
5
5
|
|
|
6
6
|
---
|
|
7
7
|
|
|
8
|
+
## v3.5.2: UX Tester v3.0 - Inline Output (No File Creation)
|
|
9
|
+
|
|
10
|
+
**Problem Solved:** User ไม่ต้องการให้ ux-tester สร้างไฟล์ .md แยก - ต้องการ verbose output ใน response แทน
|
|
11
|
+
|
|
12
|
+
**Solution:** Rewrote ux-tester to v3.0 - output inline verbose ใน response โดยไม่สร้างไฟล์
|
|
13
|
+
|
|
14
|
+
### Key Changes
|
|
15
|
+
|
|
16
|
+
| Before | After |
|
|
17
|
+
|--------|-------|
|
|
18
|
+
| สร้าง `ux-test-report.md` | ❌ ไม่สร้างไฟล์ |
|
|
19
|
+
| Compact format (MAX 150 lines) | ✅ Verbose ได้เลย |
|
|
20
|
+
| Table-only output | ✅ Detailed descriptions OK |
|
|
21
|
+
|
|
22
|
+
### Files Changed
|
|
23
|
+
|
|
24
|
+
| File | Change |
|
|
25
|
+
|------|--------|
|
|
26
|
+
| `.claude/agents/07-ux-tester.md` | v2.1→v3.0, inline output, no file creation |
|
|
27
|
+
| `.claude/commands/cdev.md` | Section 6: No File Output enforcement |
|
|
28
|
+
| `.claude/templates/phases-sections/ux-testing.md` | Remove file references |
|
|
29
|
+
|
|
30
|
+
### What Changed
|
|
31
|
+
|
|
32
|
+
- **Agent v3.0**: ห้ามสร้างไฟล์ .md, output ใน response เท่านั้น
|
|
33
|
+
- **Verbose OK**: ละเอียดได้เลย ไม่มี line limit
|
|
34
|
+
- **cdev.md**: Inject "NO FILE CREATION" rule เมื่อ invoke ux-tester
|
|
35
|
+
|
|
36
|
+
---
|
|
37
|
+
|
|
38
|
+
## v3.5.1: UX Tester Report Format Enforcement
|
|
39
|
+
|
|
40
|
+
**Problem Solved:** UX Tester agent ignored the compact report format from v3.5.0 and still generated verbose reports (~200+ lines). Root cause: format template was "passive" - no enforcement mechanism.
|
|
41
|
+
|
|
42
|
+
**Solution:** Added CRITICAL format rules to agent file + format enforcement injection in cdev.md.
|
|
43
|
+
|
|
44
|
+
### Key Changes
|
|
45
|
+
|
|
46
|
+
| Change | Location | Purpose |
|
|
47
|
+
|--------|----------|---------|
|
|
48
|
+
| CRITICAL format rules | `07-ux-tester.md` | Hard limits: MAX 150 lines, tables only |
|
|
49
|
+
| Section 6 enforcement | `cdev.md` Step 4.1 | Inject format rules when invoking ux-tester |
|
|
50
|
+
|
|
51
|
+
### Files Changed
|
|
52
|
+
|
|
53
|
+
| File | Change |
|
|
54
|
+
|------|--------|
|
|
55
|
+
| `.claude/agents/07-ux-tester.md` | Added "⚠️ CRITICAL: Report Format Rules" section, version 2.0→2.1 |
|
|
56
|
+
| `.claude/commands/cdev.md` | Added Section 6: Report Format Enforcement (ux-tester only) |
|
|
57
|
+
|
|
58
|
+
### Format Rules Enforced
|
|
59
|
+
|
|
60
|
+
- MAX 150 lines total
|
|
61
|
+
- Tables ONLY (no paragraphs for personas/issues)
|
|
62
|
+
- 1 row per persona, 1 row per issue
|
|
63
|
+
- MAX 10 steps in Human Testing Guide
|
|
64
|
+
- No verbose persona backgrounds/stories
|
|
65
|
+
|
|
66
|
+
---
|
|
67
|
+
|
|
8
68
|
## v3.5.0: UX Tester v2.0 - Token Optimized + Human Testing Guide
|
|
9
69
|
|
|
10
70
|
**Problem Solved:** UX Tester agent generated verbose reports (~200 lines) with repetitive persona details, consuming excessive tokens (~3,500). Users couldn't easily test the UI themselves because the report was technical and long.
|
package/.claude/CLAUDE.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# CLAUDE.md
|
|
2
2
|
|
|
3
3
|
> **Navigation Hub for AI Agents**
|
|
4
|
-
> **Template Version:** 3.5.
|
|
4
|
+
> **Template Version:** 3.5.2 - UX Tester v3.0 (Inline Output)
|
|
5
5
|
> **Latest:** Single Source of Truth for design compliance (prevention + detection)
|
|
6
6
|
|
|
7
7
|
---
|
|
@@ -363,7 +363,9 @@ User: "Build login system"
|
|
|
363
363
|
**Recent versions:**
|
|
364
364
|
| Version | Key Feature |
|
|
365
365
|
|---------|-------------|
|
|
366
|
-
| v3.5.
|
|
366
|
+
| v3.5.2 | **UX Tester v3.0** (Inline Output - ไม่สร้างไฟล์, verbose ได้) |
|
|
367
|
+
| v3.5.1 | UX Tester v2.1 (Format Enforcement - MAX 150 lines) |
|
|
368
|
+
| v3.5.0 | UX Tester v2.0 (Token Optimized + Human Testing Guide) |
|
|
367
369
|
| v3.4.0 | Complete Pseudocode Elimination (~3,210 lines → imperative instructions) |
|
|
368
370
|
| v3.3.0 | **Design Validation System** (prevention + detection, single source of truth) |
|
|
369
371
|
| v3.2.0 | Consolidated Pre-Work Context (single `pre-work-context.md` for agents) |
|
|
@@ -1,14 +1,25 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: ux-tester
|
|
3
|
-
description: UX Testing Agent - Tests UI from user personas via Chrome DevTools.
|
|
3
|
+
description: UX Testing Agent - Tests UI from user personas via Chrome DevTools. Outputs verbose inline report (NO file creation).
|
|
4
4
|
model: opus
|
|
5
5
|
color: green
|
|
6
6
|
---
|
|
7
7
|
|
|
8
|
-
# UX Tester Agent
|
|
8
|
+
# UX Tester Agent v3.0
|
|
9
9
|
|
|
10
|
-
> **Version:**
|
|
11
|
-
> **Output:**
|
|
10
|
+
> **Version:** 3.0.0 (Inline Output)
|
|
11
|
+
> **Output:** Verbose inline response (ไม่สร้างไฟล์)
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
## ⚠️ CRITICAL: NO FILE CREATION
|
|
16
|
+
|
|
17
|
+
**ห้ามสร้างไฟล์ .md ใดๆ ทั้งสิ้น!**
|
|
18
|
+
|
|
19
|
+
- ❌ ห้าม Write หรือ Edit ไฟล์ report
|
|
20
|
+
- ❌ ห้ามสร้าง `ux-test-report.md`
|
|
21
|
+
- ✅ Output ทุกอย่างใน response โดยตรง
|
|
22
|
+
- ✅ Verbose ละเอียดได้เลย
|
|
12
23
|
|
|
13
24
|
---
|
|
14
25
|
|
|
@@ -19,7 +30,7 @@ color: green
|
|
|
19
30
|
3. Find Dev Server (ports: 3000, 3001, 5173, 8080, 4200)
|
|
20
31
|
4. Test Each Persona via Chrome DevTools
|
|
21
32
|
5. Design Compliance Check (if data.yaml exists)
|
|
22
|
-
6.
|
|
33
|
+
6. Output Report ใน Response (ไม่สร้างไฟล์)
|
|
23
34
|
|
|
24
35
|
---
|
|
25
36
|
|
|
@@ -41,104 +52,93 @@ Note violations (colors, spacing, animation).
|
|
|
41
52
|
|
|
42
53
|
---
|
|
43
54
|
|
|
44
|
-
## Report
|
|
55
|
+
## Step 6: Output Report (Inline)
|
|
45
56
|
|
|
46
|
-
Output
|
|
57
|
+
**Output ทุกอย่างใน response โดยตรง:**
|
|
47
58
|
|
|
48
|
-
|
|
49
|
-
|
|
59
|
+
```
|
|
60
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
61
|
+
🧪 UX Test Report: {Page Name}
|
|
62
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
50
63
|
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
---
|
|
64
|
+
📅 {date} | 🌐 {dev-url} | 👥 {persona-count} personas
|
|
54
65
|
|
|
55
66
|
## Summary
|
|
56
67
|
|
|
57
|
-
**Conversion: {X}%** (now)
|
|
68
|
+
**Conversion: {X}%** (now) → **{Y}%** (potential)
|
|
58
69
|
|
|
59
|
-
|
|
60
|
-
|---------|---|----------|---------|
|
|
61
|
-
| {name} | {%} | {Yes/Maybe/No} | {reason or "-"} |
|
|
70
|
+
## Personas Tested
|
|
62
71
|
|
|
63
|
-
|
|
72
|
+
### 1. {Persona Name} ({%}%)
|
|
73
|
+
- **Background:** {detailed background}
|
|
74
|
+
- **Goal:** {what they want}
|
|
75
|
+
- **Tech Savvy:** {low/medium/high}
|
|
76
|
+
- **First Impression:** {what they see in 3 sec}
|
|
77
|
+
- **Flow Test:** {step by step what happened}
|
|
78
|
+
- **Mobile Test:** {how it looks on mobile}
|
|
79
|
+
- **Decision:** {Yes/Maybe/No}
|
|
80
|
+
- **Reason:** {detailed reason}
|
|
64
81
|
|
|
65
|
-
|
|
82
|
+
### 2. {Persona Name} ({%}%)
|
|
83
|
+
... (repeat for all personas)
|
|
66
84
|
|
|
67
|
-
|
|
68
|
-
|-------|---------|--------|-----|
|
|
69
|
-
| {issue} | {who %} | +{X}% | {how} |
|
|
85
|
+
## Issues Found
|
|
70
86
|
|
|
71
|
-
|
|
87
|
+
### Must Fix (Critical)
|
|
88
|
+
1. **{Issue}**
|
|
89
|
+
- Affects: {which personas, %}
|
|
90
|
+
- Impact: +{X}% conversion if fixed
|
|
91
|
+
- How to fix: {detailed fix}
|
|
72
92
|
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
93
|
+
### Should Fix (Important)
|
|
94
|
+
1. **{Issue}**
|
|
95
|
+
- Affects: {which personas, %}
|
|
96
|
+
- Impact: +{X}% conversion if fixed
|
|
97
|
+
- How to fix: {detailed fix}
|
|
76
98
|
|
|
77
99
|
## Working Well
|
|
78
|
-
|
|
79
|
-
- {item
|
|
80
|
-
- {item 2}
|
|
81
|
-
|
|
82
|
-
---
|
|
100
|
+
- {item 1 with detail}
|
|
101
|
+
- {item 2 with detail}
|
|
83
102
|
|
|
84
103
|
## Design Compliance
|
|
85
104
|
|
|
86
|
-
| Category | Status |
|
|
87
|
-
|
|
88
|
-
| Colors | {ok/warn/fail} | {
|
|
89
|
-
| Spacing | {ok/warn/fail} | {
|
|
90
|
-
| Animation | {ok/warn/fail} | {
|
|
91
|
-
|
|
92
|
-
{If violations: list top 3 with fix}
|
|
93
|
-
|
|
94
|
-
---
|
|
105
|
+
| Category | Status | Details |
|
|
106
|
+
|----------|--------|---------|
|
|
107
|
+
| Colors | {ok/warn/fail} | {specifics} |
|
|
108
|
+
| Spacing | {ok/warn/fail} | {specifics} |
|
|
109
|
+
| Animation | {ok/warn/fail} | {specifics} |
|
|
95
110
|
|
|
96
111
|
## Human Testing Guide
|
|
97
112
|
|
|
98
|
-
### Desktop Test
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
| 2 | {click/type/scroll what} | {result} |
|
|
104
|
-
| 3 | ... | ... |
|
|
113
|
+
### Desktop Test
|
|
114
|
+
1. Open {url}
|
|
115
|
+
2. {action} → expect {result}
|
|
116
|
+
3. {action} → expect {result}
|
|
117
|
+
...
|
|
105
118
|
|
|
106
119
|
### Mobile Test
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
| 2 | Select iPhone 14 Pro | Layout adapts |
|
|
112
|
-
| 3 | {action} | {expected} |
|
|
120
|
+
1. F12 > Toggle device (Ctrl+Shift+M)
|
|
121
|
+
2. Select iPhone 14 Pro
|
|
122
|
+
3. {action} → expect {result}
|
|
123
|
+
...
|
|
113
124
|
|
|
114
125
|
### Checklist
|
|
126
|
+
- [ ] First impression clear
|
|
127
|
+
- [ ] CTA visible
|
|
128
|
+
- [ ] Main flow works
|
|
129
|
+
- [ ] Mobile responsive
|
|
130
|
+
- [ ] No console errors
|
|
131
|
+
- [ ] Font readable
|
|
115
132
|
|
|
116
|
-
|
|
117
|
-
- [ ] CTA visible without searching
|
|
118
|
-
- [ ] Main flow completes without error
|
|
119
|
-
- [ ] Mobile works (buttons tappable)
|
|
120
|
-
- [ ] No console errors (F12 > Console)
|
|
121
|
-
- [ ] Font readable (min 14px)
|
|
133
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
122
134
|
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
## Decision
|
|
126
|
-
|
|
127
|
-
- [ ] **Approve** -> Phase 2 (Backend)
|
|
128
|
-
- [ ] **Reject** -> uxui-frontend fixes needed
|
|
129
|
-
|
|
130
|
-
**Feedback:** _________________
|
|
131
|
-
\`\`\`
|
|
132
|
-
|
|
133
|
-
---
|
|
135
|
+
## Decision Required
|
|
134
136
|
|
|
135
|
-
|
|
137
|
+
✅ "approve" → Continue to Phase 2 (Backend)
|
|
138
|
+
❌ "reject [feedback]" → Go back to Phase 1 (uxui-frontend)
|
|
136
139
|
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
3. **Expected clear** - "see popup", "go to /signup"
|
|
140
|
-
4. **Non-technical language**
|
|
141
|
-
5. **Cover critical path** - signup, purchase, contact
|
|
140
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
141
|
+
```
|
|
142
142
|
|
|
143
143
|
---
|
|
144
144
|
|
|
@@ -160,3 +160,5 @@ Output: `openspec/changes/{change-id}/ux-test-report.md`
|
|
|
160
160
|
- Talk like real user, not dev
|
|
161
161
|
- Be direct - if bad, say bad
|
|
162
162
|
- Use same language as user (Thai/English)
|
|
163
|
+
- **Verbose is OK** - ละเอียดได้เลย
|
|
164
|
+
- **NO FILE CREATION** - output ใน response เท่านั้น
|
package/.claude/commands/cdev.md
CHANGED
|
@@ -318,6 +318,24 @@ Quick Reference:
|
|
|
318
318
|
|
|
319
319
|
---
|
|
320
320
|
|
|
321
|
+
#### Section 6: No File Output (ux-tester only)
|
|
322
|
+
|
|
323
|
+
**If agent equals ux-tester:**
|
|
324
|
+
|
|
325
|
+
Add this section to the prompt:
|
|
326
|
+
|
|
327
|
+
```
|
|
328
|
+
⚠️ NO FILE CREATION
|
|
329
|
+
|
|
330
|
+
ห้ามสร้างไฟล์ .md ใดๆ ทั้งสิ้น!
|
|
331
|
+
- ❌ ห้าม Write ไฟล์ report
|
|
332
|
+
- ❌ ห้ามสร้าง ux-test-report.md
|
|
333
|
+
- ✅ Output ทุกอย่างใน response โดยตรง
|
|
334
|
+
- ✅ Verbose ละเอียดได้เลย
|
|
335
|
+
```
|
|
336
|
+
|
|
337
|
+
---
|
|
338
|
+
|
|
321
339
|
### Step 4.2: Execute Agent with Retry
|
|
322
340
|
|
|
323
341
|
---
|
|
@@ -435,8 +453,6 @@ Display this message:
|
|
|
435
453
|
|
|
436
454
|
{result_summary}
|
|
437
455
|
|
|
438
|
-
📄 Full report: openspec/changes/{change-id}/ux-test-report.md
|
|
439
|
-
|
|
440
456
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
441
457
|
|
|
442
458
|
Please decide:
|
|
@@ -52,8 +52,8 @@ For each persona:
|
|
|
52
52
|
- Calculate total conversion prediction
|
|
53
53
|
- Calculate potential after fixes
|
|
54
54
|
|
|
55
|
-
### Step 6:
|
|
56
|
-
Output
|
|
55
|
+
### Step 6: Output Report (Inline)
|
|
56
|
+
Output ทุกอย่างใน response โดยตรง (ไม่สร้างไฟล์)
|
|
57
57
|
|
|
58
58
|
## ✅ Success Criteria
|
|
59
59
|
|
|
@@ -66,8 +66,7 @@ Output: `openspec/changes/{change-id}/ux-test-report.md`
|
|
|
66
66
|
|
|
67
67
|
## 📤 Output
|
|
68
68
|
|
|
69
|
-
**
|
|
70
|
-
- `openspec/changes/{change-id}/ux-test-report.md`
|
|
69
|
+
**Output:** Inline response (ไม่สร้างไฟล์)
|
|
71
70
|
|
|
72
71
|
**Update flags.json:**
|
|
73
72
|
```json
|
|
@@ -79,8 +78,7 @@ Output: `openspec/changes/{change-id}/ux-test-report.md`
|
|
|
79
78
|
"actual_minutes": {duration},
|
|
80
79
|
"personas_tested": {count},
|
|
81
80
|
"conversion_prediction": "{percentage}",
|
|
82
|
-
"critical_issues": {count}
|
|
83
|
-
"report_path": "ux-test-report.md"
|
|
81
|
+
"critical_issues": {count}
|
|
84
82
|
}
|
|
85
83
|
}
|
|
86
84
|
}
|
|
@@ -101,8 +99,6 @@ Output: `openspec/changes/{change-id}/ux-test-report.md`
|
|
|
101
99
|
- Critical issues: {count}
|
|
102
100
|
- Potential after fixes: {percentage}%
|
|
103
101
|
|
|
104
|
-
📄 Full report: openspec/changes/{change-id}/ux-test-report.md
|
|
105
|
-
|
|
106
102
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
107
103
|
|
|
108
104
|
กรุณา:
|