@champpaba/claude-agent-kit 1.6.1 → 1.7.1

package/.claude/CLAUDE.md

@@ -1,11 +1,49 @@
 # CLAUDE.md
 
 > **Navigation Hub for AI Agents**
-> **Template Version:** 1.6.0 - Universal Multi-Agent Template
+> **Template Version:** 1.7.1 - Universal Multi-Agent Template (Opus 4.5)
 > **Latest:** Incremental Testing - Milestone-based validation for high-risk tasks with round-based retry
 
 ---
 
+## 📁 File Naming Conventions (OpenSpec + Template)
+
+> **IMPORTANT:** Avoid confusion between OpenSpec files and Template files
+
+### OpenSpec Files (from [Fission-AI/OpenSpec](https://github.com/Fission-AI/OpenSpec))
+
+| File | Purpose | When to Read |
+|------|---------|--------------|
+| `proposal.md` | WHY - Goals, scope, rationale | Phase planning |
+| `tasks.md` | WHAT - Implementation checklist | Task tracking |
+| `design.md` | **Technical/Architecture decisions** (optional) | Backend/Database phases |
+| `specs/` | Delta specs (ADDED/MODIFIED/REMOVED) | Requirement validation |
+
+### Template Files (from claude-multi-agent-template)
+
+| File | Purpose | When to Read |
+|------|---------|--------------|
+| `STYLE_GUIDE.md` | **Visual design** (colors, typography, spacing) | UI/Frontend phases |
+| `STYLE_TOKENS.json` | Lightweight design tokens (~500 tokens) | Quick UI reference |
+| `page-plan.md` | UI component layout + content strategy | uxui-frontend agent |
+| `phases.md` | Execution plan with agent assignments | All phases |
+| `flags.json` | Progress tracking | All phases |
+
+### Key Distinction
+
+```
+OpenSpec design.md    = Technical Architecture (data flow, API structure, system design)
+Template STYLE_GUIDE  = Visual Design (colors, fonts, spacing, component styles)
+```
+
+**Agents should read BOTH when relevant:**
+- `uxui-frontend` → STYLE_GUIDE.md (visual) + design.md (if has UI architecture)
+- `backend` → design.md (API/data architecture)
+- `database` → design.md (data models, relationships)
+- `frontend` → STYLE_GUIDE.md (visual) + design.md (API contracts)
+
+---
+
 ## 🎯 What is This Template?
 
 Universal, framework-agnostic template for AI-assisted development.

package/.claude/agents/01-integration.md

@@ -1,7 +1,7 @@
 ---
 name: integration
 description: Validates API contracts and coordinates multi-agent outputs
-model: haiku
+model: opus
 color: orange
 ---
 

package/.claude/agents/02-uxui-frontend.md

@@ -1,7 +1,7 @@
 ---
 name: uxui-frontend
 description: UX/UI frontend development with React/Next.js/Vue using mock data
-model: haiku
+model: opus
 color: blue
 ---
 

package/.claude/agents/03-test-debug.md

@@ -1,7 +1,7 @@
 ---
 name: test-debug
 description: Automated testing and debugging with Vitest/Jest/Playwright
-model: haiku
+model: opus
 color: red
 ---
 

package/.claude/agents/04-frontend.md

@@ -1,7 +1,7 @@
 ---
 name: frontend
 description: Frontend implementation connecting components to APIs
-model: haiku
+model: opus
 color: green
 ---
 

package/.claude/agents/05-backend.md

@@ -1,7 +1,7 @@
 ---
 name: backend
 description: Backend API development with FastAPI/Express/Django
-model: haiku
+model: opus
 color: cyan
 ---
 

package/.claude/agents/06-database.md

@@ -1,7 +1,7 @@
 ---
 name: database
 description: Database schema design and migrations with Prisma/SQLAlchemy
-model: haiku
+model: opus
 color: pink
 ---
 

package/.claude/commands/cdev.md

@@ -183,7 +183,7 @@ Run \`/designsetup\` to generate project-specific design system.
 const prompt = buildAgentPrompt(phase, changeContext)
 
 // 4.2: Execute agent with retry & validation
-output(`\n🚀 Invoking ${phase.agent} agent (model: haiku)...`)
+output(`\n🚀 Invoking ${phase.agent} agent (model: opus)...`)
 
 const result = await executeAgentWithRetry(
   phase.agent,
@@ -240,9 +240,8 @@ if (result.success) {
 3. **escalateToUser()**: See `.claude/lib/agent-executor.md`
 
 **Model Strategy:**
-- All agents use `model: haiku` (fixed)
-- Haiku performs excellently with detailed context
-- 12-20x cheaper than sonnet
+- All agents use `model: opus` (fixed)
+- Opus 4.5 is the latest Claude model with best performance
 - Quality maintained through comprehensive validation framework
 
 ---

package/.claude/contexts/patterns/agent-discovery.md

@@ -104,11 +104,15 @@ ls openspec/changes/{change-id}/.claude/
 
 4. **OpenSpec files:**
    ```bash
-   Read: openspec/changes/{change-id}/proposal.md
-   Read: openspec/changes/{change-id}/tasks.md
-   Read: openspec/changes/{change-id}/design.md  # if exists
+   Read: openspec/changes/{change-id}/proposal.md   # WHY - goals, scope
+   Read: openspec/changes/{change-id}/tasks.md      # WHAT - checklist
+   Read: openspec/changes/{change-id}/design.md     # HOW - technical architecture (if exists)
    ```
 
+   > **Note:** `design.md` = Technical/Architecture decisions (API structure, data flow)
+   > This is DIFFERENT from `STYLE_GUIDE.md` which is Visual Design (colors, fonts)
+   > See CLAUDE.md "File Naming Conventions" for details.
+
 **If change context doesn't exist:**
 - Skip Level 5 (working on general task, not OpenSpec change)
 

package/.claude/lib/agent-executor.md

@@ -80,7 +80,7 @@ auto_proceed = userApprovalGranted()  // Check if user approved workflow
 while (attempt <= max_retries):
 
   1. Invoke agent:
-     Task(agent=agentType, model='haiku', prompt=buildPrompt(auto_proceed))
+     Task(agent=agentType, model='opus', prompt=buildPrompt(auto_proceed))
 
   2. Handle agent questions (NEW!):
      If agent asks "Should I proceed?" or "Continue?":

package/.claude/lib/detailed-guides/agent-system.md

@@ -2,7 +2,7 @@
 
 > **Detailed guide to the multi-agent architecture**
 > **Source:** Extracted from CLAUDE.md (Navigation Hub)
-> **Version:** 1.4.0
+> **Version:** 1.7.0 (Opus 4.5)
 
 ---
 
@@ -29,14 +29,16 @@
 
 ## Available Agents (6 specialists)
 
-| Agent | Color | When to Use | Phase |
-|-------|-------|-------------|-------|
-| **integration** | Orange | Validate API contracts before connecting | 2.5 |
-| **uxui-frontend** | Blue | Design UI components with mock data | 1 |
-| **test-debug** | Red | Run tests and fix bugs (max 3-4 iterations) | 1,3,4 |
-| **frontend** | Green | Connect UI to backend APIs | 3 |
-| **backend** | Purple | Create API endpoints with validation | 2 |
-| **database** | Pink | Design schemas, migrations, complex queries | 2 |
+**All agents use Opus 4.5** for best-in-class reasoning and code quality.
+
+| Agent | Color | Model | When to Use | Phase |
+|-------|-------|-------|-------------|-------|
+| **integration** | Orange | opus | Validate API contracts before connecting | 2.5 |
+| **uxui-frontend** | Blue | opus | Design UI components with mock data | 1 |
+| **test-debug** | Red | opus | Run tests and fix bugs (max 3-4 iterations) | 1,3,4 |
+| **frontend** | Green | opus | Connect UI to backend APIs | 3 |
+| **backend** | Cyan | opus | Create API endpoints with validation | 2 |
+| **database** | Pink | opus | Design schemas, migrations, complex queries | 2 |
 
 ---
 

package/README.md

@@ -917,7 +917,73 @@ Built with:
 
 ---
 
-## 🆕 What's New in v1.6.0
+## 🆕 What's New in v1.7.1
+
+**Patch: OpenSpec File Naming Conventions - Clarify design.md vs STYLE_GUIDE.md** 📁
+
+### The Issue
+
+Users were confused between two files with similar names:
+- `design.md` (from OpenSpec) = Technical/Architecture decisions
+- `STYLE_GUIDE.md` (from Template) = Visual design (colors, fonts, spacing)
+
+### The Fix
+
+Added clear documentation in CLAUDE.md and agent-discovery.md:
+
+| Source | File | Purpose |
+|--------|------|---------|
+| **OpenSpec** | `design.md` | Technical Architecture (API structure, data flow) |
+| **Template** | `STYLE_GUIDE.md` | Visual Design (colors, typography, spacing) |
+
+### Updated Files
+
+- `CLAUDE.md` - New "📁 File Naming Conventions" section
+- `agent-discovery.md` - Added notes explaining design.md vs STYLE_GUIDE.md
+
+### No Breaking Changes
+
+All existing workflows continue to work. This is a documentation improvement only.
+
+---
+
+## 📋 What's New in v1.7.0
+
+**Feature: Opus 4.5 Model Upgrade - All Subagents Now Use Latest Claude Model** 🧠
+
+### The Change
+
+All 6 specialized agents now use **Claude Opus 4.5** (the latest and most capable Claude model) instead of Haiku:
+
+| Agent | Model (Before) | Model (After) |
+|-------|----------------|---------------|
+| integration | haiku | **opus** |
+| uxui-frontend | haiku | **opus** |
+| test-debug | haiku | **opus** |
+| frontend | haiku | **opus** |
+| backend | haiku | **opus** |
+| database | haiku | **opus** |
+
+### Benefits
+
+- ✅ **Best-in-class reasoning** - Opus 4.5 handles complex multi-step tasks better
+- ✅ **Improved code quality** - More accurate implementations with fewer errors
+- ✅ **Better context understanding** - Agents maintain context over longer sessions
+- ✅ **Enhanced problem-solving** - Complex debugging and architectural decisions improved
+
+### Updated Files
+
+- All agent files (`.claude/agents/*.md`) - `model: opus`
+- `/cdev` command - Model strategy updated
+- `agent-executor.md` - Task invocation uses opus
+
+### No Breaking Changes
+
+All existing workflows continue to work exactly as before, just with better performance!
+
+---
+
+## 🔄 What's New in v1.6.0
 
 **Feature: Incremental Testing - Milestone-based Validation for High-Risk Tasks** 🔄
 
@@ -1156,6 +1222,33 @@ All your customizations in `.claude/contexts/domain/` are preserved!
 
 ## 📜 Changelog
 
+### v1.7.1 (2025-11-25)
+**Patch: OpenSpec File Naming Conventions**
+
+**Added:**
+- New "📁 File Naming Conventions" section in CLAUDE.md
+- Clear distinction between OpenSpec files and Template files
+- Notes in agent-discovery.md explaining design.md purpose
+
+**Documentation:**
+- `design.md` (OpenSpec) = Technical Architecture (API, data flow)
+- `STYLE_GUIDE.md` (Template) = Visual Design (colors, fonts, spacing)
+- Updated agent reading guidance per role
+
+### v1.7.0 (2025-11-25)
+**Feature: Opus 4.5 Model Upgrade**
+
+**Changed:**
+- All 6 agents upgraded from `model: haiku` to `model: opus`
+- Updated `/cdev` model strategy description
+- Updated `agent-executor.md` Task invocation
+
+**Benefits:**
+- Best-in-class reasoning with Opus 4.5
+- Improved code quality and fewer errors
+- Better context understanding
+- Enhanced problem-solving for complex tasks
+
 ### v1.4.1 (2025-11-06)
 **Feature: Intelligent Auto-Proceed - Eliminate Double Confirmations**
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@champpaba/claude-agent-kit",
-  "version": "1.6.1",
+  "version": "1.7.1",
   "description": "Universal multi-agent template for Claude Code - AI-assisted development with specialized agents",
   "main": "bin/cli.js",
   "bin": {