@champpaba/claude-agent-kit 2.6.0 → 2.7.0

package/.claude/templates/phases-sections/test-coverage.md

@@ -1,16 +1,16 @@
-# Phase: Test Coverage Report
-
-**Agent:** `test-debug`
-**Metadata:** `| report |`
-**Estimated time:** 5 minutes
-
-## 🎯 Purpose
-Generate final test coverage report.
-
-## ✅ Success Criteria
-- [ ] Coverage report generated
-- [ ] Coverage ≥ target
-
-## 📤 Output
-- Coverage report
-- Update flags.json
+# Phase: Test Coverage Report
+
+**Agent:** `test-debug`
+**Metadata:** `| report |`
+**Estimated time:** 5 minutes
+
+## 🎯 Purpose
+Generate final test coverage report.
+
+## ✅ Success Criteria
+- [ ] Coverage report generated
+- [ ] Coverage ≥ target
+
+## 📤 Output
+- Coverage report
+- Update flags.json

package/.claude/templates/phases-sections/user-approval.md

@@ -1,14 +1,14 @@
-# Phase: User Approval
-
-**Agent:** `user`
-**Metadata:** `| approval-gate |`
-**Estimated time:** 5 minutes
-
-## 🎯 Purpose
-User reviews and approves work before backend development starts.
-
-## ✅ Success Criteria
-- [ ] User approves mockup/implementation
-
-## 📤 Output
-- Update flags.json with approval status
+# Phase: User Approval
+
+**Agent:** `user`
+**Metadata:** `| approval-gate |`
+**Estimated time:** 5 minutes
+
+## 🎯 Purpose
+User reviews and approves work before backend development starts.
+
+## ✅ Success Criteria
+- [ ] User approves mockup/implementation
+
+## 📤 Output
+- Update flags.json with approval status

package/.claude/templates/phases-sections/ux-testing.md

@@ -0,0 +1,164 @@
+# Phase: UX Testing (Persona-Based)
+
+**Agent:** `ux-tester`
+**Metadata:** `| approval-gate | user-testing | persona-based |`
+**Estimated time:** 30 minutes
+**Requires Approval:** YES (blocks until user approves/rejects)
+
+## 🎯 Purpose
+
+ทดสอบ UI จากมุมมอง User จริง ก่อนที่จะไป Phase ถัดไป (Backend)
+- Auto-generate personas จาก product context
+- Test แต่ละ persona ผ่าน Chrome DevTools
+- คำนวณ weighted conversion prediction
+- รอ User approve หรือ reject
+
+## 📋 Pre-Requisites
+
+- ✅ Phase 1 (Frontend Mockup) completed
+- ✅ Dev server running (localhost:3000 or similar)
+- ✅ Chrome DevTools MCP connected
+
+## 🔄 Process
+
+### Step 1: Load Context
+```bash
+Read: openspec/changes/{change-id}/proposal.md
+Read: openspec/changes/{change-id}/page-plan.md (if exists)
+Read: openspec/changes/{change-id}/tasks.md
+Read: design-system/data.yaml (if exists)
+```
+
+### Step 2: Auto-Generate Personas
+- Analyze product/service from context
+- Generate 3-5 personas with % breakdown
+- Explain reasoning
+
+### Step 3: Find Dev Server
+- Auto-detect running server (3000, 3001, 5173, 8080)
+- Error if no server found
+
+### Step 4: Test Each Persona
+For each persona:
+1. Navigate to page
+2. Take screenshot + snapshot
+3. First impression (3 seconds)
+4. Test main flow (click through)
+5. Test mobile (resize to 375px)
+6. Would buy? Why/why not?
+
+### Step 5: Calculate Weighted Score
+- Weight each persona's decision by their %
+- Calculate total conversion prediction
+- Calculate potential after fixes
+
+### Step 6: Generate Report
+Output: `openspec/changes/{change-id}/ux-test-report.md`
+
+## ✅ Success Criteria
+
+- [ ] Personas generated with % breakdown
+- [ ] Each persona tested (desktop + mobile)
+- [ ] Conversion prediction calculated
+- [ ] Critical issues identified
+- [ ] Recommendations with impact %
+- [ ] Report generated
+
+## 📤 Output
+
+**Files created:**
+- `openspec/changes/{change-id}/ux-test-report.md`
+
+**Update flags.json:**
+```json
+{
+  "phases": {
+    "ux_testing": {
+      "status": "awaiting_approval",
+      "completed_at": "{ISO-timestamp}",
+      "actual_minutes": {duration},
+      "personas_tested": {count},
+      "conversion_prediction": "{percentage}",
+      "critical_issues": {count},
+      "report_path": "ux-test-report.md"
+    }
+  }
+}
+```
+
+## 🛑 Approval Gate
+
+**After report generated, PAUSE and ask user:**
+
+```markdown
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🧪 UX Testing Complete!
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📊 Summary:
+- Personas tested: {count}
+- Conversion prediction: {percentage}%
+- Critical issues: {count}
+- Potential after fixes: {percentage}%
+
+📄 Full report: openspec/changes/{change-id}/ux-test-report.md
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+กรุณา:
+1. Review report ด้านบน
+2. ทดสอบ {dev-url} ด้วยตัวเอง
+3. ตัดสินใจ:
+
+✅ "approve" → ไป Phase 2 (Backend)
+❌ "reject [feedback]" → กลับ Phase 1 แก้ไข
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 🔄 Rejection Loop
+
+**If user rejects:**
+
+1. Parse feedback from rejection
+2. Update flags.json:
+   ```json
+   {
+     "phases": {
+       "ux_testing": {
+         "status": "rejected",
+         "rejection_feedback": "{user feedback}",
+         "rejection_count": 1
+       },
+       "frontend_mockup": {
+         "status": "pending",
+         "rerun_reason": "UX testing rejected: {feedback}"
+       }
+     }
+   }
+   ```
+3. Loop back to Phase 1 (uxui-frontend)
+4. After Phase 1 completes → Re-run Phase 1.5 (ux-testing)
+
+## 📊 Report to User
+
+**After approval:**
+```
+✅ Phase 1.5: UX Testing approved!
+
+⏱️ Time: {actual} minutes
+🧪 Personas: {count} tested
+📈 Conversion: {percentage}%
+
+📍 Next phase: Phase 2 - Backend API
+```
+
+**After rejection:**
+```
+🔄 Phase 1.5: UX Testing rejected
+
+📝 Feedback: {user feedback}
+🔙 Returning to: Phase 1 - Frontend Mockup
+
+uxui-frontend agent จะได้รับ feedback นี้เพื่อแก้ไข
+```

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 ChampPABA
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 ChampPABA
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -21,6 +21,7 @@ cak init
 | Agent | Phase | Role |
 |-------|-------|------|
 | uxui-frontend | 1 | UI with mock data |
+| ux-tester | 1.5 | Persona-based UX testing (approval gate) |
 | backend | 2 | API endpoints |
 | database | 2 | Schemas |
 | integration | 2.5 | Contract validation |
@@ -29,12 +30,13 @@ cak init
 
 ## Features
 
+- **UX-Tester Agent (v2.7.0)** - Persona-based UX testing with weighted conversion prediction
 - **Smart Topic Query (v2.5.0)** - Cross-library integration detection + risk summary
 - **Adaptive Depth Research (v2.4.0)** - Dynamic research layers (0-10+) based on change complexity
 - **Zero-Maintenance Tech Detection** - Auto-detects ANY library in ANY language via Context7
 - **Visual Page Planning** - Layout wireframes, component plans, animation blueprints
 - **Cross-session Context** - `PROJECT_STATUS.yml` maintains state across sessions
-- **Design System v2.0** - Interactive setup with theme selection
+- **Design System v2.1** - YAML-based extraction with single data.yaml output
 
 ## Smart Topic Query (v2.5.0)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@champpaba/claude-agent-kit",
-  "version": "2.6.0",
+  "version": "2.7.0",
   "description": "Universal multi-agent template for Claude Code - AI-assisted development with specialized agents",
   "main": "bin/cli.js",
   "bin": {