@champpaba/claude-agent-kit 1.6.0 → 1.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (72) hide show
  1. package/.claude/CHANGELOG-v1.1.1.md +259 -259
  2. package/.claude/CLAUDE.md +21 -6
  3. package/.claude/agents/01-integration.md +1 -1
  4. package/.claude/agents/02-uxui-frontend.md +1 -1
  5. package/.claude/agents/03-test-debug.md +1 -1
  6. package/.claude/agents/04-frontend.md +1 -1
  7. package/.claude/agents/05-backend.md +1 -1
  8. package/.claude/agents/06-database.md +1 -1
  9. package/.claude/commands/agentsetup.md +1464 -1464
  10. package/.claude/commands/cdev.md +3 -4
  11. package/.claude/commands/csetup.md +82 -3
  12. package/.claude/commands/cstatus.md +60 -60
  13. package/.claude/commands/cview.md +364 -364
  14. package/.claude/commands/psetup.md +101 -101
  15. package/.claude/contexts/design/accessibility.md +611 -611
  16. package/.claude/contexts/design/layout.md +400 -400
  17. package/.claude/contexts/design/responsive.md +551 -551
  18. package/.claude/contexts/design/shadows.md +522 -522
  19. package/.claude/contexts/design/typography.md +465 -465
  20. package/.claude/contexts/domain/README.md +164 -164
  21. package/.claude/contexts/patterns/agent-coordination.md +388 -388
  22. package/.claude/contexts/patterns/agent-discovery.md +182 -182
  23. package/.claude/contexts/patterns/change-workflow.md +538 -538
  24. package/.claude/contexts/patterns/code-standards.md +515 -515
  25. package/.claude/contexts/patterns/development-principles.md +513 -513
  26. package/.claude/contexts/patterns/error-handling.md +478 -478
  27. package/.claude/contexts/patterns/error-recovery.md +365 -365
  28. package/.claude/contexts/patterns/logging.md +424 -424
  29. package/.claude/contexts/patterns/task-breakdown.md +452 -452
  30. package/.claude/contexts/patterns/task-classification.md +523 -523
  31. package/.claude/contexts/patterns/tdd-classification.md +516 -516
  32. package/.claude/contexts/patterns/testing.md +413 -413
  33. package/.claude/contexts/patterns/validation-framework.md +776 -776
  34. package/.claude/lib/agent-executor.md +450 -1
  35. package/.claude/lib/agent-router.md +572 -572
  36. package/.claude/lib/detailed-guides/agent-system.md +11 -9
  37. package/.claude/lib/detailed-guides/incremental-testing.md +460 -0
  38. package/.claude/lib/flags-updater.md +469 -469
  39. package/.claude/lib/task-analyzer.md +398 -2
  40. package/.claude/lib/tdd-classifier.md +345 -345
  41. package/.claude/lib/validation-gates.md +484 -484
  42. package/.claude/settings.local.json +42 -42
  43. package/.claude/templates/context-template.md +45 -45
  44. package/.claude/templates/flags-template.json +42 -42
  45. package/.claude/templates/phase-templates.json +173 -124
  46. package/.claude/templates/phases-sections/accessibility-test.md +17 -17
  47. package/.claude/templates/phases-sections/api-design.md +37 -37
  48. package/.claude/templates/phases-sections/backend-tests.md +16 -16
  49. package/.claude/templates/phases-sections/backend.md +37 -37
  50. package/.claude/templates/phases-sections/business-logic-validation.md +16 -16
  51. package/.claude/templates/phases-sections/component-tests.md +17 -17
  52. package/.claude/templates/phases-sections/contract-backend.md +16 -16
  53. package/.claude/templates/phases-sections/contract-frontend.md +16 -16
  54. package/.claude/templates/phases-sections/database.md +35 -35
  55. package/.claude/templates/phases-sections/documentation.md +17 -17
  56. package/.claude/templates/phases-sections/e2e-tests.md +16 -16
  57. package/.claude/templates/phases-sections/fix-implementation.md +17 -17
  58. package/.claude/templates/phases-sections/frontend-integration.md +18 -18
  59. package/.claude/templates/phases-sections/frontend-mockup.md +123 -123
  60. package/.claude/templates/phases-sections/manual-flow-test.md +15 -15
  61. package/.claude/templates/phases-sections/manual-ux-test.md +16 -16
  62. package/.claude/templates/phases-sections/refactor-implementation.md +17 -17
  63. package/.claude/templates/phases-sections/refactor.md +16 -16
  64. package/.claude/templates/phases-sections/regression-tests.md +15 -15
  65. package/.claude/templates/phases-sections/report.md +16 -16
  66. package/.claude/templates/phases-sections/responsive-test.md +16 -16
  67. package/.claude/templates/phases-sections/script-implementation.md +43 -43
  68. package/.claude/templates/phases-sections/test-coverage.md +16 -16
  69. package/.claude/templates/phases-sections/user-approval.md +14 -14
  70. package/LICENSE +21 -21
  71. package/README.md +171 -35
  72. package/package.json +1 -1
@@ -1,37 +1,37 @@
1
- # Phase: API Specification
2
-
3
- **Agent:** `integration`
4
- **Metadata:** `| api-design |`
5
- **Estimated time:** 30 minutes
6
-
7
- ## 🎯 Purpose
8
-
9
- Create OpenAPI 3.0 specification for all API endpoints. Define request/response schemas, validation rules, and error responses.
10
-
11
- ## 📚 Context Loading
12
-
13
- - ✅ `../proposal.md` → Business requirements
14
- - ✅ `../tasks.md` → API endpoints to implement
15
- - ✅ Frontend mockup code → Data requirements
16
- - ⚠️ `error-handling.md` → API error patterns
17
-
18
- ## 📝 Tasks
19
-
20
- 1. Analyze frontend mockup → Determine data needs
21
- 2. Design API endpoints (RESTful)
22
- 3. Define request/response schemas (JSON Schema)
23
- 4. Define error responses (4xx, 5xx)
24
- 5. Create OpenAPI 3.0 spec file
25
-
26
- ## ✅ Success Criteria
27
-
28
- - [ ] OpenAPI 3.0 spec complete
29
- - [ ] All endpoints documented
30
- - [ ] Request/response schemas defined with examples
31
- - [ ] Error responses defined
32
-
33
- ## 📤 Output
34
-
35
- - `.claude/openapi.yaml` (OpenAPI 3.0 spec)
36
- - API documentation (Swagger UI / Redoc)
37
- - Update flags.json
1
+ # Phase: API Specification
2
+
3
+ **Agent:** `integration`
4
+ **Metadata:** `| api-design |`
5
+ **Estimated time:** 30 minutes
6
+
7
+ ## 🎯 Purpose
8
+
9
+ Create OpenAPI 3.0 specification for all API endpoints. Define request/response schemas, validation rules, and error responses.
10
+
11
+ ## 📚 Context Loading
12
+
13
+ - ✅ `../proposal.md` → Business requirements
14
+ - ✅ `../tasks.md` → API endpoints to implement
15
+ - ✅ Frontend mockup code → Data requirements
16
+ - ⚠️ `error-handling.md` → API error patterns
17
+
18
+ ## 📝 Tasks
19
+
20
+ 1. Analyze frontend mockup → Determine data needs
21
+ 2. Design API endpoints (RESTful)
22
+ 3. Define request/response schemas (JSON Schema)
23
+ 4. Define error responses (4xx, 5xx)
24
+ 5. Create OpenAPI 3.0 spec file
25
+
26
+ ## ✅ Success Criteria
27
+
28
+ - [ ] OpenAPI 3.0 spec complete
29
+ - [ ] All endpoints documented
30
+ - [ ] Request/response schemas defined with examples
31
+ - [ ] Error responses defined
32
+
33
+ ## 📤 Output
34
+
35
+ - `.claude/openapi.yaml` (OpenAPI 3.0 spec)
36
+ - API documentation (Swagger UI / Redoc)
37
+ - Update flags.json
@@ -1,16 +1,16 @@
1
- # Phase: Backend Tests
2
-
3
- **Agent:** `test-debug`
4
- **Metadata:** `| automated | TDD |`
5
- **Estimated time:** 15 minutes
6
-
7
- ## 🎯 Purpose
8
- Run unit and integration tests for backend.
9
-
10
- ## ✅ Success Criteria
11
- - [ ] All tests pass
12
- - [ ] Coverage ≥ 80%
13
-
14
- ## 📤 Output
15
- - Coverage report
16
- - Update flags.json
1
+ # Phase: Backend Tests
2
+
3
+ **Agent:** `test-debug`
4
+ **Metadata:** `| automated | TDD |`
5
+ **Estimated time:** 15 minutes
6
+
7
+ ## 🎯 Purpose
8
+ Run unit and integration tests for backend.
9
+
10
+ ## ✅ Success Criteria
11
+ - [ ] All tests pass
12
+ - [ ] Coverage ≥ 80%
13
+
14
+ ## 📤 Output
15
+ - Coverage report
16
+ - Update flags.json
@@ -1,37 +1,37 @@
1
- # Phase: Backend Implementation
2
-
3
- **Agent:** `backend`
4
- **Metadata:** `| TDD | api-work | production |`
5
- **Estimated time:** 120 minutes
6
-
7
- ## 🎯 Purpose
8
-
9
- Implement API endpoints following OpenAPI specification. Include business logic, validation, error handling, and logging.
10
-
11
- ## 📚 Context Loading
12
-
13
- - ✅ `tech-stack.md` → Package manager, framework version
14
- - ✅ `.claude/openapi.yaml` → API contract
15
- - ✅ `testing.md` (RED-GREEN-REFACTOR section)
16
- - ✅ `error-handling.md` → API error patterns
17
- - ✅ `logging.md` → Production logging
18
-
19
- ## 📝 Follow TDD (RED → GREEN → REFACTOR)
20
-
21
- 1. **RED:** Write failing tests first
22
- 2. **GREEN:** Implement to pass tests
23
- 3. **REFACTOR:** Clean up code
24
-
25
- ## ✅ Success Criteria
26
-
27
- - [ ] All endpoints implemented (match OpenAPI spec)
28
- - [ ] All tests pass (TDD: RED → GREEN → REFACTOR)
29
- - [ ] Error handling implemented
30
- - [ ] Logging added
31
- - [ ] Code coverage ≥ 80%
32
-
33
- ## 📤 Output
34
-
35
- - API routes files
36
- - Tests files
37
- - Update flags.json
1
+ # Phase: Backend Implementation
2
+
3
+ **Agent:** `backend`
4
+ **Metadata:** `| TDD | api-work | production |`
5
+ **Estimated time:** 120 minutes
6
+
7
+ ## 🎯 Purpose
8
+
9
+ Implement API endpoints following OpenAPI specification. Include business logic, validation, error handling, and logging.
10
+
11
+ ## 📚 Context Loading
12
+
13
+ - ✅ `tech-stack.md` → Package manager, framework version
14
+ - ✅ `.claude/openapi.yaml` → API contract
15
+ - ✅ `testing.md` (RED-GREEN-REFACTOR section)
16
+ - ✅ `error-handling.md` → API error patterns
17
+ - ✅ `logging.md` → Production logging
18
+
19
+ ## 📝 Follow TDD (RED → GREEN → REFACTOR)
20
+
21
+ 1. **RED:** Write failing tests first
22
+ 2. **GREEN:** Implement to pass tests
23
+ 3. **REFACTOR:** Clean up code
24
+
25
+ ## ✅ Success Criteria
26
+
27
+ - [ ] All endpoints implemented (match OpenAPI spec)
28
+ - [ ] All tests pass (TDD: RED → GREEN → REFACTOR)
29
+ - [ ] Error handling implemented
30
+ - [ ] Logging added
31
+ - [ ] Code coverage ≥ 80%
32
+
33
+ ## 📤 Output
34
+
35
+ - API routes files
36
+ - Tests files
37
+ - Update flags.json
@@ -1,16 +1,16 @@
1
- # Phase: Business Logic Validation
2
-
3
- **Agent:** `integration`
4
- **Metadata:** `| validation |`
5
- **Estimated time:** 10 minutes
6
-
7
- ## 🎯 Purpose
8
- Validate implementation matches business requirements from proposal.
9
-
10
- ## ✅ Success Criteria
11
- - [ ] All requirements from proposal covered
12
- - [ ] No discrepancies found
13
-
14
- ## 📤 Output
15
- - Validation report
16
- - Update flags.json
1
+ # Phase: Business Logic Validation
2
+
3
+ **Agent:** `integration`
4
+ **Metadata:** `| validation |`
5
+ **Estimated time:** 10 minutes
6
+
7
+ ## 🎯 Purpose
8
+ Validate implementation matches business requirements from proposal.
9
+
10
+ ## ✅ Success Criteria
11
+ - [ ] All requirements from proposal covered
12
+ - [ ] No discrepancies found
13
+
14
+ ## 📤 Output
15
+ - Validation report
16
+ - Update flags.json
@@ -1,17 +1,17 @@
1
- # Phase: Component Tests
2
-
3
- **Agent:** `test-debug`
4
- **Metadata:** `| unit-test | frontend |`
5
- **Estimated time:** 20 minutes
6
-
7
- ## 🎯 Purpose
8
- Write unit tests for frontend components.
9
-
10
- ## ✅ Success Criteria
11
- - [ ] All component tests pass
12
- - [ ] Coverage ≥ 70%
13
-
14
- ## 📤 Output
15
- - Test files
16
- - Coverage report
17
- - Update flags.json
1
+ # Phase: Component Tests
2
+
3
+ **Agent:** `test-debug`
4
+ **Metadata:** `| unit-test | frontend |`
5
+ **Estimated time:** 20 minutes
6
+
7
+ ## 🎯 Purpose
8
+ Write unit tests for frontend components.
9
+
10
+ ## ✅ Success Criteria
11
+ - [ ] All component tests pass
12
+ - [ ] Coverage ≥ 70%
13
+
14
+ ## 📤 Output
15
+ - Test files
16
+ - Coverage report
17
+ - Update flags.json
@@ -1,16 +1,16 @@
1
- # Phase: Contract Test (Backend)
2
-
3
- **Agent:** `integration`
4
- **Metadata:** `| contract | validation |`
5
- **Estimated time:** 10 minutes
6
-
7
- ## 🎯 Purpose
8
- Validate backend implementation matches OpenAPI spec.
9
-
10
- ## ✅ Success Criteria
11
- - [ ] All endpoints match spec
12
- - [ ] No schema violations
13
-
14
- ## 📤 Output
15
- - Contract test report
16
- - Update flags.json
1
+ # Phase: Contract Test (Backend)
2
+
3
+ **Agent:** `integration`
4
+ **Metadata:** `| contract | validation |`
5
+ **Estimated time:** 10 minutes
6
+
7
+ ## 🎯 Purpose
8
+ Validate backend implementation matches OpenAPI spec.
9
+
10
+ ## ✅ Success Criteria
11
+ - [ ] All endpoints match spec
12
+ - [ ] No schema violations
13
+
14
+ ## 📤 Output
15
+ - Contract test report
16
+ - Update flags.json
@@ -1,16 +1,16 @@
1
- # Phase: Contract Test (Frontend)
2
-
3
- **Agent:** `integration`
4
- **Metadata:** `| contract | validation |`
5
- **Estimated time:** 10 minutes
6
-
7
- ## 🎯 Purpose
8
- Validate frontend API calls match backend responses.
9
-
10
- ## ✅ Success Criteria
11
- - [ ] All API calls match backend contract
12
- - [ ] No contract violations
13
-
14
- ## 📤 Output
15
- - Contract test report
16
- - Update flags.json
1
+ # Phase: Contract Test (Frontend)
2
+
3
+ **Agent:** `integration`
4
+ **Metadata:** `| contract | validation |`
5
+ **Estimated time:** 10 minutes
6
+
7
+ ## 🎯 Purpose
8
+ Validate frontend API calls match backend responses.
9
+
10
+ ## ✅ Success Criteria
11
+ - [ ] All API calls match backend contract
12
+ - [ ] No contract violations
13
+
14
+ ## 📤 Output
15
+ - Contract test report
16
+ - Update flags.json
@@ -1,35 +1,35 @@
1
- # Phase: Database Schema
2
-
3
- **Agent:** `database`
4
- **Metadata:** `| prisma | migration |`
5
- **Estimated time:** 30 minutes
6
-
7
- ## 🎯 Purpose
8
-
9
- Design database schema, create migrations, add indexes for performance.
10
-
11
- ## 📚 Context Loading
12
-
13
- - ✅ `tech-stack.md` → Database ORM (Prisma, SQLAlchemy, etc.)
14
- - ✅ `../proposal.md` → Data requirements
15
- - ✅ Best practices for ORM
16
-
17
- ## 📝 Tasks
18
-
19
- 1. Design Prisma/SQLAlchemy schema
20
- 2. Create migration
21
- 3. Add indexes for frequently queried fields
22
- 4. Add foreign keys and constraints
23
-
24
- ## ✅ Success Criteria
25
-
26
- - [ ] Schema designed and created
27
- - [ ] Migration created and applied
28
- - [ ] Indexes added for performance
29
- - [ ] No migration conflicts
30
-
31
- ## 📤 Output
32
-
33
- - Schema file (schema.prisma / models.py)
34
- - Migration files
35
- - Update flags.json
1
+ # Phase: Database Schema
2
+
3
+ **Agent:** `database`
4
+ **Metadata:** `| prisma | migration |`
5
+ **Estimated time:** 30 minutes
6
+
7
+ ## 🎯 Purpose
8
+
9
+ Design database schema, create migrations, add indexes for performance.
10
+
11
+ ## 📚 Context Loading
12
+
13
+ - ✅ `tech-stack.md` → Database ORM (Prisma, SQLAlchemy, etc.)
14
+ - ✅ `../proposal.md` → Data requirements
15
+ - ✅ Best practices for ORM
16
+
17
+ ## 📝 Tasks
18
+
19
+ 1. Design Prisma/SQLAlchemy schema
20
+ 2. Create migration
21
+ 3. Add indexes for frequently queried fields
22
+ 4. Add foreign keys and constraints
23
+
24
+ ## ✅ Success Criteria
25
+
26
+ - [ ] Schema designed and created
27
+ - [ ] Migration created and applied
28
+ - [ ] Indexes added for performance
29
+ - [ ] No migration conflicts
30
+
31
+ ## 📤 Output
32
+
33
+ - Schema file (schema.prisma / models.py)
34
+ - Migration files
35
+ - Update flags.json
@@ -1,17 +1,17 @@
1
- # Phase: Documentation
2
-
3
- **Agent:** `integration`
4
- **Metadata:** `| documentation |`
5
- **Estimated time:** 15 minutes
6
-
7
- ## 🎯 Purpose
8
- Update documentation (README, JSDoc, API docs).
9
-
10
- ## ✅ Success Criteria
11
- - [ ] README updated
12
- - [ ] JSDoc comments added
13
- - [ ] API docs generated
14
-
15
- ## 📤 Output
16
- - Documentation files
17
- - Update flags.json
1
+ # Phase: Documentation
2
+
3
+ **Agent:** `integration`
4
+ **Metadata:** `| documentation |`
5
+ **Estimated time:** 15 minutes
6
+
7
+ ## 🎯 Purpose
8
+ Update documentation (README, JSDoc, API docs).
9
+
10
+ ## ✅ Success Criteria
11
+ - [ ] README updated
12
+ - [ ] JSDoc comments added
13
+ - [ ] API docs generated
14
+
15
+ ## 📤 Output
16
+ - Documentation files
17
+ - Update flags.json
@@ -1,16 +1,16 @@
1
- # Phase: E2E Tests
2
-
3
- **Agent:** `test-debug`
4
- **Metadata:** `| e2e | playwright |`
5
- **Estimated time:** 30 minutes
6
-
7
- ## 🎯 Purpose
8
- End-to-end testing of complete user journeys.
9
-
10
- ## ✅ Success Criteria
11
- - [ ] E2E tests pass
12
- - [ ] Complete user journey tested
13
-
14
- ## 📤 Output
15
- - E2E test files
16
- - Update flags.json
1
+ # Phase: E2E Tests
2
+
3
+ **Agent:** `test-debug`
4
+ **Metadata:** `| e2e | playwright |`
5
+ **Estimated time:** 30 minutes
6
+
7
+ ## 🎯 Purpose
8
+ End-to-end testing of complete user journeys.
9
+
10
+ ## ✅ Success Criteria
11
+ - [ ] E2E tests pass
12
+ - [ ] Complete user journey tested
13
+
14
+ ## 📤 Output
15
+ - E2E test files
16
+ - Update flags.json
@@ -1,17 +1,17 @@
1
- # Phase: Fix Implementation
2
-
3
- **Agent:** (varies based on bug location)
4
- **Metadata:** `| bug-fix |`
5
- **Estimated time:** 30 minutes
6
-
7
- ## 🎯 Purpose
8
- Fix bug and restore intended functionality.
9
-
10
- ## ✅ Success Criteria
11
- - [ ] Bug fixed
12
- - [ ] Tests added to prevent regression
13
-
14
- ## 📤 Output
15
- - Fixed code
16
- - Tests
17
- - Update flags.json
1
+ # Phase: Fix Implementation
2
+
3
+ **Agent:** (varies based on bug location)
4
+ **Metadata:** `| bug-fix |`
5
+ **Estimated time:** 30 minutes
6
+
7
+ ## 🎯 Purpose
8
+ Fix bug and restore intended functionality.
9
+
10
+ ## ✅ Success Criteria
11
+ - [ ] Bug fixed
12
+ - [ ] Tests added to prevent regression
13
+
14
+ ## 📤 Output
15
+ - Fixed code
16
+ - Tests
17
+ - Update flags.json
@@ -1,18 +1,18 @@
1
- # Phase: Frontend Integration
2
-
3
- **Agent:** `frontend`
4
- **Metadata:** `| api-work | TDD |`
5
- **Estimated time:** 60 minutes
6
-
7
- ## 🎯 Purpose
8
- Replace mockup data with real API calls using TanStack Query.
9
-
10
- ## ✅ Success Criteria
11
- - [ ] Mockup replaced with real API
12
- - [ ] Loading states working
13
- - [ ] Error handling implemented
14
-
15
- ## 📤 Output
16
- - Updated components
17
- - Hooks for API calls
18
- - Update flags.json
1
+ # Phase: Frontend Integration
2
+
3
+ **Agent:** `frontend`
4
+ **Metadata:** `| api-work | TDD |`
5
+ **Estimated time:** 60 minutes
6
+
7
+ ## 🎯 Purpose
8
+ Replace mockup data with real API calls using TanStack Query.
9
+
10
+ ## ✅ Success Criteria
11
+ - [ ] Mockup replaced with real API
12
+ - [ ] Loading states working
13
+ - [ ] Error handling implemented
14
+
15
+ ## 📤 Output
16
+ - Updated components
17
+ - Hooks for API calls
18
+ - Update flags.json