@champpaba/claude-agent-kit 2.1.0 → 2.1.2

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.
@@ -18,6 +18,13 @@ color: blue
18
18
 
19
19
  Complete these steps before implementation:
20
20
 
21
+ 0. **Library Requirements Check**
22
+ - Review `tasks.md` for "Install X", "Configure X" patterns
23
+ - Review `design.md` for "D1: Use X Library" decisions
24
+ - Use the specified libraries (WHY: team chose them for specific reasons)
25
+ - Example: tasks.md says "Install shadcn/ui" → Use shadcn components, follow its docs
26
+
27
+
21
28
  1. **Context Discovery** - Load project context (STEP 0)
22
29
  2. **Design Loading** - Load style guide or design principles (STEP 0.5)
23
30
  3. **Component Search** - Check existing components (STEP 3)
@@ -18,6 +18,13 @@ color: green
18
18
 
19
19
  Complete these steps before implementation:
20
20
 
21
+ 0. **Library Requirements Check**
22
+ - Review `tasks.md` for "Install X", "Configure X" patterns
23
+ - Review `design.md` for "D1: Use X Library" decisions
24
+ - Use the specified libraries (WHY: team chose them for specific reasons)
25
+ - Example: tasks.md says "Install react-query" → Use react-query, follow its docs
26
+
27
+
21
28
  1. **Pattern Loading** - Load error-handling, state management patterns
22
29
  2. **UI Review** - Read existing UI components (from uxui-frontend)
23
30
  3. **API Review** - Read API endpoints (from backend/integration)
@@ -7,7 +7,7 @@ color: cyan
7
7
 
8
8
  # Backend Agent
9
9
 
10
- > **Version:** 2.0.0 (Claude 4.5 Optimized)
10
+ > **Version:** 2.1.2 (Instruction-based Library Detection)
11
11
  > **Role:** Create API endpoints with validation, business logic, and error handling.
12
12
 
13
13
  ---
@@ -18,6 +18,12 @@ color: cyan
18
18
 
19
19
  Complete these steps before implementation:
20
20
 
21
+ 0. **Library Requirements Check**
22
+ - Review `tasks.md` for "Install X", "Configure X" patterns
23
+ - Review `design.md` for "D1: Use X Library" decisions
24
+ - Use the specified libraries (WHY: team chose them for specific reasons)
25
+ - Example: tasks.md says "Install better-auth" → Use better-auth, follow its docs
26
+
21
27
  1. **Pattern Loading** - Load error-handling, logging, testing patterns
22
28
  2. **Endpoint Search** - Check for existing similar endpoints
23
29
  3. **TDD Plan** - If TDD required, plan test cases first
@@ -7,7 +7,7 @@ color: pink
7
7
 
8
8
  # Database Agent
9
9
 
10
- > **Version:** 2.0.0 (Claude 4.5 Optimized)
10
+ > **Version:** 2.1.2 (Instruction-based Library Detection)
11
11
  > **Role:** Design schemas, create migrations, write complex queries, optimize performance.
12
12
 
13
13
  ---
@@ -18,6 +18,12 @@ color: pink
18
18
 
19
19
  Complete these steps before implementation:
20
20
 
21
+ 0. **Library Requirements Check**
22
+ - Review `tasks.md` for "Install X", "Configure X" patterns
23
+ - Review `design.md` for "D1: Use X Library" decisions
24
+ - Use the specified libraries (WHY: team chose them for specific reasons)
25
+ - Example: design.md says "Use Drizzle ORM" → Use Drizzle, follow its docs
26
+
21
27
  1. **Pattern Loading** - Load ORM patterns from Context7
22
28
  2. **Schema Search** - Check existing models/schemas
23
29
  3. **Design Plan** - Plan tables, relationships, indexes
@@ -1,6 +1,6 @@
1
1
  # Pre-Work Checklist (Shared by All Agents)
2
2
 
3
- > **Version:** 2.0.0 (Claude 4.5 Optimized)
3
+ > **Version:** 2.1.2 (Instruction-based Library Detection)
4
4
  > **Purpose:** Single source of truth for pre-work validation
5
5
 
6
6
  ---
@@ -9,6 +9,40 @@
9
9
 
10
10
  Complete these steps before implementation to ensure alignment with project standards:
11
11
 
12
+ ### Step 0: Library Requirements Check
13
+
14
+ **Scan for required libraries before writing code:**
15
+
16
+ 1. **Read `tasks.md`** - Look for these patterns:
17
+ - `Install X and dependencies` → Use library X
18
+ - `Configure X with Y adapter` → Use X with adapter Y
19
+ - Backtick packages like `better-auth` → Required dependency
20
+
21
+ 2. **Read `design.md`** - Look for these patterns:
22
+ - `### D1: Use X Library` → Decision to use X
23
+ - `**Decision:** Use X` → Chosen library
24
+ - Alternatives table → Shows why X was chosen over others
25
+
26
+ 3. **List required libraries** in your validation report
27
+
28
+ 4. **Use the libraries specified in tasks.md/design.md**
29
+ - WHY: The team chose these libraries for specific reasons (compatibility, features, constraints)
30
+ - Custom implementations waste effort and may miss edge cases the library handles
31
+
32
+ **Example:**
33
+ ```
34
+ tasks.md says: "Install better-auth and dependencies"
35
+ → Use better-auth library
36
+ → Follow better-auth documentation patterns
37
+
38
+ WHY not custom? better-auth handles OAuth flows, session management,
39
+ and security edge cases that custom code would need to re-implement.
40
+ ```
41
+
42
+ ---
43
+
44
+ ### Step 1-4: Standard Checks
45
+
12
46
  1. **Context Discovery** - Load project context via agent-discovery.md
13
47
  2. **Pattern Loading** - Load relevant patterns for your agent type
14
48
  3. **Validation Report** - Provide pre-implementation validation report
@@ -23,6 +57,11 @@ Complete these steps before implementation to ensure alignment with project stan
23
57
  ```markdown
24
58
  Pre-Implementation Validation
25
59
 
60
+ Library Requirements: (Step 0)
61
+ - [ ] Scanned tasks.md for "Install X" patterns
62
+ - [ ] Scanned design.md for design decisions
63
+ - Required libraries: {list from tasks.md/design.md}
64
+
26
65
  Project Context:
27
66
  - Project: {name}
28
67
  - Stack: {tech-stack}
@@ -41,7 +80,8 @@ Best Practices:
41
80
  Ready to Implement:
42
81
  - [ ] Task understood
43
82
  - [ ] Dependencies identified
44
- - [ ] Approach planned
83
+ - [ ] Required libraries identified
84
+ - [ ] Approach planned (using specified libraries)
45
85
  ```
46
86
 
47
87
  ---
@@ -49,9 +89,10 @@ Ready to Implement:
49
89
  ## Why This Matters
50
90
 
51
91
  Pre-work validation prevents:
92
+ - **Wrong library choices** - Using custom code when a library was already chosen by the team
52
93
  - Misaligned implementations (wrong patterns, wrong style)
53
94
  - Duplicate components (not searching existing code first)
54
95
  - Wrong package manager usage (CI/CD breaks)
55
96
  - Missing best practices (outdated patterns)
56
97
 
57
- → 80% of implementation issues caught at validation stage
98
+ → 80% of implementation issues are caught at validation stage
@@ -94,7 +94,7 @@ See: `.claude/lib/agent-executor.md` for full implementation
94
94
  ```typescript
95
95
  // Step 4: Invoke Agent with Retry & Validation
96
96
 
97
- // 4.1: Build agent prompt (with design reference + best practices - v1.8.0)
97
+ // 4.1: Build agent prompt (with design reference + best practices - v2.1.2)
98
98
  function buildAgentPrompt(phase, changeContext) {
99
99
  let prompt = `
100
100
  # Phase ${phase.phase_number}: ${phase.name}
@@ -106,6 +106,47 @@ ${changeContext.proposal}
106
106
  ${changeContext.tasks}
107
107
 
108
108
  ${phase.instructions}
109
+
110
+ ---
111
+
112
+ ## 📦 Library Requirements
113
+
114
+ **Scan for required libraries before implementation:**
115
+
116
+ 1. **Review tasks.md above** for these patterns:
117
+ - "Install X and dependencies" → Use library X
118
+ - "Configure X with Y adapter" → Use X with adapter Y
119
+ - Backtick packages like \`better-auth\` → Required dependency
120
+
121
+ 2. **Review design.md** (in change context) for:
122
+ - "### D1: Use X Library" → Decision to use X
123
+ - "**Decision:** Use X" → Chosen library
124
+ - Alternatives table shows why this library was chosen
125
+
126
+ 3. **Use the specified libraries**
127
+ - WHY: The team chose these for compatibility, features, or constraints
128
+ - Custom implementations duplicate effort and miss edge cases the library handles
129
+ - Follow library documentation patterns for consistency
130
+
131
+ **Example:**
132
+ \`\`\`
133
+ tasks.md: "Install better-auth and dependencies"
134
+ → Use better-auth library
135
+ → Follow better-auth docs for setup
136
+
137
+ WHY not custom? better-auth handles OAuth, sessions, security
138
+ edge cases that custom code would need to re-implement.
139
+ \`\`\`
140
+
141
+ **Report required libraries in your validation:**
142
+ \`\`\`
143
+ Required Libraries Found:
144
+ - better-auth (tasks.md line 6)
145
+ - @better-auth/drizzle (tasks.md line 6)
146
+ - ioredis (design.md D2)
147
+ \`\`\`
148
+
149
+ ---
109
150
  `
110
151
 
111
152
  // Add best-practices reference for ALL agents
@@ -43,7 +43,7 @@ Create it now? (yes/no)
43
43
  const answer = await askUser()
44
44
  if (answer === 'yes') {
45
45
  // Copy from template
46
- copy('PROJECT_STATUS.template.yml', statusPath)
46
+ copy('.claude/templates/PROJECT_STATUS.template.yml', statusPath)
47
47
  output('✅ Created PROJECT_STATUS.yml - please fill in your project details')
48
48
  return
49
49
  } else {
@@ -18,34 +18,7 @@ This pattern describes how the multi-agent system integrates with OpenSpec to de
18
18
 
19
19
  ## 📋 Workflow Commands
20
20
 
21
- ### 1. `/psetup` - Project Setup (One-Time)
22
-
23
- **When to use:** First time setting up the project
24
-
25
- **What it does:**
26
- 1. Detects tech stack from package files
27
- 2. Queries Context7 for best practices
28
- 3. Creates `domain/` structure (3-level indexing)
29
- 4. Generates framework-specific best practices files
30
-
31
- **Output:**
32
- ```
33
- .claude/contexts/domain/
34
- ├── index.md # Level 1 - Project Registry
35
- └── {project}/
36
- ├── README.md # Level 2 - Project Overview
37
- ├── tech-stack.md # Tech details
38
- └── best-practices/
39
- ├── index.md # Level 3 - Best Practices Registry
40
- ├── react-18.md
41
- ├── nextjs-15.md
42
- ├── prisma-6.md
43
- └── vitest-2.md
44
- ```
45
-
46
- ---
47
-
48
- ### 2. `/csetup {change-id}` - Change Setup
21
+ ### 1. `/csetup {change-id}` - Change Setup (Includes Project Setup)
49
22
 
50
23
  **When to use:** After creating OpenSpec change, before development
51
24
 
@@ -78,7 +51,7 @@ openspec/changes/CHANGE-XXX/.claude/
78
51
 
79
52
  ---
80
53
 
81
- ### 3. `/cdev {change-id}` - Start/Continue Development
54
+ ### 2. `/cdev {change-id}` - Start/Continue Development
82
55
 
83
56
  **When to use:** After `/csetup`, to execute agent workflow
84
57
 
@@ -159,7 +132,7 @@ Ready to archive!
159
132
 
160
133
  ---
161
134
 
162
- ### 4. `/cview {change-id}` - View Progress
135
+ ### 3. `/cview {change-id}` - View Progress
163
136
 
164
137
  **When to use:** Check detailed phase-by-phase progress
165
138
 
@@ -228,7 +201,7 @@ Ready to archive!
228
201
 
229
202
  ---
230
203
 
231
- ### 5. `/cstatus {change-id}` - Quick Status
204
+ ### 4. `/cstatus {change-id}` - Quick Status
232
205
 
233
206
  **When to use:** Quick glance at progress
234
207
 
@@ -485,27 +458,22 @@ else template = 'full-stack' // Safe default
485
458
 
486
459
  ## 🎯 Best Practices
487
460
 
488
- ### 1. Always Run `/psetup` First
489
- - One-time project setup
490
- - Generates framework-specific best practices
491
- - Required for agent discovery
492
-
493
- ### 2. Use `/csetup` After Creating OpenSpec Change
461
+ ### 1. Run `/csetup` First
462
+ - Auto-detects tech stack and generates best practices
494
463
  - Analyzes tasks and generates workflow
495
- - Creates per-change context
496
- - Enables progress tracking
464
+ - Required for agent discovery
497
465
 
498
- ### 3. Use `/cdev` for Execution
466
+ ### 2. Use `/cdev` for Execution
499
467
  - Orchestrates agent workflow
500
468
  - Updates progress automatically
501
469
  - Handles user actions
502
470
 
503
- ### 4. Check Progress with `/cview` or `/cstatus`
471
+ ### 3. Check Progress with `/cview` or `/cstatus`
504
472
  - `/cview` for detailed breakdown
505
473
  - `/cstatus` for quick glance
506
474
  - Real-time updates from `flags.json`
507
475
 
508
- ### 5. Agents Update `flags.json` After Each Phase
476
+ ### 4. Agents Update `flags.json` After Each Phase
509
477
  - Marks phase as completed
510
478
  - Records actual time spent
511
479
  - Lists files created
@@ -519,7 +487,7 @@ else template = 'full-stack' // Safe default
519
487
  **Solution:** Run `/csetup {change-id}` first
520
488
 
521
489
  **Problem:** Agent doesn't load project context
522
- **Solution:** Run `/psetup` to create domain/ structure
490
+ **Solution:** Run `/csetup` to create domain/ structure (auto-detects tech stack)
523
491
 
524
492
  **Problem:** Progress tracking not working
525
493
  **Solution:** Check if `flags.json` exists and is valid JSON
@@ -46,7 +46,7 @@ Unified pattern for loading design system files. 3-tier strategy: STYLE_TOKENS.j
46
46
  ## 📁 Detailed Guides (v1.4.0 - NEW!)
47
47
 
48
48
  **`detailed-guides/best-practices-system.md`** - How best practices work
49
- Complete guide to auto-generated best practices via Context7 MCP. Covers `/agentsetup`, 3-level indexing, and agent discovery flow.
49
+ Complete guide to auto-generated best practices via Context7 MCP. Covers `/csetup`, 3-level indexing, and agent discovery flow.
50
50
 
51
51
  **`detailed-guides/context-optimization.md`** - Token optimization strategy
52
52
  Details the 70% token reduction in design system loading. Explains 3-tier loading, before/after comparisons, and benefits.
@@ -156,7 +156,7 @@ const WORK_PATTERNS = {
156
156
 
157
157
  'orchestration': {
158
158
  keywords: [
159
- '/cdev', '/csetup', '/cview', '/cstatus', '/psetup',
159
+ '/cdev', '/csetup', '/cview', '/cstatus', '/pstatus',
160
160
  'continue workflow', 'next phase', 'progress'
161
161
  ],
162
162
  agent: 'main-claude',
@@ -18,7 +18,7 @@ This protocol defines how agents discover and load context before starting work.
18
18
 
19
19
  **Who uses this:**
20
20
  - All 6 agents (integration, uxui-frontend, test-debug, frontend, backend, database)
21
- - Commands that need tech stack info (/agentsetup, /csetup, /cdev)
21
+ - Commands that need tech stack info (/csetup, /cdev)
22
22
 
23
23
  ---
24
24
 
@@ -92,7 +92,7 @@ From tech-stack.md, extract:
92
92
 
93
93
  ```
94
94
  ⚠️ tech-stack.md not found!
95
- 💡 User should run: /agentsetup
95
+ 💡 User should run: /csetup
96
96
 
97
97
  FALLBACK (use ONLY if absolutely necessary):
98
98
  - Detect from package.json (JavaScript)
@@ -383,7 +383,7 @@ Troubleshooting:
383
383
  ⚠️ Warning: tech-stack.md shows pnpm, but pnpm-lock.yaml not found
384
384
 
385
385
  Suggestion:
386
- - Run: /agentsetup (regenerate tech-stack.md)
386
+ - Run: /csetup (regenerate tech-stack.md)
387
387
  - Or manually update tech-stack.md
388
388
  ```
389
389
 
@@ -392,7 +392,7 @@ Suggestion:
392
392
  ## 🔄 When to Re-load Context
393
393
 
394
394
  **Re-load Level 0-2 when:**
395
- - ✅ User runs `/agentsetup` (tech stack changed)
395
+ - ✅ User runs `/csetup` (tech stack changed)
396
396
  - ✅ Framework version upgraded
397
397
  - ✅ New dependencies added
398
398
 
@@ -110,7 +110,7 @@ WHY routing matters: Specialist agents have domain-specific validation (design t
110
110
 
111
111
  WHY: STYLE_GUIDE.md has project-specific tokens. design/*.md has universal principles.
112
112
 
113
- **Fallback:** If discovery fails, suggest `/agentsetup` or `/designsetup`
113
+ **Fallback:** If discovery fails, suggest `/csetup` or `/designsetup`
114
114
 
115
115
  ---
116
116
 
@@ -8,7 +8,7 @@
8
8
 
9
9
  ## 📚 How It Works
10
10
 
11
- 1. **Run `/agentsetup`** to detect tech stack and generate best practices
11
+ 1. **Run `/csetup`** to detect tech stack and generate best practices
12
12
  2. **Context7 queries** latest framework docs (React, Next.js, Prisma, etc.)
13
13
  3. **Best practices files** created in `domain/{project}/best-practices/`
14
14
  4. **Agents auto-discover** project via 3-level indexing
@@ -119,11 +119,10 @@ design-system/
119
119
  # 1. Generate style guide FIRST (optional but recommended)
120
120
  /designsetup
121
121
 
122
- # 2. Setup project (discovers style guide)
123
- /psetup
122
+ # 2. Setup change and project (discovers style guide, auto-detects tech stack)
123
+ /csetup feature-login
124
124
 
125
125
  # 3. Start development (agents use STYLE_GUIDE.md)
126
- /csetup feature-login
127
126
  /cdev feature-login
128
127
  ```
129
128
 
@@ -143,8 +142,7 @@ design-system/
143
142
 
144
143
  ## 🔗 See Also
145
144
 
146
- - `../../commands/agentsetup.md` - /agentsetup command (generates best practices)
145
+ - `../../commands/csetup.md` - /csetup command (setup change + auto-detect tech stack + generate best practices)
147
146
  - `../../commands/designsetup.md` - /designsetup command (generates style guide)
148
- - `../../commands/psetup.md` - /psetup command (one-time project setup)
149
147
  - `../../contexts/patterns/agent-discovery.md` - Shared agent discovery flow
150
148
  - `context-loading-protocol.md` - How agents load framework-specific context
@@ -66,11 +66,10 @@ design-system/
66
66
  # 1. Generate style guide FIRST (optional but recommended)
67
67
  /designsetup
68
68
 
69
- # 2. Setup project (discovers style guide)
70
- /psetup
69
+ # 2. Setup change and project (discovers style guide, auto-detects tech stack)
70
+ /csetup feature-login
71
71
 
72
72
  # 3. Start development (agents use STYLE_GUIDE.md)
73
- /csetup feature-login
74
73
  /cdev feature-login
75
74
  ```
76
75
 
@@ -1,6 +1,6 @@
1
1
  # Design Context: {PROJECT_NAME}
2
2
 
3
- > **Auto-generated by `/psetup` or `/designsetup`**
3
+ > **Auto-generated by `/csetup` or `/designsetup`**
4
4
  > **Last updated:** {UPDATED_AT}
5
5
 
6
6
  ---
@@ -195,7 +195,7 @@ Tokens: ~500
195
195
 
196
196
  ## 🔄 When to Update This File
197
197
 
198
- Run `/psetup` or `/designsetup` again when:
198
+ Run `/csetup` or `/designsetup` again when:
199
199
  - ✅ Design tokens change (new colors, spacing)
200
200
  - ✅ Component library changes (shadcn → Chakra UI)
201
201
  - ✅ STYLE_GUIDE.md updated
package/README.md CHANGED
@@ -1,197 +1,46 @@
1
1
  # Claude Agent Kit
2
2
 
3
- > 🤖 **Multi-Agent Implementation Engine** - The perfect companion for [OpenSpec](https://github.com/Fission-AI/OpenSpec) spec-driven development
3
+ > Multi-Agent Implementation Engine for [OpenSpec](https://github.com/Fission-AI/OpenSpec)
4
4
 
5
5
  [![npm version](https://badge.fury.io/js/@champpaba%2Fclaude-agent-kit.svg)](https://www.npmjs.com/package/@champpaba/claude-agent-kit)
6
- [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
7
-
8
- ---
9
-
10
- ## What is this?
11
-
12
- **Claude Agent Kit** turns OpenSpec plans into working code using 6 specialized AI agents.
13
-
14
- ```
15
- OpenSpec Planning → proposal.md + tasks.md
16
-
17
- Claude Agent Kit → 6 agents execute in phases → Working code + tests
18
- ```
19
-
20
- ---
21
6
 
22
7
  ## Quick Start
23
8
 
24
9
  ```bash
25
- # Install
26
10
  npm install -g @champpaba/claude-agent-kit
27
-
28
- # Initialize in your project
29
11
  cd your-project
30
12
  cak init
31
13
 
32
- # Use in Claude Code
33
- /csetup my-feature # Setup change context
34
- /cdev my-feature # Execute with agents
35
- /cstatus my-feature # Check progress
36
- ```
37
-
38
- ---
39
-
40
- ## The 6 Agents
41
-
42
- | Agent | Phase | Responsibility |
43
- |-------|-------|----------------|
44
- | **uxui-frontend** | 1 | UI components with mock data |
45
- | **backend** | 2 | API endpoints |
46
- | **database** | 2 | Schemas, migrations |
47
- | **integration** | 2.5 | Validate API contracts |
48
- | **frontend** | 3 | Connect UI to APIs |
49
- | **test-debug** | 4 | Tests and bug fixes |
50
-
51
- ---
52
-
53
- ## Commands
54
-
55
- ### CLI Commands
56
-
57
- ```bash
58
- cak init # Initialize template
59
- cak update --backup # Update to latest version
60
- ```
61
-
62
- ### Slash Commands (in Claude Code)
63
-
64
- | Command | Description |
65
- |---------|-------------|
66
- | `/designsetup` | Generate style guide (one-time) |
67
- | `/pageplan @prd.md` | Generate UI page plan |
68
- | `/csetup {id}` | Setup change context |
69
- | `/cdev {id}` | Execute with agents |
70
- | `/cview {id}` | Detailed progress |
71
- | `/cstatus {id}` | Quick status |
72
- | `/pstatus` | Update project status |
73
-
74
- ---
75
-
76
- ## Cross-Session Context (v2.1.0)
77
-
78
- `PROJECT_STATUS.yml` helps Claude remember project state between sessions:
79
-
80
- ```yaml
81
- # PROJECT_STATUS.yml
82
- current_focus:
83
- description: "Building auth system"
84
- active_change: auth-system
85
-
86
- infrastructure:
87
- database: { status: healthy }
88
- api: { status: healthy }
89
-
90
- blockers:
91
- - id: domain-config
92
- description: "Need domain for Cloudflare"
93
- blocks: [production-launch]
94
-
95
- next_priorities:
96
- - id: payment-integration
97
- reason: "Revenue blocker"
98
- ```
99
-
100
- Created by `cak init` (optional). Update with `/pstatus`.
101
-
102
- ---
103
-
104
- ## Project Structure
105
-
106
- ```
107
- your-project/
108
- ├── PROJECT_STATUS.yml # Cross-session context (optional)
109
- ├── openspec/
110
- │ └── changes/{id}/
111
- │ ├── proposal.md # From OpenSpec
112
- │ ├── tasks.md # From OpenSpec
113
- │ └── page-plan.md # From /pageplan
114
- ├── design-system/
115
- │ └── STYLE_GUIDE.md # From /designsetup
116
- └── .claude/
117
- ├── agents/ # 6 specialized agents
118
- ├── commands/ # Slash commands
119
- └── contexts/ # Patterns & domain context
120
- ```
121
-
122
- ---
123
-
124
- ## Key Features
125
-
126
- - ✅ **6 Specialized Agents** - Each focused on its domain
127
- - ✅ **Auto Best Practices** - Context7 MCP integration
128
- - ✅ **Design System** - Consistent UI via tokens.json
129
- - ✅ **Page Planning** - Component reuse, real content
130
- - ✅ **Progress Tracking** - flags.json, /cstatus, /cview
131
- - ✅ **Cross-Session Context** - PROJECT_STATUS.yml
132
-
133
- ---
134
-
135
- ## Workflow Example
136
-
137
- ```bash
138
- # 1. OpenSpec creates: proposal.md + tasks.md
139
-
140
- # 2. Setup (optional design + page plan)
141
- /designsetup
142
- /pageplan @prd.md
143
-
144
- # 3. Execute
14
+ # In Claude Code
145
15
  /csetup my-feature
146
16
  /cdev my-feature
147
-
148
- # 4. Monitor
149
- /cstatus my-feature
150
17
  ```
151
18
 
152
- ---
19
+ ## Agents
153
20
 
154
- ## Changelog
21
+ | Agent | Phase | Role |
22
+ |-------|-------|------|
23
+ | uxui-frontend | 1 | UI with mock data |
24
+ | backend | 2 | API endpoints |
25
+ | database | 2 | Schemas |
26
+ | integration | 2.5 | Contract validation |
27
+ | frontend | 3 | Connect UI to API |
28
+ | test-debug | 4 | Tests & fixes |
155
29
 
156
- ### v2.1.0 (2025-12-01)
157
- - Added `PROJECT_STATUS.yml` for cross-session context
158
- - Added `/pstatus` command
159
- - `/csetup` reads blockers from PROJECT_STATUS.yml
160
- - `/cstatus` shows project + change status
30
+ ## Features
161
31
 
162
- ### v2.0.0 (2025-11-30)
163
- - Claude 4.5 optimization (61% token reduction)
164
- - Design System v2.0 (tokens.json, selective patterns)
165
- - All agents use Opus 4.5 model
32
+ - **Instruction-based Library Detection** - Agents scan `tasks.md`/`design.md` for required libraries
33
+ - **Cross-session Context** - `PROJECT_STATUS.yml` maintains state across sessions
34
+ - **Design System v2.0** - Interactive setup with theme selection
166
35
 
167
- ### v1.8.0 (2025-11-26)
168
- - Merged `/psetup` into `/csetup`
169
- - Auto tech stack detection
170
- - Auto best-practices from Context7
36
+ ## Commands
171
37
 
172
- [Full changelog in releases](https://github.com/ChampPABA/claude-multi-agent-template/releases)
38
+ **CLI:** `cak init` | `cak update`
173
39
 
174
- ---
40
+ **Slash:** `/designsetup` `/pageplan` `/csetup {id}` `/cdev {id}` `/cstatus {id}` `/pstatus`
175
41
 
176
42
  ## Links
177
43
 
178
- - [npm Package](https://www.npmjs.com/package/@champpaba/claude-agent-kit)
179
- - [GitHub](https://github.com/ChampPABA/claude-multi-agent-template)
180
- - [OpenSpec](https://github.com/Fission-AI/OpenSpec)
181
- - [Issues](https://github.com/ChampPABA/claude-multi-agent-template/issues)
182
-
183
- ---
184
-
185
- ## License
186
-
187
- MIT License - see [LICENSE](LICENSE)
44
+ [npm](https://www.npmjs.com/package/@champpaba/claude-agent-kit) | [GitHub](https://github.com/ChampPABA/claude-multi-agent-template) | [OpenSpec](https://github.com/Fission-AI/OpenSpec)
188
45
 
189
- ---
190
-
191
- **Ready to start?**
192
-
193
- ```bash
194
- npm install -g @champpaba/claude-agent-kit
195
- cd your-project
196
- cak init
197
- ```
46
+ MIT License
package/lib/init.js CHANGED
@@ -16,7 +16,7 @@ module.exports = async function init(options = {}) {
16
16
  // Paths
17
17
  const templatePath = path.join(__dirname, '../.claude');
18
18
  const targetPath = path.join(process.cwd(), '.claude');
19
- const projectStatusTemplatePath = path.join(__dirname, '../PROJECT_STATUS.template.yml');
19
+ const projectStatusTemplatePath = path.join(__dirname, '../.claude/templates/PROJECT_STATUS.template.yml');
20
20
  const projectStatusTargetPath = path.join(process.cwd(), 'PROJECT_STATUS.yml');
21
21
 
22
22
  console.log(chalk.cyan('\n🤖 Claude Agent Kit - Initializing...\n'));
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@champpaba/claude-agent-kit",
3
- "version": "2.1.0",
3
+ "version": "2.1.2",
4
4
  "description": "Universal multi-agent template for Claude Code - AI-assisted development with specialized agents",
5
5
  "main": "bin/cli.js",
6
6
  "bin": {
@@ -10,8 +10,7 @@
10
10
  "files": [
11
11
  "bin/",
12
12
  "lib/",
13
- ".claude/",
14
- "PROJECT_STATUS.template.yml"
13
+ ".claude/"
15
14
  ],
16
15
  "scripts": {
17
16
  "test": "echo \"No tests yet\" && exit 0"