@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.
- package/.claude/agents/02-uxui-frontend.md +7 -0
- package/.claude/agents/04-frontend.md +7 -0
- package/.claude/agents/05-backend.md +7 -1
- package/.claude/agents/06-database.md +7 -1
- package/.claude/agents/_shared/pre-work-checklist.md +44 -3
- package/.claude/commands/cdev.md +42 -1
- package/.claude/commands/pstatus.md +1 -1
- package/.claude/contexts/patterns/change-workflow.md +11 -43
- package/.claude/lib/README.md +1 -1
- package/.claude/lib/agent-router.md +1 -1
- package/.claude/lib/context-loading-protocol.md +4 -4
- package/.claude/lib/detailed-guides/agent-system.md +1 -1
- package/.claude/lib/detailed-guides/best-practices-system.md +4 -6
- package/.claude/lib/detailed-guides/design-system.md +2 -3
- package/.claude/templates/design-context-template.md +2 -2
- package/README.md +20 -171
- package/lib/init.js +1 -1
- package/package.json +2 -3
- /package/{PROJECT_STATUS.template.yml → .claude/templates/PROJECT_STATUS.template.yml} +0 -0
|
@@ -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.
|
|
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.
|
|
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.
|
|
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
|
-
- [ ]
|
|
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
|
package/.claude/commands/cdev.md
CHANGED
|
@@ -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 -
|
|
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. `/
|
|
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
|
-
###
|
|
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
|
-
###
|
|
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
|
-
###
|
|
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.
|
|
489
|
-
-
|
|
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
|
-
-
|
|
496
|
-
- Enables progress tracking
|
|
464
|
+
- Required for agent discovery
|
|
497
465
|
|
|
498
|
-
###
|
|
466
|
+
### 2. Use `/cdev` for Execution
|
|
499
467
|
- Orchestrates agent workflow
|
|
500
468
|
- Updates progress automatically
|
|
501
469
|
- Handles user actions
|
|
502
470
|
|
|
503
|
-
###
|
|
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
|
-
###
|
|
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 `/
|
|
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
|
package/.claude/lib/README.md
CHANGED
|
@@ -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 `/
|
|
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', '/
|
|
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 (/
|
|
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: /
|
|
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: /
|
|
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 `/
|
|
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 `/
|
|
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 `/
|
|
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
|
-
/
|
|
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/
|
|
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
|
-
/
|
|
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 `/
|
|
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 `/
|
|
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
|
-
>
|
|
3
|
+
> Multi-Agent Implementation Engine for [OpenSpec](https://github.com/Fission-AI/OpenSpec)
|
|
4
4
|
|
|
5
5
|
[](https://www.npmjs.com/package/@champpaba/claude-agent-kit)
|
|
6
|
-
[](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
|
-
#
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
163
|
-
-
|
|
164
|
-
- Design System v2.0
|
|
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
|
-
|
|
168
|
-
- Merged `/psetup` into `/csetup`
|
|
169
|
-
- Auto tech stack detection
|
|
170
|
-
- Auto best-practices from Context7
|
|
36
|
+
## Commands
|
|
171
37
|
|
|
172
|
-
|
|
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
|
-
|
|
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, '
|
|
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.
|
|
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"
|
|
File without changes
|