@champpaba/claude-agent-kit 3.5.0 → 3.6.0

package/.claude/CHANGELOG.md

@@ -5,6 +5,66 @@
 
 ---
 
+## v3.5.2: UX Tester v3.0 - Inline Output (No File Creation)
+
+**Problem Solved:** User ไม่ต้องการให้ ux-tester สร้างไฟล์ .md แยก - ต้องการ verbose output ใน response แทน
+
+**Solution:** Rewrote ux-tester to v3.0 - output inline verbose ใน response โดยไม่สร้างไฟล์
+
+### Key Changes
+
+| Before | After |
+|--------|-------|
+| สร้าง `ux-test-report.md` | ❌ ไม่สร้างไฟล์ |
+| Compact format (MAX 150 lines) | ✅ Verbose ได้เลย |
+| Table-only output | ✅ Detailed descriptions OK |
+
+### Files Changed
+
+| File | Change |
+|------|--------|
+| `.claude/agents/07-ux-tester.md` | v2.1→v3.0, inline output, no file creation |
+| `.claude/commands/cdev.md` | Section 6: No File Output enforcement |
+| `.claude/templates/phases-sections/ux-testing.md` | Remove file references |
+
+### What Changed
+
+- **Agent v3.0**: ห้ามสร้างไฟล์ .md, output ใน response เท่านั้น
+- **Verbose OK**: ละเอียดได้เลย ไม่มี line limit
+- **cdev.md**: Inject "NO FILE CREATION" rule เมื่อ invoke ux-tester
+
+---
+
+## v3.5.1: UX Tester Report Format Enforcement
+
+**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.
+
+**Solution:** Added CRITICAL format rules to agent file + format enforcement injection in cdev.md.
+
+### Key Changes
+
+| Change | Location | Purpose |
+|--------|----------|---------|
+| CRITICAL format rules | `07-ux-tester.md` | Hard limits: MAX 150 lines, tables only |
+| Section 6 enforcement | `cdev.md` Step 4.1 | Inject format rules when invoking ux-tester |
+
+### Files Changed
+
+| File | Change |
+|------|--------|
+| `.claude/agents/07-ux-tester.md` | Added "⚠️ CRITICAL: Report Format Rules" section, version 2.0→2.1 |
+| `.claude/commands/cdev.md` | Added Section 6: Report Format Enforcement (ux-tester only) |
+
+### Format Rules Enforced
+
+- MAX 150 lines total
+- Tables ONLY (no paragraphs for personas/issues)
+- 1 row per persona, 1 row per issue
+- MAX 10 steps in Human Testing Guide
+- No verbose persona backgrounds/stories
+
+---
+
 ## v3.5.0: UX Tester v2.0 - Token Optimized + Human Testing Guide
 
 **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

@@ -1,47 +1,19 @@
 # CLAUDE.md
 
 > **Navigation Hub for AI Agents**
-> **Template Version:** 3.5.0 - UX Tester v2.0 (Token Optimized)
-> **Latest:** Single Source of Truth for design compliance (prevention + detection)
+> **Template Version:** 3.7.0 - Skills-Based Architecture
+> **Latest:** Token-optimized with skill-based commands (45-65% savings)
 
 ---
 
-## 📁 File Naming Conventions (OpenSpec + Template)
+## 📁 File Naming Conventions
 
-> **IMPORTANT:** Avoid confusion between OpenSpec files and Template files
+| Source | Files | Purpose |
+|--------|-------|---------|
+| **OpenSpec** | `proposal.md`, `tasks.md`, `design.md`, `specs/` | WHY, WHAT, Architecture |
+| **Template** | `data.yaml`, `page-plan.md`, `pre-work-context.md`, `phases.md` | Visual design, Agent context |
 
-### OpenSpec Files (from [Fission-AI/OpenSpec](https://github.com/Fission-AI/OpenSpec))
-
-| File | Purpose | When to Read |
-|------|---------|--------------|
-| `proposal.md` | WHY - Goals, scope, rationale | Phase planning |
-| `tasks.md` | WHAT - Implementation checklist | Task tracking |
-| `design.md` | **Technical/Architecture decisions** (optional) | Backend/Database phases |
-| `specs/` | Delta specs (ADDED/MODIFIED/REMOVED) | Requirement validation |
-
-### Template Files (from claude-multi-agent-template)
-
-| File | Purpose | When to Read |
-|------|---------|--------------|
-| `README.md` | **Visual design summary** (human-readable) | UI/Frontend phases |
-| `data.yaml` | Design tokens + psychology (~300 lines) | Quick UI reference |
-| `page-plan.md` | UI component layout + content strategy | uxui-frontend agent |
-| `pre-work-context.md` | **v3.2.0!** All agent context (best practices, warnings, checklist) | All agents - STEP 0 ✨ |
-| `phases.md` | Execution plan with agent assignments | All phases |
-| `flags.json` | Progress tracking | All phases |
-
-### Key Distinction
-
-```
-OpenSpec design.md    = Technical Architecture (data flow, API structure, system design)
-Template data.yaml    = Visual Design (colors, fonts, spacing, component styles)
-```
-
-**Agents should read BOTH when relevant:**
-- `uxui-frontend` → data.yaml (visual tokens) + design.md (if has UI architecture)
-- `backend` → design.md (API/data architecture)
-- `database` → design.md (data models, relationships)
-- `frontend` → data.yaml (visual tokens) + design.md (API contracts)
+**Key Distinction:** `design.md` = Technical Architecture, `data.yaml` = Visual Design
 
 ---
 
@@ -75,16 +47,28 @@ Universal, framework-agnostic template for AI-assisted development.
 - `@/.claude/lib/document-loader.md` - Token-efficient loading patterns
 - `@/.claude/contexts/design/index.md` (General design principles - fallback)
 
-**Development:**
-- `@/.claude/contexts/patterns/development-principles.md` - **v3.1.0!** SOLID, DRY, KISS, Fail Fast (Level 1 - ALL agents) ✨
-- `@/.claude/contexts/patterns/tdd-classification.md` - TDD workflow classification patterns
+**Development (Tiered Loading v3.6.0):**
+
+*Tier 1 - Core (ALL agents):*
+- `@/.claude/contexts/_core/development-principles.md` - SOLID, DRY, KISS, Fail Fast ✨
+- `@/.claude/contexts/_core/code-standards.md` - Naming, formatting, structure ✨
+
+*Tier 2 - Agent-Specific (load by role):*
+- `@/.claude/contexts/patterns/tdd-classification.md` - test-debug agent
+- `@/.claude/contexts/patterns/error-handling.md` - backend, database, frontend
+- `@/.claude/contexts/patterns/logging.md` - backend, database
+- `@/.claude/contexts/patterns/testing.md` - test-debug agent
+- `@/.claude/contexts/patterns/ui-component-consistency.md` - uxui-frontend agent
+- `@/.claude/contexts/patterns/frontend-component-strategy.md` - frontend agent
+
+*Tier 3 - On-Demand:*
 - `@/.claude/contexts/patterns/task-classification.md` (Agent selection guide)
 - `@/.claude/contexts/patterns/agent-coordination.md` (When to run agents parallel/sequential)
 - `@/.claude/contexts/patterns/error-recovery.md` (How agents handle errors & escalate)
-- `@/.claude/contexts/patterns/logging.md`
-- `@/.claude/contexts/patterns/testing.md`
 - `@/.claude/contexts/patterns/task-breakdown.md`
-- `@/.claude/contexts/patterns/frontend-component-strategy.md`
+- `@/.claude/contexts/patterns/performance-optimization.md`
+
+→ Full mapping: `.claude/agents/_shared/pre-work-checklist.md` (Step 0.4)
 
 **Project Setup:**
 - `/extract https://site.com` - Extract design from reference sites
@@ -179,6 +163,57 @@ Universal, framework-agnostic template for AI-assisted development.
 
 ---
 
+## ⚡ Tiered Context Loading (v3.6.0 - NEW!)
+
+**→ See:** `@/.claude/agents/_shared/pre-work-checklist.md` (Step 0.4)
+
+**Problem Solved:**
+- Loading all 13,000+ lines of contexts wastes tokens
+- Agents load knowledge they don't need (UI agent loads backend patterns)
+- No clear guidance on which contexts are relevant per agent
+
+**Solution: 3-Tier Loading System**
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  Tier 1: Core (_core/)           ~900 lines    ALWAYS LOAD  │
+├─────────────────────────────────────────────────────────────┤
+│  development-principles.md  (SOLID, DRY, KISS)              │
+│  code-standards.md          (naming, formatting)            │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  Tier 2: Agent-Specific     ~1,500 lines    LOAD BY ROLE    │
+├─────────────────────────────────────────────────────────────┤
+│  uxui-frontend  → design/*.md, ui-component-consistency.md  │
+│  backend        → error-handling.md, logging.md             │
+│  test-debug     → tdd-classification.md, testing.md         │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  Tier 3: On-Demand          ~300 lines      QUERY WHEN NEED │
+├─────────────────────────────────────────────────────────────┤
+│  performance-optimization.md, animation-patterns.md         │
+│  git-workflow.md, change-workflow.md                        │
+└─────────────────────────────────────────────────────────────┘
+```
+
+**Token Savings:**
+
+| Agent | Before (all) | After (tiered) | Savings |
+|-------|-------------|----------------|---------|
+| uxui-frontend | 13,000 | 3,500 | **73%** |
+| backend | 13,000 | 2,500 | **81%** |
+| test-debug | 13,000 | 2,000 | **85%** |
+| database | 13,000 | 1,800 | **86%** |
+
+**File Locations:**
+- Tier 1: `.claude/contexts/_core/`
+- Tier 2: `.claude/contexts/patterns/`, `.claude/contexts/design/`
+- Tier 3: Same folders, loaded on-demand
+
+---
+
 ## 🎨 Design System v2.1.0 (YAML-based)
 
 **→ See:** `@/.claude/lib/detailed-guides/design-system.md` for complete guide
@@ -235,7 +270,7 @@ Universal, framework-agnostic template for AI-assisted development.
 ┌─────────────────────────────────────────────────────────────┐
 │                    DETECTION (Post-Work)                     │
 ├─────────────────────────────────────────────────────────────┤
-│  ux-tester → Chrome DevTools Style Comparison                │
+│  ux-tester → agent-browser Style Comparison                  │
 │              Compare computed styles vs data.yaml tokens     │
 └─────────────────────────────────────────────────────────────┘
 ```
@@ -255,7 +290,7 @@ Universal, framework-agnostic template for AI-assisted development.
 |-------|------------|
 | Main Claude | Pre-flight check before invoking uxui-frontend |
 | uxui-frontend | STEP 0.5: Read data.yaml, report loaded tokens |
-| ux-tester | Step 5.5: Chrome DevTools validation |
+| ux-tester | Step 5.5: agent-browser validation |
 
 **Files Updated:**
 - `.claude/lib/design-validator.md` (NEW - Single Source of Truth)
@@ -363,7 +398,10 @@ User: "Build login system"
 **Recent versions:**
 | Version | Key Feature |
 |---------|-------------|
-| v3.5.0 | **UX Tester v2.0** (Token Optimized + Human Testing Guide) |
+| v3.6.0 | **Tiered Context Loading** (50-80% token savings per agent) |
+| v3.5.2 | UX Tester v3.0 (Inline Output - ไม่สร้างไฟล์, verbose ได้) |
+| v3.5.1 | UX Tester v2.1 (Format Enforcement - MAX 150 lines) |
+| v3.5.0 | UX Tester v2.0 (Token Optimized + Human Testing Guide) |
 | v3.4.0 | Complete Pseudocode Elimination (~3,210 lines → imperative instructions) |
 | v3.3.0 | **Design Validation System** (prevention + detection, single source of truth) |
 | v3.2.0 | Consolidated Pre-Work Context (single `pre-work-context.md` for agents) |
@@ -542,3 +580,25 @@ Agents query claude-mem in STEP 0 before implementation:
 ---
 
 **💡 Remember:** This template is universal. Use Context7 for framework-specific docs!
+
+
+<claude-mem-context>
+# Recent Activity
+
+<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
+
+### Feb 3, 2026
+
+| ID | Time | T | Title | Read |
+|----|------|---|-------|------|
+| #252 | 11:38 PM | 🔵 | Git status reveals extensive refactoring with skills migration and core context reorganization | ~682 |
+| #235 | 11:24 PM | ✅ | Updated CLAUDE.md design validation table to reference agent-browser | ~330 |
+| #234 | 11:23 PM | 🔵 | Design validation system uses Chrome DevTools for post-work style comparison by ux-tester | ~689 |
+| #232 | 11:22 PM | 🔵 | Found two more Chrome DevTools references in CLAUDE.md design validation section | ~488 |
+| #190 | 11:14 PM | ✅ | Updated CLAUDE.md to version 3.7.0 with skills-based architecture | ~405 |
+| #189 | 11:13 PM | 🔵 | CLAUDE.md navigation hub reveals template v3.7.0 with skills-based architecture and tiered loading | ~953 |
+| #188 | 11:12 PM | 🔄 | Simplified CLAUDE.md header with condensed file naming conventions table | ~577 |
+| #187 | " | 🔵 | CLAUDE.md navigation hub reveals comprehensive template architecture v3.6.0 | ~1396 |
+| #186 | 11:11 PM | 🔵 | Reviewed CLAUDE.md navigation hub revealing complete template architecture and versioning | ~1048 |
+| #185 | 11:10 PM | 🔵 | CLAUDE.md serves as comprehensive navigation hub for multi-agent system | ~1019 |
+</claude-mem-context>

package/.claude/agents/02-uxui-frontend.md

@@ -395,7 +395,7 @@ OR
 Next Step: {next task or agent}
 ```
 
-**IMPORTANT:** Include token usage report in final output. ux-tester will validate these against data.yaml using Chrome DevTools.
+**IMPORTANT:** Include token usage report in final output. ux-tester will validate these against data.yaml using agent-browser.
 
 ---
 

package/.claude/agents/07-ux-tester.md

@@ -1,14 +1,25 @@
 ---
 name: ux-tester
-description: UX Testing Agent - Tests UI from user personas via Chrome DevTools. Generates compact report + Human Testing Guide.
+description: UX Testing Agent - Tests UI from user personas via agent-browser. Outputs verbose inline report (NO file creation).
 model: opus
 color: green
 ---
 
-# UX Tester Agent v2.0
+# UX Tester Agent v3.0
 
-> **Version:** 2.0.0 (Token Optimized)
-> **Output:** Compact Report + Human Testing Guide
+> **Version:** 3.0.0 (Inline Output)
+> **Output:** Verbose inline response (ไม่สร้างไฟล์)
+
+---
+
+## ⚠️ CRITICAL: NO FILE CREATION
+
+**ห้ามสร้างไฟล์ .md ใดๆ ทั้งสิ้น!**
+
+- ❌ ห้าม Write หรือ Edit ไฟล์ report
+- ❌ ห้ามสร้าง `ux-test-report.md`
+- ✅ Output ทุกอย่างใน response โดยตรง
+- ✅ Verbose ละเอียดได้เลย
 
 ---
 
@@ -17,9 +28,9 @@ color: green
 1. Load Context (proposal.md, page-plan.md, tasks.md, data.yaml)
 2. Generate 3-5 Personas (name, %, goal, techSavvy, patience)
 3. Find Dev Server (ports: 3000, 3001, 5173, 8080, 4200)
-4. Test Each Persona via Chrome DevTools
+4. Test Each Persona via agent-browser
 5. Design Compliance Check (if data.yaml exists)
-6. Generate Report + Human Testing Guide
+6. Output Report ใน Response (ไม่สร้างไฟล์)
 
 ---
 
@@ -41,117 +52,112 @@ Note violations (colors, spacing, animation).
 
 ---
 
-## Report Format
+## Step 6: Output Report (Inline)
 
-Output: `openspec/changes/{change-id}/ux-test-report.md`
+**Output ทุกอย่างใน response โดยตรง:**
 
-\`\`\`markdown
-# UX Test Report: {Page Name}
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🧪 UX Test Report: {Page Name}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-> {date} | {dev-url} | {persona-count} personas
-
----
+📅 {date} | 🌐 {dev-url} | 👥 {persona-count} personas
 
 ## Summary
 
-**Conversion: {X}%** (now) | **{Y}%** (potential)
+**Conversion: {X}%** (now) → **{Y}%** (potential)
 
-| Persona | % | Decision | Blocker |
-|---------|---|----------|---------|
-| {name} | {%} | {Yes/Maybe/No} | {reason or "-"} |
+## Personas Tested
 
----
+### 1. {Persona Name} ({%}%)
+- **Background:** {detailed background}
+- **Goal:** {what they want}
+- **Tech Savvy:** {low/medium/high}
+- **First Impression:** {what they see in 3 sec}
+- **Flow Test:** {step by step what happened}
+- **Mobile Test:** {how it looks on mobile}
+- **Decision:** {Yes/Maybe/No}
+- **Reason:** {detailed reason}
 
-## Must Fix
+### 2. {Persona Name} ({%}%)
+... (repeat for all personas)
 
-| Issue | Affects | Impact | Fix |
-|-------|---------|--------|-----|
-| {issue} | {who %} | +{X}% | {how} |
+## Issues Found
 
-## Should Fix
+### Must Fix (Critical)
+1. **{Issue}**
+   - Affects: {which personas, %}
+   - Impact: +{X}% conversion if fixed
+   - How to fix: {detailed fix}
 
-| Issue | Affects | Impact | Fix |
-|-------|---------|--------|-----|
-| {issue} | {who %} | +{X}% | {how} |
+### Should Fix (Important)
+1. **{Issue}**
+   - Affects: {which personas, %}
+   - Impact: +{X}% conversion if fixed
+   - How to fix: {detailed fix}
 
 ## Working Well
-
-- {item 1}
-- {item 2}
-
----
+- {item 1 with detail}
+- {item 2 with detail}
 
 ## Design Compliance
 
-| Category | Status | Violations |
-|----------|--------|------------|
-| Colors | {ok/warn/fail} | {n} |
-| Spacing | {ok/warn/fail} | {n} |
-| Animation | {ok/warn/fail} | {n} |
-
-{If violations: list top 3 with fix}
-
----
+| Category | Status | Details |
+|----------|--------|---------|
+| Colors | {ok/warn/fail} | {specifics} |
+| Spacing | {ok/warn/fail} | {specifics} |
+| Animation | {ok/warn/fail} | {specifics} |
 
 ## Human Testing Guide
 
-### Desktop Test: {flow-name}
-
-| # | Action | Expected |
-|---|--------|----------|
-| 1 | Open {url} | See {element} |
-| 2 | {click/type/scroll what} | {result} |
-| 3 | ... | ... |
+### Desktop Test
+1. Open {url}
+2. {action} → expect {result}
+3. {action} → expect {result}
+...
 
 ### Mobile Test
-
-| # | Action | Expected |
-|---|--------|----------|
-| 1 | F12 > Toggle device (Ctrl+Shift+M) | Mobile view |
-| 2 | Select iPhone 14 Pro | Layout adapts |
-| 3 | {action} | {expected} |
+1. F12 > Toggle device (Ctrl+Shift+M)
+2. Select iPhone 14 Pro
+3. {action} → expect {result}
+...
 
 ### Checklist
+- [ ] First impression clear
+- [ ] CTA visible
+- [ ] Main flow works
+- [ ] Mobile responsive
+- [ ] No console errors
+- [ ] Font readable
 
-- [ ] First impression clear (understand in 3 sec)
-- [ ] CTA visible without searching
-- [ ] Main flow completes without error
-- [ ] Mobile works (buttons tappable)
-- [ ] No console errors (F12 > Console)
-- [ ] Font readable (min 14px)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
----
-
-## Decision
+## Decision Required
 
-- [ ] **Approve** -> Phase 2 (Backend)
-- [ ] **Reject** -> uxui-frontend fixes needed
+✅ "approve" → Continue to Phase 2 (Backend)
+❌ "reject [feedback]" → Go back to Phase 1 (uxui-frontend)
 
-**Feedback:** _________________
-\`\`\`
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
 
 ---
 
-## Human Testing Guide Rules
-
-1. **Step-by-step** - list 1, 2, 3...
-2. **Action clear** - "click button X", "type Y", "scroll down"
-3. **Expected clear** - "see popup", "go to /signup"
-4. **Non-technical language**
-5. **Cover critical path** - signup, purchase, contact
-
----
+## agent-browser Commands
 
-## Chrome DevTools
+| Command | Use |
+|---------|-----|
+| `agent-browser open <url>` | Navigate to page |
+| `agent-browser screenshot` | Overview capture |
+| `agent-browser snapshot -i` | Get interactive elements |
+| `agent-browser click @ref` | Click element |
+| `agent-browser fill @ref "text"` | Fill form |
+| `agent-browser scroll down 500` | Scroll page |
 
-| Tool | Use |
-|------|-----|
-| take_screenshot() | Overview |
-| take_snapshot() | Read content |
-| navigate_page(url) | Go to page |
-| click(uid) | Click |
-| fill(uid, value) | Fill form |
-| resize_page(375, 812) | Mobile |
+**Mobile testing:**
+```bash
+agent-browser -p ios --device "iPhone 16 Pro" open <url>
+agent-browser -p ios snapshot -i
+```
 
 ---
 
@@ -160,3 +166,5 @@ Output: `openspec/changes/{change-id}/ux-test-report.md`
 - Talk like real user, not dev
 - Be direct - if bad, say bad
 - Use same language as user (Thai/English)
+- **Verbose is OK** - ละเอียดได้เลย
+- **NO FILE CREATION** - output ใน response เท่านั้น

package/.claude/agents/CLAUDE.md

@@ -0,0 +1,18 @@
+<claude-mem-context>
+# Recent Activity
+
+<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
+
+### Feb 3, 2026
+
+| ID | Time | T | Title | Read |
+|----|------|---|-------|------|
+| #252 | 11:38 PM | 🔵 | Git status reveals extensive refactoring with skills migration and core context reorganization | ~682 |
+| #225 | 11:22 PM | 🔵 | Found Chrome DevTools reference in uxui-frontend agent documentation requiring update | ~445 |
+| #202 | 11:20 PM | ✅ | Updated ux-tester agent to use agent-browser CLI instead of Chrome DevTools MCP | ~644 |
+| #201 | " | ✅ | Updated UX Tester agent to use agent-browser instead of Chrome DevTools | ~378 |
+| #200 | " | ✅ | Updated ux-tester agent to use agent-browser instead of Chrome DevTools | ~374 |
+| #194 | " | 🔵 | UX Tester Agent v3.0 uses inline verbose output without file creation | ~884 |
+| #172 | 9:56 PM | 🔵 | Backend agent creates API endpoints with validation and business logic | ~539 |
+| #171 | " | 🔵 | uxui-frontend agent handles UI development with mock data and design validation | ~516 |
+</claude-mem-context>

package/.claude/agents/_shared/CLAUDE.md

@@ -0,0 +1,11 @@
+<claude-mem-context>
+# Recent Activity
+
+<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
+
+### Feb 3, 2026
+
+| ID | Time | T | Title | Read |
+|----|------|---|-------|------|
+| #252 | 11:38 PM | 🔵 | Git status reveals extensive refactoring with skills migration and core context reorganization | ~682 |
+</claude-mem-context>

package/.claude/agents/_shared/pre-work-checklist.md

@@ -1,6 +1,6 @@
 # Pre-Work Checklist (Shared by All Agents)
 
-> **Version:** 3.0.0 (Pre-Work Context Integration)
+> **Version:** 3.6.0 (Tiered Context Loading)
 > **Purpose:** Single source of truth for pre-work validation
 
 ---
@@ -210,10 +210,53 @@ Result: #12345 - "Chose rotating refresh tokens with Redis storage"
 
 ---
 
+### Step 0.4: Tiered Context Loading (v3.6.0 - NEW)
+
+**Load contexts based on tier system for token efficiency:**
+
+WHY: Loading all 13,000+ lines of contexts wastes tokens. Load only what's relevant for your role.
+
+#### Tier 1: Core (ALL agents load these)
+
+```
+@/.claude/contexts/_core/development-principles.md  (SOLID, DRY, KISS)
+@/.claude/contexts/_core/code-standards.md          (naming, formatting)
+```
+
+#### Tier 2: Agent-Specific (load based on your role)
+
+| Agent | Contexts to Load |
+|-------|-----------------|
+| **uxui-frontend** | `design/*.md`, `patterns/ui-component-consistency.md`, `patterns/animation-patterns.md` |
+| **frontend** | `design/color-theory.md`, `patterns/error-handling.md`, `patterns/frontend-component-strategy.md` |
+| **backend** | `patterns/error-handling.md`, `patterns/logging.md`, `patterns/validation-framework.md` |
+| **database** | `patterns/error-handling.md`, `patterns/logging.md` |
+| **test-debug** | `patterns/tdd-classification.md`, `patterns/testing.md`, `patterns/error-recovery.md` |
+| **integration** | `patterns/error-handling.md`, `patterns/validation-framework.md` |
+| **ux-tester** | `design/accessibility.md`, `design/color-theory.md` |
+
+#### Tier 3: On-Demand (query when specific topic arises)
+
+Don't pre-load these. Read only when the task specifically requires:
+- `patterns/performance-optimization.md` - When optimizing
+- `patterns/animation-patterns.md` - When adding animations (non-uxui agents)
+- `patterns/git-workflow.md` - When handling git operations
+- `patterns/change-workflow.md` - When managing change lifecycle
+
+**Report in validation:**
+```markdown
+Contexts Loaded: (Step 0.4)
+- Tier 1 (Core): development-principles.md, code-standards.md
+- Tier 2 (Agent): {list based on agent type}
+- Tier 3 (On-Demand): {only if task requires specific topic}
+```
+
+---
+
 ### Step 1-4: Standard Checks
 
 1. **Context Discovery** - Load project context via agent-discovery.md
-2. **Pattern Loading** - Load relevant patterns for your agent type
+2. **Pattern Loading** - (Now covered by Step 0.4 Tiered Loading)
 3. **Validation Report** - Provide pre-implementation validation report
 4. **Wait for Approval** - Proceed only after orchestrator validation
 

package/.claude/commands/CLAUDE.md

@@ -0,0 +1,20 @@
+<claude-mem-context>
+# Recent Activity
+
+<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
+
+### Feb 3, 2026
+
+| ID | Time | T | Title | Read |
+|----|------|---|-------|------|
+| #252 | 11:38 PM | 🔵 | Git status reveals extensive refactoring with skills migration and core context reorganization | ~682 |
+| #219 | 11:22 PM | ✅ | Updated cdev command validation requirements for ux-tester from Chrome DevTools to agent-browser | ~488 |
+| #216 | 11:21 PM | 🔵 | Examined cdev command validation checklist for ux-tester agent | ~486 |
+| #214 | " | ✅ | Replaced Chrome DevTools references with agent-browser in extract command | ~592 |
+| #210 | " | ✅ | Updated extract command error handling to reference agent-browser instead of Chrome DevTools MCP | ~430 |
+| #209 | " | ✅ | Updated extract command to use agent-browser for full-page screenshots | ~386 |
+| #208 | " | ✅ | Updated extract command to use agent-browser CLI instead of Chrome DevTools MCP | ~350 |
+| #198 | 11:20 PM | 🔵 | Extract command remains as full markdown specification in commands directory | ~776 |
+| #181 | 11:09 PM | 🔵 | /pageplan command generates visual page planning with wireframes, animations, and asset checklists | ~971 |
+| #168 | 9:55 PM | 🔵 | csetup command orchestrates AI-driven task analysis and agent workflow generation | ~572 |
+</claude-mem-context>