claude-cli-advanced-starter-pack 1.0.0

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.
Files changed (67) hide show
  1. package/LICENSE +21 -0
  2. package/OVERVIEW.md +597 -0
  3. package/README.md +439 -0
  4. package/bin/gtask.js +282 -0
  5. package/bin/postinstall.js +53 -0
  6. package/package.json +69 -0
  7. package/src/agents/phase-dev-templates.js +1011 -0
  8. package/src/agents/templates.js +668 -0
  9. package/src/analysis/checklist-parser.js +414 -0
  10. package/src/analysis/codebase.js +481 -0
  11. package/src/cli/menu.js +958 -0
  12. package/src/commands/claude-audit.js +1482 -0
  13. package/src/commands/claude-settings.js +2243 -0
  14. package/src/commands/create-agent.js +681 -0
  15. package/src/commands/create-command.js +337 -0
  16. package/src/commands/create-hook.js +262 -0
  17. package/src/commands/create-phase-dev/codebase-analyzer.js +813 -0
  18. package/src/commands/create-phase-dev/documentation-generator.js +352 -0
  19. package/src/commands/create-phase-dev/post-completion.js +404 -0
  20. package/src/commands/create-phase-dev/scale-calculator.js +344 -0
  21. package/src/commands/create-phase-dev/wizard.js +492 -0
  22. package/src/commands/create-phase-dev.js +481 -0
  23. package/src/commands/create-skill.js +313 -0
  24. package/src/commands/create.js +446 -0
  25. package/src/commands/decompose.js +392 -0
  26. package/src/commands/detect-tech-stack.js +768 -0
  27. package/src/commands/explore-mcp/claude-md-updater.js +252 -0
  28. package/src/commands/explore-mcp/mcp-installer.js +346 -0
  29. package/src/commands/explore-mcp/mcp-registry.js +438 -0
  30. package/src/commands/explore-mcp.js +638 -0
  31. package/src/commands/gtask-init.js +641 -0
  32. package/src/commands/help.js +128 -0
  33. package/src/commands/init.js +1890 -0
  34. package/src/commands/install.js +250 -0
  35. package/src/commands/list.js +116 -0
  36. package/src/commands/roadmap.js +750 -0
  37. package/src/commands/setup-wizard.js +482 -0
  38. package/src/commands/setup.js +351 -0
  39. package/src/commands/sync.js +534 -0
  40. package/src/commands/test-run.js +456 -0
  41. package/src/commands/test-setup.js +456 -0
  42. package/src/commands/validate.js +67 -0
  43. package/src/config/tech-stack.defaults.json +182 -0
  44. package/src/config/tech-stack.schema.json +502 -0
  45. package/src/github/client.js +359 -0
  46. package/src/index.js +84 -0
  47. package/src/templates/claude-command.js +244 -0
  48. package/src/templates/issue-body.js +284 -0
  49. package/src/testing/config.js +411 -0
  50. package/src/utils/template-engine.js +398 -0
  51. package/src/utils/validate-templates.js +223 -0
  52. package/src/utils.js +396 -0
  53. package/templates/commands/ccasp-setup.template.md +113 -0
  54. package/templates/commands/context-audit.template.md +97 -0
  55. package/templates/commands/create-task-list.template.md +382 -0
  56. package/templates/commands/deploy-full.template.md +261 -0
  57. package/templates/commands/github-task-start.template.md +99 -0
  58. package/templates/commands/github-update.template.md +69 -0
  59. package/templates/commands/happy-start.template.md +117 -0
  60. package/templates/commands/phase-track.template.md +142 -0
  61. package/templates/commands/tunnel-start.template.md +127 -0
  62. package/templates/commands/tunnel-stop.template.md +106 -0
  63. package/templates/hooks/context-guardian.template.js +173 -0
  64. package/templates/hooks/deployment-orchestrator.template.js +219 -0
  65. package/templates/hooks/github-progress-hook.template.js +197 -0
  66. package/templates/hooks/happy-checkpoint-manager.template.js +222 -0
  67. package/templates/hooks/phase-dev-enforcer.template.js +183 -0
package/OVERVIEW.md ADDED
@@ -0,0 +1,597 @@
1
+ # Claude CLI Advanced Starter Pack - Complete Overview
2
+
3
+ **A platform-agnostic toolkit for supercharging Claude Code CLI with agents, hooks, skills, testing, and GitHub integration.**
4
+
5
+ ---
6
+
7
+ ## Architecture Diagram
8
+
9
+ ```
10
+ ┌─────────────────────────────────────────────────────────────────────────────┐
11
+ │ CLAUDE CLI ADVANCED STARTER PACK │
12
+ │ │
13
+ │ ┌─────────────────────────────────────────────────────────────────────┐ │
14
+ │ │ npm install -g │ │
15
+ │ │ claude-cli-advanced-starter-pack │ │
16
+ │ └─────────────────────────────────────────────────────────────────────┘ │
17
+ │ │ │
18
+ │ ▼ │
19
+ │ ┌─────────────────────────────────────────────────────────────────────┐ │
20
+ │ │ GLOBAL CLI (ccasp) │ │
21
+ │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌────────────┐ │ │
22
+ │ │ │ menu │ │ init │ │ detect-stack│ │project-init│ │ │
23
+ │ │ │ (default) │ │ (deploy) │ │ (analyze) │ │ (wizard) │ │ │
24
+ │ │ └──────────────┘ └──────────────┘ └──────────────┘ └────────────┘ │ │
25
+ │ └─────────────────────────────────────────────────────────────────────┘ │
26
+ │ │ │
27
+ │ ccasp init / ccasp project-init │
28
+ │ │ │
29
+ │ ▼ │
30
+ │ ┌─────────────────────────────────────────────────────────────────────┐ │
31
+ │ │ YOUR PROJECT (.claude/) │ │
32
+ │ │ │ │
33
+ │ │ ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌───────────────┐ │ │
34
+ │ │ │ commands/ │ │ skills/ │ │ agents/ │ │ hooks/ │ │ │
35
+ │ │ │ /menu │ │ (domain │ │ (L1/L2/L3 │ │ (enforcement) │ │ │
36
+ │ │ │ /e2e-test │ │ expertise)│ │ hierarchy)│ │ │ │ │
37
+ │ │ │ /deploy │ │ │ │ │ │ │ │ │
38
+ │ │ └────────────┘ └────────────┘ └────────────┘ └───────────────┘ │ │
39
+ │ │ │ │
40
+ │ │ ┌────────────────────────────────────────────────────────────────┐ │ │
41
+ │ │ │ settings.json │ settings.local.json │ tech-stack.json │ │ │
42
+ │ │ └────────────────────────────────────────────────────────────────┘ │ │
43
+ │ └─────────────────────────────────────────────────────────────────────┘ │
44
+ │ │
45
+ └─────────────────────────────────────────────────────────────────────────────┘
46
+ ```
47
+
48
+ ---
49
+
50
+ ## User Journey: From Install to First Project
51
+
52
+ ### Phase 1: Global Installation
53
+
54
+ ```
55
+ ┌──────────────────────────────────────────────────────────────────────────┐
56
+ │ PHASE 1: INSTALLATION │
57
+ │ │
58
+ │ User Terminal │
59
+ │ ──────────── │
60
+ │ $ npm install -g claude-cli-advanced-starter-pack │
61
+ │ │
62
+ │ ┌──────────────────────────────────────────────────────────────────┐ │
63
+ │ │ Creates global commands: │ │
64
+ │ │ • ccasp (primary) │ │
65
+ │ │ • claude-advanced (alias) │ │
66
+ │ │ • claude-cli-advanced-starter-pack (full name) │ │
67
+ │ └──────────────────────────────────────────────────────────────────┘ │
68
+ │ │
69
+ │ Available immediately from ANY directory: │
70
+ │ $ ccasp menu # Interactive menu │
71
+ │ $ ccasp wizard # Setup wizard (vibe-code friendly) │
72
+ │ $ ccasp help-examples # Show all commands │
73
+ │ │
74
+ │ 🎉 Postinstall message shows setup options automatically! │
75
+ └──────────────────────────────────────────────────────────────────────────┘
76
+ ```
77
+
78
+ ### Phase 2: Navigate to Your Project
79
+
80
+ ```
81
+ ┌──────────────────────────────────────────────────────────────────────────┐
82
+ │ PHASE 2: PROJECT SETUP │
83
+ │ │
84
+ │ $ cd /path/to/your-project │
85
+ │ $ ccasp # Opens interactive menu │
86
+ │ │
87
+ │ ┌────────────────────────────────────────────────────────────────┐ │
88
+ │ │ │ │
89
+ │ │ ╔═══════════════════════════════════════════════════════╗ │ │
90
+ │ │ ║ CLAUDE CLI ADVANCED STARTER PACK ║ │ │
91
+ │ │ ║ ║ │ │
92
+ │ │ ║ ? Choose an action: ║ │ │
93
+ │ │ ║ ❯ 1. Initialize Project (detect stack, setup) ║ │ │
94
+ │ │ ║ 2. Create GitHub Issue ║ │ │
95
+ │ │ ║ 3. Create Agent / Hook / Skill ║ │ │
96
+ │ │ ║ 4. Explore MCP Servers ║ │ │
97
+ │ │ ║ 5. Audit CLAUDE.md ║ │ │
98
+ │ │ ║ 6. Configure Settings ║ │ │
99
+ │ │ ║ 7. Exit ║ │ │
100
+ │ │ ╚═══════════════════════════════════════════════════════╝ │ │
101
+ │ │ │ │
102
+ │ └────────────────────────────────────────────────────────────────┘ │
103
+ │ │
104
+ └──────────────────────────────────────────────────────────────────────────┘
105
+ ```
106
+
107
+ ### Phase 3: Project Initialization (Three Paths)
108
+
109
+ ```
110
+ ┌──────────────────────────────────────────────────────────────────────────┐
111
+ │ PHASE 3: INITIALIZATION │
112
+ │ │
113
+ │ PATH A: Vibe Wizard PATH B: Quick Init PATH C: Full Wizard │
114
+ │ ────────────────── ───────────────── ────────────────── │
115
+ │ $ ccasp wizard $ ccasp init $ ccasp project-init │
116
+ │ (or /ccasp-setup) │
117
+ │ │
118
+ │ ┌─────────────────┐ │
119
+ │ │ VIBE-CODE │ (Designed for mobile/remote use) │
120
+ │ │ FRIENDLY │ • Single character inputs │
121
+ │ │ │ • Numbered options (1-7) │
122
+ │ │ Just type: │ • Letter presets (A-D) │
123
+ │ │ "1" = Quick │ • Progressive disclosure │
124
+ │ │ "B" = Standard │ • No long text entry │
125
+ │ └─────────────────┘ │
126
+ │ │
127
+ │ PATH A: Wizard PATH B: Quick Init PATH C: Full Wizard │
128
+ │ ───────────────── ───────────────── ────────────────── │
129
+ │ $ ccasp wizard $ ccasp init $ ccasp project-init │
130
+ │ │
131
+ │ ┌─────────────────────┐ ┌─────────────────────┐ │
132
+ │ │ • Deploys commands │ │ Step 1: Detect Stack│ │
133
+ │ │ • Creates .claude/ │ │ - package.json │ │
134
+ │ │ • Minimal prompts │ │ - config files │ │
135
+ │ │ │ │ - git remotes │ │
136
+ │ │ Best for: Existing │ └──────────┬──────────┘ │
137
+ │ │ users who know the │ │ │
138
+ │ │ toolkit │ ▼ │
139
+ │ └─────────────────────┘ ┌─────────────────────┐ │
140
+ │ │ Step 2: Review │ │
141
+ │ │ - Frontend: React │ │
142
+ │ │ - Backend: FastAPI│ │
143
+ │ │ - Testing: PW │ │
144
+ │ └──────────┬──────────┘ │
145
+ │ │ │
146
+ │ ▼ │
147
+ │ ┌─────────────────────┐ │
148
+ │ │ Step 3: Configure │ │
149
+ │ │ - GitHub setup │ │
150
+ │ │ - Testing config │ │
151
+ │ │ - Deployment │ │
152
+ │ └──────────┬──────────┘ │
153
+ │ │ │
154
+ │ ▼ │
155
+ │ ┌─────────────────────┐ │
156
+ │ │ Step 4: Generate │ │
157
+ │ │ - tech-stack.json │ │
158
+ │ │ - TESTING_RULES │ │
159
+ │ │ - Templates │ │
160
+ │ └─────────────────────┘ │
161
+ │ │
162
+ └──────────────────────────────────────────────────────────────────────────┘
163
+ ```
164
+
165
+ ### Phase 4: What Gets Created
166
+
167
+ ```
168
+ ┌──────────────────────────────────────────────────────────────────────────┐
169
+ │ GENERATED PROJECT STRUCTURE │
170
+ │ │
171
+ │ your-project/ │
172
+ │ ├── .claude/ │
173
+ │ │ ├── commands/ # Slash commands for Claude Code │
174
+ │ │ │ ├── menu.md # /menu - Interactive navigation │
175
+ │ │ │ ├── deploy-full.md # /deploy-full - Deployment │
176
+ │ │ │ ├── create-task-list.md # /create-task-list - Task planning │
177
+ │ │ │ ├── e2e-test.md # /e2e-test - Playwright testing │
178
+ │ │ │ └── ... # More commands │
179
+ │ │ │ │
180
+ │ │ ├── skills/ # Domain expertise modules │
181
+ │ │ │ └── (your skills) │
182
+ │ │ │ │
183
+ │ │ ├── agents/ # Agent definitions │
184
+ │ │ │ └── (your agents) │
185
+ │ │ │ │
186
+ │ │ ├── hooks/ # Enforcement hooks │
187
+ │ │ │ └── (your hooks) │
188
+ │ │ │ │
189
+ │ │ ├── settings.json # Project settings (git-tracked) │
190
+ │ │ ├── settings.local.json # Local settings (gitignored) │
191
+ │ │ ├── tech-stack.json # Detected tech stack config │
192
+ │ │ └── task-lists/ │
193
+ │ │ └── TESTING_RULES.md # Persistent testing instructions │
194
+ │ │ │
195
+ │ ├── CLAUDE.md # Enhanced with tech stack info │
196
+ │ └── .gtaskrc # GitHub configuration │
197
+ │ │
198
+ └──────────────────────────────────────────────────────────────────────────┘
199
+ ```
200
+
201
+ ---
202
+
203
+ ## Feature Modules Diagram
204
+
205
+ ```
206
+ ┌─────────────────────────────────────────────────────────────────────────────┐
207
+ │ FEATURE MODULES │
208
+ │ │
209
+ │ ┌─────────────────────────────────────────────────────────────────────┐ │
210
+ │ │ AGENT CREATION SYSTEM │ │
211
+ │ │ │ │
212
+ │ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │
213
+ │ │ │ L1 │───▶│ L2 │───▶│ L3 │ │ │
214
+ │ │ │ Orchestrator│ │ Specialist │ │ Worker │ │ │
215
+ │ │ │ │ │ │ │ │ │ │
216
+ │ │ │ • Coordinate│ │ • Domain │ │ • Execute │ │ │
217
+ │ │ │ • Delegate │ │ focus │ │ • Report │ │ │
218
+ │ │ │ • Aggregate │ │ • Expertise │ │ • Simple │ │ │
219
+ │ │ └─────────────┘ └─────────────┘ └─────────────┘ │ │
220
+ │ │ │ │
221
+ │ │ ccasp create-agent → Interactive wizard for any agent type │ │
222
+ │ └─────────────────────────────────────────────────────────────────────┘ │
223
+ │ │
224
+ │ ┌─────────────────────────────────────────────────────────────────────┐ │
225
+ │ │ HOOK SYSTEM │ │
226
+ │ │ │ │
227
+ │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │
228
+ │ │ │ PreToolUse │ │ PostToolUse │ │UserPromptSub │ │ │
229
+ │ │ │ │ │ │ │ │ │ │
230
+ │ │ │ • Validate │ │ • Verify │ │ • Inject │ │ │
231
+ │ │ │ before │ │ results │ │ context │ │ │
232
+ │ │ │ • Block/Warn │ │ • Log │ │ • Enhance │ │ │
233
+ │ │ └──────────────┘ └──────────────┘ └──────────────┘ │ │
234
+ │ │ │ │
235
+ │ │ ccasp create-hook → Build enforcement for any tool │ │
236
+ │ └─────────────────────────────────────────────────────────────────────┘ │
237
+ │ │
238
+ │ ┌─────────────────────────────────────────────────────────────────────┐ │
239
+ │ │ TESTING SYSTEM │ │
240
+ │ │ │ │
241
+ │ │ ┌──────────────────────────────────────────────────────┐ │ │
242
+ │ │ │ Ralph Wiggum Loop │ │ │
243
+ │ │ │ │ │ │
244
+ │ │ │ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐ │ │ │
245
+ │ │ │ │Test │───▶│Fail?│───▶│Fix │───▶│Test │──┐ │ │ │
246
+ │ │ │ └─────┘ └──┬──┘ └─────┘ └─────┘ │ │ │ │
247
+ │ │ │ │ │ │ │ │
248
+ │ │ │ Pass│ Repeat │ │ │
249
+ │ │ │ ▼ (max 10) │ │ │
250
+ │ │ │ ┌─────┐ │ │ │ │
251
+ │ │ │ │Done!│◀────────────────────────┘ │ │ │
252
+ │ │ │ └─────┘ │ │ │
253
+ │ │ └──────────────────────────────────────────────────────┘ │ │
254
+ │ │ │ │
255
+ │ │ ccasp test --mode ralph → Continuous fix until passing │ │
256
+ │ │ ccasp test --mode manual → Single test run │ │
257
+ │ │ ccasp test --ui → Playwright UI mode │ │
258
+ │ └─────────────────────────────────────────────────────────────────────┘ │
259
+ │ │
260
+ │ ┌─────────────────────────────────────────────────────────────────────┐ │
261
+ │ │ GITHUB INTEGRATION │ │
262
+ │ │ │ │
263
+ │ │ ┌──────────────────────────────────────────────────────┐ │ │
264
+ │ │ │ │ │ │
265
+ │ │ │ Codebase ┌─────────────────┐ GitHub │ │ │
266
+ │ │ │ Analysis ───▶│ Issue + Tasks │◀──▶ Project │ │ │
267
+ │ │ │ │ │ Board │ │ │
268
+ │ │ │ File/Func │ • Description │ │ │ │
269
+ │ │ │ Detection │ • Code refs │ Bidirectional │ │ │
270
+ │ │ │ │ • Checklist │ Sync │ │ │
271
+ │ │ │ └─────────────────┘ │ │ │
272
+ │ │ │ │ │ │
273
+ │ │ └──────────────────────────────────────────────────────┘ │ │
274
+ │ │ │ │
275
+ │ │ ccasp create → Create issue with analysis │ │
276
+ │ │ ccasp decompose → Break issue into tasks │ │
277
+ │ │ ccasp sync watch → Live progress tracking │ │
278
+ │ └─────────────────────────────────────────────────────────────────────┘ │
279
+ │ │
280
+ │ ┌─────────────────────────────────────────────────────────────────────┐ │
281
+ │ │ PHASED DEVELOPMENT │ │
282
+ │ │ │ │
283
+ │ │ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐ │ │
284
+ │ │ │Scope│──▶│Scale│──▶│Plan │──▶│Docs │──▶│Exec │ │ │
285
+ │ │ │ │ │S/M/L│ │ │ │ │ │ │ │ │
286
+ │ │ └─────┘ └─────┘ └─────┘ └─────┘ └─────┘ │ │
287
+ │ │ │ │
288
+ │ │ Generates: │ │
289
+ │ │ • EXECUTIVE_SUMMARY.md • RAG Phase Executor Agent │ │
290
+ │ │ • PROGRESS.json • Enforcement Hooks │ │
291
+ │ │ • Slash Commands • Git Checkpoints │ │
292
+ │ │ │ │
293
+ │ │ ccasp create-phase-dev → 95%+ success probability planning │ │
294
+ │ └─────────────────────────────────────────────────────────────────────┘ │
295
+ │ │
296
+ │ ┌─────────────────────────────────────────────────────────────────────┐ │
297
+ │ │ MCP EXPLORATION │ │
298
+ │ │ │ │
299
+ │ │ ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌────────────┐ │ │
300
+ │ │ │ Testing │ │ Database │ │ Deployment │ │ Automation │ │ │
301
+ │ │ │ │ │ │ │ │ │ │ │ │
302
+ │ │ │ Playwright │ │ PostgreSQL │ │ Railway │ │ GitHub │ │ │
303
+ │ │ │ Puppeteer │ │ MongoDB │ │ Cloudflare │ │ Linear │ │ │
304
+ │ │ │ Browserbase│ │ Supabase │ │ Vercel │ │ Notion │ │ │
305
+ │ │ └────────────┘ └────────────┘ └────────────┘ └────────────┘ │ │
306
+ │ │ │ │
307
+ │ │ 50+ MCP servers with smart recommendations │ │
308
+ │ │ │ │
309
+ │ │ ccasp explore-mcp --recommend → Based on your tech stack │ │
310
+ │ │ ccasp explore-mcp --testing → Quick install test servers │ │
311
+ │ └─────────────────────────────────────────────────────────────────────┘ │
312
+ │ │
313
+ └─────────────────────────────────────────────────────────────────────────────┘
314
+ ```
315
+
316
+ ---
317
+
318
+ ## Tech Stack Detection Flow
319
+
320
+ ```
321
+ ┌─────────────────────────────────────────────────────────────────────────────┐
322
+ │ TECH STACK AUTO-DETECTION │
323
+ │ │
324
+ │ ccasp detect-stack │
325
+ │ │
326
+ │ ┌─────────────────┐ │
327
+ │ │ Scan Project │ │
328
+ │ └────────┬────────┘ │
329
+ │ │ │
330
+ │ ┌────────┴────────┬────────────────┬────────────────┬──────────────┐ │
331
+ │ ▼ ▼ ▼ ▼ ▼ │
332
+ │ ┌─────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌─────────┐ │
333
+ │ │package. │ │ vite. │ │requirements│ │playwright.│ │ git │ │
334
+ │ │json │ │ config.ts │ │.txt │ │config.ts │ │ remote │ │
335
+ │ └────┬────┘ └─────┬─────┘ └─────┬─────┘ └─────┬─────┘ └────┬────┘ │
336
+ │ │ │ │ │ │ │
337
+ │ ▼ ▼ ▼ ▼ ▼ │
338
+ │ ┌─────────────────────────────────────────────────────────────────────┐ │
339
+ │ │ DETECTION ENGINE │ │
340
+ │ │ │ │
341
+ │ │ Frontend: React + Vite + Zustand + Tailwind │ │
342
+ │ │ Backend: FastAPI (Python) │ │
343
+ │ │ Database: PostgreSQL + SQLAlchemy │ │
344
+ │ │ E2E Testing: Playwright │ │
345
+ │ │ Unit Tests: Vitest + Pytest │ │
346
+ │ │ Deployment: Cloudflare (frontend), Railway (backend) │ │
347
+ │ │ Dev Tunnel: ngrok │ │
348
+ │ │ Git Remote: github.com/user/repo │ │
349
+ │ └─────────────────────────────────────────────────────────────────────┘ │
350
+ │ │ │
351
+ │ ▼ │
352
+ │ ┌─────────────────────────────────────────────────────────────────────┐ │
353
+ │ │ tech-stack.json │ │
354
+ │ │ │ │
355
+ │ │ { │ │
356
+ │ │ "frontend": { │ │
357
+ │ │ "framework": "react", │ │
358
+ │ │ "buildTool": "vite", │ │
359
+ │ │ "port": 5174 │ │
360
+ │ │ }, │ │
361
+ │ │ "testing": { │ │
362
+ │ │ "e2e": { "framework": "playwright" }, │ │
363
+ │ │ "selectors": { │ │
364
+ │ │ "username": "[data-testid=\"username-input\"]", │ │
365
+ │ │ "password": "[data-testid=\"password-input\"]" │ │
366
+ │ │ } │ │
367
+ │ │ }, │ │
368
+ │ │ "urls": { │ │
369
+ │ │ "local": { "frontend": "http://localhost:5174" } │ │
370
+ │ │ } │ │
371
+ │ │ } │ │
372
+ │ └─────────────────────────────────────────────────────────────────────┘ │
373
+ │ │ │
374
+ │ ▼ │
375
+ │ ┌─────────────────────────────────────────────────────────────────────┐ │
376
+ │ │ TEMPLATES USE PLACEHOLDERS │ │
377
+ │ │ │ │
378
+ │ │ {{frontend.port}} → 5174 │ │
379
+ │ │ {{testing.e2e.framework}} → playwright │ │
380
+ │ │ {{testing.selectors.username}} → [data-testid="..."] │ │
381
+ │ │ {{urls.production.frontend}} → https://your-app.com │ │
382
+ │ └─────────────────────────────────────────────────────────────────────┘ │
383
+ │ │
384
+ └─────────────────────────────────────────────────────────────────────────────┘
385
+ ```
386
+
387
+ ---
388
+
389
+ ## CLAUDE.md Enhancement Flow
390
+
391
+ ```
392
+ ┌─────────────────────────────────────────────────────────────────────────────┐
393
+ │ CLAUDE.MD ENHANCEMENT │
394
+ │ │
395
+ │ ccasp claude-audit → "✨ Enhance CLAUDE.md (NEW)" │
396
+ │ │
397
+ │ ┌─────────────────────────────────────────────────────────────────────┐ │
398
+ │ │ ENHANCEMENT OPTIONS │ │
399
+ │ │ │ │
400
+ │ │ 1. Generate full CLAUDE.md from scratch │ │
401
+ │ │ 2. Add missing sections to existing │ │
402
+ │ │ 3. Generate specific section │ │
403
+ │ │ 4. Preview generated content │ │
404
+ │ └─────────────────────────────────────────────────────────────────────┘ │
405
+ │ │
406
+ │ ┌─────────────────────────────────────────────────────────────────────┐ │
407
+ │ │ AUTO-GENERATED SECTIONS │ │
408
+ │ │ │ │
409
+ │ │ Based on detected tech stack: │ │
410
+ │ │ │ │
411
+ │ │ ┌────────────────────┐ ┌────────────────────┐ │ │
412
+ │ │ │ ## Quick Start │ │ ## Tech Stack │ │ │
413
+ │ │ │ ```bash │ │ | Layer | Tech | │ │ │
414
+ │ │ │ npm install │ │ |-------|------| │ │ │
415
+ │ │ │ npm run dev │ │ | Frontend | React│ │ │
416
+ │ │ │ npm test │ │ | Backend | API │ │ │ │
417
+ │ │ │ ``` │ │ │ │ │
418
+ │ │ └────────────────────┘ └────────────────────┘ │ │
419
+ │ │ │ │
420
+ │ │ ┌────────────────────┐ ┌────────────────────┐ │ │
421
+ │ │ │ ## Import Patterns │ │ ## Testing │ │ │
422
+ │ │ │ ```typescript │ │ ```bash │ │ │
423
+ │ │ │ import { use... } │ │ npx playwright test│ │ │
424
+ │ │ │ import { store } │ │ npx playwright ui │ │ │
425
+ │ │ │ ``` │ │ ``` │ │ │
426
+ │ │ └────────────────────┘ └────────────────────┘ │ │
427
+ │ │ │ │
428
+ │ │ ┌────────────────────┐ ┌────────────────────┐ │ │
429
+ │ │ │ ## Reference Docs │ │ ## Critical Rules │ │ │
430
+ │ │ │ - [React](url) │ │ IMPORTANT: │ │ │
431
+ │ │ │ - [Vite](url) │ │ 1. NEVER commit │ │ │
432
+ │ │ │ - [Playwright](url)│ │ secrets │ │ │
433
+ │ │ └────────────────────┘ └────────────────────┘ │ │
434
+ │ │ │ │
435
+ │ └─────────────────────────────────────────────────────────────────────┘ │
436
+ │ │
437
+ └─────────────────────────────────────────────────────────────────────────────┘
438
+ ```
439
+
440
+ ---
441
+
442
+ ## Command Reference Table
443
+
444
+ ### Core Commands
445
+
446
+ | Command | Description | Example |
447
+ |---------|-------------|---------|
448
+ | `ccasp` | Interactive menu (default) | `ccasp` |
449
+ | `ccasp init` | Deploy toolkit to project | `ccasp init --force` |
450
+ | `ccasp project-init` | Full setup wizard | `ccasp project-init` |
451
+ | `ccasp detect-stack` | Auto-detect tech stack | `ccasp detect-stack --json` |
452
+ | `ccasp claude-audit` | Audit CLAUDE.md quality | `ccasp claude-audit` |
453
+ | `ccasp claude-settings` | Configure permissions | `ccasp claude-settings` |
454
+
455
+ ### GitHub Integration
456
+
457
+ | Command | Description | Example |
458
+ |---------|-------------|---------|
459
+ | `ccasp setup` | Configure GitHub connection | `ccasp setup -o owner -r repo` |
460
+ | `ccasp create` | Create issue with analysis | `ccasp create -t "Bug fix"` |
461
+ | `ccasp list` | List recent issues | `ccasp list --mine` |
462
+ | `ccasp decompose` | Break down issue | `ccasp decompose 123` |
463
+ | `ccasp sync` | Sync with GitHub | `ccasp sync watch 123` |
464
+ | `ccasp roadmap` | Roadmap integration | `ccasp roadmap import` |
465
+
466
+ ### Agent & Extension Creation
467
+
468
+ | Command | Description | Example |
469
+ |---------|-------------|---------|
470
+ | `ccasp create-agent` | Create agents | `ccasp create-agent` |
471
+ | `ccasp create-hook` | Create enforcement hooks | `ccasp create-hook -e PreToolUse` |
472
+ | `ccasp create-command` | Create slash commands | `ccasp create-command -n deploy` |
473
+ | `ccasp create-skill` | Create RAG skills | `ccasp create-skill -n api-expert` |
474
+
475
+ ### Testing & Development
476
+
477
+ | Command | Description | Example |
478
+ |---------|-------------|---------|
479
+ | `ccasp test-setup` | Configure testing | `ccasp test-setup` |
480
+ | `ccasp test` | Run tests | `ccasp test --mode ralph` |
481
+ | `ccasp create-phase-dev` | Create phased plan | `ccasp create-phase-dev --scale M` |
482
+ | `ccasp explore-mcp` | Discover MCP servers | `ccasp explore-mcp --recommend` |
483
+
484
+ ---
485
+
486
+ ## Complete User Flow Diagram
487
+
488
+ ```
489
+ ┌─────────────────────────────────────────────────────────────────────────────┐
490
+ │ COMPLETE USER FLOW │
491
+ │ │
492
+ │ ┌─────────────────────────────────────────────────────────────────────┐ │
493
+ │ │ FIRST TIME USER │ │
494
+ │ │ │ │
495
+ │ │ 1. npm install -g claude-cli-advanced-starter-pack │ │
496
+ │ │ │ │ │
497
+ │ │ ▼ │ │
498
+ │ │ 2. cd my-project │ │
499
+ │ │ │ │ │
500
+ │ │ ▼ │ │
501
+ │ │ 3. ccasp project-init (or ccasp init for quick setup) │ │
502
+ │ │ │ │ │
503
+ │ │ ┌───────────────┼───────────────┐ │ │
504
+ │ │ ▼ ▼ ▼ │ │
505
+ │ │ Detect Stack Configure Generate │ │
506
+ │ │ (auto) GitHub/Tests Templates │ │
507
+ │ │ │ │ │
508
+ │ │ ▼ │ │
509
+ │ │ 4. Open Claude Code CLI in project │ │
510
+ │ │ │ │ │
511
+ │ │ ▼ │ │
512
+ │ │ 5. Use deployed slash commands: │ │
513
+ │ │ • /menu - Project navigation │ │
514
+ │ │ • /create-task-list - Plan your work │ │
515
+ │ │ • /e2e-test - Run tests with Ralph Loop │ │
516
+ │ │ • /deploy-full - Deploy to production │ │
517
+ │ │ │ │
518
+ │ └─────────────────────────────────────────────────────────────────────┘ │
519
+ │ │
520
+ │ ┌─────────────────────────────────────────────────────────────────────┐ │
521
+ │ │ ONGOING USAGE │ │
522
+ │ │ │ │
523
+ │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │
524
+ │ │ │ Plan Feature │───▶│ Implement │───▶│ Test │ │ │
525
+ │ │ │ │ │ │ │ │ │ │
526
+ │ │ │ /create-task │ │ Use agents & │ │ /e2e-test │ │ │
527
+ │ │ │ -list │ │ hooks │ │ --mode ralph │ │ │
528
+ │ │ └──────────────┘ └──────────────┘ └──────────────┘ │ │
529
+ │ │ │ │ │ │
530
+ │ │ │ ┌──────────────┐ │ │ │
531
+ │ │ └───────────▶│ Deploy │◀───────────┘ │ │
532
+ │ │ │ │ │ │
533
+ │ │ │ /deploy-full │ │ │
534
+ │ │ └──────────────┘ │ │
535
+ │ │ │ │ │
536
+ │ │ ▼ │ │
537
+ │ │ ┌──────────────┐ │ │
538
+ │ │ │ Commit │ │ │
539
+ │ │ │ │ │ │
540
+ │ │ │ Auto-updates │ │ │
541
+ │ │ │ GitHub issue │ │ │
542
+ │ │ └──────────────┘ │ │
543
+ │ │ │ │
544
+ │ └─────────────────────────────────────────────────────────────────────┘ │
545
+ │ │
546
+ │ ┌─────────────────────────────────────────────────────────────────────┐ │
547
+ │ │ POWER USER FEATURES │ │
548
+ │ │ │ │
549
+ │ │ • Create custom agents for domain expertise │ │
550
+ │ │ • Build enforcement hooks for code quality │ │
551
+ │ │ • Define RAG skills for complex workflows │ │
552
+ │ │ • Use phased development for large projects │ │
553
+ │ │ • Explore and install MCP servers │ │
554
+ │ │ • Bidirectional sync with GitHub Project Board │ │
555
+ │ │ │ │
556
+ │ └─────────────────────────────────────────────────────────────────────┘ │
557
+ │ │
558
+ └─────────────────────────────────────────────────────────────────────────────┘
559
+ ```
560
+
561
+ ---
562
+
563
+ ## Quick Start Guide
564
+
565
+ ```bash
566
+ # 1. Install globally
567
+ npm install -g claude-cli-advanced-starter-pack
568
+
569
+ # 2. Navigate to your project
570
+ cd /path/to/your-project
571
+
572
+ # 3. Run the setup wizard
573
+ ccasp project-init
574
+
575
+ # 4. (Optional) Connect to GitHub
576
+ ccasp setup
577
+
578
+ # 5. Open Claude Code in your project
579
+ # Now you have access to all slash commands!
580
+ ```
581
+
582
+ ---
583
+
584
+ ## Summary
585
+
586
+ **Claude CLI Advanced Starter Pack** transforms Claude Code CLI into a comprehensive development platform with:
587
+
588
+ - **🤖 Agent Hierarchy** - L1/L2/L3 agents for complex task orchestration
589
+ - **🪝 Enforcement Hooks** - Quality gates for every tool call
590
+ - **🧪 Ralph Loop Testing** - Continuous test-fix until all pass
591
+ - **📋 GitHub Integration** - Bidirectional task tracking
592
+ - **🔍 Tech Stack Detection** - Auto-configure from your codebase
593
+ - **📝 CLAUDE.md Enhancement** - Generate documentation from stack
594
+ - **🚀 Phased Development** - 95%+ success probability planning
595
+ - **🔌 MCP Discovery** - 50+ servers with smart recommendations
596
+
597
+ All platform-agnostic, all automatically configured from your existing codebase.