@champpaba/claude-agent-kit 2.6.0 → 2.7.0

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

@@ -1,37 +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
+# 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/.claude/templates/phases-sections/business-logic-validation.md

@@ -1,16 +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
+# 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/.claude/templates/phases-sections/component-tests.md

@@ -1,17 +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
+# 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/.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/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

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

@@ -1,16 +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
+# 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

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

@@ -1,43 +1,43 @@
-# Phase: Script Implementation
-
-**Agent:** `backend` (reused for scripts)
-**Metadata:** `| TDD | script | cli |`
-**Estimated time:** 60 minutes
-
-## 🎯 Purpose
-
-Implement CLI tool or background script with proper error handling, logging, and user-friendly output.
-
-## 📚 Context Loading
-
-- ✅ `tech-stack.md` → Python/Node.js version, package manager
-- ✅ `testing.md` (TDD: RED-GREEN-REFACTOR)
-- ✅ `error-handling.md` → Network/file errors
-- ✅ `logging.md` → CLI logging patterns
-- ❌ Skip: API-specific contexts
-
-## 📝 Follow TDD
-
-This is a **CLI script**, not an API.
-
-Focus on:
-- CLI argument parsing (Click/argparse/yargs)
-- Progress indicators (tqdm/ora)
-- Exit codes (0 = success, 1 = error)
-- User-friendly error messages
-- File I/O operations
-- Network requests (if applicable)
-
-## ✅ Success Criteria
-
-- [ ] Script functionality implemented
-- [ ] CLI arguments working
-- [ ] Progress indicators shown
-- [ ] Error handling implemented
-- [ ] Tests pass (≥80% coverage)
-
-## 📤 Output
-
-- Script files
-- Test files
-- Update flags.json
+# Phase: Script Implementation
+
+**Agent:** `backend` (reused for scripts)
+**Metadata:** `| TDD | script | cli |`
+**Estimated time:** 60 minutes
+
+## 🎯 Purpose
+
+Implement CLI tool or background script with proper error handling, logging, and user-friendly output.
+
+## 📚 Context Loading
+
+- ✅ `tech-stack.md` → Python/Node.js version, package manager
+- ✅ `testing.md` (TDD: RED-GREEN-REFACTOR)
+- ✅ `error-handling.md` → Network/file errors
+- ✅ `logging.md` → CLI logging patterns
+- ❌ Skip: API-specific contexts
+
+## 📝 Follow TDD
+
+This is a **CLI script**, not an API.
+
+Focus on:
+- CLI argument parsing (Click/argparse/yargs)
+- Progress indicators (tqdm/ora)
+- Exit codes (0 = success, 1 = error)
+- User-friendly error messages
+- File I/O operations
+- Network requests (if applicable)
+
+## ✅ Success Criteria
+
+- [ ] Script functionality implemented
+- [ ] CLI arguments working
+- [ ] Progress indicators shown
+- [ ] Error handling implemented
+- [ ] Tests pass (≥80% coverage)
+
+## 📤 Output
+
+- Script files
+- Test files
+- Update flags.json