@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
@@ -183,7 +183,7 @@ Run \`/designsetup\` to generate project-specific design system.
183
183
  const prompt = buildAgentPrompt(phase, changeContext)
184
184
 
185
185
  // 4.2: Execute agent with retry & validation
186
- output(`\nšŸš€ Invoking ${phase.agent} agent (model: haiku)...`)
186
+ output(`\nšŸš€ Invoking ${phase.agent} agent (model: opus)...`)
187
187
 
188
188
  const result = await executeAgentWithRetry(
189
189
  phase.agent,
@@ -240,9 +240,8 @@ if (result.success) {
240
240
  3. **escalateToUser()**: See `.claude/lib/agent-executor.md`
241
241
 
242
242
  **Model Strategy:**
243
- - All agents use `model: haiku` (fixed)
244
- - Haiku performs excellently with detailed context
245
- - 12-20x cheaper than sonnet
243
+ - All agents use `model: opus` (fixed)
244
+ - Opus 4.5 is the latest Claude model with best performance
246
245
  - Quality maintained through comprehensive validation framework
247
246
 
248
247
  ---
@@ -201,6 +201,10 @@ for (const task of tasks) {
201
201
  // Sort by priority (CRITICAL → HIGH → MEDIUM → LOW)
202
202
  analyzedTasks.sort((a, b) => b.priority.score - a.priority.score)
203
203
 
204
+ // Calculate testing strategy stats (NEW in v1.4.0)
205
+ const incrementalTasks = analyzedTasks.filter(t => t.testingStrategy?.type === 'incremental')
206
+ const totalMilestones = incrementalTasks.reduce((sum, t) => sum + (t.testingStrategy?.milestones?.length || 0), 0)
207
+
204
208
  // Store for phases.md generation
205
209
  const taskAnalysis = {
206
210
  tasks: analyzedTasks,
@@ -219,7 +223,11 @@ const taskAnalysis = {
219
223
  },
220
224
  researchRequired: analyzedTasks.filter(t => t.research?.required).length,
221
225
  subtasksExpanded: analyzedTasks.filter(t => t.subtasks.length > 0).length,
222
- averageComplexity: (analyzedTasks.reduce((sum, t) => sum + t.complexity.score, 0) / analyzedTasks.length).toFixed(1)
226
+ averageComplexity: (analyzedTasks.reduce((sum, t) => sum + t.complexity.score, 0) / analyzedTasks.length).toFixed(1),
227
+ // NEW: Incremental Testing stats
228
+ incrementalTesting: incrementalTasks.length,
229
+ standardTesting: analyzedTasks.length - incrementalTasks.length,
230
+ totalMilestones: totalMilestones
223
231
  }
224
232
  }
225
233
  ```
@@ -244,6 +252,13 @@ const taskAnalysis = {
244
252
  āš ļø MEDIUM risk: 3 tasks
245
253
  āœ… LOW risk: 3 tasks
246
254
 
255
+ šŸ”„ Testing Strategy (NEW in v1.4.0):
256
+ šŸ”„ Incremental: 3 tasks (11 milestones total)
257
+ → Payment integration (4 milestones)
258
+ → Auth system (4 milestones)
259
+ → User data migration (3 milestones)
260
+ ā–¶ļø Standard: 5 tasks
261
+
247
262
  šŸ”¬ Research Required: 2 tasks
248
263
  - React Query v5 migration (15 min)
249
264
  - Stripe payment best practices (15 min)
@@ -360,7 +375,7 @@ const allPhases = [...researchPhases, ...phaseSections]
360
375
 
361
376
  ---
362
377
 
363
- ## šŸ“Š Task Analysis Summary (v1.3.0 - TaskMaster-style)
378
+ ## šŸ“Š Task Analysis Summary (v1.4.0 - Incremental Testing)
364
379
 
365
380
  **Analyzed Tasks:** {taskAnalysis.summary.total}
366
381
  **Average Complexity:** {taskAnalysis.summary.averageComplexity}/10
@@ -376,6 +391,10 @@ const allPhases = [...researchPhases, ...phaseSections]
376
391
  - āš ļø MEDIUM risk: {taskAnalysis.summary.risk.medium} tasks
377
392
  - āœ… LOW risk: {taskAnalysis.summary.risk.low} tasks
378
393
 
394
+ **Testing Strategy:** (NEW in v1.4.0)
395
+ - šŸ”„ Incremental: {taskAnalysis.summary.incrementalTesting} tasks ({taskAnalysis.summary.totalMilestones} milestones)
396
+ - ā–¶ļø Standard: {taskAnalysis.summary.standardTesting} tasks
397
+
379
398
  **Research Phases:** {taskAnalysis.summary.researchRequired} added
380
399
  **Subtasks Expanded:** {taskAnalysis.summary.subtasksExpanded} tasks
381
400
 
@@ -435,7 +454,10 @@ ${allPhases.map((phaseSection, index) => {
435
454
  )
436
455
 
437
456
  let metadata = ''
457
+ let milestonesSection = ''
458
+
438
459
  if (matchingTask) {
460
+ // Standard metadata
439
461
  metadata = `
440
462
  **Task Metadata (TaskMaster Analysis):**
441
463
  - **Complexity:** ${matchingTask.complexity.score}/10 (${matchingTask.complexity.level})
@@ -452,9 +474,66 @@ ${matchingTask.risk.mitigation.length > 0 ? ` - Mitigation:\n${matchingTask.ris
452
474
 
453
475
  ${matchingTask.subtasks.length > 0 ? `**Subtasks:**\n${matchingTask.subtasks.map(st => ` - ${st.id}: ${st.description} (${st.estimatedTime} min)`).join('\n')}\n` : ''}
454
476
  `
477
+
478
+ // NEW: Incremental Testing Milestones (v1.4.0)
479
+ if (matchingTask.testingStrategy?.type === 'incremental' && matchingTask.testingStrategy.milestones) {
480
+ metadata += `
481
+ **Testing Strategy:** šŸ”„ INCREMENTAL
482
+ - **Reason:** ${matchingTask.testingStrategy.reason}
483
+ - **Total Milestones:** ${matchingTask.testingStrategy.milestones.length}
484
+
485
+ `
486
+
487
+ // Generate milestone subsections
488
+ milestonesSection = matchingTask.testingStrategy.milestones.map(milestone => `
489
+ #### Milestone ${milestone.id}/${matchingTask.testingStrategy.milestones.length}: ${milestone.name}
490
+
491
+ **Test Scope:** ${milestone.testScope}
492
+ **Estimated Time:** ${milestone.estimatedTime} min
493
+ **Retry Limit:** ${milestone.retryLimit} attempts
494
+
495
+ **Exit Criteria:**
496
+ ${milestone.exitCriteria.map(criterion => `- [ ] ${criterion}`).join('\n')}
497
+
498
+ **Instructions for Agent:**
499
+ 1. **Implement:** ${milestone.name}
500
+ 2. **Test:** ${milestone.testScope}
501
+ 3. **Validate:** Check ALL exit criteria above
502
+ 4. **Report results in this format:**
503
+
504
+ \`\`\`
505
+ ## Milestone ${milestone.id} Results
506
+
507
+ **Implementation Summary:**
508
+ [Brief description of what was implemented]
509
+
510
+ **Test Results:**
511
+ ${milestone.exitCriteria.map(criterion => `- [ ] ${criterion} - [PASS/FAIL] - [Brief explanation]`).join('\n')}
512
+
513
+ **Issues Found (if any):**
514
+ [List any issues encountered]
515
+
516
+ **Conclusion:**
517
+ [PASS → Ready for Milestone ${milestone.id + 1}]
518
+ [FAIL → Need to fix [X] before retry]
519
+ \`\`\`
520
+
521
+ 5. **IF FAILED:** Debug issues → Retry (max ${milestone.retryLimit} attempts)
522
+ 6. **IF ALL RETRIES FAIL:** Escalate to Main Claude for guidance
523
+ 7. **IF PASSED:** Proceed to ${milestone.id < matchingTask.testingStrategy.milestones.length ? `Milestone ${milestone.id + 1}` : 'next phase'}
524
+
525
+ ---
526
+ `).join('\n')
527
+ } else if (matchingTask.testingStrategy?.type === 'standard') {
528
+ metadata += `
529
+ **Testing Strategy:** ā–¶ļø STANDARD
530
+ - **Reason:** ${matchingTask.testingStrategy.reason}
531
+
532
+ `
533
+ }
455
534
  }
456
535
 
457
- return `${phaseSection}\n${metadata}`
536
+ return `${phaseSection}\n${metadata}${milestonesSection}`
458
537
  }).join('\n---\n\n')}
459
538
 
460
539
  ---
@@ -1,60 +1,60 @@
1
- ---
2
- name: Change Status
3
- description: Quick progress status for a change
4
- category: Multi-Agent
5
- tags: [status, progress, quick]
6
- ---
7
-
8
- ## Usage
9
-
10
- ```bash
11
- /cstatus {change-id}
12
- ```
13
-
14
- ## What It Does
15
-
16
- Shows quick progress summary:
17
- - Progress percentage with bar
18
- - Current phase
19
- - Time spent/remaining
20
- - Quick stats
21
-
22
- ## Output Format
23
-
24
- ```
25
- šŸ“Š CHANGE-{id}: {type} | {template}
26
-
27
- Progress: [ā–ˆā–ˆā–ˆā–ˆā–ˆā–ˆā–ˆā–ˆā–‘ā–‘] 64% (7/11 phases)
28
-
29
- Current Phase: #8 Refactor (test-debug)
30
- ā”œā”€ Started: 14:15 (15 minutes ago)
31
- ā”œā”€ Estimated: 20 minutes
32
- └─ Status: in_progress
33
-
34
- āœ… Completed: 7 phases
35
- šŸ”„ In Progress: 1 phase
36
- ā³ Remaining: 3 phases
37
-
38
- ā±ļø Time:
39
- ā”œā”€ Spent: 2h 55min (estimated: 3h 15min)
40
- ā”œā”€ Remaining: ~35 minutes
41
- └─ Efficiency: 111% (ahead of estimate)
42
-
43
- šŸ“ˆ Stats:
44
- ā”œā”€ Tests: 12 passed, 0 failed (75% coverage)
45
- ā”œā”€ Issues: 2 found, 2 fixed, 0 remaining
46
- └─ Files: 4 created, 2 modified
47
-
48
- šŸŽÆ Next Steps:
49
- 1. Complete refactoring (20 min)
50
- 2. Test coverage report (5 min)
51
- 3. Documentation (15 min)
52
-
53
- Commands:
54
- → Detailed view: /cview {change-id}
55
- → Continue dev: /cdev {change-id}
56
- ```
57
-
58
- ## Implementation
59
-
60
- Read `openspec/changes/{change-id}/.claude/flags.json` and format output using helper functions.
1
+ ---
2
+ name: Change Status
3
+ description: Quick progress status for a change
4
+ category: Multi-Agent
5
+ tags: [status, progress, quick]
6
+ ---
7
+
8
+ ## Usage
9
+
10
+ ```bash
11
+ /cstatus {change-id}
12
+ ```
13
+
14
+ ## What It Does
15
+
16
+ Shows quick progress summary:
17
+ - Progress percentage with bar
18
+ - Current phase
19
+ - Time spent/remaining
20
+ - Quick stats
21
+
22
+ ## Output Format
23
+
24
+ ```
25
+ šŸ“Š CHANGE-{id}: {type} | {template}
26
+
27
+ Progress: [ā–ˆā–ˆā–ˆā–ˆā–ˆā–ˆā–ˆā–ˆā–‘ā–‘] 64% (7/11 phases)
28
+
29
+ Current Phase: #8 Refactor (test-debug)
30
+ ā”œā”€ Started: 14:15 (15 minutes ago)
31
+ ā”œā”€ Estimated: 20 minutes
32
+ └─ Status: in_progress
33
+
34
+ āœ… Completed: 7 phases
35
+ šŸ”„ In Progress: 1 phase
36
+ ā³ Remaining: 3 phases
37
+
38
+ ā±ļø Time:
39
+ ā”œā”€ Spent: 2h 55min (estimated: 3h 15min)
40
+ ā”œā”€ Remaining: ~35 minutes
41
+ └─ Efficiency: 111% (ahead of estimate)
42
+
43
+ šŸ“ˆ Stats:
44
+ ā”œā”€ Tests: 12 passed, 0 failed (75% coverage)
45
+ ā”œā”€ Issues: 2 found, 2 fixed, 0 remaining
46
+ └─ Files: 4 created, 2 modified
47
+
48
+ šŸŽÆ Next Steps:
49
+ 1. Complete refactoring (20 min)
50
+ 2. Test coverage report (5 min)
51
+ 3. Documentation (15 min)
52
+
53
+ Commands:
54
+ → Detailed view: /cview {change-id}
55
+ → Continue dev: /cdev {change-id}
56
+ ```
57
+
58
+ ## Implementation
59
+
60
+ Read `openspec/changes/{change-id}/.claude/flags.json` and format output using helper functions.