@champpaba/claude-agent-kit 2.0.0 → 2.1.0

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/PROJECT_STATUS.template.yml

@@ -0,0 +1,105 @@
+# PROJECT_STATUS.yml
+# Cross-session context for Claude - update after significant milestones
+# Optional: Remove this file if your project doesn't need cross-session tracking
+#
+# WHY this file exists:
+# - New Claude sessions lose context about infrastructure state, blockers, and priorities
+# - Reading multiple files (README, archived proposals, tasks.md) wastes tokens
+# - This single file provides quick context snapshot for AI sessions
+
+last_updated: "YYYY-MM-DD"
+
+# Optional settings
+_config:
+  stale_warning_days: 7  # Suggest /pstatus review if older than this
+
+# -------------------------------------------------------------------
+# CURRENT FOCUS
+# What phase is the project in? What's actively being worked on?
+# -------------------------------------------------------------------
+current_focus:
+  description: "Brief description of current project phase"
+  active_change: null  # change-id if OpenSpec change in progress, null if between changes
+
+# -------------------------------------------------------------------
+# COMPLETED CHANGES
+# Recently shipped work - helps Claude understand what's already done
+# -------------------------------------------------------------------
+completed_changes: []
+  # Example:
+  # - id: auth-system
+  #   date: "2025-11-30"
+  #   summary: "Login/logout, JWT tokens, protected routes"
+  # - id: infrastructure-cicd
+  #   date: "2025-11-28"
+  #   summary: "Docker, CI/CD pipeline, Cloudflare Tunnel"
+
+# -------------------------------------------------------------------
+# INFRASTRUCTURE STATUS
+# Current state of services - helps Claude understand what's running
+# -------------------------------------------------------------------
+infrastructure: {}
+  # Example structure (customize for your project):
+  #
+  # database:
+  #   status: healthy  # healthy | degraded | down | not_setup
+  #   notes: "PostgreSQL, 4 tables deployed"
+  #
+  # api:
+  #   status: healthy
+  #   notes: "6 endpoints, running on port 3000"
+  #
+  # cloudflare_tunnel:
+  #   status: running
+  #   waiting_for: domain  # null if fully operational
+  #   notes: "Tunnel active, pending domain configuration"
+  #
+  # Status values: healthy, degraded, down, not_setup, waiting
+
+# -------------------------------------------------------------------
+# BLOCKERS
+# External dependencies blocking progress
+# Claude will avoid suggesting work that's blocked
+# -------------------------------------------------------------------
+blockers: []
+  # Example:
+  # - id: domain-config
+  #   description: "Need domain for Cloudflare public routes"
+  #   blocks: [production-launch, ssl-setup]
+  #
+  # - id: stripe-api-key
+  #   description: "Waiting for Stripe test API key from finance team"
+  #   blocks: [payment-integration]
+
+# -------------------------------------------------------------------
+# NEXT PRIORITIES
+# What should be worked on next (with reasoning)
+# Helps Claude suggest appropriate next steps
+# -------------------------------------------------------------------
+next_priorities: []
+  # Example:
+  # - id: payment-integration
+  #   reason: "Revenue blocker - needed before launch"
+  #
+  # - id: user-profile
+  #   reason: "Dependency for RIASEC save feature"
+
+# -------------------------------------------------------------------
+# NOTES
+# Free-form context that doesn't fit above
+# -------------------------------------------------------------------
+notes: |
+  Add any additional context here.
+  Examples:
+  - Dev server running on localhost:3000
+  - Test with: curl http://localhost:3000/health
+  - Staging environment: https://staging.example.com
+
+# -------------------------------------------------------------------
+# REFERENCES (optional)
+# Quick links to important project files
+# -------------------------------------------------------------------
+references:
+  # roadmap: "docs/proposal_list.md"
+  # architecture: "openspec/specs/architecture.md"
+  # style_guide: "design-system/STYLE_GUIDE.md"