Claude CLI Advanced Starter Pack (CCASP)

╔═══════════════════════════════════════════════════════════════════════════════╗
║                                                                               ║
║   ╔═╗╦  ╔═╗╦ ╦╔╦╗╔═╗  ╔═╗╔╦╗╦  ╦╔═╗╔╗╔╔═╗╔═╗╔╦╗  ╔═╗╔╦╗╔═╗╦═╗╔╦╗╔═╗╦═╗       ║
║   ║  ║  ╠═╣║ ║ ║║║╣   ╠═╣ ║║╚╗╔╝╠═╣║║║║  ║╣  ║║  ╚═╗ ║ ╠═╣╠╦╝ ║ ║╣ ╠╦╝       ║
║   ╚═╝╩═╝╩ ╩╚═╝═╩╝╚═╝  ╩ ╩═╩╝ ╚╝ ╩ ╩╝╚╝╚═╝╚═╝═╩╝  ╚═╝ ╩ ╩ ╩╩╚═ ╩ ╚═╝╩╚═       ║
║                                                                               ║
║                          v1.0.12  •  Production Ready                         ║
║                                                                               ║
╚═══════════════════════════════════════════════════════════════════════════════╝

Table of Contents

• Overview
• Key Features
• Architecture
• Quick Start
• Installation Options
• Commands Reference
• Configuration
• Template Engine
• API Reference
• Tech Stack Detection
• Feature Presets
• MCP Server Integration
• Troubleshooting
• Contributing

Overview

CCASP is a two-phase toolkit that extends Claude Code CLI capabilities:

What This Means for You

1. Terminal Commands (ccasp wizard, ccasp init) run without AI — they read your project files and generate configuration
2. Slash Commands (/menu, /deploy-full) run inside Claude Code CLI with full AI capabilities

Key Features

Core Capabilities

Optional Feature Modules

Architecture

┌─────────────────────────────────────────────────────────────────────────────┐
│                    CCASP ARCHITECTURE                                        │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  PHASE 1: TERMINAL (No AI)                                                   │
│  ─────────────────────────                                                   │
│                                                                              │
│  npm install ──► postinstall ──► ccasp wizard                                │
│                                                                              │
│  ┌──────────────┐   ┌──────────────┐   ┌──────────────┐                     │
│  │  Tech Stack  │──►│   Template   │──►│   Feature    │                     │
│  │  Detection   │   │   Engine     │   │  Selection   │                     │
│  │ (768 lines)  │   │ (398 lines)  │   │ (1386 lines) │                     │
│  └──────────────┘   └──────────────┘   └──────────────┘                     │
│         │                  │                  │                              │
│         ▼                  ▼                  ▼                              │
│  ┌──────────────────────────────────────────────────────────────────┐       │
│  │                    YOUR PROJECT (.claude/)                        │       │
│  │  commands/ │ agents/ │ skills/ │ hooks/ │ docs/ │ settings.json  │       │
│  └──────────────────────────────────────────────────────────────────┘       │
│                                                                              │
│  PHASE 2: CLAUDE CODE CLI (AI-Powered)                                       │
│  ─────────────────────────────────────                                       │
│                                                                              │
│  ┌──────────────────────────────────────────────────────────────────┐       │
│  │                     RESTART REQUIRED                              │       │
│  │                            ↓                                      │       │
│  │  /menu │ /deploy-full │ /github-update │ /phase-track │ ...      │       │
│  │                                                                   │       │
│  │  Agents: L1 Orchestrators ──► L2 Specialists ──► L3 Workers      │       │
│  │  Hooks: PreToolUse | PostToolUse | UserPromptSubmit              │       │
│  │  Skills: RAG context + templates + workflows                      │       │
│  └──────────────────────────────────────────────────────────────────┘       │
│                                                                              │
└─────────────────────────────────────────────────────────────────────────────┘

Directory Structure

After running ccasp init, your project gets:

.claude/
├── commands/              # Slash commands (markdown with YAML frontmatter)
│   ├── menu.md           # Interactive menu
│   ├── ccasp-setup.md    # Setup wizard
│   ├── deploy-full.md    # Deployment command
│   └── ...               # 20+ commands based on feature selection
├── agents/               # L1/L2/L3 agent definitions
├── skills/               # RAG-enhanced skill packages
│   └── skill-name/
│       ├── skill.md      # Definition
│       ├── context/      # Knowledge base
│       └── workflows/    # Procedures
├── hooks/                # Enforcement hooks
│   ├── pre-tool-use/
│   ├── post-tool-use/
│   └── user-prompt-submit/
├── docs/                 # Generated documentation
├── phase-dev/            # Phased development projects
├── settings.json         # Hook configuration
└── tech-stack.json       # Detected/configured values

Quick Start

# Step 1: Install globally
npm install -g claude-cli-advanced-starter-pack

# Step 2: Run the setup wizard (terminal command - no AI needed)
ccasp wizard

# Step 3: IMPORTANT - Restart Claude Code CLI
#         Changes to .claude/ require a new session
claude .

# Step 4: Use slash commands inside Claude (AI-powered)
/menu

Post-Install Welcome

🚀 Claude CLI Advanced Starter Pack

✓ Installation complete!

Quick Setup Options:

1. Run vibe-friendly setup wizard:
   $ ccasp wizard

2. Quick init (auto-detect + deploy):
   $ ccasp init

3. Full interactive menu:
   $ ccasp

Installation Options

Option A: Global Installation (Recommended)

npm install -g claude-cli-advanced-starter-pack
ccasp wizard

Option B: Project-Local Installation

npm install --save-dev claude-cli-advanced-starter-pack
npx ccasp wizard

Option C: One-Time Use

npx claude-cli-advanced-starter-pack init

CLI Aliases

All aliases point to the same CLI:

ccasp                           # Short form (recommended)
ccasp w                         # Wizard shortcut
claude-advanced                 # Medium form
claude-cli-advanced-starter-pack # Full name

Commands Reference

Terminal Commands (Shell — No AI)

Slash Commands (Inside Claude Code CLI — AI-Powered)

Core Commands (Always Installed)

Feature-Specific Commands

Configuration

tech-stack.json

Auto-generated during init with detected and configured values:

{
  "version": "2.0.0",
  "project": {
    "name": "my-project",
    "type": "fullstack"
  },
  "frontend": {
    "framework": "react",
    "port": 5173,
    "buildCommand": "npm run build",
    "devCommand": "npm run dev",
    "distDir": "dist"
  },
  "backend": {
    "framework": "fastapi",
    "port": 8001,
    "language": "python",
    "healthEndpoint": "/health"
  },
  "database": {
    "type": "postgresql",
    "orm": "prisma"
  },
  "testing": {
    "unit": "vitest",
    "e2e": "playwright",
    "unitCommand": "npm test",
    "e2eCommand": "npm run test:e2e"
  },
  "deployment": {
    "frontend": {
      "platform": "cloudflare",
      "projectName": "my-app",
      "productionUrl": "https://my-app.pages.dev"
    },
    "backend": {
      "platform": "railway",
      "projectId": "{{DEPLOY_BACKEND_PROJECT_ID}}",
      "serviceId": "{{DEPLOY_BACKEND_SERVICE_ID}}",
      "environmentId": "{{DEPLOY_BACKEND_ENVIRONMENT_ID}}"
    }
  },
  "versionControl": {
    "provider": "github",
    "owner": "username",
    "repo": "repo-name",
    "defaultBranch": "main",
    "projectBoard": {
      "number": 3
    }
  },
  "features": {
    "githubIntegration": true,
    "phasedDevelopment": true,
    "tokenManagement": false,
    "deploymentAutomation": true,
    "tunnelServices": false,
    "happyMode": false
  }
}

settings.json

Configure hooks and behavior:

{
  "hooks": {
    "enabled": true,
    "preToolUse": ["file-guard", "token-guardian"],
    "postToolUse": ["test-enforcer", "github-progress"],
    "userPromptSubmit": ["context-loader"]
  },
  "agents": {
    "defaultModel": "sonnet",
    "maxTokensPerTask": 8000
  }
}

Template Engine

CCASP uses a Handlebars-style template engine (398 lines) for platform-agnostic configuration.

Supported Syntax

Template Example

{{#if deployment.backend.platform}}
## Backend Deployment

{{#if (eq deployment.backend.platform "railway")}}
Using Railway MCP:

mcp__railway-mcp-server__deployment_trigger({ projectId: "{{deployment.backend.projectId}}", serviceId: "{{deployment.backend.serviceId}}" })

{{/if}}

{{#if (eq deployment.backend.platform "vercel")}}
Using Vercel:
```bash
vercel --prod

{{/if}} {{else}} ⚠️ Backend deployment not configured {{/if}}

---

## API Reference

### Programmatic Usage

```javascript
import {
  // Setup & Detection
  runSetupWizard,
  detectTechStack,
  runClaudeAudit,

  // Template Processing
  replacePlaceholders,
  processFile,
  processDirectory,
  generateTechStack,

  // GitHub Integration
  isAuthenticated,
  getCurrentUser,
  listRepos,
  createIssue,
  addIssueToProject,
  listProjectFields,

  // Codebase Analysis
  searchFiles,
  searchContent,
  findDefinitions,
  analyzeForIssue,

  // Templates
  ENHANCEMENT_TEMPLATES,
  generateClaudeCommand,
  generateIssueBody,
} from 'claude-cli-advanced-starter-pack';

Key Functions

detectTechStack(projectPath: string): Promise<TechStack>

Detects project technology stack by reading configuration files:

const techStack = await detectTechStack(process.cwd());
console.log(techStack.frontend.framework); // "react"
console.log(techStack.backend.framework);  // "fastapi"

replacePlaceholders(content: string, values: object, options?: object): { content: string, warnings: string[] }

Process templates with values:

const template = '{{project.name}} uses {{frontend.framework}}';
const { content, warnings } = replacePlaceholders(template, techStack);
// content: "my-app uses react"

Options:

• preserveUnknown: Keep unresolved placeholders (default: false)
• warnOnMissing: Log warnings for missing values (default: true)
• processConditionals: Enable conditional processing (default: true)

processFile(filePath: string, values: object, options?: object): Promise<{ content: string, warnings: string[] }>

Process a template file:

const result = await processFile('./template.md', techStack);

processDirectory(dirPath: string, values: object, options?: object): Promise<void>

Process all templates in a directory:

await processDirectory('./templates', techStack, {
  extensions: ['.md', '.json', '.js'],
  exclude: ['node_modules'],
  recursive: true
});

Tech Stack Detection

CCASP detects 40+ frameworks and tools by reading project files (no AI required):

Detection Sources

Detected Categories

• Frontend: React, Vue, Angular, Svelte, Next.js, Nuxt, Astro
• Backend: FastAPI, Express, NestJS, Django, Flask, Rails, Gin
• Database: PostgreSQL, MySQL, MongoDB, SQLite, Redis
• ORM: Prisma, TypeORM, SQLAlchemy, Drizzle
• Testing: Jest, Vitest, Mocha, pytest, Playwright, Cypress
• Deployment: Railway, Vercel, Netlify, Cloudflare, Heroku, AWS
• Build Tools: Vite, Webpack, esbuild, Turbopack

Feature Presets

During setup, choose a preset for quick configuration:

MCP Server Integration

CCASP helps discover and configure Model Context Protocol (MCP) servers:

ccasp explore-mcp              # Interactive menu
ccasp explore-mcp --recommend  # Auto-recommend based on codebase
ccasp explore-mcp --testing    # Quick install Playwright + Puppeteer

Supported MCP Servers

MCP Configuration Generated

{
  "mcpServers": {
    "railway": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-railway"],
      "env": {
        "RAILWAY_API_TOKEN": "your-token"
      }
    },
    "playwright": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-playwright"]
    }
  }
}

Prerequisites

GitHub CLI Setup (for GitHub features)

gh auth login
gh auth status

Troubleshooting

Common Issues

Debug Commands

ccasp detect-stack --verbose    # See all detected values
ccasp validate --path templates # Check template agnosticism
ccasp claude-audit              # Audit CLAUDE.md quality

For detailed troubleshooting, see the Troubleshooting Wiki.

Contributing

Contributions welcome! Please read our contributing guidelines.

Development Setup

git clone https://github.com/evan043/claude-cli-advanced-starter-pack.git
cd claude-cli-advanced-starter-pack
npm install
npm run lint
npm test

Code Structure

src/
├── commands/           # 23 command implementations
├── cli/               # Interactive menu system
├── github/            # GitHub API wrapper
├── agents/            # Agent template generators
├── utils/             # Template engine, validators
└── index.js           # Main exports

templates/
├── commands/          # Slash command templates
└── hooks/             # Hook templates

License

MIT © evan043