@champpaba/claude-agent-kit 2.6.0 → 2.7.0

package/.claude/settings.local.json

@@ -1,42 +1,42 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(git add:*)",
-      "Bash(env)",
-      "Bash(npx:*)",
-      "mcp__context7__resolve-library-id",
-      "mcp__context7__get-library-docs",
-      "Bash(where:*)",
-      "Bash(claude mcp add chrome-devtools npx chrome-devtools-mcp@latest)",
-      "Read(//c/Users/User/**)",
-      "Bash(cat:*)",
-      "Bash(tasklist:*)",
-      "Bash(start chrome:*)",
-      "Bash(curl:*)",
-      "mcp__chrome-devtools__list_pages",
-      "mcp__chrome-devtools__new_page",
-      "Bash(taskkill:*)",
-      "mcp__chrome-devtools__take_snapshot",
-      "mcp__chrome-devtools__navigate_page",
-      "mcp__chrome-devtools__fill",
-      "mcp__chrome-devtools__click",
-      "mcp__chrome-devtools__take_screenshot",
-      "Bash(/agents uxui-frontend)",
-      "WebFetch(domain:github.com)",
-      "WebFetch(domain:raw.githubusercontent.com)",
-      "Bash(git -C \"E:\\project\\claude-multi-agent-template\" status)",
-      "Bash(npm init:*)",
-      "Bash(npm install:*)",
-      "Bash(npm run build:*)",
-      "Bash(find:*)",
-      "Bash(npm test:*)",
-      "Bash(npm run dev:*)",
-      "Bash(git commit:*)",
-      "Bash(git config:*)",
-      "Bash(git push:*)",
-      "Bash(git log:*)"
-    ],
-    "deny": [],
-    "ask": []
-  }
-}
+{
+  "permissions": {
+    "allow": [
+      "Bash(git add:*)",
+      "Bash(env)",
+      "Bash(npx:*)",
+      "mcp__context7__resolve-library-id",
+      "mcp__context7__get-library-docs",
+      "Bash(where:*)",
+      "Bash(claude mcp add chrome-devtools npx chrome-devtools-mcp@latest)",
+      "Read(//c/Users/User/**)",
+      "Bash(cat:*)",
+      "Bash(tasklist:*)",
+      "Bash(start chrome:*)",
+      "Bash(curl:*)",
+      "mcp__chrome-devtools__list_pages",
+      "mcp__chrome-devtools__new_page",
+      "Bash(taskkill:*)",
+      "mcp__chrome-devtools__take_snapshot",
+      "mcp__chrome-devtools__navigate_page",
+      "mcp__chrome-devtools__fill",
+      "mcp__chrome-devtools__click",
+      "mcp__chrome-devtools__take_screenshot",
+      "Bash(/agents uxui-frontend)",
+      "WebFetch(domain:github.com)",
+      "WebFetch(domain:raw.githubusercontent.com)",
+      "Bash(git -C \"E:\\project\\claude-multi-agent-template\" status)",
+      "Bash(npm init:*)",
+      "Bash(npm install:*)",
+      "Bash(npm run build:*)",
+      "Bash(find:*)",
+      "Bash(npm test:*)",
+      "Bash(npm run dev:*)",
+      "Bash(git commit:*)",
+      "Bash(git config:*)",
+      "Bash(git push:*)",
+      "Bash(git log:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

package/.claude/templates/PROJECT_STATUS.template.yml

@@ -167,4 +167,4 @@ notes: |
 references:
   # roadmap: "docs/proposal_list.md"
   # architecture: "openspec/specs/architecture.md"
-  # style_guide: "design-system/STYLE_GUIDE.md"
+  # design_tokens: "design-system/data.yaml"

package/.claude/templates/STYLE_GUIDE.template.md

@@ -734,10 +734,10 @@ module.exports = {
 
 **Priority:**
 ```
-STYLE_GUIDE.md > best-practices/ > generic design contexts
+data.yaml > best-practices/ > generic design contexts
 ```
 
-This file is the single source of truth for design.
+The data.yaml file is the single source of truth for design.
 
 ### For Designers
 
@@ -752,7 +752,7 @@ This file is the single source of truth for design.
 
 **Good:**
 ```tsx
-// Uses STYLE_GUIDE values
+// Uses data.yaml values
 <button className="bg-[#6366f1] px-4 py-2 rounded-md shadow-sm">
   Sign In
 </button>
@@ -760,7 +760,7 @@ This file is the single source of truth for design.
 
 **Bad:**
 ```tsx
-// Arbitrary values not in STYLE_GUIDE
+// Arbitrary values not in data.yaml
 <button className="bg-[#5555ff] px-5 py-3 rounded-lg shadow-md">
   Sign In
 </button>
@@ -800,7 +800,7 @@ Before submitting a new component, verify:
    ```
 
 2. **Review changes:**
-   - Compare new STYLE_GUIDE with old
+   - Compare new data.yaml with old
    - Identify breaking changes
    - Document migration path
 
@@ -846,11 +846,11 @@ Before submitting a new component, verify:
 
 ### Components look inconsistent
 
-**Cause:** Not following STYLE_GUIDE, using arbitrary values
+**Cause:** Not following data.yaml, using arbitrary values
 
 **Solution:**
 - Review component code
-- Compare against STYLE_GUIDE values
+- Compare against data.yaml values
 - Refactor to match specifications
 
 ---

package/.claude/templates/context-template.md

@@ -1,45 +1,45 @@
-# Agent Context: {CHANGE_ID} {CHANGE_TITLE}
-
-## Change Info
-- **ID:** {CHANGE_ID}
-- **Type:** {CHANGE_TYPE}
-- **Status:** Phase {CURRENT_PHASE_NUMBER}/{TOTAL_PHASES}
-- **Created:** {CREATED_DATE}
-
-## References
-**IMPORTANT:** Agents MUST read these before starting work!
-
-- **Proposal:** [../proposal.md](../proposal.md) - Business requirements and scope
-- **Tasks:** [../tasks.md](../tasks.md) - Implementation checklist
-- **Design:** [../design.md](../design.md) - Technical decisions (if exists)
-- **Specs:** ../specs/ - Delta requirements
-
-## Tech Stack
-
-### Core (from project-level)
-Reference: `@/.claude/contexts/domain/project/best-practices/`
-
-{CORE_TECH_LIST}
-
-### Additional (Change-specific)
-**New tech for this Change only:**
-
-{ADDITIONAL_TECH_LIST}
-
-## Change-Specific Patterns
-
-{CHANGE_SPECIFIC_PATTERNS}
-
-## Agent Instructions per Phase
-
-{AGENT_INSTRUCTIONS}
-
-## Phase Tracking
-**Current phase:** {CURRENT_PHASE}
-
-See `flags.json` for detailed tracking.
-
----
-
-**Last updated:** {UPDATED_DATE}
-**Phase:** {CURRENT_PHASE} ({STATUS})
+# Agent Context: {CHANGE_ID} {CHANGE_TITLE}
+
+## Change Info
+- **ID:** {CHANGE_ID}
+- **Type:** {CHANGE_TYPE}
+- **Status:** Phase {CURRENT_PHASE_NUMBER}/{TOTAL_PHASES}
+- **Created:** {CREATED_DATE}
+
+## References
+**IMPORTANT:** Agents MUST read these before starting work!
+
+- **Proposal:** [../proposal.md](../proposal.md) - Business requirements and scope
+- **Tasks:** [../tasks.md](../tasks.md) - Implementation checklist
+- **Design:** [../design.md](../design.md) - Technical decisions (if exists)
+- **Specs:** ../specs/ - Delta requirements
+
+## Tech Stack
+
+### Core (from project-level)
+Reference: `@/.claude/contexts/domain/project/best-practices/`
+
+{CORE_TECH_LIST}
+
+### Additional (Change-specific)
+**New tech for this Change only:**
+
+{ADDITIONAL_TECH_LIST}
+
+## Change-Specific Patterns
+
+{CHANGE_SPECIFIC_PATTERNS}
+
+## Agent Instructions per Phase
+
+{AGENT_INSTRUCTIONS}
+
+## Phase Tracking
+**Current phase:** {CURRENT_PHASE}
+
+See `flags.json` for detailed tracking.
+
+---
+
+**Last updated:** {UPDATED_DATE}
+**Phase:** {CURRENT_PHASE} ({STATUS})

package/.claude/templates/design-context-template.md

@@ -8,8 +8,8 @@
 ## 🎨 Design System Overview
 
 **Status:** {DESIGN_SYSTEM_STATUS}
-- ✅ Complete (STYLE_GUIDE.md + STYLE_TOKENS.json exist)
-- ⚠️ Partial (STYLE_GUIDE.md only)
+- ✅ Complete (data.yaml + README.md exist)
+- ⚠️ Partial (only one file exists)
 - ❌ None (needs /designsetup)
 
 **Generated from:**
@@ -24,20 +24,20 @@
 
 ### Primary Reference (Lightweight)
 ```
-✅ STYLE_TOKENS.json (~500 tokens)
-   design-system/STYLE_TOKENS.json
+✅ data.yaml (~800 tokens)
+   design-system/data.yaml
 
    Contains: Colors, spacing, typography, shadows, borders, animations
    Use: Quick reference for all commands and agents
 ```
 
-### Full Reference (Optional - Load on Demand)
+### Human-Readable Summary (For Humans Only)
 ```
-📖 STYLE_GUIDE.md (~5000 tokens)
-   design-system/STYLE_GUIDE.md
+📖 README.md (~100 tokens)
+   design-system/README.md
 
-   Contains: 17 sections including component examples, layout patterns
-   Use: Only load specific sections when needed
+   Contains: Summary of design system for human review
+   Use: Humans reviewing design, NOT for agents
 ```
 
 ### Fallback (Universal Principles)
@@ -139,13 +139,13 @@ Read: .claude/contexts/domain/{PROJECT_NAME}/design-context.md
 Tokens: ~1000
 ```
 
-**Step 2: Load STYLE_TOKENS.json (if needed)**
+**Step 2: Load data.yaml (if needed)**
 ```
-Read: design-system/STYLE_TOKENS.json
-Tokens: ~500
+Read: design-system/data.yaml
+Tokens: ~800
 ```
 
-**Total: ~1500 tokens (vs 5000+ for full STYLE_GUIDE.md)**
+**Total: ~1500 tokens (efficient loading)**
 
 ---
 
@@ -158,22 +158,16 @@ Tokens: ~500
    - File paths
    - Critical rules
 
-2. **Read STYLE_TOKENS.json**
+2. **Read data.yaml**
    - Full design tokens
    - Component library info
    - Usage patterns
 
-3. **Optional: Read STYLE_GUIDE.md sections**
-   - Only load sections needed for current task
-   - Example: Component Styles, Layout Patterns
-   - Tokens: ~2000 (selective loading)
-
-4. **Report:**
+3. **Report:**
    ```
    ✅ Design Context Loaded
    📁 design-context.md ✓
-   📦 STYLE_TOKENS.json ✓
-   📖 STYLE_GUIDE.md (Section 6: Component Styles) ✓
+   📦 data.yaml ✓
 
    Design Tokens Extracted:
    - Primary: {PRIMARY_COLOR}
@@ -187,9 +181,8 @@ Tokens: ~500
 
 | Approach | Tokens | Speed | Recommended |
 |----------|--------|-------|-------------|
-| **Old: Load full STYLE_GUIDE.md** | ~5000 | Slow | ❌ |
-| **New: design-context.md + STYLE_TOKENS.json** | ~1500 | Fast | ✅ |
-| **Agent: Selective STYLE_GUIDE sections** | ~3500 | Medium | ✅ (when needed) |
+| **design-context.md + data.yaml** | ~1800 | Fast | ✅ |
+| **data.yaml only** | ~800 | Very Fast | ✅ (quick tasks) |
 
 ---
 
@@ -198,15 +191,15 @@ Tokens: ~500
 Run `/csetup` or `/designsetup` again when:
 - ✅ Design tokens change (new colors, spacing)
 - ✅ Component library changes (shadcn → Chakra UI)
-- ✅ STYLE_GUIDE.md updated
+- ✅ data.yaml updated
 - ✅ New project phase (rebrand, redesign)
 
 ---
 
 ## 📖 References
 
-- **Full Style Guide:** `design-system/STYLE_GUIDE.md`
-- **Design Tokens:** `design-system/STYLE_TOKENS.json`
+- **Design Tokens:** `design-system/data.yaml` (agent reads this)
+- **Human Summary:** `design-system/README.md` (for humans)
 - **Universal Design:** `.claude/contexts/design/`
 - **Best Practices:** `.claude/contexts/domain/{PROJECT_NAME}/best-practices/`
 
@@ -214,7 +207,7 @@ Run `/csetup` or `/designsetup` again when:
 
 **🎯 Next Steps for Agents:**
 1. Load design-context.md (~1K tokens) ✅
-2. Load STYLE_TOKENS.json (~500 tokens) ✅
+2. Load data.yaml (~800 tokens) ✅
 3. Extract design tokens ✅
 4. Report loaded context ✅
 5. Begin implementation with design system awareness ✅

package/.claude/templates/flags-template.json

@@ -1,42 +1,42 @@
-{
-  "version": "1.0.0",
-  "change_id": "",
-  "change_type": "",
-  "template": "",
-  "created_at": "",
-  "updated_at": "",
-
-  "current_phase": "",
-
-  "phases": {},
-
-  "meta": {
-    "total_phases": 0,
-    "completed_phases": 0,
-    "in_progress_phases": 0,
-    "pending_phases": 0,
-    "progress_percentage": 0,
-
-    "total_estimated_minutes": 0,
-    "total_actual_minutes": 0,
-    "time_remaining_estimate": 0,
-
-    "tests_total": 0,
-    "tests_passed": 0,
-    "tests_failed": 0,
-    "coverage_percentage": 0,
-
-    "issues_found": 0,
-    "issues_fixed": 0,
-    "issues_remaining": 0,
-
-    "files_created": 0,
-    "files_modified": 0
-  },
-
-  "ready_to_archive": false,
-  "blocked": false,
-  "blocking_reason": null,
-
-  "history": []
-}
+{
+  "version": "1.0.0",
+  "change_id": "",
+  "change_type": "",
+  "template": "",
+  "created_at": "",
+  "updated_at": "",
+
+  "current_phase": "",
+
+  "phases": {},
+
+  "meta": {
+    "total_phases": 0,
+    "completed_phases": 0,
+    "in_progress_phases": 0,
+    "pending_phases": 0,
+    "progress_percentage": 0,
+
+    "total_estimated_minutes": 0,
+    "total_actual_minutes": 0,
+    "time_remaining_estimate": 0,
+
+    "tests_total": 0,
+    "tests_passed": 0,
+    "tests_failed": 0,
+    "coverage_percentage": 0,
+
+    "issues_found": 0,
+    "issues_fixed": 0,
+    "issues_remaining": 0,
+
+    "files_created": 0,
+    "files_modified": 0
+  },
+
+  "ready_to_archive": false,
+  "blocked": false,
+  "blocking_reason": null,
+
+  "history": []
+}

package/.claude/templates/page-plan-example.md

@@ -1,6 +1,6 @@
 # Page Plan: Landing Page (EXAMPLE)
 > This is an example template showing the structure of page-plan.md
-> Generated from: proposal.md, prd.md, project_brief.md, STYLE_GUIDE.md
+> Generated from: proposal.md, prd.md, project_brief.md, data.yaml
 > Change ID: landing-page
 
 ---
@@ -562,18 +562,18 @@ _Length: 75 words_
 
 ## 5. Design Notes
 
-**Follow STYLE_GUIDE.md for all design decisions:**
+**Follow data.yaml for all design decisions:**
 
-- **Primary Color:** `#0d7276` (from STYLE_GUIDE.md Section 3)
-- **Font Family:** `Prompt` (from STYLE_GUIDE.md Section 4)
-- **Spacing Scale:** 8px grid system - use `p-4`, `p-6`, `p-8`, `gap-4`, `gap-6` (from STYLE_GUIDE.md Section 5)
-- **Component Library:** shadcn/ui (from STYLE_GUIDE.md Section 6)
-- **Icons:** Material Symbols (Outline style) (from STYLE_GUIDE.md Section 17)
+- **Primary Color:** `#0d7276` (from data.yaml colors section)
+- **Font Family:** `Prompt` (from data.yaml typography section)
+- **Spacing Scale:** 8px grid system - use `p-4`, `p-6`, `p-8`, `gap-4`, `gap-6` (from data.yaml spacing)
+- **Component Library:** shadcn/ui (from data.yaml)
+- **Icons:** Material Symbols (Outline style) (from data.yaml)
 - **Shadows:**
   - Cards: `shadow-sm` on default, `shadow-md` on hover
   - Elevated elements: `shadow-lg`
 - **Border Radius:** `rounded-lg` for cards, `rounded-md` for buttons/inputs
-- **Responsive Breakpoints:** (from STYLE_GUIDE.md Section 13)
+- **Responsive Breakpoints:** (from data.yaml)
   - Mobile: < 640px
   - Tablet: 640px - 1024px
   - Desktop: > 1024px
@@ -686,7 +686,7 @@ public/
 **Generated by:** /pageplan command
 **Date:** 2025-01-15
 **For:** Change ID `landing-page`
-**Context files used:** proposal.md, prd.md, project_brief.md, STYLE_GUIDE.md
+**Context files used:** proposal.md, prd.md, project_brief.md, data.yaml
 
 ---
 

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

@@ -1,17 +1,17 @@
-# Phase: Accessibility Test
-
-**Agent:** `test-debug`
-**Metadata:** `| automated | accessibility |`
-**Estimated time:** 10 minutes
-
-## 🎯 Purpose
-Run automated accessibility tests (Lighthouse, axe-core).
-
-## ✅ Success Criteria
-- [ ] Lighthouse score ≥ 95
-- [ ] Contrast ratios pass WCAG AAA
-- [ ] ARIA labels complete
-
-## 📤 Output
-- Test report
-- Update flags.json
+# Phase: Accessibility Test
+
+**Agent:** `test-debug`
+**Metadata:** `| automated | accessibility |`
+**Estimated time:** 10 minutes
+
+## 🎯 Purpose
+Run automated accessibility tests (Lighthouse, axe-core).
+
+## ✅ Success Criteria
+- [ ] Lighthouse score ≥ 95
+- [ ] Contrast ratios pass WCAG AAA
+- [ ] ARIA labels complete
+
+## 📤 Output
+- Test report
+- Update flags.json

package/.claude/templates/phases-sections/api-design.md

@@ -1,37 +1,37 @@
-# Phase: API Specification
-
-**Agent:** `integration`
-**Metadata:** `| api-design |`
-**Estimated time:** 30 minutes
-
-## 🎯 Purpose
-
-Create OpenAPI 3.0 specification for all API endpoints. Define request/response schemas, validation rules, and error responses.
-
-## 📚 Context Loading
-
-- ✅ `../proposal.md` → Business requirements
-- ✅ `../tasks.md` → API endpoints to implement
-- ✅ Frontend mockup code → Data requirements
-- ⚠️ `error-handling.md` → API error patterns
-
-## 📝 Tasks
-
-1. Analyze frontend mockup → Determine data needs
-2. Design API endpoints (RESTful)
-3. Define request/response schemas (JSON Schema)
-4. Define error responses (4xx, 5xx)
-5. Create OpenAPI 3.0 spec file
-
-## ✅ Success Criteria
-
-- [ ] OpenAPI 3.0 spec complete
-- [ ] All endpoints documented
-- [ ] Request/response schemas defined with examples
-- [ ] Error responses defined
-
-## 📤 Output
-
-- `.claude/openapi.yaml` (OpenAPI 3.0 spec)
-- API documentation (Swagger UI / Redoc)
-- Update flags.json
+# Phase: API Specification
+
+**Agent:** `integration`
+**Metadata:** `| api-design |`
+**Estimated time:** 30 minutes
+
+## 🎯 Purpose
+
+Create OpenAPI 3.0 specification for all API endpoints. Define request/response schemas, validation rules, and error responses.
+
+## 📚 Context Loading
+
+- ✅ `../proposal.md` → Business requirements
+- ✅ `../tasks.md` → API endpoints to implement
+- ✅ Frontend mockup code → Data requirements
+- ⚠️ `error-handling.md` → API error patterns
+
+## 📝 Tasks
+
+1. Analyze frontend mockup → Determine data needs
+2. Design API endpoints (RESTful)
+3. Define request/response schemas (JSON Schema)
+4. Define error responses (4xx, 5xx)
+5. Create OpenAPI 3.0 spec file
+
+## ✅ Success Criteria
+
+- [ ] OpenAPI 3.0 spec complete
+- [ ] All endpoints documented
+- [ ] Request/response schemas defined with examples
+- [ ] Error responses defined
+
+## 📤 Output
+
+- `.claude/openapi.yaml` (OpenAPI 3.0 spec)
+- API documentation (Swagger UI / Redoc)
+- Update flags.json

package/.claude/templates/phases-sections/backend-tests.md

@@ -1,16 +1,16 @@
-# Phase: Backend Tests
-
-**Agent:** `test-debug`
-**Metadata:** `| automated | TDD |`
-**Estimated time:** 15 minutes
-
-## 🎯 Purpose
-Run unit and integration tests for backend.
-
-## ✅ Success Criteria
-- [ ] All tests pass
-- [ ] Coverage ≥ 80%
-
-## 📤 Output
-- Coverage report
-- Update flags.json
+# Phase: Backend Tests
+
+**Agent:** `test-debug`
+**Metadata:** `| automated | TDD |`
+**Estimated time:** 15 minutes
+
+## 🎯 Purpose
+Run unit and integration tests for backend.
+
+## ✅ Success Criteria
+- [ ] All tests pass
+- [ ] Coverage ≥ 80%
+
+## 📤 Output
+- Coverage report
+- Update flags.json