@champpaba/claude-agent-kit 2.1.0 → 2.1.1

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.
@@ -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,40 @@
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
- ---
153
-
154
- ## Changelog
19
+ ## Agents
155
20
 
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
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 |
161
29
 
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
166
-
167
- ### v1.8.0 (2025-11-26)
168
- - Merged `/psetup` into `/csetup`
169
- - Auto tech stack detection
170
- - Auto best-practices from Context7
30
+ ## Commands
171
31
 
172
- [Full changelog in releases](https://github.com/ChampPABA/claude-multi-agent-template/releases)
32
+ **CLI:** `cak init` | `cak update`
173
33
 
174
- ---
34
+ **Slash:** `/designsetup` `/pageplan` `/csetup {id}` `/cdev {id}` `/cstatus {id}` `/pstatus`
175
35
 
176
36
  ## Links
177
37
 
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)
38
+ [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
39
 
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
- ```
40
+ 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.1",
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"