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.
- package/OVERVIEW.md +5 -1
- package/README.md +241 -132
- package/bin/gtask.js +53 -0
- package/package.json +1 -1
- package/src/cli/menu.js +27 -0
- package/src/commands/explore-mcp/mcp-registry.js +99 -0
- package/src/commands/init.js +309 -80
- package/src/commands/install-panel-hook.js +108 -0
- package/src/commands/install-scripts.js +232 -0
- package/src/commands/install-skill.js +220 -0
- package/src/commands/panel.js +297 -0
- package/src/commands/setup-wizard.js +4 -3
- package/src/commands/test-setup.js +4 -5
- package/src/data/releases.json +209 -0
- package/src/panel/queue.js +188 -0
- package/templates/commands/ask-claude.template.md +118 -0
- package/templates/commands/ccasp-panel.template.md +72 -0
- package/templates/commands/ccasp-setup.template.md +470 -79
- package/templates/commands/create-smoke-test.template.md +186 -0
- package/templates/commands/project-impl.template.md +9 -113
- package/templates/commands/refactor-check.template.md +112 -0
- package/templates/commands/refactor-cleanup.template.md +144 -0
- package/templates/commands/refactor-prep.template.md +192 -0
- package/templates/docs/AI_ARCHITECTURE_CONSTITUTION.template.md +198 -0
- package/templates/docs/DETAILED_GOTCHAS.template.md +347 -0
- package/templates/docs/PHASE-DEV-CHECKLIST.template.md +241 -0
- package/templates/docs/PROGRESS_JSON_TEMPLATE.json +117 -0
- package/templates/docs/background-agent.template.md +264 -0
- package/templates/hooks/autonomous-decision-logger.template.js +207 -0
- package/templates/hooks/branch-merge-checker.template.js +272 -0
- package/templates/hooks/context-injector.template.js +261 -0
- package/templates/hooks/git-commit-tracker.template.js +267 -0
- package/templates/hooks/happy-mode-detector.template.js +214 -0
- package/templates/hooks/happy-title-generator.template.js +260 -0
- package/templates/hooks/issue-completion-detector.template.js +205 -0
- package/templates/hooks/panel-queue-reader.template.js +83 -0
- package/templates/hooks/phase-validation-gates.template.js +307 -0
- package/templates/hooks/session-id-generator.template.js +236 -0
- package/templates/hooks/token-budget-loader.template.js +234 -0
- package/templates/hooks/token-usage-monitor.template.js +193 -0
- package/templates/hooks/tool-output-cacher.template.js +219 -0
- package/templates/patterns/README.md +129 -0
- package/templates/patterns/l1-l2-orchestration.md +189 -0
- package/templates/patterns/multi-phase-orchestration.md +258 -0
- package/templates/patterns/two-tier-query-pipeline.md +192 -0
- package/templates/scripts/README.md +109 -0
- package/templates/scripts/analyze-delegation-log.js +299 -0
- package/templates/scripts/autonomous-decision-logger.js +277 -0
- package/templates/scripts/git-history-analyzer.py +269 -0
- package/templates/scripts/phase-validation-gates.js +307 -0
- package/templates/scripts/poll-deployment-status.js +260 -0
- package/templates/scripts/roadmap-scanner.js +263 -0
- package/templates/scripts/validate-deployment.js +293 -0
- package/templates/skills/agent-creator/skill.json +18 -0
- package/templates/skills/agent-creator/skill.md +335 -0
- package/templates/skills/hook-creator/skill.json +18 -0
- package/templates/skills/hook-creator/skill.md +318 -0
- package/templates/skills/panel/skill.json +18 -0
- package/templates/skills/panel/skill.md +90 -0
- package/templates/skills/rag-agent-creator/skill.json +18 -0
- 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
|
-
**
|
|
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
|
+
║ v1.8.0 • Production Ready ║
|
|
13
13
|
║ ║
|
|
14
14
|
╚═══════════════════════════════════════════════════════════════════════════════╝
|
|
15
15
|
```
|
|
@@ -18,9 +18,9 @@
|
|
|
18
18
|
[](https://nodejs.org)
|
|
19
19
|
[](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](
|
|
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
|
|
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
|
-
###
|
|
80
|
-
|
|
81
|
-
|
|
|
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
|
-
|
|
|
84
|
-
|
|
|
85
|
-
|
|
|
86
|
-
|
|
|
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/ │
|
|
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
|
-
│ └── ... #
|
|
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
|
|
229
|
+
### Post-Install Commands
|
|
177
230
|
|
|
178
|
-
```
|
|
179
|
-
|
|
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
|
-
|
|
189
|
-
|
|
235
|
+
# Install utility scripts
|
|
236
|
+
ccasp install-scripts
|
|
190
237
|
|
|
191
|
-
|
|
192
|
-
|
|
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
|
-
| `/
|
|
279
|
-
| `/
|
|
280
|
-
| `/
|
|
281
|
-
| `/
|
|
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
|
-
"
|
|
347
|
-
"
|
|
348
|
-
"
|
|
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
|
|
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
|
-
//
|
|
455
|
-
|
|
456
|
-
|
|
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)
|
|
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 +
|
|
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
|
|
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/ #
|
|
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
|
-
|
|
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](
|
|
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();
|