@champpaba/claude-agent-kit 1.7.1 → 2.0.0

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

@@ -1,16 +1,16 @@
-# Phase: Contract Test (Backend)
-
-**Agent:** `integration`
-**Metadata:** `| contract | validation |`
-**Estimated time:** 10 minutes
-
-## 🎯 Purpose
-Validate backend implementation matches OpenAPI spec.
-
-## ✅ Success Criteria
-- [ ] All endpoints match spec
-- [ ] No schema violations
-
-## 📤 Output
-- Contract test report
-- Update flags.json
+# Phase: Contract Test (Backend)
+
+**Agent:** `integration`
+**Metadata:** `| contract | validation |`
+**Estimated time:** 10 minutes
+
+## 🎯 Purpose
+Validate backend implementation matches OpenAPI spec.
+
+## ✅ Success Criteria
+- [ ] All endpoints match spec
+- [ ] No schema violations
+
+## 📤 Output
+- Contract test report
+- Update flags.json

package/.claude/templates/phases-sections/contract-frontend.md

@@ -1,16 +1,16 @@
-# Phase: Contract Test (Frontend)
-
-**Agent:** `integration`
-**Metadata:** `| contract | validation |`
-**Estimated time:** 10 minutes
-
-## 🎯 Purpose
-Validate frontend API calls match backend responses.
-
-## ✅ Success Criteria
-- [ ] All API calls match backend contract
-- [ ] No contract violations
-
-## 📤 Output
-- Contract test report
-- Update flags.json
+# Phase: Contract Test (Frontend)
+
+**Agent:** `integration`
+**Metadata:** `| contract | validation |`
+**Estimated time:** 10 minutes
+
+## 🎯 Purpose
+Validate frontend API calls match backend responses.
+
+## ✅ Success Criteria
+- [ ] All API calls match backend contract
+- [ ] No contract violations
+
+## 📤 Output
+- Contract test report
+- Update flags.json

package/.claude/templates/phases-sections/database.md

@@ -1,35 +1,35 @@
-# Phase: Database Schema
-
-**Agent:** `database`
-**Metadata:** `| prisma | migration |`
-**Estimated time:** 30 minutes
-
-## 🎯 Purpose
-
-Design database schema, create migrations, add indexes for performance.
-
-## 📚 Context Loading
-
-- ✅ `tech-stack.md` → Database ORM (Prisma, SQLAlchemy, etc.)
-- ✅ `../proposal.md` → Data requirements
-- ✅ Best practices for ORM
-
-## 📝 Tasks
-
-1. Design Prisma/SQLAlchemy schema
-2. Create migration
-3. Add indexes for frequently queried fields
-4. Add foreign keys and constraints
-
-## ✅ Success Criteria
-
-- [ ] Schema designed and created
-- [ ] Migration created and applied
-- [ ] Indexes added for performance
-- [ ] No migration conflicts
-
-## 📤 Output
-
-- Schema file (schema.prisma / models.py)
-- Migration files
-- Update flags.json
+# Phase: Database Schema
+
+**Agent:** `database`
+**Metadata:** `| prisma | migration |`
+**Estimated time:** 30 minutes
+
+## 🎯 Purpose
+
+Design database schema, create migrations, add indexes for performance.
+
+## 📚 Context Loading
+
+- ✅ `tech-stack.md` → Database ORM (Prisma, SQLAlchemy, etc.)
+- ✅ `../proposal.md` → Data requirements
+- ✅ Best practices for ORM
+
+## 📝 Tasks
+
+1. Design Prisma/SQLAlchemy schema
+2. Create migration
+3. Add indexes for frequently queried fields
+4. Add foreign keys and constraints
+
+## ✅ Success Criteria
+
+- [ ] Schema designed and created
+- [ ] Migration created and applied
+- [ ] Indexes added for performance
+- [ ] No migration conflicts
+
+## 📤 Output
+
+- Schema file (schema.prisma / models.py)
+- Migration files
+- Update flags.json

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

@@ -1,16 +1,16 @@
-# Phase: E2E Tests
-
-**Agent:** `test-debug`
-**Metadata:** `| e2e | playwright |`
-**Estimated time:** 30 minutes
-
-## 🎯 Purpose
-End-to-end testing of complete user journeys.
-
-## ✅ Success Criteria
-- [ ] E2E tests pass
-- [ ] Complete user journey tested
-
-## 📤 Output
-- E2E test files
-- Update flags.json
+# Phase: E2E Tests
+
+**Agent:** `test-debug`
+**Metadata:** `| e2e | playwright |`
+**Estimated time:** 30 minutes
+
+## 🎯 Purpose
+End-to-end testing of complete user journeys.
+
+## ✅ Success Criteria
+- [ ] E2E tests pass
+- [ ] Complete user journey tested
+
+## 📤 Output
+- E2E test files
+- Update flags.json

package/.claude/templates/phases-sections/fix-implementation.md

@@ -1,17 +1,17 @@
-# Phase: Fix Implementation
-
-**Agent:** (varies based on bug location)
-**Metadata:** `| bug-fix |`
-**Estimated time:** 30 minutes
-
-## 🎯 Purpose
-Fix bug and restore intended functionality.
-
-## ✅ Success Criteria
-- [ ] Bug fixed
-- [ ] Tests added to prevent regression
-
-## 📤 Output
-- Fixed code
-- Tests
-- Update flags.json
+# Phase: Fix Implementation
+
+**Agent:** (varies based on bug location)
+**Metadata:** `| bug-fix |`
+**Estimated time:** 30 minutes
+
+## 🎯 Purpose
+Fix bug and restore intended functionality.
+
+## ✅ Success Criteria
+- [ ] Bug fixed
+- [ ] Tests added to prevent regression
+
+## 📤 Output
+- Fixed code
+- Tests
+- Update flags.json

package/.claude/templates/phases-sections/frontend-integration.md

@@ -1,18 +1,18 @@
-# Phase: Frontend Integration
-
-**Agent:** `frontend`
-**Metadata:** `| api-work | TDD |`
-**Estimated time:** 60 minutes
-
-## 🎯 Purpose
-Replace mockup data with real API calls using TanStack Query.
-
-## ✅ Success Criteria
-- [ ] Mockup replaced with real API
-- [ ] Loading states working
-- [ ] Error handling implemented
-
-## 📤 Output
-- Updated components
-- Hooks for API calls
-- Update flags.json
+# Phase: Frontend Integration
+
+**Agent:** `frontend`
+**Metadata:** `| api-work | TDD |`
+**Estimated time:** 60 minutes
+
+## 🎯 Purpose
+Replace mockup data with real API calls using TanStack Query.
+
+## ✅ Success Criteria
+- [ ] Mockup replaced with real API
+- [ ] Loading states working
+- [ ] Error handling implemented
+
+## 📤 Output
+- Updated components
+- Hooks for API calls
+- Update flags.json

package/.claude/templates/phases-sections/frontend-mockup.md

@@ -1,123 +1,123 @@
-# Phase: Frontend Mockup
-
-**Agent:** `uxui-frontend`
-**Metadata:** `| design-work | TDD | mockup |`
-**Estimated time:** 90 minutes
-
-## 📚 Context Loading Strategy
-
-**Tier 1 - Critical (Always Load):**
-- ✅ `tech-stack.md` → Package manager, React/Next.js versions
-- ✅ `project.md` (Code Conventions, Testing Strategy sections)
-- ✅ `ui-component-consistency.md` → Visual consistency patterns
-
-**Tier 2 - Conditional (Metadata: design-work):**
-- ✅ `design/index.md` → Design system overview
-- ✅ `design/box-thinking.md` → Layout analysis
-- ✅ `design/color-theory.md` → Color usage
-- ✅ `design/spacing.md` → Spacing scale (8, 16, 24, 32, 40, 48px)
-
-**Tier 3 - Skip (Not Needed):**
-- ❌ `error-handling.md` → Not needed for mockup (no real API)
-- ❌ `logging.md` → Not production code yet
-
-**Token estimate:** ~7,000 tokens (vs 15,000 without filtering)
-
-## 🎯 Purpose
-
-Create UI components with mockup data. Focus on visual design, layout, and user experience without backend integration.
-
-## 📝 Agent-Specific Instructions
-
-**MANDATORY PRE-WORK (STEP 0-5 from CLAUDE.md):**
-
-1. **Project Discovery:**
-   - Read: `domain/index.md` → Get project name
-   - Read: `domain/project/README.md` → Get core stack
-   - Read: `domain/project/best-practices/index.md` → Get relevant practices
-   - Read relevant best practices files
-
-2. **Change Context:**
-   - Read: `../proposal.md` → Business requirements
-   - Read: `../.claude/context.md` → Change-specific tech
-
-3. **Design Contexts (design-work flag):**
-   - Read ALL design contexts (listed in Tier 2 above)
-
-4. **Box Thinking Analysis:**
-   - Identify boxes: containers, children, siblings
-   - Document relationships: nested, adjacent
-   - Plan space flow: spacing scale
-   - Plan responsive: stack/merge/compress
-
-5. **Search for Existing Components:**
-   ```bash
-   Glob: "**/*{Keyword}*.{tsx,jsx,vue}"
-   Grep: "[similar-pattern]"
-   ```
-   - Decision: Reuse > Compose > Extend > Create New
-   - Extract design tokens from similar components
-
-6. **Report Pre-Implementation:**
-   Provide detailed report covering steps 1-5 BEFORE writing code.
-
-**IMPLEMENTATION:**
-
-- Use **mockup data** for all dynamic content
-- Follow TDD if applicable (see testing.md)
-- Visual consistency: match existing components
-- Loading states: skeleton loaders
-- Error states: user-friendly messages (mockup errors)
-- Responsive design: test 3 breakpoints minimum
-
-**CRITICAL RULES:**
-- ❌ NO hardcoded colors → ✅ Use theme tokens
-- ❌ NO arbitrary spacing → ✅ Use spacing scale
-- ❌ NO inconsistent icons → ✅ Match reference components
-- ❌ NO creating duplicate components → ✅ Search and reuse first
-
-## ✅ Success Criteria
-
-- [ ] UI components created with mockup data
-- [ ] Responsive design implemented (3 breakpoints)
-- [ ] Visual consistency matches design system
-- [ ] Component reuses existing UI primitives
-- [ ] No hardcoded colors or spacing values
-- [ ] Pre-implementation analysis completed
-
-## 📤 Output
-
-**Files created/modified:**
-- List all component files created
-- List all files modified
-
-**Update flags.json:**
-```json
-{
-  "phases": {
-    "frontend_mockup": {
-      "status": "completed",
-      "completed_at": "{ISO-timestamp}",
-      "actual_minutes": {duration},
-      "tasks_completed": ["{task-ids}"],
-      "files_created": ["{file-paths}"],
-      "notes": "Summary of work done"
-    }
-  }
-}
-```
-
-**Report to user:**
-```
-✅ Phase 1: Frontend Mockup completed!
-
-⏱️ Time: {actual} minutes (estimated: 90)
-
-📁 Files created:
-{list-of-files}
-
-✓ Tasks completed:
-{list-of-task-ids}
-
-📍 Next phase: #2 Accessibility Test (test-debug agent)
-```
+# Phase: Frontend Mockup
+
+**Agent:** `uxui-frontend`
+**Metadata:** `| design-work | TDD | mockup |`
+**Estimated time:** 90 minutes
+
+## 📚 Context Loading Strategy
+
+**Tier 1 - Critical (Always Load):**
+- ✅ `tech-stack.md` → Package manager, React/Next.js versions
+- ✅ `project.md` (Code Conventions, Testing Strategy sections)
+- ✅ `ui-component-consistency.md` → Visual consistency patterns
+
+**Tier 2 - Conditional (Metadata: design-work):**
+- ✅ `design/index.md` → Design system overview
+- ✅ `design/box-thinking.md` → Layout analysis
+- ✅ `design/color-theory.md` → Color usage
+- ✅ `design/spacing.md` → Spacing scale (8, 16, 24, 32, 40, 48px)
+
+**Tier 3 - Skip (Not Needed):**
+- ❌ `error-handling.md` → Not needed for mockup (no real API)
+- ❌ `logging.md` → Not production code yet
+
+**Token estimate:** ~7,000 tokens (vs 15,000 without filtering)
+
+## 🎯 Purpose
+
+Create UI components with mockup data. Focus on visual design, layout, and user experience without backend integration.
+
+## 📝 Agent-Specific Instructions
+
+**MANDATORY PRE-WORK (STEP 0-5 from CLAUDE.md):**
+
+1. **Project Discovery:**
+   - Read: `domain/index.md` → Get project name
+   - Read: `domain/project/README.md` → Get core stack
+   - Read: `domain/project/best-practices/index.md` → Get relevant practices
+   - Read relevant best practices files
+
+2. **Change Context:**
+   - Read: `../proposal.md` → Business requirements
+   - Read: `../.claude/context.md` → Change-specific tech
+
+3. **Design Contexts (design-work flag):**
+   - Read ALL design contexts (listed in Tier 2 above)
+
+4. **Box Thinking Analysis:**
+   - Identify boxes: containers, children, siblings
+   - Document relationships: nested, adjacent
+   - Plan space flow: spacing scale
+   - Plan responsive: stack/merge/compress
+
+5. **Search for Existing Components:**
+   ```bash
+   Glob: "**/*{Keyword}*.{tsx,jsx,vue}"
+   Grep: "[similar-pattern]"
+   ```
+   - Decision: Reuse > Compose > Extend > Create New
+   - Extract design tokens from similar components
+
+6. **Report Pre-Implementation:**
+   Provide detailed report covering steps 1-5 BEFORE writing code.
+
+**IMPLEMENTATION:**
+
+- Use **mockup data** for all dynamic content
+- Follow TDD if applicable (see testing.md)
+- Visual consistency: match existing components
+- Loading states: skeleton loaders
+- Error states: user-friendly messages (mockup errors)
+- Responsive design: test 3 breakpoints minimum
+
+**CRITICAL RULES:**
+- ❌ NO hardcoded colors → ✅ Use theme tokens
+- ❌ NO arbitrary spacing → ✅ Use spacing scale
+- ❌ NO inconsistent icons → ✅ Match reference components
+- ❌ NO creating duplicate components → ✅ Search and reuse first
+
+## ✅ Success Criteria
+
+- [ ] UI components created with mockup data
+- [ ] Responsive design implemented (3 breakpoints)
+- [ ] Visual consistency matches design system
+- [ ] Component reuses existing UI primitives
+- [ ] No hardcoded colors or spacing values
+- [ ] Pre-implementation analysis completed
+
+## 📤 Output
+
+**Files created/modified:**
+- List all component files created
+- List all files modified
+
+**Update flags.json:**
+```json
+{
+  "phases": {
+    "frontend_mockup": {
+      "status": "completed",
+      "completed_at": "{ISO-timestamp}",
+      "actual_minutes": {duration},
+      "tasks_completed": ["{task-ids}"],
+      "files_created": ["{file-paths}"],
+      "notes": "Summary of work done"
+    }
+  }
+}
+```
+
+**Report to user:**
+```
+✅ Phase 1: Frontend Mockup completed!
+
+⏱️ Time: {actual} minutes (estimated: 90)
+
+📁 Files created:
+{list-of-files}
+
+✓ Tasks completed:
+{list-of-task-ids}
+
+📍 Next phase: #2 Accessibility Test (test-debug agent)
+```

package/.claude/templates/phases-sections/manual-flow-test.md

@@ -1,15 +1,15 @@
-# Phase: Manual Flow Test
-
-**Agent:** `user`
-**Metadata:** `| manual-test | flow |`
-**Estimated time:** 20 minutes
-
-## 🎯 Purpose
-Manual testing of complete data flow (frontend → backend → database).
-
-## ✅ Success Criteria
-- [ ] Complete flow works
-- [ ] Edge cases handled
-
-## 📤 Output
-- Update flags.json with results
+# Phase: Manual Flow Test
+
+**Agent:** `user`
+**Metadata:** `| manual-test | flow |`
+**Estimated time:** 20 minutes
+
+## 🎯 Purpose
+Manual testing of complete data flow (frontend → backend → database).
+
+## ✅ Success Criteria
+- [ ] Complete flow works
+- [ ] Edge cases handled
+
+## 📤 Output
+- Update flags.json with results

package/.claude/templates/phases-sections/manual-ux-test.md

@@ -1,16 +1,16 @@
-# Phase: Manual UX Test
-
-**Agent:** `user`
-**Metadata:** `| manual-test | ux |`
-**Estimated time:** 15 minutes
-
-## 🎯 Purpose
-Manual testing of UX, visual consistency, and responsive design.
-
-## ✅ Success Criteria
-- [ ] Visual consistency verified
-- [ ] Responsive design tested (3 breakpoints)
-- [ ] User journey works smoothly
-
-## 📤 Output
-- Update flags.json with issues found/fixed
+# Phase: Manual UX Test
+
+**Agent:** `user`
+**Metadata:** `| manual-test | ux |`
+**Estimated time:** 15 minutes
+
+## 🎯 Purpose
+Manual testing of UX, visual consistency, and responsive design.
+
+## ✅ Success Criteria
+- [ ] Visual consistency verified
+- [ ] Responsive design tested (3 breakpoints)
+- [ ] User journey works smoothly
+
+## 📤 Output
+- Update flags.json with issues found/fixed

package/.claude/templates/phases-sections/refactor-implementation.md

@@ -1,17 +1,17 @@
-# Phase: Refactor Implementation
-
-**Agent:** `test-debug`
-**Metadata:** `| refactor |`
-**Estimated time:** 60 minutes
-
-## 🎯 Purpose
-Refactor code to improve quality.
-
-## ✅ Success Criteria
-- [ ] Code improved
-- [ ] All tests pass
-- [ ] No functionality changes
-
-## 📤 Output
-- Refactored code
-- Update flags.json
+# Phase: Refactor Implementation
+
+**Agent:** `test-debug`
+**Metadata:** `| refactor |`
+**Estimated time:** 60 minutes
+
+## 🎯 Purpose
+Refactor code to improve quality.
+
+## ✅ Success Criteria
+- [ ] Code improved
+- [ ] All tests pass
+- [ ] No functionality changes
+
+## 📤 Output
+- Refactored code
+- Update flags.json

package/.claude/templates/phases-sections/refactor.md

@@ -1,16 +1,16 @@
-# Phase: Refactor
-
-**Agent:** `test-debug`
-**Metadata:** `| refactor |`
-**Estimated time:** 20 minutes
-
-## 🎯 Purpose
-Improve code quality without changing functionality.
-
-## ✅ Success Criteria
-- [ ] Code refactored
-- [ ] All tests still pass
-
-## 📤 Output
-- Refactored code
-- Update flags.json
+# Phase: Refactor
+
+**Agent:** `test-debug`
+**Metadata:** `| refactor |`
+**Estimated time:** 20 minutes
+
+## 🎯 Purpose
+Improve code quality without changing functionality.
+
+## ✅ Success Criteria
+- [ ] Code refactored
+- [ ] All tests still pass
+
+## 📤 Output
+- Refactored code
+- Update flags.json

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

@@ -1,15 +1,15 @@
-# Phase: Regression Tests
-
-**Agent:** `test-debug`
-**Metadata:** `| automated | regression |`
-**Estimated time:** 10 minutes
-
-## 🎯 Purpose
-Ensure refactoring didn't break anything.
-
-## ✅ Success Criteria
-- [ ] All regression tests pass
-
-## 📤 Output
-- Test report
-- Update flags.json
+# Phase: Regression Tests
+
+**Agent:** `test-debug`
+**Metadata:** `| automated | regression |`
+**Estimated time:** 10 minutes
+
+## 🎯 Purpose
+Ensure refactoring didn't break anything.
+
+## ✅ Success Criteria
+- [ ] All regression tests pass
+
+## 📤 Output
+- Test report
+- Update flags.json