@champpaba/claude-agent-kit 1.0.0

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

@@ -0,0 +1,124 @@
+{
+  "version": "1.0.0",
+  "templates": {
+    "full-stack": {
+      "name": "Full-Stack Feature",
+      "description": "Complete feature with frontend UI, backend API, and database",
+      "phases": [
+        "frontend-mockup",
+        "accessibility-test",
+        "manual-ux-test",
+        "business-logic-validation",
+        "user-approval",
+        "api-design",
+        "backend",
+        "database",
+        "backend-tests",
+        "contract-backend",
+        "frontend-integration",
+        "contract-frontend",
+        "e2e-tests",
+        "manual-flow-test",
+        "refactor",
+        "regression-tests",
+        "test-coverage",
+        "documentation",
+        "report"
+      ],
+      "total_phases": 19,
+      "estimated_minutes": 420
+    },
+
+    "frontend-only": {
+      "name": "Frontend Only",
+      "description": "UI components with mockup data, no backend integration",
+      "phases": [
+        "frontend-mockup",
+        "accessibility-test",
+        "manual-ux-test",
+        "business-logic-validation",
+        "user-approval",
+        "component-tests",
+        "responsive-test",
+        "refactor",
+        "test-coverage",
+        "documentation",
+        "report"
+      ],
+      "total_phases": 11,
+      "estimated_minutes": 195
+    },
+
+    "backend-only": {
+      "name": "Backend Only",
+      "description": "API endpoints and database without frontend",
+      "phases": [
+        "api-design",
+        "backend",
+        "database",
+        "backend-tests",
+        "contract-backend",
+        "e2e-api-tests",
+        "refactor",
+        "regression-tests",
+        "documentation",
+        "report"
+      ],
+      "total_phases": 10,
+      "estimated_minutes": 210
+    },
+
+    "script-only": {
+      "name": "Script/CLI Tool",
+      "description": "Command-line tool or background script",
+      "phases": [
+        "script-implementation",
+        "automated-tests",
+        "manual-testing",
+        "business-logic-validation",
+        "refactor",
+        "test-coverage",
+        "documentation"
+      ],
+      "total_phases": 7,
+      "estimated_minutes": 150
+    },
+
+    "bug-fix": {
+      "name": "Bug Fix",
+      "description": "Fix existing functionality",
+      "phases": [
+        "fix-implementation",
+        "unit-tests",
+        "manual-verification",
+        "regression-tests",
+        "report"
+      ],
+      "total_phases": 5,
+      "estimated_minutes": 60
+    },
+
+    "refactor": {
+      "name": "Refactoring",
+      "description": "Improve code quality without changing functionality",
+      "phases": [
+        "refactor-implementation",
+        "regression-tests",
+        "documentation",
+        "report"
+      ],
+      "total_phases": 4,
+      "estimated_minutes": 90
+    }
+  },
+
+  "detection_keywords": {
+    "frontend": ["component", "page", "ui", "form", "button", "layout", "responsive", "css", "style", "tsx", "jsx", "vue"],
+    "backend": ["api", "endpoint", "route", "handler", "server", "backend", "middleware", "controller"],
+    "database": ["database", "schema", "migration", "prisma", "model", "query", "sql", "table"],
+    "api_integration": ["fetch", "axios", "api call", "integration", "connect to", "http request"],
+    "script": ["cli", "command", "script", "automation", "batch", "cron", "job", "worker"],
+    "bug_fix": ["bug", "fix", "issue", "error", "broken", "crash"],
+    "refactor": ["refactor", "cleanup", "optimize", "improve", "restructure", "reorganize"]
+  }
+}

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

@@ -0,0 +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

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

@@ -0,0 +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

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

@@ -0,0 +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

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

@@ -0,0 +1,37 @@
+# Phase: Backend Implementation
+
+**Agent:** `backend`
+**Metadata:** `| TDD | api-work | production |`
+**Estimated time:** 120 minutes
+
+## 🎯 Purpose
+
+Implement API endpoints following OpenAPI specification. Include business logic, validation, error handling, and logging.
+
+## 📚 Context Loading
+
+- ✅ `tech-stack.md` → Package manager, framework version
+- ✅ `.claude/openapi.yaml` → API contract
+- ✅ `testing.md` (RED-GREEN-REFACTOR section)
+- ✅ `error-handling.md` → API error patterns
+- ✅ `logging.md` → Production logging
+
+## 📝 Follow TDD (RED → GREEN → REFACTOR)
+
+1. **RED:** Write failing tests first
+2. **GREEN:** Implement to pass tests
+3. **REFACTOR:** Clean up code
+
+## ✅ Success Criteria
+
+- [ ] All endpoints implemented (match OpenAPI spec)
+- [ ] All tests pass (TDD: RED → GREEN → REFACTOR)
+- [ ] Error handling implemented
+- [ ] Logging added
+- [ ] Code coverage ≥ 80%
+
+## 📤 Output
+
+- API routes files
+- Tests files
+- Update flags.json

package/template/.claude/templates/phases-sections/business-logic-validation.md

@@ -0,0 +1,16 @@
+# Phase: Business Logic Validation
+
+**Agent:** `integration`
+**Metadata:** `| validation |`
+**Estimated time:** 10 minutes
+
+## 🎯 Purpose
+Validate implementation matches business requirements from proposal.
+
+## ✅ Success Criteria
+- [ ] All requirements from proposal covered
+- [ ] No discrepancies found
+
+## 📤 Output
+- Validation report
+- Update flags.json

package/template/.claude/templates/phases-sections/component-tests.md

@@ -0,0 +1,17 @@
+# Phase: Component Tests
+
+**Agent:** `test-debug`
+**Metadata:** `| unit-test | frontend |`
+**Estimated time:** 20 minutes
+
+## 🎯 Purpose
+Write unit tests for frontend components.
+
+## ✅ Success Criteria
+- [ ] All component tests pass
+- [ ] Coverage ≥ 70%
+
+## 📤 Output
+- Test files
+- Coverage report
+- Update flags.json

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

@@ -0,0 +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

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

@@ -0,0 +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

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

@@ -0,0 +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

package/template/.claude/templates/phases-sections/documentation.md

@@ -0,0 +1,17 @@
+# Phase: Documentation
+
+**Agent:** `integration`
+**Metadata:** `| documentation |`
+**Estimated time:** 15 minutes
+
+## 🎯 Purpose
+Update documentation (README, JSDoc, API docs).
+
+## ✅ Success Criteria
+- [ ] README updated
+- [ ] JSDoc comments added
+- [ ] API docs generated
+
+## 📤 Output
+- Documentation files
+- Update flags.json

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

@@ -0,0 +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

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

@@ -0,0 +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

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

@@ -0,0 +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

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

@@ -0,0 +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)
+```

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

@@ -0,0 +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

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

@@ -0,0 +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

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

@@ -0,0 +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

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

@@ -0,0 +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

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

@@ -0,0 +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

package/template/.claude/templates/phases-sections/report.md

@@ -0,0 +1,16 @@
+# Phase: Final Report
+
+**Agent:** `integration`
+**Metadata:** `| report |`
+**Estimated time:** 10 minutes
+
+## 🎯 Purpose
+Generate verbose report for archive.
+
+## ✅ Success Criteria
+- [ ] Report generated with all stats
+- [ ] Ready to archive
+
+## 📤 Output
+- .claude/report.md
+- Update flags.json

package/template/.claude/templates/phases-sections/responsive-test.md

@@ -0,0 +1,16 @@
+# Phase: Responsive Test
+
+**Agent:** `user`
+**Metadata:** `| manual-test | responsive |`
+**Estimated time:** 15 minutes
+
+## 🎯 Purpose
+Manual testing of responsive design across breakpoints.
+
+## ✅ Success Criteria
+- [ ] Desktop layout works
+- [ ] Tablet layout works
+- [ ] Mobile layout works
+
+## 📤 Output
+- Update flags.json with test results