@champpaba/claude-agent-kit 2.7.0 → 2.8.0

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

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

@@ -1,16 +1,16 @@
-# Phase: Test Coverage Report
-
-**Agent:** `test-debug`
-**Metadata:** `| report |`
-**Estimated time:** 5 minutes
-
-## 🎯 Purpose
-Generate final test coverage report.
-
-## ✅ Success Criteria
-- [ ] Coverage report generated
-- [ ] Coverage ≥ target
-
-## 📤 Output
-- Coverage report
-- Update flags.json
+# Phase: Test Coverage Report
+
+**Agent:** `test-debug`
+**Metadata:** `| report |`
+**Estimated time:** 5 minutes
+
+## 🎯 Purpose
+Generate final test coverage report.
+
+## ✅ Success Criteria
+- [ ] Coverage report generated
+- [ ] Coverage ≥ target
+
+## 📤 Output
+- Coverage report
+- Update flags.json

package/.claude/templates/phases-sections/user-approval.md

@@ -1,14 +1,14 @@
-# Phase: User Approval
-
-**Agent:** `user`
-**Metadata:** `| approval-gate |`
-**Estimated time:** 5 minutes
-
-## 🎯 Purpose
-User reviews and approves work before backend development starts.
-
-## ✅ Success Criteria
-- [ ] User approves mockup/implementation
-
-## 📤 Output
-- Update flags.json with approval status
+# Phase: User Approval
+
+**Agent:** `user`
+**Metadata:** `| approval-gate |`
+**Estimated time:** 5 minutes
+
+## 🎯 Purpose
+User reviews and approves work before backend development starts.
+
+## ✅ Success Criteria
+- [ ] User approves mockup/implementation
+
+## 📤 Output
+- Update flags.json with approval status

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 ChampPABA
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 ChampPABA
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -30,6 +30,7 @@ cak init
 
 ## Features
 
+- **Critical Flow Injection (v2.8.0)** - Non-negotiable security items auto-injected for auth, payment, healthcare, fintech
 - **UX-Tester Agent (v2.7.0)** - Persona-based UX testing with weighted conversion prediction
 - **Smart Topic Query (v2.5.0)** - Cross-library integration detection + risk summary
 - **Adaptive Depth Research (v2.4.0)** - Dynamic research layers (0-10+) based on change complexity
@@ -38,6 +39,30 @@ cak init
 - **Cross-session Context** - `PROJECT_STATUS.yml` maintains state across sessions
 - **Design System v2.1** - YAML-based extraction with single data.yaml output
 
+## Critical Flow Injection (v2.8.0)
+
+```
+Problem: Research is flexible, but security items are non-negotiable
+         e.g., Password hashing, PCI-DSS, HIPAA compliance
+
+Solution: Auto-inject critical items based on change analysis
+
+Detected Flows → Injected Items:
+  ├── Auth     → Password hashing, JWT secure storage, session mgmt (7 items)
+  ├── Payment  → PCI key security, no card storage, webhook verification (5 items)
+  ├── Healthcare → HIPAA: PHI encryption, access control, audit trail (5 items)
+  └── Fintech  → PCI-DSS: encryption, key rotation, audit logging (6 items)
+
+Each item has:
+  { id, check, why, severity: 'critical' }
+```
+
+**How it works:**
+1. `/csetup` analyzes change → detects `hasAuth`, `hasPayment`, `industryContext`
+2. Research layers are generated dynamically (flexible)
+3. Critical items are INJECTED into appropriate layers (non-negotiable)
+4. Agents receive checklist with both research + critical items
+
 ## Smart Topic Query (v2.5.0)
 
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@champpaba/claude-agent-kit",
-  "version": "2.7.0",
+  "version": "2.8.0",
   "description": "Universal multi-agent template for Claude Code - AI-assisted development with specialized agents",
   "main": "bin/cli.js",
   "bin": {
@@ -13,7 +13,8 @@
     ".claude/"
   ],
   "scripts": {
-    "test": "echo \"No tests yet\" && exit 0"
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "keywords": [
     "claude",
@@ -37,11 +38,14 @@
   },
   "homepage": "https://github.com/ChampPABA/claude-multi-agent-template#readme",
   "dependencies": {
+    "chalk": "^4.1.2",
     "commander": "^12.0.0",
-    "fs-extra": "^11.2.0",
-    "chalk": "^4.1.2"
+    "fs-extra": "^11.2.0"
   },
   "engines": {
     "node": ">=14.0.0"
+  },
+  "devDependencies": {
+    "vitest": "^4.0.15"
   }
 }