@champpaba/claude-agent-kit 1.6.0 → 1.7.0

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

@@ -1,123 +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)
-```
+# 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/.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/report.md

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