@champpaba/claude-agent-kit 2.0.1 → 2.1.0

package/README.md

@@ -4,1584 +4,194 @@
 
 [![npm version](https://badge.fury.io/js/@champpaba%2Fclaude-agent-kit.svg)](https://www.npmjs.com/package/@champpaba/claude-agent-kit)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Node.js Version](https://img.shields.io/node/v/@champpaba/claude-agent-kit)](https://nodejs.org)
 
 ---
 
-## 🎯 What is this?
+## What is this?
 
-**Claude Agent Kit picks up where OpenSpec planning ends.**
-
-While OpenSpec handles **alignment** (Draft Proposal → Review & Align), Claude Agent Kit handles **implementation** (Implement Tasks → Archive & Update) with specialized AI agents.
-
-### The Complete Workflow
+**Claude Agent Kit** turns OpenSpec plans into working code using 6 specialized AI agents.
 
 ```
-┌─────────────────────────────────────────────────────────────┐
-│                    OpenSpec Planning                        │
-│  (Spec-Driven Development for AI Coding Assistants)        │
-└─────────────────────────────────────────────────────────────┘
-                            ↓
-              Generates: proposal.md + tasks.md
-                            ↓
-┌─────────────────────────────────────────────────────────────┐
-│              Claude Agent Kit Implementation                │
-│         (Multi-Agent Execution with 6 Specialists)          │
-└─────────────────────────────────────────────────────────────┘
-                            ↓
-              Completes: All tasks with quality gates
-```
-
----
-
-## 🔄 How They Work Together
-
-| Stage | Tool | What Happens | Output |
-|-------|------|--------------|--------|
-| **1. Draft Proposal** | OpenSpec | Human requests change, AI scaffolds structure | `proposal.md` + `tasks.md` |
-| **2. Review & Align** | OpenSpec | Team iterates until consensus | Approved specs |
-| **2.5. Page Planning** | **Claude Agent Kit** | *(UI tasks only)* Generate content & component plan | `page-plan.md` |
-| **3. Setup Context** | **Claude Agent Kit** | Classify tasks, generate workflow | `workflow.md` |
-| **4. Implement Tasks** | **Claude Agent Kit** | 6 specialized agents execute work | Working code + tests |
-| **5. Archive & Update** | OpenSpec | Merge changes back to specs | Updated `specs/` |
-
-### What OpenSpec Generates
-
-**proposal.md** - Business case and scope
-```markdown
-# Change Proposal: User Authentication System
-
-## Motivation
-Users need secure login functionality...
-
-## Scope
-- Email/password authentication
-- JWT token generation
-- Protected routes middleware
-```
-
-**tasks.md** - Implementation checklist
-```markdown
-## Database Setup
-- [ ] Create User model with email, password fields
-- [ ] Add unique constraint on email
-
-## Backend Implementation
-- [ ] POST /api/auth/login endpoint
-- [ ] Password hashing with bcrypt
-- [ ] JWT token generation
-
-## Frontend Implementation
-- [ ] Login form component
-- [ ] Form validation
-- [ ] Token storage
+OpenSpec Planning → proposal.md + tasks.md
+                          ↓
+Claude Agent Kit → 6 agents execute in phases → Working code + tests
 ```
 
-### What Claude Agent Kit Does
-
-**Input:** Reads `proposal.md` + `tasks.md` from OpenSpec
-
-**Process:**
-1. `/pageplan` *(UI tasks only)* - Generate content & component reuse plan
-2. `/csetup {change-id}` - Analyze tasks, classify by agent, generate workflow
-3. `/cdev {change-id}` - Execute with 6 specialized agents in phases:
-   - **Phase 1:** UI with mock data (uxui-frontend)
-   - **Phase 2:** Real API + database (backend + database, parallel)
-   - **Phase 2.5:** Validate contracts (integration)
-   - **Phase 3:** Connect UI to API (frontend)
-   - **Phase 4:** Tests + bug fixes (test-debug)
-
-**Output:** Working implementation ready for review
-
 ---
 
-## 🎨 NEW: Page Planning for UI Tasks
-
-**Problem:** Before `/pageplan`, agents would:
-- ❌ Create duplicate components (3 different Navbar components!)
-- ❌ Use inconsistent colors (`#0d7276` on landing, `#4f46e5` on dashboard)
-- ❌ Generate lorem ipsum instead of real content
-- ❌ Waste time searching for components during implementation
-
-**Solution:** `/pageplan` command analyzes BEFORE implementing
-
-### How It Works
-
-```bash
-# Step 1: OpenSpec generates tasks
-User: "Build landing page for TOEIC app"
-→ Creates: openspec/changes/landing-page/proposal.md + tasks.md
-
-# Step 2: Generate page plan (NEW!)
-User: /pageplan @prd.md @project_brief.md
-
-# What it does:
-# 1. Reads user-specified files (PRD, brief)
-# 2. Reads proposal.md (technical architecture)
-# 3. Reads STYLE_GUIDE.md (visual design)
-# 4. Searches existing components (Navbar, Footer, etc.)
-# 5. AI drafts real content from PRD
-# 6. Generates: openspec/changes/landing-page/page-plan.md
-```
-
-### page-plan.md Output
-
-```markdown
-# Page Plan: Landing Page
-
-## 1. Component Plan
-🔄 Reuse: Navbar, Footer (found in codebase)
-✅ New Shared: (none)
-✅ New Specific: HeroSection, FeatureGrid, TestimonialCarousel
-
-## 2. Page Structure
-<Layout>
-  <Navbar /> {/* Reuse */}
-  <HeroSection /> {/* New - see content below */}
-  <FeatureGrid />
-  <TestimonialCarousel />
-  <Footer /> {/* Reuse */}
-</Layout>
-
-## 3. Assets to Prepare
-- [ ] hero-image.jpg (1920x1080)
-- [ ] logo.svg (200x60)
-- [ ] feature-icons (3x 24x24 SVG)
-
-## 4. Content Draft (AI-Generated - Please Review & Edit)
-**Headline:** "Master TOEIC with AI-Powered Tests"
-**Subheadline:** "Experience exam-quality questions with instant AI scoring"
-**CTA:** "Start Free Test"
-
-**Features:**
-- Real TOEIC-style questions
-- Instant AI scoring
-- Progress tracking dashboard
-```
-
-### Step 3: User Prepares
-
-- ✅ Review content draft (edit as needed)
-- ✅ Prepare assets (images, icons)
-- ✅ Approve `page-plan.md`
-
-### Step 4: Implementation
-
-```bash
-/csetup landing-page
-/cdev landing-page
-
-# uxui-frontend agent automatically:
-# - STEP 0.5: Reads page-plan.md ✅
-# - STEP 3: SKIP component search (already done!) ⚡ 25% faster
-# - Uses: Real content from page-plan
-# - Reuses: Navbar, Footer (no duplicates)
-# - Creates: HeroSection, FeatureGrid, TestimonialCarousel
-# - Applies: Colors/spacing from STYLE_GUIDE.md
-```
-
-### Benefits
-
-| Before (No page-plan) | After (With page-plan) |
-|----------------------|------------------------|
-| ❌ Agent searches during implementation | ✅ Search done once upfront (25% faster) |
-| ❌ Duplicate components created | ✅ Clear reuse plan |
-| ❌ Lorem ipsum content | ✅ Real content from PRD |
-| ❌ Missing assets mid-work | ✅ Asset checklist prepared |
-| ❌ Inconsistent design | ✅ Synced with STYLE_GUIDE |
-| ❌ Agent guesses structure | ✅ Clear component hierarchy |
-
-### When to Use /pageplan
-
-```
-✅ Use for:
-- Landing pages
-- Dashboards
-- Multi-section UI pages
-- Any task with multiple components
-
-❌ Skip for:
-- Backend API endpoints
-- Database schemas
-- Single-component tasks
-- Non-UI work
-```
-
----
-
-## 🤖 The 6 Specialized Agents
-
-| Agent | Color | Responsibility | Phase |
-|-------|-------|---------------|-------|
-| **uxui-frontend** | 🔵 Blue | Design UI components with mock data | 1 |
-| **backend** | 🟣 Purple | Create API endpoints with validation | 2 |
-| **database** | 🩷 Pink | Design schemas, migrations, queries | 2 |
-| **integration** | 🟠 Orange | Validate API contracts before connecting | 2.5 |
-| **frontend** | 🟢 Green | Connect UI to backend APIs | 3 |
-| **test-debug** | 🔴 Red | Run tests and fix bugs (max 3-4 iterations) | 1,3,4 |
-
-Each agent:
-- ✅ Auto-discovers your project context (tech stack, best practices)
-- ✅ Follows framework-specific patterns from Context7 MCP
-- ✅ Maintains design consistency across the codebase
-- ✅ Reports progress with detailed logging
-- ✅ **Smart auto-proceed:** Eliminates double confirmations when user approves workflow
-
----
-
-## 📦 Installation
+## Quick Start
 
 ```bash
+# Install
 npm install -g @champpaba/claude-agent-kit
-```
-
-### Alternative Package Managers
 
-```bash
-# Using pnpm
-pnpm add -g @champpaba/claude-agent-kit
+# Initialize in your project
+cd your-project
+cak init
 
-# Using yarn
-yarn global add @champpaba/claude-agent-kit
+# Use in Claude Code
+/csetup my-feature    # Setup change context
+/cdev my-feature      # Execute with agents
+/cstatus my-feature   # Check progress
 ```
 
 ---
 
-## 🚀 Quick Start (with OpenSpec)
-
-### Step 1: OpenSpec Planning
-
-```bash
-# In your OpenSpec-enabled project
-cd my-app
-
-# Draft a change proposal (OpenSpec handles this)
-"I want to build a landing page for my TOEIC app"
-# → Generates: openspec/changes/landing-page/proposal.md + tasks.md
-```
-
-### Step 2: Initialize Claude Agent Kit
-
-```bash
-# Initialize the agent system
-cak init
-```
-
-### Step 3: Generate Page Plan (UI tasks only)
+## The 6 Agents
 
-```bash
-# In Claude Code:
-/pageplan @prd.md @project_brief.md
-
-# → Generates: openspec/changes/landing-page/page-plan.md
-# → Review content, prepare assets
-```
-
-### Step 4: Setup Change Context
+| Agent | Phase | Responsibility |
+|-------|-------|----------------|
+| **uxui-frontend** | 1 | UI components with mock data |
+| **backend** | 2 | API endpoints |
+| **database** | 2 | Schemas, migrations |
+| **integration** | 2.5 | Validate API contracts |
+| **frontend** | 3 | Connect UI to APIs |
+| **test-debug** | 4 | Tests and bug fixes |
 
-```bash
-/csetup landing-page
-```
+---
 
-**What happens:**
-- Reads `openspec/changes/landing-page/proposal.md` (business context)
-- Reads `openspec/changes/landing-page/tasks.md` (implementation checklist)
-- Reads `openspec/changes/landing-page/page-plan.md` (if exists - content plan)
-- Classifies tasks by agent (database, backend, frontend, etc.)
-- Generates `workflow.md` (execution plan)
+## Commands
 
-### Step 5: Execute Implementation
+### CLI Commands
 
 ```bash
-/cdev landing-page
+cak init              # Initialize template
+cak update --backup   # Update to latest version
 ```
 
-**What happens:**
-1. **Phase 1:** uxui-frontend reads `page-plan.md` → creates UI with real content
-2. **Phase 2:** backend + database create APIs + models (parallel, if needed)
-3. **Phase 2.5:** integration validates API contracts
-4. **Phase 3:** frontend connects UI to APIs (if needed)
-5. **Phase 4:** test-debug runs tests, fixes bugs
+### Slash Commands (in Claude Code)
 
-### Step 6: Monitor Progress
-
-```bash
-# View detailed progress
-/cview landing-page
-
-# Quick status check
-/cstatus landing-page
-# → Phase 1/4 - UI Implementation (100%)
-```
+| Command | Description |
+|---------|-------------|
+| `/designsetup` | Generate style guide (one-time) |
+| `/pageplan @prd.md` | Generate UI page plan |
+| `/csetup {id}` | Setup change context |
+| `/cdev {id}` | Execute with agents |
+| `/cview {id}` | Detailed progress |
+| `/cstatus {id}` | Quick status |
+| `/pstatus` | Update project status |
 
 ---
 
-## 🎯 Complete Workflow Examples
+## Cross-Session Context (v2.1.0)
 
-### Workflow A: UI Feature (with /pageplan)
+`PROJECT_STATUS.yml` helps Claude remember project state between sessions:
 
-```bash
-# 1. OpenSpec Planning
-User: "Build landing page for TOEIC app"
-→ Creates: proposal.md + tasks.md
+```yaml
+# PROJECT_STATUS.yml
+current_focus:
+  description: "Building auth system"
+  active_change: auth-system
 
-# 2. Page Planning (NEW!)
-/pageplan @prd.md @project_brief.md
-→ Creates: page-plan.md
-→ User reviews content & prepares assets
+infrastructure:
+  database: { status: healthy }
+  api: { status: healthy }
 
-# 3. Setup Context
-/csetup landing-page
-→ Reads: proposal.md, tasks.md, page-plan.md
-→ Generates: workflow.md
+blockers:
+  - id: domain-config
+    description: "Need domain for Cloudflare"
+    blocks: [production-launch]
 
-# 4. Implementation
-/cdev landing-page
-→ uxui-frontend reads page-plan.md (STEP 0.5)
-→ Skips redundant component search
-→ Uses real content + reuse plan
-→ 25% faster implementation
-
-# 5. Monitor
-/cview landing-page
+next_priorities:
+  - id: payment-integration
+    reason: "Revenue blocker"
 ```
 
-### Workflow B: Backend Feature (skip /pageplan)
-
-```bash
-# 1. OpenSpec Planning
-User: "Add payment processing API"
-→ Creates: proposal.md + tasks.md
-
-# 2. Setup Context (skip /pageplan - not UI work)
-/csetup payment-api
-
-# 3. Implementation
-/cdev payment-api
-→ Phase 2: backend + database agents (parallel)
-→ Phase 2.5: integration validates contracts
-→ Phase 3: frontend connects (if UI exists)
-→ Phase 4: test-debug validates
-
-# 4. Monitor
-/cview payment-api
-```
-
-### Workflow C: Full-Stack Feature (with /pageplan)
-
-```bash
-# 1. OpenSpec Planning
-User: "Build user authentication system"
-→ Creates: proposal.md + tasks.md
-
-# 2. Page Planning (for login UI only)
-/pageplan @prd.md
-→ Creates: page-plan.md (login form content + components)
-
-# 3. Setup Context
-/csetup auth-system
-
-# 4. Implementation
-/cdev auth-system
-→ Phase 1: uxui-frontend (login form, reads page-plan.md)
-→ Phase 2: backend (POST /api/auth/login) + database (User model)
-→ Phase 2.5: integration (validate contract)
-→ Phase 3: frontend (connect form to API)
-→ Phase 4: test-debug (E2E tests)
-
-# 5. Monitor
-/cview auth-system
-```
+Created by `cak init` (optional). Update with `/pstatus`.
 
 ---
 
-## 📁 Project Structure After Init
+## Project Structure
 
 ```
 your-project/
+├── PROJECT_STATUS.yml          # Cross-session context (optional)
 ├── openspec/
-│   ├── specs/                       # Source of truth (OpenSpec)
-│   └── changes/
-│       └── landing-page/
-│           ├── proposal.md          ← OpenSpec generates
-│           ├── tasks.md             ← OpenSpec generates
-│           ├── page-plan.md         ← /pageplan generates (UI tasks)
-│           ├── workflow.md          ← /csetup generates
-│           └── flags.json           ← /cdev tracks progress
-│
+│   └── changes/{id}/
+│       ├── proposal.md         # From OpenSpec
+│       ├── tasks.md            # From OpenSpec
+│       └── page-plan.md        # From /pageplan
 ├── design-system/
-│   └── STYLE_GUIDE.md               ← /designsetup generates
-│
+│   └── STYLE_GUIDE.md          # From /designsetup
 └── .claude/
-    ├── CLAUDE.md                    # Navigation guide
-    │
-    ├── agents/                      # 6 specialized agents
-    │   ├── 01-integration.md
-    │   ├── 02-uxui-frontend.md
-    │   ├── 03-test-debug.md
-    │   ├── 04-frontend.md
-    │   ├── 05-backend.md
-    │   └── 06-database.md
-    │
-    ├── commands/                    # Slash commands
-    │   ├── designsetup.md           # Generate style guide
-    │   ├── pageplan.md              # Generate page plan
-    │   ├── csetup.md                # Change setup (v1.8.0: includes best-practices)
-    │   ├── cdev.md                  # Change development
-    │   ├── cview.md                 # View progress
-    │   └── cstatus.md               # Quick status
-    │
-    ├── contexts/
-    │   ├── design/                  # Design foundation
-    │   ├── patterns/                # Universal patterns
-    │   └── domain/                  # Project context
-    │
-    └── lib/                         # Implementation logic
-        ├── agent-executor.md
-        ├── tdd-classifier.md
-        ├── flags-updater.md
-        └── agent-router.md
-```
-
----
-
-## 🎯 Why Use Claude Agent Kit?
-
-### Without Claude Agent Kit (Manual Implementation)
-
-```
-❌ You manually interpret tasks.md
-❌ You context-switch between frontend/backend/database
-❌ You might forget edge cases or tests
-❌ Inconsistent code patterns across features
-❌ No systematic error handling
-❌ Duplicate components everywhere
-❌ Lorem ipsum content in UI
-```
-
-### With Claude Agent Kit
-
-```
-✅ Agents auto-classify and execute tasks
-✅ Each agent focuses on its specialty
-✅ Built-in validation gates (integration agent)
-✅ Consistent patterns via auto-discovery
-✅ Automatic retry with escalation
-✅ Component reuse plan (/pageplan)
-✅ Real content from PRD
-✅ 25% faster UI implementation
-```
-
----
-
-## 📚 Key Features
-
-### ✅ Seamless OpenSpec Integration
-
-- Reads `proposal.md` for business context
-- Parses `tasks.md` for implementation checklist
-- Generates `page-plan.md` for UI tasks (NEW!)
-- Tracks progress in `flags.json`
-- Updates completion status back to OpenSpec
-
-### ✅ Auto-Generated Best Practices (v1.8.0)
-
-Uses Context7 MCP to fetch latest framework docs **automatically during `/csetup`**:
-
-```bash
-/csetup my-feature
-# → Auto-detects: Next.js 15, React 18, Prisma 6
-# → Auto-generates: .claude/contexts/domain/project/best-practices/
-#    - nextjs.md
-#    - react.md
-#    - prisma.md
-# → Agents MUST read these before coding (validated)
-```
-
-### ✅ 3-Level Project Indexing
-
-Agents auto-discover context:
-
-```
-1. Read: domain/index.md → Get current project
-2. Read: domain/{project}/README.md → Get tech stack
-3. Read: domain/{project}/best-practices/index.md → Load patterns
-```
-
-### ✅ Design Foundation
-
-Universal design principles:
-- Color theory (WCAG AAA contrast)
-- Typography scales
-- 8px spacing grid (8, 16, 24, 32, 40, 48px)
-- 4-level shadow system
-- Box thinking framework
-- Accessibility (WCAG 2.1 AA)
-
-### ✅ Quality Gates
-
-- **TDD for critical paths** (auth, payments, data transforms)
-- **Test-alongside for simple code** (CRUD, UI components)
-- **Max 3-4 retry iterations** before escalation
-- **Integration validation** before connecting UI to API
-- **Smart auto-proceed** (eliminate redundant confirmations, 25% faster)
-
----
-
-## 🔧 CLI Commands
-
-### `cak init`
-Initialize agent system in current project
-
-```bash
-cak init
-cak init --force  # Overwrite existing .claude/
-```
-
-**Creates:**
-- `.claude/` folder with 6 agents
-- Slash commands (`/psetup`, `/csetup`, `/cdev`, etc.)
-- Universal patterns & design foundation
-
----
-
-### `cak update`
-Update to latest agent templates
-
-```bash
-cak update
-cak update --backup  # Create .claude.backup/ first
-```
-
-**What it does:**
-- Updates all template files to latest version
-- Preserves your customizations in `domain/`
-- Creates backup before updating (with `--backup` flag)
-
----
-
-### `cak --version`
-Show version number
-
-```bash
-cak --version
-# → 1.0.0
-```
-
----
-
-### `cak --help`
-Display help information
-
-```bash
-cak --help
-```
-
----
-
-## 🔄 Workflow Commands (in Claude Code)
-
-### `/designsetup` - Generate style guide (one-time)
-
-```bash
-/designsetup
-```
-
-**Auto-detects from:**
-1. `reference/` folder → Extract design from HTML/screenshots
-2. Existing codebase → Reverse engineer patterns
-3. AI generation → Modern best practices
-
-**Creates:** `design-system/STYLE_GUIDE.md`
-
----
-
-### `/pageplan` - Generate page plan (UI tasks only) 🆕
-
-```bash
-/pageplan @prd.md @project_brief.md
-```
-
-**What it does:**
-- Reads user-specified files (PRD, brief)
-- Reads `proposal.md` + `STYLE_GUIDE.md`
-- Searches existing components
-- AI drafts real content from PRD
-- Generates asset checklist
-
-**Creates:** `page-plan.md`
-- Component reuse plan (🔄 Reuse vs ✅ New)
-- Page structure (component hierarchy)
-- Assets to prepare (images, icons)
-- Content draft (headlines, descriptions)
-
----
-
-### `/csetup {change-id}` - Setup change context (v1.8.0)
-
-```bash
-/csetup landing-page
-```
-
-**What it does (v1.8.0 - now includes best practices setup):**
-- Reads `proposal.md` (business context)
-- Reads `tasks.md` (implementation checklist)
-- Reads `design.md` (architecture, if exists)
-- Reads `page-plan.md` (if exists - UI content plan)
-- **Auto-detects tech stack** from package.json, design.md, proposal
-- **Auto-generates best practices** from Context7 MCP (replaces `/psetup`)
-- Classifies tasks by agent
-- Generates `workflow.md` (execution plan)
-
----
-
-### `/cdev {change-id}` - Execute implementation
-
-```bash
-/cdev landing-page
-
-# Or with explicit approval
-"ลุยเลย"  # Continue without confirmation prompts
+    ├── agents/                 # 6 specialized agents
+    ├── commands/               # Slash commands
+    └── contexts/               # Patterns & domain context
 ```
 
-**What it does:**
-- Runs agents in phases (1 → 2 → 2.5 → 3 → 4)
-- uxui-frontend auto-reads `page-plan.md` (STEP 0.5)
-- **Auto-proceed:** Detects user approval ("continue", "ลุยเลย") and eliminates redundant confirmation prompts
-- Updates `flags.json` (progress tracking)
-- Reports completion status
-
-**Auto-Proceed Feature:**
-- When you say "continue", "proceed", "yes", or "ลุยเลย", Main Claude auto-responds to agent questions
-- **50-90% fewer confirmations** (1x per workflow instead of 2x per phase)
-- **25% faster execution** (no waiting for redundant approvals)
-
 ---
 
-### `/cview {change-id}` - View detailed progress
+## Key Features
 
-```bash
-/cview landing-page
-```
-
-**Shows:**
-- Completed/pending tasks
-- Agent activity log
-- Current phase
-- Error messages (if any)
+- ✅ **6 Specialized Agents** - Each focused on its domain
+- ✅ **Auto Best Practices** - Context7 MCP integration
+- ✅ **Design System** - Consistent UI via tokens.json
+- ✅ **Page Planning** - Component reuse, real content
+- ✅ **Progress Tracking** - flags.json, /cstatus, /cview
+- ✅ **Cross-Session Context** - PROJECT_STATUS.yml
 
 ---
 
-### `/cstatus {change-id}` - Quick status
+## Workflow Example
 
 ```bash
-/cstatus landing-page
-# → Phase 2/4 - Backend Implementation (75%)
-```
+# 1. OpenSpec creates: proposal.md + tasks.md
 
----
-
-## 🎨 Design System Integration
-
-### Auto-Generate Style Guide
-
-```bash
+# 2. Setup (optional design + page plan)
 /designsetup
-```
-
-**Detection priority:**
-1. **reference/ folder** (HTML/screenshots) → Extract design style
-2. **Existing codebase** (>10 components) → Reverse engineer patterns
-3. **AI generation** → Modern best practices
-
-**Output:** `design-system/STYLE_GUIDE.md`
-
-**17 Comprehensive Sections:**
-1. Overview
-2. Design Philosophy
-3. Color Palette (HEX codes, usage, Tailwind classes)
-4. Typography (headings, body, weights)
-5. Spacing System (4px/8px grid)
-6. Component Styles (Button, Card, Input, Badge, etc.)
-7. Shadows & Elevation
-8. Animations & Transitions
-9. Border Styles
-10. Border Radius
-11. Opacity & Transparency
-12. Z-Index Layers
-13. Responsive Breakpoints
-14. CSS Variables / Tailwind Theme (Design Tokens)
-15. Layout Patterns
-16. Example Component Reference (React + Tailwind code)
-17. Additional Sections (Best Practices, Accessibility, Icon System)
-
-**Agents automatically use `STYLE_GUIDE.md` for:**
-- Color palette (no hardcoded colors)
-- Spacing scale (consistent gaps/padding)
-- Typography (font hierarchy)
-- Component patterns (reuse before create)
-
----
-
-## 🧪 Testing Philosophy
-
-**Agents follow TDD classification:**
-
-| Code Type | Approach | Example |
-|-----------|----------|---------|
-| **Critical paths** | TDD (Red-Green-Refactor) | Auth logic, payments, calculations |
-| **Simple code** | Test-alongside | CRUD, UI components, config |
-
-**Test-debug agent:**
-- Runs tests automatically after implementation
-- Fixes bugs (max 3-4 iterations)
-- Escalates if stuck (reports to user)
-
----
-
-## 🔧 Supported Tech Stacks
-
-Agents auto-detect your stack via Context7 MCP:
-
-**Frontend:**
-- Next.js, React, Vue, Svelte, Angular
-
-**Backend:**
-- FastAPI, Express, NestJS, Django, Flask, Next.js API Routes
-
-**Database:**
-- Prisma, SQLAlchemy, TypeORM, Drizzle
-
-**Testing:**
-- Vitest, Jest, Pytest, Playwright
-
----
-
-## 📖 Usage Examples
-
-### Example 1: Simple UI Task (with /pageplan)
-
-```bash
-# In Claude Code
-"Build a user profile page with edit functionality"
-
-# If it's a UI task, optionally run:
 /pageplan @prd.md
 
-# Then execute:
-/csetup profile-page
-/cdev profile-page
-```
-
-Claude will:
-1. Read `task-classification.md`
-2. Select agents: `uxui-frontend` → `backend` → `frontend` → `test-debug`
-3. uxui-frontend reads `page-plan.md` (if exists)
-4. Execute in sequence
-5. Report completion
-
----
-
-### Example 2: Complex Multi-Agent Workflow (OpenSpec)
-
-Using OpenSpec workflow:
-
-```bash
-# 1. OpenSpec generates proposal + tasks
-"I want to add a dashboard with analytics"
-# → proposal.md + tasks.md created
-
-# 2. Generate page plan
-/pageplan @prd.md @analytics_spec.md
-
-# 3. Setup change context
-/csetup analytics-dashboard
-
-# 4. Start development
-/cdev analytics-dashboard
-
-# 5. View progress
-/cview analytics-dashboard
-```
-
-This follows a structured 4-phase approach:
-1. **Phase 1:** UI with mock data (uxui-frontend reads page-plan.md)
-2. **Phase 2:** Real API + database (backend + database)
-3. **Phase 2.5:** Validate contracts (integration)
-4. **Phase 3:** Connect UI to API (frontend)
-5. **Phase 4:** Tests + bug fixes (test-debug)
-
----
-
-## 🔄 Updating to Latest Version
-
-### Method 1: Update the npm package
-
-```bash
-npm update -g @champpaba/claude-agent-kit
-```
-
-### Method 2: Update template in project
-
-```bash
-cd your-project
-cak update --backup
-```
-
-This will:
-- Create backup at `.claude.backup/`
-- Update all template files
-- Preserve your customizations in `domain/`
-
----
-
-## 🎯 Customization
-
-### Add Project-Specific Context
-
-After running `cak init`, add your own context files:
-
-```bash
-mkdir -p .claude/contexts/domain/my-project
-```
-
-**Example:** E-commerce checkout flow
-```markdown
-<!-- .claude/contexts/domain/my-project/checkout-flow.md -->
-# Checkout Flow
-
-## Steps
-1. Cart review
-2. Shipping address
-3. Payment method
-4. Order confirmation
-
-## Business Rules
-- Free shipping over $50
-- Tax calculation by state
-- Inventory check before payment
-```
-
-Agents will auto-discover and use these patterns.
-
----
-
-## 🔗 Ecosystem
-
-**Claude Agent Kit works with:**
-
-| Tool | Purpose | Integration |
-|------|---------|-------------|
-| **OpenSpec** | Spec-driven planning | Reads `proposal.md` + `tasks.md` |
-| **Context7 MCP** | Always-updated docs | Auto-generates best practices |
-| **Claude Code** | AI coding assistant | Execution environment |
-
----
-
-## 🤝 Contributing
-
-We welcome contributions!
-
-- Report bugs: [GitHub Issues](https://github.com/ChampPABA/claude-multi-agent-template/issues)
-- Feature requests: [Discussions](https://github.com/ChampPABA/claude-multi-agent-template/discussions)
-- Pull requests: Follow [CONTRIBUTING.md](CONTRIBUTING.md)
-
----
-
-## 📄 License
-
-MIT License - see [LICENSE](LICENSE)
-
----
-
-## 🙏 Credits
-
-Built with:
-- [OpenSpec](https://github.com/Fission-AI/OpenSpec) - Spec-driven development framework
-- [Claude Code](https://claude.com/claude-code) - AI coding assistant
-- [Context7 MCP](https://context7.com) - Always up-to-date library docs
-
----
-
-## 🆕 What's New in v2.0.0
-
-**Two Major Improvements:** Claude 4.5 Optimization + Design System v2.0 🚀🎨
-
-### Part 1: Claude 4.5 Optimization
-
-1. **Claude 4.5 Best Practices** - All files refactored for better AI comprehension
-2. **Professional Tone** - Replaced aggressive language with respectful instructions
-3. **Positive Instructions** - "Use X" instead of "Don't do Y" with WHY explanations
-4. **Token Reduction** - Agent files ~65% smaller + 30 supporting files optimized
-5. **Shared Components** - New `.claude/agents/_shared/` folder prevents duplication
-
-### Tone Calibration
-
-| Before | After | WHY |
-|--------|-------|-----|
-| "MUST", "WILL BE REJECTED" | Professional tone | Claude 4.5 works better with respectful instructions |
-| "Don't do X", "Never Y" | "Use X instead" | Positive instructions are clearer |
-| "🚨 CRITICAL!", "🚫 Forbidden" | "📋 Guidelines", "⚠️ Note" | Less aggressive, same clarity |
-| Rules without context | Rules with WHY | Claude applies rules more intelligently |
-
-### New Shared Components
-
-```
-.claude/agents/_shared/
-├── pre-work-checklist.md     # Common validation steps
-├── package-manager.md        # Package manager protocol
-├── documentation-policy.md   # What files to create
-├── agent-boundaries.md       # When to use which agent
-└── README.md                 # Overview
-```
-
-### Token Savings (Agents)
-
-| Agent | Before | After | Reduction |
-|-------|--------|-------|-----------|
-| uxui-frontend | ~1037 | ~375 | 64% |
-| integration | ~600 | ~210 | 65% |
-| backend | ~700 | ~244 | 65% |
-| database | ~680 | ~273 | 60% |
-| frontend | ~650 | ~296 | 54% |
-| test-debug | ~580 | ~252 | 57% |
-| **Total** | **~4247** | **~1650** | **61%** |
-
-Plus ~500 tokens in shared files = **~2150 total** (was ~4247)
-
-### Part 2: Design System v2.0
-
-**Complete overhaul of design system with interactive setup, theme selection, and smart page planning.**
-
-### New Design System Features
-
-- 🎯 **`/extract`** - Multi-URL design extraction with style detection
-- 🎭 **`/designsetup`** - Interactive 3-round loop with theme recommendations
-- 📦 **`tokens.json`** - Enhanced design tokens with style/theme/animations (~800 tokens)
-- 📝 **`patterns/*.md`** - Selective code patterns (buttons, cards, forms, scroll-animations, decorations)
-- 🔍 **Auto Page Type Detection** - `/pageplan` auto-detects landing/dashboard/auth
-
-### Page Type Handling
-
-| Page Type | Decorations | Scroll Anims | Buyer Avatar | Patterns Loaded |
-|-----------|-------------|--------------|--------------|-----------------|
-| Landing/Marketing | ✅ Full | ✅ Enabled | ✅ Enabled | buttons, cards, scroll-anims, decorations |
-| Dashboard/Admin | ❌ Minimal | ❌ Disabled | ❌ Skipped | buttons, cards, forms |
-| Auth (Login/Register) | ❌ None | ❌ Disabled | ❌ Skipped | buttons, forms |
-
-### Design System Token Savings
-
-| Approach | Tokens | Improvement |
-|----------|--------|-------------|
-| Old: Full STYLE_GUIDE.md | ~5000 | - |
-| New: tokens.json + selective patterns | ~800-1200 | **84%** |
-
-### Files Refactored (36 total)
-
-- **6 agent files** - Professional tone, positive instructions
-- **6 lib files** - WHY explanations, table formats
-- **4 command files** - Softer language, guidelines
-- **11 pattern files** - "⚠️ Common Mistakes" instead of "🚨 Critical"
-- **3 design files** - "should check" instead of "MUST check"
-- **3 template files** - Table with WHY
-- **3 other lib files** - Consistent formatting
-
-### Best Practices Applied (Claude 4 Guidelines)
-
-1. **Tone Calibration** - Professional, direct (not aggressive)
-2. **Action Orientation** - Explicit "Write code" vs "Consider"
-3. **Prevent Overengineering** - Clear boundaries
-4. **Encourage Exploration** - Read before implementing
-5. **Rich Output When Needed** - Specify requirements
-6. **Context for Rules** - Explain WHY
-7. **Positive Instructions** - "Use X" not "Don't Y"
-
----
-
-## 📋 What's New in v1.7.1
-
-**Patch: OpenSpec File Naming Conventions - Clarify design.md vs STYLE_GUIDE.md** 📁
-
-### The Issue
-
-Users were confused between two files with similar names:
-- `design.md` (from OpenSpec) = Technical/Architecture decisions
-- `STYLE_GUIDE.md` (from Template) = Visual design (colors, fonts, spacing)
-
-### The Fix
-
-Added clear documentation in CLAUDE.md and agent-discovery.md:
-
-| Source | File | Purpose |
-|--------|------|---------|
-| **OpenSpec** | `design.md` | Technical Architecture (API structure, data flow) |
-| **Template** | `STYLE_GUIDE.md` | Visual Design (colors, typography, spacing) |
-
-### Updated Files
-
-- `CLAUDE.md` - New "📁 File Naming Conventions" section
-- `agent-discovery.md` - Added notes explaining design.md vs STYLE_GUIDE.md
-
-### No Breaking Changes
-
-All existing workflows continue to work. This is a documentation improvement only.
-
----
-
-## 📋 What's New in v1.7.0
-
-**Feature: Opus 4.5 Model Upgrade - All Subagents Now Use Latest Claude Model** 🧠
-
-### The Change
-
-All 6 specialized agents now use **Claude Opus 4.5** (the latest and most capable Claude model) instead of Haiku:
-
-| Agent | Model (Before) | Model (After) |
-|-------|----------------|---------------|
-| integration | haiku | **opus** |
-| uxui-frontend | haiku | **opus** |
-| test-debug | haiku | **opus** |
-| frontend | haiku | **opus** |
-| backend | haiku | **opus** |
-| database | haiku | **opus** |
-
-### Benefits
-
-- ✅ **Best-in-class reasoning** - Opus 4.5 handles complex multi-step tasks better
-- ✅ **Improved code quality** - More accurate implementations with fewer errors
-- ✅ **Better context understanding** - Agents maintain context over longer sessions
-- ✅ **Enhanced problem-solving** - Complex debugging and architectural decisions improved
-
-### Updated Files
-
-- All agent files (`.claude/agents/*.md`) - `model: opus`
-- `/cdev` command - Model strategy updated
-- `agent-executor.md` - Task invocation uses opus
-
-### No Breaking Changes
-
-All existing workflows continue to work exactly as before, just with better performance!
-
----
-
-## 🔄 What's New in v1.6.0
-
-**Feature: Incremental Testing - Milestone-based Validation for High-Risk Tasks** 🔄
-
-### The Problem: All-or-Nothing Testing
-
-**Before v1.6.0:**
-```
-Task: "Integrate Google Maps API"
-→ Agent implements complete solution (1000 locations)
-→ Tests with full dataset
-→ Bug found → Hard to debug (which part failed?)
-→ Fix → Retest full dataset → Slow iteration
-
-Problem:
-❌ Large scope = hard to debug
-❌ Late bug detection (at scale)
-❌ Rework expensive (threw away 1000-location implementation)
-❌ No confidence in progressive scaling
-```
-
-**After v1.6.0:**
-```
-Task: "Integrate Google Maps API"
-→ Milestone 1: Test 1 location (hardcoded)
-   → Bug found → Easy to debug (small scope)
-   → Fix → Retest 1 location → Fast iteration
-→ Milestone 2: Test 10 locations (parameterized)
-   → Works! Confidence++
-→ Milestone 3: Error handling
-   → Refine edge cases
-→ Milestone 4: Scale to 1000
-   → Already confident (1 and 10 worked)
-
-Benefits:
-✅ Small scope = easy debugging
-✅ Early bug detection (at milestone 1)
-✅ Low rework (fix before scaling)
-✅ Progressive confidence
-```
-
-### The Solution: Milestone-based Validation
-
-**Automatic Detection:** `/csetup` detects high-risk tasks automatically
-- Risk = HIGH (payment, auth, security)
-- Risk = MEDIUM + Complexity ≥ 7 (complex forms)
-- External API dependency (Google Maps, Stripe, OpenAI)
-- Data-intensive operation (ETL, migration, batch processing)
-
-**3 Milestone Patterns:**
-
-1. **Backend API Integration** (4 milestones)
-   - M1: Core implementation (1 record, hardcoded)
-   - M2: Parameterized query (10 records, dynamic)
-   - M3: Error handling (invalid input, timeouts)
-   - M4: Scale + performance (100-1000 records)
-
-2. **Complex Form** (3 milestones)
-   - M1: Architecture + skeleton (2-3 critical fields)
-   - M2: E2E flow validation (submit → API → DB)
-   - M3: Complete all fields (all 20 fields + validation)
-
-3. **Database Migration / ETL** (3 milestones)
-   - M1: Dry-run (10 records)
-   - M2: Scale to 100 records
-   - M3: Full dataset (staging)
-
-### Round-based Retry Logic
-
-**Per-Milestone Quota:**
-- **2 attempts per round** (not total)
-- **Unlimited rounds** (Main Claude decides when to stop)
-- **Hints reset quota** (fresh start)
-
-**Example:**
-```
-Milestone 1: Core implementation
-→ Round 1: Attempt 1 ❌ (API key missing)
-→ Round 1: Attempt 2 ❌ (Still missing)
-→ Main Claude: "Check API_KEY env variable" 💡
-→ Round 2: Attempt 1 ✅ (Fixed!)
+# 3. Execute
+/csetup my-feature
+/cdev my-feature
 
-Total attempts: 3 (2 in Round 1, 1 in Round 2)
+# 4. Monitor
+/cstatus my-feature
 ```
 
-### Main Claude Intervention
-
-**Decision Matrix:**
-
-| Error Pattern | Complexity | Confidence | Action |
-|---------------|------------|------------|--------|
-| Same error 2x | SIMPLE | HIGH | Give Hints |
-| Same error 2x | COMPLEX | LOW | Ask Human |
-| Different errors | ANY | ANY | Ask Human |
-| Intermittent | ANY | ANY | Ask Human |
-| 2+ rounds no progress | ANY | ANY | Ask Human |
-
-**Pattern-based Hints:**
-- 401 Unauthorized → Check API_KEY, verify key validity
-- Timeout → Increase threshold, check network
-- Schema mismatch → Compare actual vs expected, check API version
-
-### Benefits & Trade-offs
-
-**Benefits:**
-- ✅ **75% faster debug** - Catch bugs at M1 (1 record) vs M4 (1000 records)
-- ✅ **60-70% rework reduction** - Fix before scaling
-- ✅ **80% faster debugging** - Small scope (1 record) vs full dataset
-- ✅ **90% success rate** - Progressive confidence at M4
-- ✅ **40-50% net speedup** - +15-20% time upfront → -60-70% rework time
-
-**Trade-offs:**
-- ⚠️ **Timeline:** +15-20% upfront (but saves 60-70% rework)
-- ⚠️ **Complexity:** phases.md 2-3x longer (summary table at top)
-- ⚠️ **Learning curve:** More coordination (automated by `/csetup`)
-
-**Net benefit:** +15-20% time → -60-70% rework = **40-50% faster overall**
-
-### When to Use Incremental Testing
-
-**✅ Use for:**
-- Payment integration, Auth systems (HIGH risk)
-- Complex forms with 20+ fields (Complexity ≥ 7)
-- External APIs (Google Maps, Stripe, OpenAI)
-- Data migrations, ETL pipelines (data-intensive)
-
-**❌ Skip for:**
-- Simple CRUD operations (LOW risk, Complexity < 5)
-- UI components (standard testing sufficient)
-- Configuration changes (no integration testing needed)
-
-**Detection Rate:** ~20-30% of tasks (only high-risk)
-
 ---
 
-## 🎉 What's New in v1.4.0
-
-**Major Update: Context Optimization & DRY Consolidation**
-
-### Token Efficiency Improvements
-
-**Problem Solved:**
-- Before v1.4.0: Same documentation duplicated across 6 agent files + CLAUDE.md
-- Package Manager warnings: 360 lines duplicated 6x
-- Context Loading Strategy: 1,200 lines duplicated 6x
-- TDD Workflow examples: 1,200 lines duplicated 3x
-- Handoff templates: 900 lines duplicated 6x
-- Documentation policies: 480 lines duplicated 6x
-- CLAUDE.md: 890 lines mixing navigation + detailed guides
-
-**Solution Implemented:**
-- ✅ Created consolidated lib files (context-loading-protocol.md, handoff-protocol.md, tdd-workflow.md)
-- ✅ Extracted detailed guides from CLAUDE.md to lib/detailed-guides/
-- ✅ Applied consistent reference pattern: Brief summary + "→ See: path" + agent-specific additions
-- ✅ Maintained 100% content quality (all information preserved)
+## Changelog
 
-**Results:**
-- **All 6 agents:** 6,796 → 4,749 lines (-2,047, -30.1% reduction)
-- **CLAUDE.md:** 890 → 163 lines (-727, -81.7% reduction)
-- **Grand Total:** 7,686 → 4,912 lines (-2,774, -36.1% reduction)
-- **Token savings:** ~36% reduction in total context size
-- **Speed improvement:** Faster agent loading and execution
-- **Maintainability:** Single source of truth for shared documentation
-
-### New Consolidated Documentation Structure
-
-**Created in v1.4.0:**
-```
-.claude/lib/
-├── context-loading-protocol.md     # Universal context loading strategy
-├── handoff-protocol.md             # Agent handoff templates
-├── tdd-workflow.md                 # TDD workflow examples
-└── detailed-guides/
-    ├── best-practices-system.md    # How best practices work
-    ├── context-optimization.md     # Token optimization strategy
-    ├── page-planning.md            # /pageplan command guide
-    ├── taskmaster-analysis.md      # 6-dimension task analysis
-    ├── design-system.md            # Style guide generation
-    └── agent-system.md             # Agent overview & workflow
-```
-
-### Benefits for Users
-
-**For Developers:**
-- ⚡ 36% faster context loading
-- 📖 Cleaner, easier-to-navigate documentation
-- 🎯 CLAUDE.md is now a pure navigation hub (163 lines)
-- 🔍 Detailed guides are modular and focused
-
-**For Claude Agents:**
-- 🚀 Faster startup (less context to load)
-- 💾 More token budget for actual work
-- 📚 Single source of truth (no conflicting info)
-- 🔄 Easier maintenance (update once, apply everywhere)
-
-### Migration Notes
-
-**No breaking changes!** All existing workflows continue to work:
-- ✅ `/psetup`, `/csetup`, `/cdev` commands unchanged
-- ✅ Agent behavior unchanged (same quality, faster execution)
-- ✅ All features from v1.1-1.3 preserved
-- ✅ Existing projects can update with `cak update`
-
-**New Reference Pattern:**
-Agents now use lightweight references instead of duplicating full documentation:
-
-```markdown
-## Context Loading Strategy
-
-**→ See:** `.claude/lib/context-loading-protocol.md` for complete protocol
-
-**Agent-Specific Additions (frontend):**
-### State Management Libraries
-...
-```
-
-### Upgrading to v1.4.1
-
-```bash
-# Update npm package
-npm update -g @champpaba/claude-agent-kit
-
-# Update template in your project (creates backup)
-cd your-project
-cak update --backup
-```
-
-**What's New:**
-- ✅ Auto-proceed feature (eliminate double confirmations)
-- ✅ 50-90% fewer approval prompts
-- ✅ 25% faster workflow execution
-- ✅ All v1.4.0 features (context optimization, DRY consolidation)
-
-All your customizations in `.claude/contexts/domain/` are preserved!
-
----
-
-## 📜 Changelog
+### v2.1.0 (2025-12-01)
+- Added `PROJECT_STATUS.yml` for cross-session context
+- Added `/pstatus` command
+- `/csetup` reads blockers from PROJECT_STATUS.yml
+- `/cstatus` shows project + change status
 
 ### v2.0.0 (2025-11-30)
-**Major: Claude 4.5 Optimization - Full Template Refactor**
-
-**Added:**
-- Shared components folder `.claude/agents/_shared/`
-- WHY explanations for all rules
-
-**Changed:**
-- All 6 agent files refactored (~65% smaller)
-- 30 supporting files updated for Claude 4.5 best practices
-- "MUST", "CRITICAL" → Professional tone
-- "Don't do X" → "Use Y instead" with WHY
-- "🚨" → "⚠️" throughout
-
-**Benefits:**
-- Better AI comprehension with professional tone
-- 61% token reduction in agent files
-- No duplication (shared components)
-
----
+- Claude 4.5 optimization (61% token reduction)
+- Design System v2.0 (tokens.json, selective patterns)
+- All agents use Opus 4.5 model
 
 ### v1.8.0 (2025-11-26)
-**Major: Token Optimization & Streamlined Workflow**
-
-**Removed:**
-- `/psetup` command - Merged into `/csetup`
-- `/agentsetup` command - Merged into `/csetup`
-- `documentation` phase from all templates
-- `report` phase from all templates
-- Template files: `documentation.md`, `report.md`
-
-**Added:**
-- Auto tech stack detection in `/csetup` (from package.json, design.md, proposal)
-- Auto best-practices generation from Context7 MCP
-- Verbose terminal summary when change completes
-- Temp file auto-cleanup after each phase
-- Best-practices injection in `/cdev` agent prompts
-- Forbidden Files section in code-standards.md
-- Documentation Policy (v1.8.0) in all agents
-
-**Changed:**
-- All templates: Reduced phases (removed doc/report)
-- `/cdev`: Now shows verbose summary instead of creating files
-- All agents: Updated to reference forbidden files policy
-- `agent-executor.md`: Added temp file cleanup logic
-- `agent-discovery.md`: Updated fallback message
-
-**Benefits:**
-- ~25 min saved per change (no doc/report phases)
-- No more temp file clutter
-- Simplified workflow (1 command instead of 2)
-- Better best-practices enforcement (validated)
-
-### v1.7.1 (2025-11-25)
-**Patch: OpenSpec File Naming Conventions**
-
-**Added:**
-- New "📁 File Naming Conventions" section in CLAUDE.md
-- Clear distinction between OpenSpec files and Template files
-- Notes in agent-discovery.md explaining design.md purpose
-
-**Documentation:**
-- `design.md` (OpenSpec) = Technical Architecture (API, data flow)
-- `STYLE_GUIDE.md` (Template) = Visual Design (colors, fonts, spacing)
-- Updated agent reading guidance per role
-
-### v1.7.0 (2025-11-25)
-**Feature: Opus 4.5 Model Upgrade**
-
-**Changed:**
-- All 6 agents upgraded from `model: haiku` to `model: opus`
-- Updated `/cdev` model strategy description
-- Updated `agent-executor.md` Task invocation
-
-**Benefits:**
-- Best-in-class reasoning with Opus 4.5
-- Improved code quality and fewer errors
-- Better context understanding
-- Enhanced problem-solving for complex tasks
-
-### v1.4.1 (2025-11-06)
-**Feature: Intelligent Auto-Proceed - Eliminate Double Confirmations**
-
-**Added:**
-- Auto-proceed approval context in agent prompts
-- Smart detection of user approval keywords ("continue", "proceed", "yes", "ลุยเลย")
-- Agent question handling logic (auto-respond vs ask user)
-- Auto-proceed decision tree in agent-executor.md
-
-**Improved:**
-- User experience: 50-90% fewer confirmation prompts
-- Execution speed: 25% faster (no waiting for redundant approvals)
-- Workflow clarity: User approves once, system handles agent interactions
-
-**Technical Details:**
-- Modified: `.claude/lib/agent-executor.md` (+80 lines)
-- Implementation: Lean solution (1 file, 0.1% context increase)
-- Backward compatible: Manual approval mode still available
-
-**When It Activates:**
-- User runs `/cdev` command (implicit approval)
-- User says "continue", "proceed", "yes", "ลุยเลย" (explicit approval)
-
-**Before:**
-```
-User approves → Agent asks → Main asks user again ❌
-```
-
-**After:**
-```
-User approves → Agent asks → Main answers directly ✅
-```
-
-### v1.4.0 (2025-11-05)
-**Major: Context Optimization & DRY Consolidation**
-
-**Added:**
-- New consolidated lib files: `context-loading-protocol.md`, `handoff-protocol.md`, `tdd-workflow.md`
-- New detailed guides folder: `lib/detailed-guides/` (6 focused guides)
-- Reference pattern across all agents (Brief summary → See: path → Additions)
-
-**Changed:**
-- All 6 agents refactored: 30.1% size reduction (6,796 → 4,749 lines)
-- CLAUDE.md refactored: 81.7% size reduction (890 → 163 lines, pure navigation hub)
-- Documentation structure: Moved detailed content to modular lib files
-
-**Performance:**
-- 36% total context reduction (7,686 → 4,912 lines)
-- Faster agent loading and execution
-- More token budget available for actual work
-
-**Improved:**
-- Maintainability: Single source of truth for shared docs
-- Discoverability: Clear navigation in CLAUDE.md
-- Modularity: Detailed guides in separate files
-- Consistency: Same content quality, zero duplication
-
-### v1.3.0 (2025-10-30)
-**Feature: TaskMaster-style Intelligent Task Analysis**
-
-**Added:**
-- 6-dimension task analysis in `/csetup`:
-  - Complexity scoring (1-10)
-  - Dependency detection (auto-detects blocks/blocked-by)
-  - Risk assessment (LOW/MEDIUM/HIGH with mitigation)
-  - Research requirements (auto-generates queries)
-  - Subtask breakdown (complex tasks → smaller steps)
-  - Priority ranking (CRITICAL → LOW, scored 0-100)
-- Task analyzer implementation: `.claude/lib/task-analyzer.md`
-- Enhanced phases.md with metadata, time buffers, research phases
+- Merged `/psetup` into `/csetup`
+- Auto tech stack detection
+- Auto best-practices from Context7
 
-**Improved:**
-- Time estimates with automatic buffers (+41% average)
-- Research phases auto-added for new tech/libraries
-- Dependency order in workflow execution
-- Risk mitigation strategies per task
-
-**Inspired by:** [claude-task-master](https://github.com/eyaltoledano/claude-task-master)
-
-### v1.2.0 (2025-10-27)
-**Feature: Context Optimization - 70% Token Reduction**
-
-**Added:**
-- 3-tier loading strategy: STYLE_TOKENS.json (500) → design-context.md (1K) → STYLE_GUIDE.md (5K)
-- Document loader protocol: `.claude/lib/document-loader.md`
-- Lightweight design tokens: `design-system/STYLE_TOKENS.json`
-
-**Improved:**
-- Token usage: ~20K → ~4.7K (70% reduction for design system)
-- Speed: 3-4x faster command execution
-- Consistency: Enforced design tokens, no random colors
-
-### v1.1.1 (2025-10-25)
-**Patch: Minor Fixes**
-
-**Fixed:**
-- Template path correction: `template/.claude` → `.claude`
-- Documentation typos and formatting
-
-### v1.1.0 (2025-10-24)
-**Feature: Enhanced Implementation Logic**
-
-**Added:**
-- Implementation logic overview: `lib/README.md`
-- Agent executor with retry & escalation: `lib/agent-executor.md`
-- TDD classifier logic: `lib/tdd-classifier.md`
-- Progress tracking protocol: `lib/flags-updater.md`
-- Mandatory agent routing: `lib/agent-router.md`
-- Shared agent discovery flow: `contexts/patterns/agent-discovery.md`
-
-### v1.0.0 (2025-10-20)
-**Initial Release: Multi-Agent Template**
-
-**Core Features:**
-- 6 specialized agents (integration, uxui-frontend, test-debug, frontend, backend, database)
-- OpenSpec integration (`/csetup`, `/cdev`, `/cview`, `/cstatus`)
-- Auto-generated best practices via Context7 MCP
-- 3-level project indexing (domain → project → best-practices)
-- Design foundation (color theory, spacing, typography)
-- `/designsetup` command (auto-generate style guide)
-- `/pageplan` command (UI content & component planning)
-- Universal patterns (logging, testing, error-handling, TDD)
-- CLI: `cak init`, `cak update`
+[Full changelog in releases](https://github.com/ChampPABA/claude-multi-agent-template/releases)
 
 ---
 
-## 🔗 Links
+## Links
 
-- **npm Package:** https://www.npmjs.com/package/@champpaba/claude-agent-kit
-- **GitHub:** https://github.com/ChampPABA/claude-multi-agent-template
-- **OpenSpec:** https://github.com/Fission-AI/OpenSpec
-- **Issues:** https://github.com/ChampPABA/claude-multi-agent-template/issues
+- [npm Package](https://www.npmjs.com/package/@champpaba/claude-agent-kit)
+- [GitHub](https://github.com/ChampPABA/claude-multi-agent-template)
+- [OpenSpec](https://github.com/Fission-AI/OpenSpec)
+- [Issues](https://github.com/ChampPABA/claude-multi-agent-template/issues)
 
 ---
 
-## 💡 Quick Tips
+## License
 
-1. **Run `/designsetup` FIRST** - Ensures visual consistency from day 1
-2. **Use `/pageplan` for UI tasks** - 25% faster implementation, better content
-3. **Review `page-plan.md` before `/cdev`** - Edit content, prepare assets
-4. **Setup Context7 MCP** - Agents get latest framework docs automatically
-5. **Use OpenSpec for complex features** - Better alignment before implementation
-6. **Monitor with `/cview`** - See exactly what agents are doing
-7. **Always use `--backup` when updating** - Protects your customizations
-
----
-
-## 📋 Complete Flow Summary (v1.8.0)
-
-```
-1️⃣ OpenSpec Planning
-   → proposal.md + tasks.md + design.md (optional)
-
-2️⃣ Generate Style Guide (one-time, optional)
-   /designsetup
-   → STYLE_GUIDE.md
-
-3️⃣ Generate Page Plan (UI tasks only)
-   /pageplan @prd.md
-   → page-plan.md (content + component plan)
-
-4️⃣ Setup Change Context (v1.8.0: now includes best-practices!)
-   /csetup {change-id}
-   → Auto-detects tech stack
-   → Auto-generates best-practices from Context7
-   → workflow.md
-
-5️⃣ Execute Implementation
-   /cdev {change-id}
-   → Working code + tests
-   → Verbose summary in terminal (no temp files!)
-
-6️⃣ Monitor Progress
-   /cview {change-id}
-   → Detailed progress report
-
-7️⃣ OpenSpec Archive & Update
-   → Merge to specs/
-```
+MIT License - see [LICENSE](LICENSE)
 
 ---
 
-**Ready to implement with confidence?** 🚀
+**Ready to start?**
 
 ```bash
-# Install globally
 npm install -g @champpaba/claude-agent-kit
-
-# Initialize in your project
 cd your-project
 cak init
-
-# Generate style guide (optional but recommended)
-/designsetup
-
-# Start building (after OpenSpec planning)
-/pageplan @prd.md           # UI tasks only
-/csetup your-feature        # v1.8.0: auto-generates best-practices!
-/cdev your-feature
 ```
-
-Let specialized agents handle implementation while you focus on specs and architecture!