claude-cli-advanced-starter-pack 1.0.16 → 1.8.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 (61) hide show
  1. package/OVERVIEW.md +5 -1
  2. package/README.md +241 -132
  3. package/bin/gtask.js +53 -0
  4. package/package.json +1 -1
  5. package/src/cli/menu.js +27 -0
  6. package/src/commands/explore-mcp/mcp-registry.js +99 -0
  7. package/src/commands/init.js +309 -80
  8. package/src/commands/install-panel-hook.js +108 -0
  9. package/src/commands/install-scripts.js +232 -0
  10. package/src/commands/install-skill.js +220 -0
  11. package/src/commands/panel.js +297 -0
  12. package/src/commands/setup-wizard.js +4 -3
  13. package/src/commands/test-setup.js +4 -5
  14. package/src/data/releases.json +209 -0
  15. package/src/panel/queue.js +188 -0
  16. package/templates/commands/ask-claude.template.md +118 -0
  17. package/templates/commands/ccasp-panel.template.md +72 -0
  18. package/templates/commands/ccasp-setup.template.md +470 -79
  19. package/templates/commands/create-smoke-test.template.md +186 -0
  20. package/templates/commands/project-impl.template.md +9 -113
  21. package/templates/commands/refactor-check.template.md +112 -0
  22. package/templates/commands/refactor-cleanup.template.md +144 -0
  23. package/templates/commands/refactor-prep.template.md +192 -0
  24. package/templates/docs/AI_ARCHITECTURE_CONSTITUTION.template.md +198 -0
  25. package/templates/docs/DETAILED_GOTCHAS.template.md +347 -0
  26. package/templates/docs/PHASE-DEV-CHECKLIST.template.md +241 -0
  27. package/templates/docs/PROGRESS_JSON_TEMPLATE.json +117 -0
  28. package/templates/docs/background-agent.template.md +264 -0
  29. package/templates/hooks/autonomous-decision-logger.template.js +207 -0
  30. package/templates/hooks/branch-merge-checker.template.js +272 -0
  31. package/templates/hooks/context-injector.template.js +261 -0
  32. package/templates/hooks/git-commit-tracker.template.js +267 -0
  33. package/templates/hooks/happy-mode-detector.template.js +214 -0
  34. package/templates/hooks/happy-title-generator.template.js +260 -0
  35. package/templates/hooks/issue-completion-detector.template.js +205 -0
  36. package/templates/hooks/panel-queue-reader.template.js +83 -0
  37. package/templates/hooks/phase-validation-gates.template.js +307 -0
  38. package/templates/hooks/session-id-generator.template.js +236 -0
  39. package/templates/hooks/token-budget-loader.template.js +234 -0
  40. package/templates/hooks/token-usage-monitor.template.js +193 -0
  41. package/templates/hooks/tool-output-cacher.template.js +219 -0
  42. package/templates/patterns/README.md +129 -0
  43. package/templates/patterns/l1-l2-orchestration.md +189 -0
  44. package/templates/patterns/multi-phase-orchestration.md +258 -0
  45. package/templates/patterns/two-tier-query-pipeline.md +192 -0
  46. package/templates/scripts/README.md +109 -0
  47. package/templates/scripts/analyze-delegation-log.js +299 -0
  48. package/templates/scripts/autonomous-decision-logger.js +277 -0
  49. package/templates/scripts/git-history-analyzer.py +269 -0
  50. package/templates/scripts/phase-validation-gates.js +307 -0
  51. package/templates/scripts/poll-deployment-status.js +260 -0
  52. package/templates/scripts/roadmap-scanner.js +263 -0
  53. package/templates/scripts/validate-deployment.js +293 -0
  54. package/templates/skills/agent-creator/skill.json +18 -0
  55. package/templates/skills/agent-creator/skill.md +335 -0
  56. package/templates/skills/hook-creator/skill.json +18 -0
  57. package/templates/skills/hook-creator/skill.md +318 -0
  58. package/templates/skills/panel/skill.json +18 -0
  59. package/templates/skills/panel/skill.md +90 -0
  60. package/templates/skills/rag-agent-creator/skill.json +18 -0
  61. package/templates/skills/rag-agent-creator/skill.md +307 -0
package/OVERVIEW.md CHANGED
@@ -1,6 +1,10 @@
1
1
  # Claude CLI Advanced Starter Pack - Complete Overview
2
2
 
3
- **A platform-agnostic toolkit for supercharging Claude Code CLI with agents, hooks, skills, testing, and GitHub integration.**
3
+ **Version 1.8.0** | **60+ Components** | **Production Ready**
4
+
5
+ **A platform-agnostic toolkit for supercharging Claude Code CLI with 12 hooks, 4 agent patterns, 7 MCP servers, 7 utility scripts, and GitHub integration.**
6
+
7
+ > **New in v1.8.0**: Complete 85-recommendations roadmap with utility scripts, agent patterns library, enhanced MCP discovery, and comprehensive documentation templates.
4
8
 
5
9
  ---
6
10
 
package/README.md CHANGED
@@ -9,7 +9,7 @@
9
9
  ║ ║ ║ ╠═╣║ ║ ║║║╣ ╠═╣ ║║╚╗╔╝╠═╣║║║║ ║╣ ║║ ╚═╗ ║ ╠═╣╠╦╝ ║ ║╣ ╠╦╝ ║
10
10
  ║ ╚═╝╩═╝╩ ╩╚═╝═╩╝╚═╝ ╩ ╩═╩╝ ╚╝ ╩ ╩╝╚╝╚═╝╚═╝═╩╝ ╚═╝ ╩ ╩ ╩╩╚═ ╩ ╚═╝╩╚═ ║
11
11
  ║ ║
12
- ║ v1.0.12 • Production Ready
12
+ ║ v1.8.0 • Production Ready
13
13
  ║ ║
14
14
  ╚═══════════════════════════════════════════════════════════════════════════════╝
15
15
  ```
@@ -18,9 +18,9 @@
18
18
  [![Node.js 18+](https://img.shields.io/badge/node-18%2B-brightgreen)](https://nodejs.org)
19
19
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
20
20
 
21
- **A professional-grade CLI toolkit for Claude Code CLI — agents, hooks, skills, MCP servers, phased development, and GitHub integration.**
21
+ **A professional-grade CLI toolkit for Claude Code CLI — 60+ components including agents, hooks, skills, MCP servers, phased development, and GitHub integration.**
22
22
 
23
- [Getting Started](#quick-start) • [Documentation](https://github.com/evan043/claude-cli-advanced-starter-pack/wiki) • [API Reference](#api-reference) • [Contributing](#contributing)
23
+ [Getting Started](#quick-start) • [Documentation](./docs/WIKI.md) • [API Reference](#api-reference) • [Contributing](#contributing)
24
24
 
25
25
  </div>
26
26
 
@@ -29,11 +29,15 @@
29
29
  ## Table of Contents
30
30
 
31
31
  - [Overview](#overview)
32
+ - [What's New in v1.8.0](#whats-new-in-v180)
32
33
  - [Key Features](#key-features)
33
34
  - [Architecture](#architecture)
34
35
  - [Quick Start](#quick-start)
35
36
  - [Installation Options](#installation-options)
36
37
  - [Commands Reference](#commands-reference)
38
+ - [Hook Templates](#hook-templates)
39
+ - [Agent Patterns](#agent-patterns)
40
+ - [Utility Scripts](#utility-scripts)
37
41
  - [Configuration](#configuration)
38
42
  - [Template Engine](#template-engine)
39
43
  - [API Reference](#api-reference)
@@ -61,6 +65,22 @@ CCASP is a **two-phase toolkit** that extends Claude Code CLI capabilities:
61
65
 
62
66
  ---
63
67
 
68
+ ## What's New in v1.8.0
69
+
70
+ **60+ components** across 8 implementation phases:
71
+
72
+ | Phase | Version | Components |
73
+ |-------|---------|------------|
74
+ | Phase 1-2 | v1.1-1.2 | **12 Hook Templates** — token management, session tracking, deployment automation |
75
+ | Phase 3 | v1.3 | **3 Skill Templates** — agent-creator, hook-creator, rag-agent-creator |
76
+ | Phase 4 | v1.4 | **5 Command Templates** — refactoring tools, smoke test generation |
77
+ | Phase 5 | v1.5 | **5 Documentation Templates** — architecture constitution, gotchas, checklists |
78
+ | Phase 6 | v1.6 | **4 Agent Patterns** — L1→L2 orchestration, multi-phase, query pipeline |
79
+ | Phase 7 | v1.7 | **7 MCP Servers** — log-monitor, browser-monitor, tunnel services |
80
+ | Phase 8 | v1.8 | **7 Utility Scripts** — deployment validation, roadmap scanning, security audit |
81
+
82
+ ---
83
+
64
84
  ## Key Features
65
85
 
66
86
  ### Core Capabilities
@@ -68,22 +88,53 @@ CCASP is a **two-phase toolkit** that extends Claude Code CLI capabilities:
68
88
  | Feature | Description |
69
89
  |---------|-------------|
70
90
  | **L1/L2/L3 Agent Hierarchy** | Orchestrators, specialists, and workers with configurable model selection |
71
- | **Enforcement Hooks** | PreToolUse, PostToolUse, UserPromptSubmit hooks for validation and monitoring |
72
- | **RAG-Enhanced Skills** | Domain-specific knowledge packages with context, templates, and workflows |
91
+ | **12 Enforcement Hooks** | PreToolUse, PostToolUse, UserPromptSubmit hooks for validation and monitoring |
92
+ | **3 RAG-Enhanced Skills** | Domain-specific knowledge packages with context, templates, and workflows |
73
93
  | **Phased Development** | 95%+ success rate planning with PROGRESS.json state tracking |
74
94
  | **GitHub Integration** | Project Board sync, issue creation with codebase analysis |
75
- | **MCP Server Discovery** | Auto-recommend and configure MCP servers for your stack |
95
+ | **7 MCP Servers** | Auto-recommend and configure MCP servers for your stack |
96
+ | **4 Agent Patterns** | Reusable orchestration patterns for complex multi-agent tasks |
97
+ | **7 Utility Scripts** | Deployment validation, security audits, log analysis |
76
98
  | **Template Engine** | Handlebars-style placeholders with conditionals and loops |
77
99
  | **Tech Stack Detection** | Pattern-based detection of 40+ frameworks and tools |
78
100
 
79
- ### Optional Feature Modules
80
-
81
- | Module | Commands | Purpose |
101
+ ### Hook Templates (12 Total)
102
+
103
+ | Hook | Purpose | Portability |
104
+ |------|---------|-------------|
105
+ | `tool-output-cacher` | Cache >2KB outputs, save ~500 tokens | 100% |
106
+ | `token-budget-loader` | Pre-calculate daily budget | 100% |
107
+ | `token-usage-monitor` | Auto-respawn at 90% threshold | 100% |
108
+ | `session-id-generator` | UUID sessions with PID registry | 100% |
109
+ | `autonomous-decision-logger` | JSONL audit trail | 95% |
110
+ | `git-commit-tracker` | Update PROGRESS.json | 90% |
111
+ | `branch-merge-checker` | Validate main sync before deploy | 95% |
112
+ | `phase-validation-gates` | 5-gate validation | 90% |
113
+ | `issue-completion-detector` | Auto-trigger deployment | 85% |
114
+ | `context-injector` | Inject prior session context | 85% |
115
+ | `happy-title-generator` | Auto-generate session titles | 100% |
116
+ | `happy-mode-detector` | Detect Happy daemon env | 100% |
117
+
118
+ ### Agent Patterns (4 Patterns)
119
+
120
+ | Pattern | Use Case | Complexity |
121
+ |---------|----------|------------|
122
+ | [Two-Tier Query Pipeline](./templates/patterns/two-tier-query-pipeline.md) | Intent classification + execution | Medium |
123
+ | [L1→L2 Orchestration](./templates/patterns/l1-l2-orchestration.md) | Master-worker parallel tasks | Medium |
124
+ | [Multi-Phase Orchestration](./templates/patterns/multi-phase-orchestration.md) | Sequential phases with parallel tasks | High |
125
+ | [5-Point Integration Validation](./templates/patterns/README.md) | EXIST→INIT→REGISTER→INVOKE→PROPAGATE | High |
126
+
127
+ ### Utility Scripts (7 Scripts)
128
+
129
+ | Script | Language | Purpose |
82
130
  |--------|----------|---------|
83
- | **Token Management** | `/context-audit` | Track API usage with thresholds |
84
- | **Deployment Automation** | `/deploy-full` | Full-stack Railway/Cloudflare/Vercel |
85
- | **Tunnel Services** | `/tunnel-start`, `/tunnel-stop` | ngrok, localtunnel, cloudflare-tunnel |
86
- | **Happy Mode** | `/happy-start` | Mobile app integration |
131
+ | `validate-deployment.js` | Node.js | Pre-deployment env validation (Railway/CF/Vercel) |
132
+ | `poll-deployment-status.js` | Node.js | Poll until deployment complete |
133
+ | `roadmap-scanner.js` | Node.js | Multi-roadmap progress dashboard |
134
+ | `analyze-delegation-log.js` | Node.js | Model usage and token analysis |
135
+ | `autonomous-decision-logger.js` | Node.js | JSONL audit trail for agents |
136
+ | `phase-validation-gates.js` | Node.js | 5-gate validation system |
137
+ | `git-history-analyzer.py` | Python | Security audit for secrets in git |
87
138
 
88
139
  ---
89
140
 
@@ -91,7 +142,7 @@ CCASP is a **two-phase toolkit** that extends Claude Code CLI capabilities:
91
142
 
92
143
  ```
93
144
  ┌─────────────────────────────────────────────────────────────────────────────┐
94
- │ CCASP ARCHITECTURE
145
+ │ CCASP ARCHITECTURE (v1.8.0)
95
146
  ├─────────────────────────────────────────────────────────────────────────────┤
96
147
  │ │
97
148
  │ PHASE 1: TERMINAL (No AI) │
@@ -108,7 +159,7 @@ CCASP is a **two-phase toolkit** that extends Claude Code CLI capabilities:
108
159
  │ ▼ ▼ ▼ │
109
160
  │ ┌──────────────────────────────────────────────────────────────────┐ │
110
161
  │ │ YOUR PROJECT (.claude/) │ │
111
- │ │ commands/ │ agents/ │ skills/ │ hooks/ │ docs/ │ settings.json │ │
162
+ │ │ commands/ │ agents/ │ skills/ │ hooks/ │ scripts/ │ docs/ │ │
112
163
  │ └──────────────────────────────────────────────────────────────────┘ │
113
164
  │ │
114
165
  │ PHASE 2: CLAUDE CODE CLI (AI-Powered) │
@@ -122,6 +173,7 @@ CCASP is a **two-phase toolkit** that extends Claude Code CLI capabilities:
122
173
  │ │ Agents: L1 Orchestrators ──► L2 Specialists ──► L3 Workers │ │
123
174
  │ │ Hooks: PreToolUse | PostToolUse | UserPromptSubmit │ │
124
175
  │ │ Skills: RAG context + templates + workflows │ │
176
+ │ │ Patterns: Query Pipeline | L1→L2 | Multi-Phase │ │
125
177
  │ └──────────────────────────────────────────────────────────────────┘ │
126
178
  │ │
127
179
  └─────────────────────────────────────────────────────────────────────────────┘
@@ -137,17 +189,18 @@ After running `ccasp init`, your project gets:
137
189
  │ ├── menu.md # Interactive menu
138
190
  │ ├── ccasp-setup.md # Setup wizard
139
191
  │ ├── deploy-full.md # Deployment command
140
- │ └── ... # 20+ commands based on feature selection
192
+ │ └── ... # 25+ commands based on feature selection
141
193
  ├── agents/ # L1/L2/L3 agent definitions
142
194
  ├── skills/ # RAG-enhanced skill packages
143
195
  │ └── skill-name/
144
196
  │ ├── skill.md # Definition
145
197
  │ ├── context/ # Knowledge base
146
198
  │ └── workflows/ # Procedures
147
- ├── hooks/ # Enforcement hooks
199
+ ├── hooks/ # Enforcement hooks (12 templates available)
148
200
  │ ├── pre-tool-use/
149
201
  │ ├── post-tool-use/
150
202
  │ └── user-prompt-submit/
203
+ ├── scripts/ # Utility scripts (7 available via install-scripts)
151
204
  ├── docs/ # Generated documentation
152
205
  ├── phase-dev/ # Phased development projects
153
206
  ├── settings.json # Hook configuration
@@ -173,23 +226,17 @@ claude .
173
226
  /menu
174
227
  ```
175
228
 
176
- ### Post-Install Welcome
229
+ ### Post-Install Commands
177
230
 
178
- ```
179
- 🚀 Claude CLI Advanced Starter Pack
180
-
181
- ✓ Installation complete!
182
-
183
- Quick Setup Options:
184
-
185
- 1. Run vibe-friendly setup wizard:
186
- $ ccasp wizard
231
+ ```bash
232
+ # Install additional skills after init
233
+ ccasp install-skill
187
234
 
188
- 2. Quick init (auto-detect + deploy):
189
- $ ccasp init
235
+ # Install utility scripts
236
+ ccasp install-scripts
190
237
 
191
- 3. Full interactive menu:
192
- $ ccasp
238
+ # Explore MCP servers for your stack
239
+ ccasp explore-mcp --recommend
193
240
  ```
194
241
 
195
242
  ---
@@ -237,18 +284,17 @@ claude-cli-advanced-starter-pack # Full name
237
284
  |---------|-------------|-------------|
238
285
  | `ccasp wizard` | Vibe-friendly setup wizard | Single-char navigation |
239
286
  | `ccasp init` | Deploy commands to project | `--force`, `--minimal` |
240
- | `ccasp detect-stack` | Auto-detect tech stack | `--verbose` |
287
+ | `ccasp detect-stack` | Auto-detect tech stack | `--verbose`, `--json` |
241
288
  | `ccasp create-agent` | Create L1/L2/L3 agents | Interactive wizard |
242
289
  | `ccasp create-hook` | Create enforcement hooks | Interactive wizard |
243
290
  | `ccasp create-skill` | Create RAG skill packages | Interactive wizard |
244
291
  | `ccasp create-command` | Create slash commands | Interactive wizard |
245
292
  | `ccasp create-phase-dev` | Create phased dev plan | `--scale S/M/L`, `--autonomous` |
246
293
  | `ccasp explore-mcp` | MCP server discovery | `--recommend`, `--testing` |
294
+ | `ccasp install-skill` | Install skill packages | `--list` |
295
+ | `ccasp install-scripts` | Install utility scripts | `--list` |
247
296
  | `ccasp claude-audit` | Audit CLAUDE.md | Enhancement suggestions |
248
- | `ccasp validate` | Validate template agnosticism | `--path`, `--fix` |
249
297
  | `ccasp roadmap` | Sync roadmaps with GitHub | `import`, `sync`, `status` |
250
- | `ccasp sync` | Sync tasks with GitHub | `pull`, `push`, `watch` |
251
- | `ccasp list` | List recent GitHub issues | `--mine`, `--status` |
252
298
 
253
299
  ### Slash Commands (Inside Claude Code CLI — AI-Powered)
254
300
 
@@ -275,10 +321,133 @@ claude-cli-advanced-starter-pack # Full name
275
321
  | `/github-task-start` | GitHub Integration | Start/complete GitHub tasks |
276
322
  | `/phase-track` | Phased Development | Track progress on plans |
277
323
  | `/deploy-full` | Deployment Automation | Full-stack deployment |
278
- | `/tunnel-start` | Tunnel Services | Start ngrok/localtunnel |
279
- | `/tunnel-stop` | Tunnel Services | Stop active tunnel |
280
- | `/context-audit` | Token Management | Audit token usage |
281
- | `/happy-start` | Happy Mode | Start mobile integration |
324
+ | `/refactor-check` | Refactoring Tools | Pre-commit quality gate |
325
+ | `/refactor-cleanup` | Refactoring Tools | Auto-fix lint, format, imports |
326
+ | `/create-smoke-test` | Testing | Auto-generate Playwright tests |
327
+ | `/ask-claude` | Discovery | Natural language command search |
328
+
329
+ ---
330
+
331
+ ## Hook Templates
332
+
333
+ CCASP includes 12 production-ready hook templates:
334
+
335
+ ### Token & Session Management
336
+
337
+ ```javascript
338
+ // token-usage-monitor: Auto-respawn at 90% threshold
339
+ {
340
+ event: "PostToolUse",
341
+ trigger: async (context) => {
342
+ const usage = context.tokenUsage;
343
+ if (usage.percentage > 90) {
344
+ await respawnSession();
345
+ }
346
+ }
347
+ }
348
+ ```
349
+
350
+ ### Deployment Automation
351
+
352
+ ```javascript
353
+ // branch-merge-checker: Block deploy on diverged branches
354
+ {
355
+ event: "PreToolUse",
356
+ tools: ["mcp__railway-mcp-server__deployment_trigger"],
357
+ check: async () => {
358
+ const { stdout } = await exec('git status -sb');
359
+ if (stdout.includes('ahead') || stdout.includes('behind')) {
360
+ return { allow: false, reason: "Branch not synced with main" };
361
+ }
362
+ }
363
+ }
364
+ ```
365
+
366
+ ### Installing Hooks
367
+
368
+ ```bash
369
+ # Via init wizard
370
+ ccasp init # Select 'advancedHooks' feature
371
+
372
+ # Manually copy templates
373
+ cp templates/hooks/*.template.js .claude/hooks/
374
+ ```
375
+
376
+ ---
377
+
378
+ ## Agent Patterns
379
+
380
+ ### L1→L2 Orchestration
381
+
382
+ For tasks requiring parallel specialist agents:
383
+
384
+ ```
385
+ ┌─────────────────────┐
386
+ │ L1 Orchestrator │
387
+ │ - Decompose task │
388
+ │ - Dispatch L2s │
389
+ │ - Aggregate │
390
+ └─────────────────────┘
391
+
392
+ ┌────────────────────┼────────────────────┐
393
+ ↓ ↓ ↓
394
+ ┌───────────────┐ ┌───────────────┐ ┌───────────────┐
395
+ │ L2 Specialist │ │ L2 Specialist │ │ L2 Specialist │
396
+ │ (Search) │ │ (Analyze) │ │ (Document) │
397
+ └───────────────┘ └───────────────┘ └───────────────┘
398
+ ```
399
+
400
+ ### Multi-Phase Orchestration
401
+
402
+ For complex projects with sequential phases:
403
+
404
+ ```typescript
405
+ const phases: Phase[] = [
406
+ { id: 'discovery', parallel: true, tasks: [...] },
407
+ { id: 'planning', parallel: false, tasks: [...] },
408
+ { id: 'implementation', parallel: true, tasks: [...] },
409
+ { id: 'testing', parallel: false, tasks: [...] }
410
+ ];
411
+
412
+ // Execute with validation gates between phases
413
+ const result = await executePhases(phases);
414
+ ```
415
+
416
+ See [templates/patterns/](./templates/patterns/) for complete documentation.
417
+
418
+ ---
419
+
420
+ ## Utility Scripts
421
+
422
+ ### Installation
423
+
424
+ ```bash
425
+ ccasp install-scripts
426
+ # Interactive selection of 7 scripts
427
+ ```
428
+
429
+ ### Usage Examples
430
+
431
+ ```bash
432
+ # Pre-deployment validation
433
+ node .claude/scripts/validate-deployment.js --platform railway
434
+
435
+ # Poll deployment status
436
+ node .claude/scripts/poll-deployment-status.js \
437
+ --platform railway \
438
+ --deployment-id abc123 \
439
+ --timeout 300
440
+
441
+ # Scan roadmaps for progress
442
+ node .claude/scripts/roadmap-scanner.js --output json
443
+
444
+ # Analyze Claude delegation logs
445
+ node .claude/scripts/analyze-delegation-log.js \
446
+ ~/.claude/logs/delegation.jsonl --cost-estimate
447
+
448
+ # Security audit git history
449
+ python .claude/scripts/git-history-analyzer.py --patterns "password|secret"
450
+ ```
282
451
 
283
452
  ---
284
453
 
@@ -321,47 +490,34 @@ Auto-generated during init with detected and configured values:
321
490
  "deployment": {
322
491
  "frontend": {
323
492
  "platform": "cloudflare",
324
- "projectName": "my-app",
325
- "productionUrl": "https://my-app.pages.dev"
493
+ "projectName": "my-app"
326
494
  },
327
495
  "backend": {
328
496
  "platform": "railway",
329
- "projectId": "{{DEPLOY_BACKEND_PROJECT_ID}}",
330
- "serviceId": "{{DEPLOY_BACKEND_SERVICE_ID}}",
331
- "environmentId": "{{DEPLOY_BACKEND_ENVIRONMENT_ID}}"
332
- }
333
- },
334
- "versionControl": {
335
- "provider": "github",
336
- "owner": "username",
337
- "repo": "repo-name",
338
- "defaultBranch": "main",
339
- "projectBoard": {
340
- "number": 3
497
+ "projectId": "{{DEPLOY_BACKEND_PROJECT_ID}}"
341
498
  }
342
499
  },
343
500
  "features": {
344
501
  "githubIntegration": true,
345
502
  "phasedDevelopment": true,
346
- "tokenManagement": false,
347
- "deploymentAutomation": true,
348
- "tunnelServices": false,
349
- "happyMode": false
503
+ "advancedHooks": true,
504
+ "refactoring": true,
505
+ "skillTemplates": true
350
506
  }
351
507
  }
352
508
  ```
353
509
 
354
510
  ### settings.json
355
511
 
356
- Configure hooks and behavior:
512
+ Configure hooks and agent behavior:
357
513
 
358
514
  ```json
359
515
  {
360
516
  "hooks": {
361
517
  "enabled": true,
362
- "preToolUse": ["file-guard", "token-guardian"],
363
- "postToolUse": ["test-enforcer", "github-progress"],
364
- "userPromptSubmit": ["context-loader"]
518
+ "preToolUse": ["file-guard", "token-guardian", "branch-merge-checker"],
519
+ "postToolUse": ["test-enforcer", "github-progress", "autonomous-decision-logger"],
520
+ "userPromptSubmit": ["context-loader", "session-id-generator"]
365
521
  },
366
522
  "agents": {
367
523
  "defaultModel": "sonnet",
@@ -374,7 +530,7 @@ Configure hooks and behavior:
374
530
 
375
531
  ## Template Engine
376
532
 
377
- CCASP uses a Handlebars-style template engine (398 lines) for platform-agnostic configuration.
533
+ CCASP uses a Handlebars-style template engine for platform-agnostic configuration.
378
534
 
379
535
  ### Supported Syntax
380
536
 
@@ -440,10 +596,8 @@ import {
440
596
  // GitHub Integration
441
597
  isAuthenticated,
442
598
  getCurrentUser,
443
- listRepos,
444
599
  createIssue,
445
600
  addIssueToProject,
446
- listProjectFields,
447
601
 
448
602
  // Codebase Analysis
449
603
  searchFiles,
@@ -451,10 +605,9 @@ import {
451
605
  findDefinitions,
452
606
  analyzeForIssue,
453
607
 
454
- // Templates
455
- ENHANCEMENT_TEMPLATES,
456
- generateClaudeCommand,
457
- generateIssueBody,
608
+ // Scripts & Skills
609
+ runInstallScripts,
610
+ installSkillCommand,
458
611
  } from 'claude-cli-advanced-starter-pack';
459
612
  ```
460
613
 
@@ -470,7 +623,7 @@ console.log(techStack.frontend.framework); // "react"
470
623
  console.log(techStack.backend.framework); // "fastapi"
471
624
  ```
472
625
 
473
- #### `replacePlaceholders(content: string, values: object, options?: object): { content: string, warnings: string[] }`
626
+ #### `replacePlaceholders(content: string, values: object, options?: object)`
474
627
 
475
628
  Process templates with values:
476
629
 
@@ -480,31 +633,6 @@ const { content, warnings } = replacePlaceholders(template, techStack);
480
633
  // content: "my-app uses react"
481
634
  ```
482
635
 
483
- Options:
484
- - `preserveUnknown`: Keep unresolved placeholders (default: false)
485
- - `warnOnMissing`: Log warnings for missing values (default: true)
486
- - `processConditionals`: Enable conditional processing (default: true)
487
-
488
- #### `processFile(filePath: string, values: object, options?: object): Promise<{ content: string, warnings: string[] }>`
489
-
490
- Process a template file:
491
-
492
- ```javascript
493
- const result = await processFile('./template.md', techStack);
494
- ```
495
-
496
- #### `processDirectory(dirPath: string, values: object, options?: object): Promise<void>`
497
-
498
- Process all templates in a directory:
499
-
500
- ```javascript
501
- await processDirectory('./templates', techStack, {
502
- extensions: ['.md', '.json', '.js'],
503
- exclude: ['node_modules'],
504
- recursive: true
505
- });
506
- ```
507
-
508
636
  ---
509
637
 
510
638
  ## Tech Stack Detection
@@ -525,9 +653,6 @@ CCASP detects 40+ frameworks and tools by reading project files (**no AI require
525
653
  | `.git/config` | Repository URL |
526
654
  | `railway.json` | Railway deployment |
527
655
  | `wrangler.toml` | Cloudflare config |
528
- | `vercel.json` | Vercel config |
529
- | `Dockerfile` | Container setup |
530
- | Directory structure | Project type (monorepo, fullstack, etc.) |
531
656
 
532
657
  ### Detected Categories
533
658
 
@@ -537,7 +662,6 @@ CCASP detects 40+ frameworks and tools by reading project files (**no AI require
537
662
  - **ORM**: Prisma, TypeORM, SQLAlchemy, Drizzle
538
663
  - **Testing**: Jest, Vitest, Mocha, pytest, Playwright, Cypress
539
664
  - **Deployment**: Railway, Vercel, Netlify, Cloudflare, Heroku, AWS
540
- - **Build Tools**: Vite, Webpack, esbuild, Turbopack
541
665
 
542
666
  ---
543
667
 
@@ -549,7 +673,7 @@ During setup, choose a preset for quick configuration:
549
673
  |--------|--------|-------------------|
550
674
  | **A** | Minimal | `/menu`, `/ccasp-setup` only |
551
675
  | **B** | Standard | + GitHub Integration + Phased Development |
552
- | **C** | Full | + Deployment + Tunnels + Token Management |
676
+ | **C** | Full | + Deployment + Hooks + Refactoring + Scripts |
553
677
  | **D** | Custom | Pick individual features |
554
678
 
555
679
  ---
@@ -564,36 +688,18 @@ ccasp explore-mcp --recommend # Auto-recommend based on codebase
564
688
  ccasp explore-mcp --testing # Quick install Playwright + Puppeteer
565
689
  ```
566
690
 
567
- ### Supported MCP Servers
691
+ ### Supported MCP Servers (v1.7.0+)
568
692
 
569
693
  | Category | Servers |
570
694
  |----------|---------|
571
- | **Testing** | Playwright, Puppeteer, Browser Monitor |
572
- | **Deployment** | Railway, Cloudflare, Vercel |
695
+ | **Testing** | Playwright, Puppeteer, Browser Monitor, Skyvern |
696
+ | **Deployment** | Railway, Cloudflare, Vercel, DigitalOcean |
697
+ | **Debugging** | Log Monitor, Browser Monitor |
698
+ | **Tunnel** | ngrok, Cloudflare Tunnel, LocalTunnel |
573
699
  | **Version Control** | GitHub, GitLab |
574
- | **Database** | PostgreSQL, SQLite, Redis |
575
- | **Communication** | Slack, Discord, Email |
576
- | **Utilities** | Filesystem, Fetch, Memory |
577
-
578
- ### MCP Configuration Generated
579
-
580
- ```json
581
- {
582
- "mcpServers": {
583
- "railway": {
584
- "command": "npx",
585
- "args": ["-y", "@anthropic/mcp-server-railway"],
586
- "env": {
587
- "RAILWAY_API_TOKEN": "your-token"
588
- }
589
- },
590
- "playwright": {
591
- "command": "npx",
592
- "args": ["-y", "@anthropic/mcp-server-playwright"]
593
- }
594
- }
595
- }
596
- ```
700
+ | **Database** | PostgreSQL, SQLite, Supabase, Redis |
701
+ | **Communication** | Slack, Discord, Resend Email |
702
+ | **Utilities** | Filesystem, Fetch, Memory (ChromaDB) |
597
703
 
598
704
  ---
599
705
 
@@ -630,12 +736,11 @@ gh auth status
630
736
 
631
737
  ```bash
632
738
  ccasp detect-stack --verbose # See all detected values
633
- ccasp validate --path templates # Check template agnosticism
739
+ ccasp install-scripts --list # List available scripts
740
+ ccasp install-skill --list # List available skills
634
741
  ccasp claude-audit # Audit CLAUDE.md quality
635
742
  ```
636
743
 
637
- For detailed troubleshooting, see the [Troubleshooting Wiki](https://github.com/evan043/claude-cli-advanced-starter-pack/wiki/Troubleshooting).
638
-
639
744
  ---
640
745
 
641
746
  ## Contributing
@@ -656,7 +761,7 @@ npm test
656
761
 
657
762
  ```
658
763
  src/
659
- ├── commands/ # 23 command implementations
764
+ ├── commands/ # 25 command implementations
660
765
  ├── cli/ # Interactive menu system
661
766
  ├── github/ # GitHub API wrapper
662
767
  ├── agents/ # Agent template generators
@@ -664,8 +769,12 @@ src/
664
769
  └── index.js # Main exports
665
770
 
666
771
  templates/
667
- ├── commands/ # Slash command templates
668
- └── hooks/ # Hook templates
772
+ ├── commands/ # Slash command templates (18)
773
+ ├── hooks/ # Hook templates (12)
774
+ ├── skills/ # Skill templates (3)
775
+ ├── patterns/ # Agent patterns (4)
776
+ ├── scripts/ # Utility scripts (7)
777
+ └── docs/ # Doc templates (5)
669
778
  ```
670
779
 
671
780
  ---
@@ -680,6 +789,6 @@ MIT © [evan043](https://github.com/evan043)
680
789
 
681
790
  **Made for Claude Code CLI** — Supercharge your AI-assisted development workflow.
682
791
 
683
- [Documentation](https://github.com/evan043/claude-cli-advanced-starter-pack/wiki) • [Issues](https://github.com/evan043/claude-cli-advanced-starter-pack/issues) • [npm](https://www.npmjs.com/package/claude-cli-advanced-starter-pack)
792
+ [Documentation](./docs/WIKI.md) • [Issues](https://github.com/evan043/claude-cli-advanced-starter-pack/issues) • [npm](https://www.npmjs.com/package/claude-cli-advanced-starter-pack)
684
793
 
685
794
  </div>
package/bin/gtask.js CHANGED
@@ -31,6 +31,10 @@ import { runRoadmap } from '../src/commands/roadmap.js';
31
31
  import { runInit } from '../src/commands/init.js';
32
32
  import { showHelp } from '../src/commands/help.js';
33
33
  import { runSetupWizard } from '../src/commands/setup-wizard.js';
34
+ import { installSkillCommand, listSkills } from '../src/commands/install-skill.js';
35
+ import { runInstallScripts } from '../src/commands/install-scripts.js';
36
+ import { runPanel, launchPanel } from '../src/commands/panel.js';
37
+ import { runInstallPanelHook } from '../src/commands/install-panel-hook.js';
34
38
  import { getVersion, checkPrerequisites } from '../src/utils.js';
35
39
 
36
40
  program
@@ -278,5 +282,54 @@ program
278
282
  await runSetupWizard();
279
283
  });
280
284
 
285
+ // Install skill
286
+ program
287
+ .command('install-skill')
288
+ .description('Install skills to your project')
289
+ .option('--list', 'List available skills')
290
+ .action(async (options) => {
291
+ if (options.list) {
292
+ listSkills();
293
+ } else {
294
+ await installSkillCommand(options);
295
+ }
296
+ });
297
+
298
+ // Install scripts
299
+ program
300
+ .command('install-scripts')
301
+ .description('Install utility scripts to .claude/scripts/')
302
+ .option('--list', 'List available scripts')
303
+ .action(async (options) => {
304
+ await runInstallScripts(options);
305
+ });
306
+
307
+ // Panel - persistent control panel for Claude Code
308
+ program
309
+ .command('panel')
310
+ .description('Launch persistent control panel (run in separate terminal)')
311
+ .action(async () => {
312
+ await runPanel();
313
+ });
314
+
315
+ // Panel launcher - opens panel in new window
316
+ program
317
+ .command('panel-launch')
318
+ .alias('pl')
319
+ .description('Open CCASP panel in a new terminal window')
320
+ .action(async () => {
321
+ await launchPanel();
322
+ });
323
+
324
+ // Install panel hook
325
+ program
326
+ .command('install-panel-hook')
327
+ .description('Install queue reader hook for panel integration')
328
+ .option('--global', 'Install to ~/.claude/ (all projects)')
329
+ .option('--force', 'Overwrite existing hook')
330
+ .action(async (options) => {
331
+ await runInstallPanelHook(options);
332
+ });
333
+
281
334
  // Parse and run
282
335
  program.parse();