Claude CLI Advanced Starter Pack (CCASP)

hljs

╔═══════════════════════════════════════════════════════════════════════════════╗
║                                                                               ║
║   ╔═╗╦  ╔═╗╦ ╦╔╦╗╔═╗  ╔═╗╔╦╗╦  ╦╔═╗╔╗╔╔═╗╔═╗╔╦╗  ╔═╗╔╦╗╔═╗╦═╗╔╦╗╔═╗╦═╗       ║
║   ║  ║  ╠═╣║ ║ ║║║╣   ╠═╣ ║║╚╗╔╝╠═╣║║║║  ║╣  ║║  ╚═╗ ║ ╠═╣╠╦╝ ║ ║╣ ╠╦╝       ║
║   ╚═╝╩═╝╩ ╩╚═╝═╩╝╚═╝  ╩ ╩═╩╝ ╚╝ ╩ ╩╝╚╝╚═╝╚═╝═╩╝  ╚═╝ ╩ ╩ ╩╩╚═ ╩ ╚═╝╩╚═       ║
║                                                                               ║
║                           v2.11.4  •  Production Ready                        ║
║                                                                               ║
╚═══════════════════════════════════════════════════════════════════════════════╝

Your entire Claude Code setup — customized for your stack — deployed in one command.

hljs language-bash

npx claude-cli-advanced-starter-pack init

Quick Start • What You Get • 📚 Wiki • Roadmap

v2.11.4 Feature Update — Neovim Deploy Panel & Session Management

Feb 2026 — Enhanced Neovim plugin with deploy configuration panel, session reorder controls, and always-on symlink sync for project templates. Plus per-session slash commands and restored minimized session support.

What's New in v2.11.4

Deploy Configuration Panel

New flyout panel in nvim-ccasp:

Deploy Config — Configure deployment settings from Neovim sidebar
Service Management — Railway/Cloudflare settings at a glance
Quick Deploy — Trigger deployments without leaving the editor

Session Reorder & Management

Footer taskbar enhancements:

Session Reorder Button — Drag-and-drop session ordering in footer
Per-Session Slash Commands — Each session gets its own command scope
Active Session Targeting — Commands route to the focused session
Restored Minimized Sessions — Splash screen recovery for minimized sessions

Always-On Symlink Sync

Template synchronization improvements:

Symlink Sync — Project templates stay in sync automatically
No Manual Refresh — Changes propagate without ccasp init
Dev Mode Compatible — Works seamlessly with worktree workflows

Previous: Competitor Research & MVP Build Mode (v2.11.1)

6-Phase Competitive Intelligence in /project-implementation
B2C MVP vs Enterprise B2B build tier selection
Auto-Configure Feature Toggles by market type
Build Tier Awareness in /phase-dev-plan and /create-roadmap

Upgrade Now

hljs language-bash

# Update to v2.11.4
npm update -g claude-cli-advanced-starter-pack

# Sync new commands to your project
ccasp init

v2.11.1 — Competitor Research & MVP Build Mode (click to expand)

Feb 2026 — New optional competitive intelligence workflow during project setup. Run 6-phase competitor research, validate compliance, and choose between B2C MVP (6-week, freemium) or Enterprise B2B (10-week, full compliance) build tiers.

Competitor Research Workflow — 6-phase competitive intelligence in /project-implementation
Build Tier Selection — B2C MVP (6 weeks, freemium) vs Enterprise B2B (10 weeks, full compliance)
Auto-Configure Feature Toggles — Tier selection auto-stubs/enables multi-tenancy, RBAC, billing
Neovim Panel — New "MARKET RESEARCH" section with competitor_research toggle
Build Tier Awareness — /phase-dev-plan and /create-roadmap read buildTier from tech-stack.json

v2.8.1 — Getting Started Onboarding + Help System (nvim-ccasp) (click to expand)

Feb 2026 — Interactive 8-page Getting Started guide with first-launch detection, ASCII diagrams, try-it actions, and a persistent Help system with 11 searchable wiki topics embedded offline.

Getting Started Guide — 8-page onboarding with ASCII diagrams, keybinding tables, try-it actions
First-Launch Detection — Auto-opens on first launch, remembers completion state
Help System — 11 wiki topics with Telescope fuzzy search + vim.ui.select fallback
Navigation — Page dots, n/p keys, 1-8 jump, h/l arrow support
New Commands — :CcaspWelcome, :CcaspHelp, <leader>c?, <leader>cw
Sidebar Integration — Help tab now shows Getting Started and Help links

v2.7.0 — Vision Multi-Instance & Decision Engine (click to expand)

Feb 2026 — Vision Mode now supports multiple concurrent visions with a centralized registry, cross-process file locking, slug uniqueness enforcement, and an intelligent decision engine.

Vision Registry: Centralized VISION_REGISTRY.json with atomic writes, auto-rebuild
Decision Engine: Weighted scoring selects plan type (task-list / phase-dev-plan / roadmap / epic / vision-full)
Slug Uniqueness: generateUniqueSlug() appends -2/-3 on collision
New Commands: ccasp vision list, ccasp vision cleanup, /vision-list

v2.6.1 — Smart Todo List with AI Intent Routing (click to expand)

Feb 2026 — New Smart Todo system: quick-add with auto-paraphrasing, interactive menu, AI-powered "Work on item" that suggests the best CCASP workflow (Vision/Epic/Roadmap/Phase-Dev/Task List), plus full Neovim integration with sidebar, floating panel, and Telescope picker.

/todo-add — Quick-add with auto-paraphrasing to 5-6 word titles
/todo — Interactive menu: list, navigate, work-on, complete, delete
AI Intent Routing — Analyzes todo and suggests Vision/Epic/Roadmap/Phase-Dev/Task List/Just do it
Neovim Integration — Sidebar section, floating panel, Telescope picker

🚀 v2.6.0 Feature Update — Smart Site Intel Dev-Scan System

Feb 2026 — New developer-focused application scanner: per-route health monitoring, data-testid coverage tracking, git-diff incremental scanning, regression detection, and interactive dashboard with 12 MCP tools.

🆕 What's New in v2.6.0

🔬 Smart Site Intel Dev-Scan

Developer-focused per-route application scanning:

Route Catalog — AST-based route discovery with reverse file→route mapping
Config Reader — Reads tech-stack.json, .env, playwright.config automatically
Playwright Scanner — Auth, live DOM testid check, axe a11y, optional Lighthouse
Git Diff Integration — Incremental scanning with 30% threshold for full scan
State Persistence — Per-route scores, history (20 entries FIFO), diff tracking
Quick Check — Static testid coverage in <10s (no Playwright needed)

📊 Dev Scan Dashboard

Interactive web dashboard at http://localhost:3847:

Health Metrics — Overall score, total routes, testid coverage, last scan
Sortable Route Table — Sort by path, testid, a11y, perf, health grade
Color-Coded Grades — A (green) through F (red) per-route health
Diff Display — Improvements (green) and regressions (red)
Trend Sparklines — Inline SVG health history per route
Filter Controls — All routes, failing (<70%), regressions only
7 New API Endpoints — state, summary, routes, diffs, history, testid-coverage

🔌 3 New MCP Tools (12 Total)

Expanded site-intel MCP server:

site_intel_dev_scan — Full/incremental per-route scan with diffs
site_intel_quick_check — Fast static testid coverage (no Playwright)
site_intel_dev_state — Read current state without scanning
Updated /site-intel slash command with dev-scan actions
New /site-intel-dashboard dedicated slash command

📦 Dev-Scan Module (8 Files, ~78KB)

Complete scanning subsystem:

config-reader.js — Project config loading (226 lines)
route-catalog.js — Route discovery + reverse map (246 lines)
state-manager.js — Persistent state + history (305 lines)
git-diff.js — Changed file detection + route mapping (184 lines)
testid-checker.js — Static analysis, 11 patterns (326 lines)
scanner.js — Playwright-based scanning (361 lines)
diff-reporter.js — Categorized diff output (201 lines)

Upgrade Now

hljs language-bash

# Update to latest
npm update -g claude-cli-advanced-starter-pack

# Sync all new features to your project
ccasp init

The Problem

Every new project means:

❌ Manually creating .claude/ folders and configurations
❌ Copy-pasting commands, hooks, and agents from old projects
❌ Forgetting critical settings and enforcement hooks
❌ Agents that don't understand your tech stack
❌ Hours of setup before you can actually build

The Solution

One command. Fully configured. Stack-aware.

hljs language-bash

npx claude-cli-advanced-starter-pack init

CCASP scans your project, detects your stack (React? FastAPI? Prisma? Playwright?), and deploys a complete .claude/ folder with:

✅ 64 slash commands — deployment, testing, refactoring, GitHub sync, UI testing
✅ 44 enforcement hooks — validation, progress tracking, agent orchestration
✅ Stack-specific agents — specialists that know your frameworks
✅ Smart updates — add features without losing customizations

What You Get

Component	Count	Examples
Slash Commands	66	`/deploy-full`, `/pr-merge`, `/ralph`, `/ui-test`, `/research-competitor`
Enforcement Hooks	44	Token tracking, agent orchestration, refactor safety, UI test auto-run
Tech Stack Detection	55+	React, Vue, FastAPI, Express, Prisma, Playwright
Agent Templates	L1/L2/L3	Orchestrators → Specialists → Workers + UI testing agents
MCP Integrations	50+	Railway, Cloudflare, GitHub, Playwright
Skills (RAG)	6	agent-creator, hook-creator, refactor patterns, nvim-ui-test

AI Constitution Framework

Enforce project-specific coding standards and architecture patterns with automatic validation.

Quick Start

hljs language-bash

ccasp constitution-init --preset senior    # 5% sampling, all sections
ccasp constitution-init --preset minimal   # 2% sampling, security only
ccasp constitution-init --preset strict    # 15% sampling, maximum coverage

Features

YAML-based rules at .claude/config/constitution.yaml
Hook enforcement with configurable sampling (1-in-20 default)
Sensitive pattern bypass - security rules always checked
Stop → Explain → Suggest → Refactor violation flow
Neovim integration - edit constitution from sidebar

Rule Sections

Section	Examples
`code_style`	Naming, types, imports
`architecture`	Patterns, boundaries
`security`	Credentials, validation
`performance`	Async, memoization
`git`	Commits, branches
`dependencies`	Versions, security

See /ai-constitution-framework in Claude Code for full documentation.

Landing Page Generator

Automated marketing asset pipeline: capture screenshots, apply device frames, generate GIFs, and build landing page components.

Commands

Command	Description
`/landing-page-generator`	Interactive menu: configure, capture, frame, GIF, preview, build, deploy
`/landing-page-generator-executor`	Automated phase executor for pipeline tasks
`/landing-page-toggle`	Enable/disable landing page in production

Pipeline

Capture - Playwright screenshots of app routes at configurable viewports
Frame - Composite into device bezels (MacBook Pro, iPhone 15, iPad, etc.)
Generate GIFs - Stitch framed screenshots into animated marketing GIFs
Build - Generate React components with the produced assets

Skill: Screenshot Pipeline

The screenshot-pipeline skill package includes reference documentation for:

Device frames - 12+ device templates (laptop, phone, tablet)
Viewport presets - Standard configurations for phone/tablet/desktop
Pipeline config - Full configuration schema with examples

Requires: sharp, gifencoder, canvas NPM packages + playwright-ext MCP server.

See It In Action

📸 Screenshots Gallery (click to expand/collapse)

Desktop UI

/menu — Interactive Navigation

Full-featured menu with all options

Project Configuration Settings

GitHub, deployment, tunnels, tokens

Mobile UI (Happy.engineering)

/menu — Mobile Navigation Single-key navigation, 40-char width	Setup Wizard — Feature Selection Choose commands, agents, hooks, skills
GitHub Project Setup One-click repo and Project Board sync	/claude-audit — Analysis Report CLAUDE.md analysis with score
Audit Score Breakdown Detailed scoring and summary	Actionable Recommendations Priority-ordered improvements

Highlight Features

🎯 Stack-Aware Agents

Auto-generates agents that know your tech:

React + Zustand + Tailwind specialist
FastAPI + SQLAlchemy backend agent
Playwright E2E testing expert
PostgreSQL + Prisma database agent

🔄 Ralph Loop Testing

Continuous test-fix cycle until green:

hljs language-bash

/ralph --watch

Runs tests → Parses failures → Fixes code → Repeats.

Smart Recovery: Every 3rd failed attempt deploys a web search agent to find best-practice solutions for stubborn bugs or implementation issues.

Max 10 iterations. Stops on 3x same failure.

🗺️ Multi-Phase Roadmaps

Coordinate full-stack, multi-feature development:

hljs language-bash

/create-roadmap "Q1 Feature Sprint"

Break epics into phased milestones
GitHub issue tracking per phase
Customizable Project Board sync
Dependency graphs with auto-ordering
Progress dashboard across all phases

🚀 One-Command Deployment

Full-stack deploy to Railway + Cloudflare:

hljs language-bash

/deploy-full

Backend and frontend in parallel
Pre-flight validation
Automatic rollback on failure

📋 Phased Development

Break complex features into phases:

hljs language-bash

/phase-dev-plan "Add user authentication"

95%+ success probability planning
PROGRESS.json state tracking
GitHub issue sync
L1/L2/L3 agent orchestration

🔀 Safe PR Merges

9-phase merge workflow with safety:

hljs language-bash

/pr-merge

Auto-stash uncommitted changes
Resolve conflicts, CI failures, reviews
Automatic rollback on any failure

🎫 GitHub Epic System

Multi-issue epic workflows:

hljs language-bash

/create-github-epic "Auth System"

Creates parent epic with child issues
Tracks completion across all issues
Auto-syncs with Project Board
Progress comments on epic issue

📱 Mobile-First UI

Works with Happy.engineering:

40-character max width
Card-based layouts
Single-character inputs
Auto-detected via environment

👁️ Vision Mode — Autonomous MVP Development

Transform natural language into complete, working MVPs:

hljs language-bash

ccasp vision init "Build a kanban board with real-time collaboration"

8-Stage Orchestrated Workflow:

Initialize — Parse prompt, detect intent, extract features
Analyze — Web search for inspiration, discover npm/pip packages, match MCP servers
Architect — Generate Mermaid diagrams, API contracts, ASCII wireframes
Security — Scan dependencies with npm audit, pip-audit, OSV Scanner
Create Agents — Spawn specialized agents for detected tech stack
Execute — Autonomous development loop with self-healing
Validate — Run tests, verify MVP completeness
Complete — Final verification and checkpoint creation

Features:

🎯 Natural Language Input — "Build a todo app with React and FastAPI"
🔍 Analysis Engine — Similar apps search, tool discovery, MCP matching
🏗️ Architecture Planning — Mermaid diagrams, API contracts, state design
👁️ Drift Detection — Hook-based observer with automatic plan adjustment
🔒 Security Scanning — Pre-install vulnerability detection
🤖 Dynamic Agents — Creates specialists based on tech stack
🔄 Self-Healing — Automatic test failure resolution
📊 Web Dashboard — Real-time status at http://localhost:3847

hljs language-bash

# Initialize and run
ccasp vision init "Your app idea here"
ccasp vision run my-app

# Multi-vision management (v2.7.0)
ccasp vision list           # Registry-backed listing
ccasp vision cleanup        # Remove orphaned visions

# Monitor with web dashboard
ccasp vision dashboard

# Or use slash commands
/vision-init                # Decision engine auto-selects plan type
/vision-status              # Shows plan type indicators
/vision-list                # Multi-vision registry management
/vision-run

Architecture

After running ccasp init, your project gets:

hljs language-bash

.claude/
├── commands/              # 64 slash commands
│   ├── menu.md           # Interactive navigation
│   ├── deploy-full.md    # Full-stack deployment
│   ├── ralph.md          # Test-fix loops
│   └── ...
├── agents/                # Stack-specific AI agents
│   ├── react-specialist.md
│   ├── fastapi-specialist.md
│   └── ...
├── hooks/                 # 44 enforcement hooks
│   ├── ralph-loop-enforcer.js
│   ├── progress-tracker.js
│   └── ...
├── skills/                # RAG-enhanced packages
├── config/
│   └── tech-stack.json    # Your detected stack
└── settings.json          # Project configuration

Everything is customized to your package.json, config files, and directory structure.

Quick Start

hljs language-bash

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

# Step 2: Initialize (detects your stack, deploys .claude/)
ccasp init

# Step 3: Restart Claude Code CLI (required for new commands)
claude .

# Step 4: Use slash commands
/menu

One-Time Use (No Install)

hljs language-bash

npx claude-cli-advanced-starter-pack init

Roadmap

🚀 Coming Soon

Feature	Status
Competitor Research & MVP Build Mode	✅ Complete
Neovim UI Testing + Appshell Layout	✅ Complete
Vision Multi-Instance & Decision Engine	✅ Complete
Smart Site Intel Dev-Scan	✅ Complete
Vision Mode Orchestration	✅ Complete
Website Intelligence (Site-Intel)	✅ Complete
Anthropic MCP Registry	✅ Complete
nvim-ccasp Modular Refactoring	✅ Complete
JS Module Decomposition (Epic 3)	✅ Complete
Jira Integration	🔨 In Development
Linear Sync	🔨 In Development
ClickUp Integration	📋 Planned
Vision Driver Bot (VDB) v2	🔨 In Development
Multi-Repo Orchestration	📋 Planned

Version History

v2.11.4

Neovim Deploy Panel & Session Management — Feb 2026

Deploy Configuration Panel: New flyout panel for deployment settings in nvim-ccasp sidebar
Session Reorder Button: Drag-and-drop session ordering in footer taskbar
Always-On Symlink Sync: Project templates stay in sync automatically without manual ccasp init

v2.11.2

Per-Session Commands & Minimized Session Recovery — Feb 2026

Per-Session Slash Commands: Each Claude CLI session gets its own command scope and active targeting
Minimized Session Recovery: Restore minimized sessions from splash screen
Slideshow GIF: Added animated demo GIF to README hero section

v2.11.1

Competitor Research & MVP Build Mode — Feb 2026

Competitor Research Workflow: Optional 6-phase competitive intelligence in /project-implementation Step 1.8
Build Tier Selection: B2C MVP (6 weeks, freemium) vs Enterprise B2B (10 weeks, full compliance)
Auto-Configure Feature Toggles: Tier selection auto-stubs/enables multi-tenancy, RBAC, billing, API contracts, mobile
Neovim Panel: New "MARKET RESEARCH" section with competitor_research toggle (14th feature)
Build Tier Awareness: /phase-dev-plan and /create-roadmap read buildTier from tech-stack.json
Compliance Integration: Runs /compliance-check on discovered competitors for IP protection
Tier-Specific Roadmap Phases: B2C and Enterprise each get optimized 6-phase ordering
Tests: 17/17 config tests, 29/29 bridge tests, all syntax checks passing

v2.8.0

Neovim UI Testing Framework + Appshell Layout — Feb 2026

UI Testing Framework: Deterministic headless testing with plenary.nvim — driver (534 lines), snapshot (512 lines), 4 spec files, 3 runner scripts
Appshell Layout: VS Code-inspired zone-based UI with icon rail, flyout, header, footer, content zone, right panel
6 New Commands: /ui-test, /ui-smoke, /ui-snapshot, /ui-bug, /ui-fix, /repo-guard
3 New Agents: ui-driver, ui-debugger, nvim-test-runner with clear delegation boundaries
2 New Hooks: nvim-after-edit-test (auto-smoke on Lua edit), agent-limit-compact (3 concurrent max)
Per-Folder Documentation: 15 files across nvim-ui-testing/ subfolders (READMEs, examples, checklists)
Integration Templates: MCP-Neovim bridge config, claude-code.nvim compatibility guide
CLAUDE_WORKFLOW.md: Development workflow documentation for the nvim-ccasp plugin

v2.7.0

Vision Multi-Instance & Decision Engine — Feb 2026

Vision Registry: Centralized VISION_REGISTRY.json with atomic writes, auto-rebuild from filesystem, cross-process file locking
Decision Engine: Weighted scoring selects plan type (task-list / phase-dev-plan / roadmap / epic / vision-full) based on prompt complexity
Slug Uniqueness: generateUniqueSlug() appends -2/-3 on collision, registry-backed enforcement
Enhanced CLI: ccasp vision list (registry-backed with plan type column), ccasp vision cleanup (orphaned/failed removal)
New Slash Command: /vision-list for multi-vision management
Templates Updated: /vision-init shows decision engine result, /vision-status shows plan type indicators
32 New Tests: Registry, slug uniqueness, decision engine, file locking, edge cases, backward compatibility (489 total)

v2.6.0

Smart Site Intel Dev-Scan System — Feb 2026

Dev-Scan Module: 8-file scanning subsystem (~78KB) for developer-focused per-route analysis
Dashboard Extensions: 7 new API endpoints + Dev Scan tab with sortable route table, grade badges, sparklines, diffs
3 New MCP Tools: site_intel_dev_scan, site_intel_quick_check, site_intel_dev_state (12 total)
Slash Commands: Updated /site-intel with dev-scan actions, new /site-intel-dashboard command
Git Diff Integration: Incremental scanning based on changed files with 30% threshold for full scan promotion
Static TestID Checker: 11 interactive element patterns, recursive 2-level import resolution, <10s for 80+ routes
State Persistence: Per-route scores with 20-entry FIFO history, regression/improvement tracking across commits
Barrel Exports: Full dev-scan module exports in src/site-intel/index.js

v2.5.0

Neovim Plugin Refactoring + Site Intelligence + MCP Registry — Feb 2026

nvim-ccasp 7-Phase Refactoring: 39 files, 12,505 lines. sidebar.lua -52%, 10 new modules, health score 87/100
Website Intelligence System: 5-layer MCP server (discovery, summarizer, graph, memory, judgment) with web dashboard
Anthropic MCP Registry: Official API integration for 50+ verified MCP servers with auto-recommendations
JS Module Decomposition (Epic 3): 20 files decomposed into 74 focused submodules across 3 phases
New Hooks: agent-guardrails, file-collision-detector, quality-check, ralph-bdd-mode, tdd-enforcer
New Skills: github-actions-generator with security references
Test Coverage: 15+ new test files (site-intel, token-budget, roadmap-schema, delegation-protocol, etc.)

v2.2.19

Neovim Integration (nvim-ccasp) — Feb 2026

Zero-Setup Launcher: ccasp neovim launches Neovim with CCASP pre-loaded
Auto-Install Neovim: Detects winget/choco/scoop (Windows), brew (macOS), apt/dnf/pacman (Linux)
Multi-Session Terminals: Up to 8 Claude CLI sessions with automatic quadrant stacking
Color-Coded Titlebars: 8 colors (Blue, Green, Purple, Orange, Red, Cyan, Pink, Yellow) with rename/minimize/close
Auto-Insert Mode: Click on session to start typing immediately
Collapsible Sidebar: Mouse-clickable sections, all collapsed by default
Prompt Injector v1.1.0: Intercept prompts, optionally enhance with GPT-5.2
npm Package Integration: nvim-ccasp/ included in npm distribution
Permanent Installation: ccasp nvim-setup with symlink/copy options

v2.2.18

Critical Commands & Self-Healing Updates — Feb 2026

Critical Commands: update-check and __ccasp-sync-marker now ALWAYS update during ccasp init
Self-Healing Updates: /update-check can now update itself, fixing the bootstrap problem
Auto-Upgrade Detection: Missing sync marker triggers automatic ccasp init for full 11-category sync
Backwards Compatibility: Older projects automatically upgraded to new sync system

v2.2.17

Auto-Run Init on Outdated Projects — Feb 2026

Automatic Upgrade: /update-check now runs ccasp init when sync marker missing
Zero-Touch Migration: Users don't need to know about the upgrade — it just works

v2.2.16

Sync Marker System — Feb 2026

New File: __ccasp-sync-marker.md detects if project has full 11-category sync
Version Detection: Marker indicates v2.2.16+ capabilities
Upgrade Path: Clear messaging when older versions detected

v2.2.15

Hook File Extension Support — Feb 2026

.cjs Support: Hooks now support .cjs extension for CommonJS compatibility
github-progress-hook.cjs: New hook registered for TodoWrite matcher
Settings Registration: Automatic hook registration during init

v2.2.14

Full Template Category Sync — Feb 2026

11 Categories: /update-check now scans ALL template directories
New Categories: commands-dev, scripts, github/ISSUE_TEMPLATE, workflows, mcp
Complete Coverage: No more missing files after updates

v2.2.13

Simplified Update Check — Feb 2026

Comprehensive Sync: /update-check redesigned for complete file synchronization
Hash Comparison: Detects customized files and skips them automatically
Smart Merge: Preserves user modifications while adding new features

v2.2.12

Enhanced Issue Templates with Hook-Based Sync — Feb 2026

Type-Specific Templates: 4 templates (Feature, Refactor, Bug, Testing)
CCASP-META: Machine-parseable HTML comments for agent updates
Generated Files Section: All issues link to source documentation
Hook Infrastructure: PostToolUse hook detects PROGRESS.json changes
L3 Sync Worker: Background agent updates GitHub issues automatically
5-Phase Implementation: Complete architecture from templates to testing

v2.2.11

Consolidated Roadmap Architecture — Feb 2026

Unified Architecture: Task/Phase/Roadmap share same exploration file structure
Tunnel URL Support: Development tunnel URLs integrated into deployment workflow
Consistent Planning: All three scales generate 6-file exploration documents

v2.2.10

Menu Display Fix — Feb 2026

ASCII Box Menu: Clean display with consistent formatting
Display Instructions: Better guidance in /menu command

v2.2.9

Mandatory L2 Exploration Files — Feb 2026

Enforcement: L2 specialists MUST create exploration files before implementation
6-File Standard: EXPLORATION_SUMMARY, CODE_SNIPPETS, REFERENCE_FILES, AGENT_DELEGATION, PHASE_BREAKDOWN, findings.json
Quality Gates: Slash commands validate exploration docs exist

v2.2.8

Graduated Task/Phase/Roadmap Architecture — Feb 2026

Three Planning Scales: Tasks, Phases, and Roadmaps with unified structure
L2 Exploration System: Specialists receive full context through generated docs
Fast Dev-Sync: Quick synchronization for development workflows
Worktree Integration: Improved dev mode with git worktree support

v2.2.5

Dev Mode Smart Sync & Wizard UX — Feb 2026

Smart Sync for Dev Mode: New smart-sync.js utility preserves user customizations when syncing from worktree
Menu Worktree Sync: [W] Sync from Worktree option appears during dev mode with sync status banner
/dev-mode-deploy-to-projects: New slash command with --dry-run, --force, --project options
/menu-happy: Dedicated mobile menu command (40-char width) — auto-detection removed from /menu
Wizard UX Improvements: Reinstall option, accurate template counts, better mismatch handling (#64)
Hook Migration: Hooks migrated from .js to .cjs for CommonJS compatibility

v2.2.4

E2E Testing Integration & Happy Mode Fix — Feb 2025

Comprehensive E2E Testing Integration: Deep Playwright integration with credential injection, tunnel services, and Ralph Loop configuration
Happy Mode Detection Fix: BREAKING - HAPPY_SERVER_URL alone no longer triggers mobile mode; requires active session indicators
GitHub Integration Improvements: Enhanced error handling, cleaner issue parsing, refined MCP handling
Screenshot Gallery: Added 6 screenshots showcasing desktop and mobile UI
Developer Guides: New wiki sections for forking, local development, contributing, and npm updates

v2.2.3

Security & Packaging — Feb 2025

Removed hardcoded paths from npm package
Improved template portability

v2.2.0

Vision Driver Bot & GitHub Epics — Jan 2025

Vision Driver Bot (VDB): Autonomous development with lint fixes
GitHub Epic System: Multi-issue epic workflows with /create-github-epic
Init for New Projects: /init-ccasp-new-project for Happy users
Modular Commands: 7 large files refactored for maintainability

Full v2.2.0 Release Notes →

View All Releases →

Top Features

Vision Mode Orchestration (NEW in v2.3.0)

Autonomous MVP development from natural language:

hljs language-bash

/vision-init "Build a task management app with drag-and-drop"

Vision Mode is an L0+ orchestration layer above Epics, enabling:

Natural Language → MVP: Describe your product, Claude builds it autonomously
8-Phase Architecture: Schema → Analysis → Architecture → Observer → Agent Factory → Security → Autonomous Execution → Integration
Drift Detection: Observer hook monitors PROGRESS.json and ROADMAP.json for alignment
Self-Healing: Autonomous loop retries failed tasks with intelligent fixes

hljs language-sql

Vision Hierarchy:
VISION (L0+) ← Natural language prompt
├── EPIC (L0) ← Generated epic with milestones
│   ├── ROADMAP (L1) ← Multi-phase roadmap
│   │   └── PHASE-DEV (L2) ← Individual phases
│   │       └── TASKS (L3) ← Atomic work units

Commands:

/vision-init — Initialize from prompt (decision engine auto-selects plan type)
/vision-status — View progress, alignment, and plan type
/vision-list — Multi-vision registry management
/vision-adjust — Adjust when drift detected

Vision Driver Bot (VDB) (Actively Being Developed)

Autonomous development workflows with automatic lint fixes:

hljs language-bash

VDB State (.claude/vdb/state.json)
├── Current task tracking
├── Lint error queue
├── Fix history
└── Session metrics

Workflow: Detect lint errors → Queue fixes → Apply → Verify

GitHub Epic System (Actively Being Developed)

Multi-issue epic workflows:

hljs language-bash

/create-github-epic "User Authentication System"

Creates parent epic issue
Links child issues automatically
Tracks completion across issues
Syncs with Project Board

Agent Orchestration

Hierarchical agent execution:

hljs language-java

L1 Orchestrator (You / Main Conversation)
├── L2 Frontend Specialist (Sonnet)
│   ├── L3 Component Search Worker (Haiku)
│   └── L3 Style Analyzer Worker (Haiku)
├── L2 Backend Specialist (Sonnet)
│   └── L3 API Discovery Worker (Haiku)
├── L2 Testing Specialist (Sonnet)
└── L2 Deployment Specialist (Sonnet)

Refactoring System

hljs language-bash

# Continuous test-fix until green
/ralph --watch

# Characterization tests before refactoring
/golden-master src/utils/calculate.ts

# Guided 8-step refactoring workflow
/refactor-workflow

Neovim Plugin (nvim-ccasp) (Production Ready)

Zero-Setup Launch:

hljs language-bash

ccasp neovim              # Launch with CCASP pre-loaded
ccasp neovim /path/to/dir # Launch in specific directory
ccasp nvim-setup          # Install permanently to Neovim config

Features:

Multi-Session Terminals: Up to 8 Claude CLI sessions with quadrant stacking
Appshell Layout: VS Code-inspired zone-based UI (icon rail, flyout, header, footer, content, right panel)
UI Testing Framework: Headless tests with plenary.nvim (/ui-test, /ui-smoke, /ui-snapshot)
Color-Coded Titlebars: 8 colors with rename, minimize, close buttons
Collapsible Sidebar: Mouse-clickable sections, all collapsed by default
Control Panel: Toggle features, change models, restart agents
Telescope Integration: Browse commands, skills, hooks with fuzzy finding

Keybindings:

Key	Action
`Ctrl+B`	Toggle sidebar
`Ctrl+Shift+N`	New Claude session
` (backtick)	Quick toggle sessions
`Tab`	Cycle sessions
`,p`	Control Panel
`,g`	Agent Grid
`,i`	Toggle Prompt Injector

lazy.nvim Config:

hljs language-lua

{
  dir = "path/to/nvim-ccasp",  -- Auto-generated by ccasp neovim
  config = function()
    require("ccasp").setup({
      layout = "classic",
      sidebar = { width = 40, auto_open = true },
      terminal = { shell = "claude", size = 60 },
    })
  end,
}

Auto-installs Neovim on first run (winget/brew/apt detected automatically).

Happy.engineering Mobile UI

Auto-detected. Mobile-optimized formatting:

hljs language-yaml

┌────────────────────────────────────┐
│ [1] Issue #42                      │
│ Add JWT authentication             │
├────────────────────────────────────┤
│ Status: Ready                      │
│ Priority: High                     │
│ @johndoe • 2h ago                  │
└────────────────────────────────────┘

PR Merge Workflow

hljs language-bash

/pr-merge        # Current branch
/pr-merge 123    # Specific PR
/pr-merge --dry-run

9 phases: Identify → Checkpoint → Detect blockers → Resolve → Message → Merge method → Execute → Cleanup → Summary

Roadmap Orchestration

hljs language-bash

ccasp create-roadmap          # Mode A: Natural language → phases
ccasp roadmap import          # Mode B: GitHub issues → phases

/roadmap-status               # Progress dashboard
/roadmap-edit                 # Reorder, merge, split phases
/roadmap-track                # Execute with dependency checking

Commands Reference

Terminal Commands (No AI)

Command	Description
`ccasp wizard`	Vibe-friendly setup wizard
`ccasp init`	Deploy to project
`ccasp detect-stack`	Auto-detect tech stack
`ccasp create-agent`	Create L1/L2/L3 agents
`ccasp create-hook`	Create enforcement hooks
`ccasp explore-mcp`	MCP server discovery
`ccasp neovim`	Launch Neovim with CCASP (zero-setup)
`ccasp nvim-setup`	Install nvim-ccasp permanently

Slash Commands (AI-Powered)

Command	Description
`/menu`	Interactive navigation
`/deploy-full`	Full-stack deployment
`/pr-merge`	Safe PR merge workflow
`/ralph`	Test-fix loops
`/phase-dev-plan`	Phased development
`/create-github-epic`	Epic workflows
`/refactor-workflow`	Guided refactoring
`/golden-master`	Characterization tests
`/vision-init`	Autonomous MVP from prompt
`/vision-status`	Vision progress dashboard
`/vision-adjust`	Adjust Vision plan
`/vision-list`	Multi-vision registry management
`/ui-test`	Neovim UI full test suite
`/ui-smoke`	Quick Neovim smoke test
`/ui-snapshot`	Layout snapshot + diff
`/ui-fix`	Guided UI debug/fix workflow
`/repo-guard`	Pre-commit quality gate
`/site-intel`	Website intelligence + dev scanning
`/site-intel-dashboard`	Dev scan dashboard viewer
`/competitor-research-build-mode`	Competitor research & build tier tracker
`/research-competitor`	6-phase competitive intelligence

Full Commands Reference →

Hook Templates (44)

Category	Hooks
Token & Session	token-usage-monitor, session-id-generator, context-guardian
Deployment	branch-merge-checker, deployment-orchestrator
Refactoring	ralph-loop-enforcer, refactor-verify, refactor-transaction
Agent Orchestration	hierarchy-validator, progress-tracker, l2-completion-reporter
Neovim UI Testing	nvim-after-edit-test, agent-limit-compact
Happy.engineering	happy-mode-detector, happy-checkpoint-manager

Tech Stack Detection

Detects 55+ frameworks by reading project files (no AI):

Category	Detected
Frontend	React, Vue, Angular, Svelte, Next.js, Nuxt, Astro
Backend	FastAPI, Express, NestJS, Django, Flask, Rails
Database	PostgreSQL, MySQL, MongoDB, SQLite, Redis
ORM	Prisma, TypeORM, SQLAlchemy, Drizzle
Testing	Jest, Vitest, Playwright, Cypress, pytest
Deployment	Railway, Vercel, Netlify, Cloudflare

MCP Server Integration

hljs language-bash

ccasp explore-mcp              # Interactive menu
ccasp explore-mcp --recommend  # Auto-recommend for your stack

Category	Servers
Testing	Playwright, Puppeteer, Skyvern
Deployment	Railway, Cloudflare, Vercel
Database	PostgreSQL, Supabase, Redis
Tunnel	ngrok, Cloudflare Tunnel

Contributing

hljs language-bash

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

Contributing Guidelines →

License

MIT © evan043

Stop configuring Claude Code for every project. CCASP gives you a complete, stack-customized setup in one command.

Get Started • Documentation • Issues • npm

Claude CLI Advanced Starter Pack (CCASP)

hljs

╔═══════════════════════════════════════════════════════════════════════════════╗
║                                                                               ║
║   ╔═╗╦  ╔═╗╦ ╦╔╦╗╔═╗  ╔═╗╔╦╗╦  ╦╔═╗╔╗╔╔═╗╔═╗╔╦╗  ╔═╗╔╦╗╔═╗╦═╗╔╦╗╔═╗╦═╗       ║
║   ║  ║  ╠═╣║ ║ ║║║╣   ╠═╣ ║║╚╗╔╝╠═╣║║║║  ║╣  ║║  ╚═╗ ║ ╠═╣╠╦╝ ║ ║╣ ╠╦╝       ║
║   ╚═╝╩═╝╩ ╩╚═╝═╩╝╚═╝  ╩ ╩═╩╝ ╚╝ ╩ ╩╝╚╝╚═╝╚═╝═╩╝  ╚═╝ ╩ ╩ ╩╩╚═ ╩ ╚═╝╩╚═       ║
║                                                                               ║
║                           v2.11.4  •  Production Ready                        ║
║                                                                               ║
╚═══════════════════════════════════════════════════════════════════════════════╝

Your entire Claude Code setup — customized for your stack — deployed in one command.

hljs language-bash

npx claude-cli-advanced-starter-pack init

Quick Start • What You Get • 📚 Wiki • Roadmap

v2.11.4 Feature Update — Neovim Deploy Panel & Session Management

Feb 2026 — Enhanced Neovim plugin with deploy configuration panel, session reorder controls, and always-on symlink sync for project templates. Plus per-session slash commands and restored minimized session support.

What's New in v2.11.4

Deploy Configuration Panel

New flyout panel in nvim-ccasp:

Deploy Config — Configure deployment settings from Neovim sidebar
Service Management — Railway/Cloudflare settings at a glance
Quick Deploy — Trigger deployments without leaving the editor

Session Reorder & Management

Footer taskbar enhancements:

Session Reorder Button — Drag-and-drop session ordering in footer
Per-Session Slash Commands — Each session gets its own command scope
Active Session Targeting — Commands route to the focused session
Restored Minimized Sessions — Splash screen recovery for minimized sessions

Always-On Symlink Sync

Template synchronization improvements:

Symlink Sync — Project templates stay in sync automatically
No Manual Refresh — Changes propagate without ccasp init
Dev Mode Compatible — Works seamlessly with worktree workflows

Previous: Competitor Research & MVP Build Mode (v2.11.1)

6-Phase Competitive Intelligence in /project-implementation
B2C MVP vs Enterprise B2B build tier selection
Auto-Configure Feature Toggles by market type
Build Tier Awareness in /phase-dev-plan and /create-roadmap

Upgrade Now

hljs language-bash

# Update to v2.11.4
npm update -g claude-cli-advanced-starter-pack

# Sync new commands to your project
ccasp init

v2.11.1 — Competitor Research & MVP Build Mode (click to expand)

Feb 2026 — New optional competitive intelligence workflow during project setup. Run 6-phase competitor research, validate compliance, and choose between B2C MVP (6-week, freemium) or Enterprise B2B (10-week, full compliance) build tiers.

Competitor Research Workflow — 6-phase competitive intelligence in /project-implementation
Build Tier Selection — B2C MVP (6 weeks, freemium) vs Enterprise B2B (10 weeks, full compliance)
Auto-Configure Feature Toggles — Tier selection auto-stubs/enables multi-tenancy, RBAC, billing
Neovim Panel — New "MARKET RESEARCH" section with competitor_research toggle
Build Tier Awareness — /phase-dev-plan and /create-roadmap read buildTier from tech-stack.json

v2.8.1 — Getting Started Onboarding + Help System (nvim-ccasp) (click to expand)

Feb 2026 — Interactive 8-page Getting Started guide with first-launch detection, ASCII diagrams, try-it actions, and a persistent Help system with 11 searchable wiki topics embedded offline.

Getting Started Guide — 8-page onboarding with ASCII diagrams, keybinding tables, try-it actions
First-Launch Detection — Auto-opens on first launch, remembers completion state
Help System — 11 wiki topics with Telescope fuzzy search + vim.ui.select fallback
Navigation — Page dots, n/p keys, 1-8 jump, h/l arrow support
New Commands — :CcaspWelcome, :CcaspHelp, <leader>c?, <leader>cw
Sidebar Integration — Help tab now shows Getting Started and Help links

v2.7.0 — Vision Multi-Instance & Decision Engine (click to expand)

Feb 2026 — Vision Mode now supports multiple concurrent visions with a centralized registry, cross-process file locking, slug uniqueness enforcement, and an intelligent decision engine.

Vision Registry: Centralized VISION_REGISTRY.json with atomic writes, auto-rebuild
Decision Engine: Weighted scoring selects plan type (task-list / phase-dev-plan / roadmap / epic / vision-full)
Slug Uniqueness: generateUniqueSlug() appends -2/-3 on collision
New Commands: ccasp vision list, ccasp vision cleanup, /vision-list

v2.6.1 — Smart Todo List with AI Intent Routing (click to expand)

Feb 2026 — New Smart Todo system: quick-add with auto-paraphrasing, interactive menu, AI-powered "Work on item" that suggests the best CCASP workflow (Vision/Epic/Roadmap/Phase-Dev/Task List), plus full Neovim integration with sidebar, floating panel, and Telescope picker.

/todo-add — Quick-add with auto-paraphrasing to 5-6 word titles
/todo — Interactive menu: list, navigate, work-on, complete, delete
AI Intent Routing — Analyzes todo and suggests Vision/Epic/Roadmap/Phase-Dev/Task List/Just do it
Neovim Integration — Sidebar section, floating panel, Telescope picker

🚀 v2.6.0 Feature Update — Smart Site Intel Dev-Scan System

Feb 2026 — New developer-focused application scanner: per-route health monitoring, data-testid coverage tracking, git-diff incremental scanning, regression detection, and interactive dashboard with 12 MCP tools.

🆕 What's New in v2.6.0

🔬 Smart Site Intel Dev-Scan

Developer-focused per-route application scanning:

Route Catalog — AST-based route discovery with reverse file→route mapping
Config Reader — Reads tech-stack.json, .env, playwright.config automatically
Playwright Scanner — Auth, live DOM testid check, axe a11y, optional Lighthouse
Git Diff Integration — Incremental scanning with 30% threshold for full scan
State Persistence — Per-route scores, history (20 entries FIFO), diff tracking
Quick Check — Static testid coverage in <10s (no Playwright needed)

📊 Dev Scan Dashboard

Interactive web dashboard at http://localhost:3847:

Health Metrics — Overall score, total routes, testid coverage, last scan
Sortable Route Table — Sort by path, testid, a11y, perf, health grade
Color-Coded Grades — A (green) through F (red) per-route health
Diff Display — Improvements (green) and regressions (red)
Trend Sparklines — Inline SVG health history per route
Filter Controls — All routes, failing (<70%), regressions only
7 New API Endpoints — state, summary, routes, diffs, history, testid-coverage

🔌 3 New MCP Tools (12 Total)

Expanded site-intel MCP server:

site_intel_dev_scan — Full/incremental per-route scan with diffs
site_intel_quick_check — Fast static testid coverage (no Playwright)
site_intel_dev_state — Read current state without scanning
Updated /site-intel slash command with dev-scan actions
New /site-intel-dashboard dedicated slash command

📦 Dev-Scan Module (8 Files, ~78KB)

Complete scanning subsystem:

config-reader.js — Project config loading (226 lines)
route-catalog.js — Route discovery + reverse map (246 lines)
state-manager.js — Persistent state + history (305 lines)
git-diff.js — Changed file detection + route mapping (184 lines)
testid-checker.js — Static analysis, 11 patterns (326 lines)
scanner.js — Playwright-based scanning (361 lines)
diff-reporter.js — Categorized diff output (201 lines)

Upgrade Now

hljs language-bash

# Update to latest
npm update -g claude-cli-advanced-starter-pack

# Sync all new features to your project
ccasp init

The Problem

Every new project means:

❌ Manually creating .claude/ folders and configurations
❌ Copy-pasting commands, hooks, and agents from old projects
❌ Forgetting critical settings and enforcement hooks
❌ Agents that don't understand your tech stack
❌ Hours of setup before you can actually build

The Solution

One command. Fully configured. Stack-aware.

hljs language-bash

npx claude-cli-advanced-starter-pack init

CCASP scans your project, detects your stack (React? FastAPI? Prisma? Playwright?), and deploys a complete .claude/ folder with:

✅ 64 slash commands — deployment, testing, refactoring, GitHub sync, UI testing
✅ 44 enforcement hooks — validation, progress tracking, agent orchestration
✅ Stack-specific agents — specialists that know your frameworks
✅ Smart updates — add features without losing customizations

What You Get

Component	Count	Examples
Slash Commands	66	`/deploy-full`, `/pr-merge`, `/ralph`, `/ui-test`, `/research-competitor`
Enforcement Hooks	44	Token tracking, agent orchestration, refactor safety, UI test auto-run
Tech Stack Detection	55+	React, Vue, FastAPI, Express, Prisma, Playwright
Agent Templates	L1/L2/L3	Orchestrators → Specialists → Workers + UI testing agents
MCP Integrations	50+	Railway, Cloudflare, GitHub, Playwright
Skills (RAG)	6	agent-creator, hook-creator, refactor patterns, nvim-ui-test

AI Constitution Framework

Enforce project-specific coding standards and architecture patterns with automatic validation.

Quick Start

hljs language-bash

ccasp constitution-init --preset senior    # 5% sampling, all sections
ccasp constitution-init --preset minimal   # 2% sampling, security only
ccasp constitution-init --preset strict    # 15% sampling, maximum coverage

Features

YAML-based rules at .claude/config/constitution.yaml
Hook enforcement with configurable sampling (1-in-20 default)
Sensitive pattern bypass - security rules always checked
Stop → Explain → Suggest → Refactor violation flow
Neovim integration - edit constitution from sidebar

Rule Sections

Section	Examples
`code_style`	Naming, types, imports
`architecture`	Patterns, boundaries
`security`	Credentials, validation
`performance`	Async, memoization
`git`	Commits, branches
`dependencies`	Versions, security

See /ai-constitution-framework in Claude Code for full documentation.

Landing Page Generator

Automated marketing asset pipeline: capture screenshots, apply device frames, generate GIFs, and build landing page components.

Commands

Command	Description
`/landing-page-generator`	Interactive menu: configure, capture, frame, GIF, preview, build, deploy
`/landing-page-generator-executor`	Automated phase executor for pipeline tasks
`/landing-page-toggle`	Enable/disable landing page in production

Pipeline

Capture - Playwright screenshots of app routes at configurable viewports
Frame - Composite into device bezels (MacBook Pro, iPhone 15, iPad, etc.)
Generate GIFs - Stitch framed screenshots into animated marketing GIFs
Build - Generate React components with the produced assets

Skill: Screenshot Pipeline

The screenshot-pipeline skill package includes reference documentation for:

Device frames - 12+ device templates (laptop, phone, tablet)
Viewport presets - Standard configurations for phone/tablet/desktop
Pipeline config - Full configuration schema with examples

Requires: sharp, gifencoder, canvas NPM packages + playwright-ext MCP server.

See It In Action

📸 Screenshots Gallery (click to expand/collapse)

Desktop UI

/menu — Interactive Navigation

Full-featured menu with all options

Project Configuration Settings

GitHub, deployment, tunnels, tokens

Mobile UI (Happy.engineering)

/menu — Mobile Navigation Single-key navigation, 40-char width	Setup Wizard — Feature Selection Choose commands, agents, hooks, skills
GitHub Project Setup One-click repo and Project Board sync	/claude-audit — Analysis Report CLAUDE.md analysis with score
Audit Score Breakdown Detailed scoring and summary	Actionable Recommendations Priority-ordered improvements

Highlight Features

🎯 Stack-Aware Agents

Auto-generates agents that know your tech:

React + Zustand + Tailwind specialist
FastAPI + SQLAlchemy backend agent
Playwright E2E testing expert
PostgreSQL + Prisma database agent

🔄 Ralph Loop Testing

Continuous test-fix cycle until green:

hljs language-bash

/ralph --watch

Runs tests → Parses failures → Fixes code → Repeats.

Smart Recovery: Every 3rd failed attempt deploys a web search agent to find best-practice solutions for stubborn bugs or implementation issues.

Max 10 iterations. Stops on 3x same failure.

🗺️ Multi-Phase Roadmaps

Coordinate full-stack, multi-feature development:

hljs language-bash

/create-roadmap "Q1 Feature Sprint"

Break epics into phased milestones
GitHub issue tracking per phase
Customizable Project Board sync
Dependency graphs with auto-ordering
Progress dashboard across all phases

🚀 One-Command Deployment

Full-stack deploy to Railway + Cloudflare:

hljs language-bash

/deploy-full

Backend and frontend in parallel
Pre-flight validation
Automatic rollback on failure

📋 Phased Development

Break complex features into phases:

hljs language-bash

/phase-dev-plan "Add user authentication"

95%+ success probability planning
PROGRESS.json state tracking
GitHub issue sync
L1/L2/L3 agent orchestration

🔀 Safe PR Merges

9-phase merge workflow with safety:

hljs language-bash

/pr-merge

Auto-stash uncommitted changes
Resolve conflicts, CI failures, reviews
Automatic rollback on any failure

🎫 GitHub Epic System

Multi-issue epic workflows:

hljs language-bash

/create-github-epic "Auth System"

Creates parent epic with child issues
Tracks completion across all issues
Auto-syncs with Project Board
Progress comments on epic issue

📱 Mobile-First UI

Works with Happy.engineering:

40-character max width
Card-based layouts
Single-character inputs
Auto-detected via environment

👁️ Vision Mode — Autonomous MVP Development

Transform natural language into complete, working MVPs:

hljs language-bash

ccasp vision init "Build a kanban board with real-time collaboration"

8-Stage Orchestrated Workflow:

Initialize — Parse prompt, detect intent, extract features
Analyze — Web search for inspiration, discover npm/pip packages, match MCP servers
Architect — Generate Mermaid diagrams, API contracts, ASCII wireframes
Security — Scan dependencies with npm audit, pip-audit, OSV Scanner
Create Agents — Spawn specialized agents for detected tech stack
Execute — Autonomous development loop with self-healing
Validate — Run tests, verify MVP completeness
Complete — Final verification and checkpoint creation

Features:

🎯 Natural Language Input — "Build a todo app with React and FastAPI"
🔍 Analysis Engine — Similar apps search, tool discovery, MCP matching
🏗️ Architecture Planning — Mermaid diagrams, API contracts, state design
👁️ Drift Detection — Hook-based observer with automatic plan adjustment
🔒 Security Scanning — Pre-install vulnerability detection
🤖 Dynamic Agents — Creates specialists based on tech stack
🔄 Self-Healing — Automatic test failure resolution
📊 Web Dashboard — Real-time status at http://localhost:3847

hljs language-bash

# Initialize and run
ccasp vision init "Your app idea here"
ccasp vision run my-app

# Multi-vision management (v2.7.0)
ccasp vision list           # Registry-backed listing
ccasp vision cleanup        # Remove orphaned visions

# Monitor with web dashboard
ccasp vision dashboard

# Or use slash commands
/vision-init                # Decision engine auto-selects plan type
/vision-status              # Shows plan type indicators
/vision-list                # Multi-vision registry management
/vision-run

Architecture

After running ccasp init, your project gets:

hljs language-bash

.claude/
├── commands/              # 64 slash commands
│   ├── menu.md           # Interactive navigation
│   ├── deploy-full.md    # Full-stack deployment
│   ├── ralph.md          # Test-fix loops
│   └── ...
├── agents/                # Stack-specific AI agents
│   ├── react-specialist.md
│   ├── fastapi-specialist.md
│   └── ...
├── hooks/                 # 44 enforcement hooks
│   ├── ralph-loop-enforcer.js
│   ├── progress-tracker.js
│   └── ...
├── skills/                # RAG-enhanced packages
├── config/
│   └── tech-stack.json    # Your detected stack
└── settings.json          # Project configuration

Everything is customized to your package.json, config files, and directory structure.

Quick Start

hljs language-bash

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

# Step 2: Initialize (detects your stack, deploys .claude/)
ccasp init

# Step 3: Restart Claude Code CLI (required for new commands)
claude .

# Step 4: Use slash commands
/menu

One-Time Use (No Install)

hljs language-bash

npx claude-cli-advanced-starter-pack init

Roadmap

🚀 Coming Soon

Feature	Status
Competitor Research & MVP Build Mode	✅ Complete
Neovim UI Testing + Appshell Layout	✅ Complete
Vision Multi-Instance & Decision Engine	✅ Complete
Smart Site Intel Dev-Scan	✅ Complete
Vision Mode Orchestration	✅ Complete
Website Intelligence (Site-Intel)	✅ Complete
Anthropic MCP Registry	✅ Complete
nvim-ccasp Modular Refactoring	✅ Complete
JS Module Decomposition (Epic 3)	✅ Complete
Jira Integration	🔨 In Development
Linear Sync	🔨 In Development
ClickUp Integration	📋 Planned
Vision Driver Bot (VDB) v2	🔨 In Development
Multi-Repo Orchestration	📋 Planned

Version History

v2.11.4

Neovim Deploy Panel & Session Management — Feb 2026

Deploy Configuration Panel: New flyout panel for deployment settings in nvim-ccasp sidebar
Session Reorder Button: Drag-and-drop session ordering in footer taskbar
Always-On Symlink Sync: Project templates stay in sync automatically without manual ccasp init

v2.11.2

Per-Session Commands & Minimized Session Recovery — Feb 2026

Per-Session Slash Commands: Each Claude CLI session gets its own command scope and active targeting
Minimized Session Recovery: Restore minimized sessions from splash screen
Slideshow GIF: Added animated demo GIF to README hero section

v2.11.1

Competitor Research & MVP Build Mode — Feb 2026

Competitor Research Workflow: Optional 6-phase competitive intelligence in /project-implementation Step 1.8
Build Tier Selection: B2C MVP (6 weeks, freemium) vs Enterprise B2B (10 weeks, full compliance)
Auto-Configure Feature Toggles: Tier selection auto-stubs/enables multi-tenancy, RBAC, billing, API contracts, mobile
Neovim Panel: New "MARKET RESEARCH" section with competitor_research toggle (14th feature)
Build Tier Awareness: /phase-dev-plan and /create-roadmap read buildTier from tech-stack.json
Compliance Integration: Runs /compliance-check on discovered competitors for IP protection
Tier-Specific Roadmap Phases: B2C and Enterprise each get optimized 6-phase ordering
Tests: 17/17 config tests, 29/29 bridge tests, all syntax checks passing

v2.8.0

Neovim UI Testing Framework + Appshell Layout — Feb 2026

UI Testing Framework: Deterministic headless testing with plenary.nvim — driver (534 lines), snapshot (512 lines), 4 spec files, 3 runner scripts
Appshell Layout: VS Code-inspired zone-based UI with icon rail, flyout, header, footer, content zone, right panel
6 New Commands: /ui-test, /ui-smoke, /ui-snapshot, /ui-bug, /ui-fix, /repo-guard
3 New Agents: ui-driver, ui-debugger, nvim-test-runner with clear delegation boundaries
2 New Hooks: nvim-after-edit-test (auto-smoke on Lua edit), agent-limit-compact (3 concurrent max)
Per-Folder Documentation: 15 files across nvim-ui-testing/ subfolders (READMEs, examples, checklists)
Integration Templates: MCP-Neovim bridge config, claude-code.nvim compatibility guide
CLAUDE_WORKFLOW.md: Development workflow documentation for the nvim-ccasp plugin

v2.7.0

Vision Multi-Instance & Decision Engine — Feb 2026

Vision Registry: Centralized VISION_REGISTRY.json with atomic writes, auto-rebuild from filesystem, cross-process file locking
Decision Engine: Weighted scoring selects plan type (task-list / phase-dev-plan / roadmap / epic / vision-full) based on prompt complexity
Slug Uniqueness: generateUniqueSlug() appends -2/-3 on collision, registry-backed enforcement
Enhanced CLI: ccasp vision list (registry-backed with plan type column), ccasp vision cleanup (orphaned/failed removal)
New Slash Command: /vision-list for multi-vision management
Templates Updated: /vision-init shows decision engine result, /vision-status shows plan type indicators
32 New Tests: Registry, slug uniqueness, decision engine, file locking, edge cases, backward compatibility (489 total)

v2.6.0

Smart Site Intel Dev-Scan System — Feb 2026

Dev-Scan Module: 8-file scanning subsystem (~78KB) for developer-focused per-route analysis
Dashboard Extensions: 7 new API endpoints + Dev Scan tab with sortable route table, grade badges, sparklines, diffs
3 New MCP Tools: site_intel_dev_scan, site_intel_quick_check, site_intel_dev_state (12 total)
Slash Commands: Updated /site-intel with dev-scan actions, new /site-intel-dashboard command
Git Diff Integration: Incremental scanning based on changed files with 30% threshold for full scan promotion
Static TestID Checker: 11 interactive element patterns, recursive 2-level import resolution, <10s for 80+ routes
State Persistence: Per-route scores with 20-entry FIFO history, regression/improvement tracking across commits
Barrel Exports: Full dev-scan module exports in src/site-intel/index.js

v2.5.0

Neovim Plugin Refactoring + Site Intelligence + MCP Registry — Feb 2026

nvim-ccasp 7-Phase Refactoring: 39 files, 12,505 lines. sidebar.lua -52%, 10 new modules, health score 87/100
Website Intelligence System: 5-layer MCP server (discovery, summarizer, graph, memory, judgment) with web dashboard
Anthropic MCP Registry: Official API integration for 50+ verified MCP servers with auto-recommendations
JS Module Decomposition (Epic 3): 20 files decomposed into 74 focused submodules across 3 phases
New Hooks: agent-guardrails, file-collision-detector, quality-check, ralph-bdd-mode, tdd-enforcer
New Skills: github-actions-generator with security references
Test Coverage: 15+ new test files (site-intel, token-budget, roadmap-schema, delegation-protocol, etc.)

v2.2.19

Neovim Integration (nvim-ccasp) — Feb 2026

Zero-Setup Launcher: ccasp neovim launches Neovim with CCASP pre-loaded
Auto-Install Neovim: Detects winget/choco/scoop (Windows), brew (macOS), apt/dnf/pacman (Linux)
Multi-Session Terminals: Up to 8 Claude CLI sessions with automatic quadrant stacking
Color-Coded Titlebars: 8 colors (Blue, Green, Purple, Orange, Red, Cyan, Pink, Yellow) with rename/minimize/close
Auto-Insert Mode: Click on session to start typing immediately
Collapsible Sidebar: Mouse-clickable sections, all collapsed by default
Prompt Injector v1.1.0: Intercept prompts, optionally enhance with GPT-5.2
npm Package Integration: nvim-ccasp/ included in npm distribution
Permanent Installation: ccasp nvim-setup with symlink/copy options

v2.2.18

Critical Commands & Self-Healing Updates — Feb 2026

Critical Commands: update-check and __ccasp-sync-marker now ALWAYS update during ccasp init
Self-Healing Updates: /update-check can now update itself, fixing the bootstrap problem
Auto-Upgrade Detection: Missing sync marker triggers automatic ccasp init for full 11-category sync
Backwards Compatibility: Older projects automatically upgraded to new sync system

v2.2.17

Auto-Run Init on Outdated Projects — Feb 2026

Automatic Upgrade: /update-check now runs ccasp init when sync marker missing
Zero-Touch Migration: Users don't need to know about the upgrade — it just works

v2.2.16

Sync Marker System — Feb 2026

New File: __ccasp-sync-marker.md detects if project has full 11-category sync
Version Detection: Marker indicates v2.2.16+ capabilities
Upgrade Path: Clear messaging when older versions detected

v2.2.15

Hook File Extension Support — Feb 2026

.cjs Support: Hooks now support .cjs extension for CommonJS compatibility
github-progress-hook.cjs: New hook registered for TodoWrite matcher
Settings Registration: Automatic hook registration during init

v2.2.14

Full Template Category Sync — Feb 2026

11 Categories: /update-check now scans ALL template directories
New Categories: commands-dev, scripts, github/ISSUE_TEMPLATE, workflows, mcp
Complete Coverage: No more missing files after updates

v2.2.13

Simplified Update Check — Feb 2026

Comprehensive Sync: /update-check redesigned for complete file synchronization
Hash Comparison: Detects customized files and skips them automatically
Smart Merge: Preserves user modifications while adding new features

v2.2.12

Enhanced Issue Templates with Hook-Based Sync — Feb 2026

Type-Specific Templates: 4 templates (Feature, Refactor, Bug, Testing)
CCASP-META: Machine-parseable HTML comments for agent updates
Generated Files Section: All issues link to source documentation
Hook Infrastructure: PostToolUse hook detects PROGRESS.json changes
L3 Sync Worker: Background agent updates GitHub issues automatically
5-Phase Implementation: Complete architecture from templates to testing

v2.2.11

Consolidated Roadmap Architecture — Feb 2026

Unified Architecture: Task/Phase/Roadmap share same exploration file structure
Tunnel URL Support: Development tunnel URLs integrated into deployment workflow
Consistent Planning: All three scales generate 6-file exploration documents

v2.2.10

Menu Display Fix — Feb 2026

ASCII Box Menu: Clean display with consistent formatting
Display Instructions: Better guidance in /menu command

v2.2.9

Mandatory L2 Exploration Files — Feb 2026

Enforcement: L2 specialists MUST create exploration files before implementation
6-File Standard: EXPLORATION_SUMMARY, CODE_SNIPPETS, REFERENCE_FILES, AGENT_DELEGATION, PHASE_BREAKDOWN, findings.json
Quality Gates: Slash commands validate exploration docs exist

v2.2.8

Graduated Task/Phase/Roadmap Architecture — Feb 2026

Three Planning Scales: Tasks, Phases, and Roadmaps with unified structure
L2 Exploration System: Specialists receive full context through generated docs
Fast Dev-Sync: Quick synchronization for development workflows
Worktree Integration: Improved dev mode with git worktree support

v2.2.5

Dev Mode Smart Sync & Wizard UX — Feb 2026

Smart Sync for Dev Mode: New smart-sync.js utility preserves user customizations when syncing from worktree
Menu Worktree Sync: [W] Sync from Worktree option appears during dev mode with sync status banner
/dev-mode-deploy-to-projects: New slash command with --dry-run, --force, --project options
/menu-happy: Dedicated mobile menu command (40-char width) — auto-detection removed from /menu
Wizard UX Improvements: Reinstall option, accurate template counts, better mismatch handling (#64)
Hook Migration: Hooks migrated from .js to .cjs for CommonJS compatibility

v2.2.4

E2E Testing Integration & Happy Mode Fix — Feb 2025

Comprehensive E2E Testing Integration: Deep Playwright integration with credential injection, tunnel services, and Ralph Loop configuration
Happy Mode Detection Fix: BREAKING - HAPPY_SERVER_URL alone no longer triggers mobile mode; requires active session indicators
GitHub Integration Improvements: Enhanced error handling, cleaner issue parsing, refined MCP handling
Screenshot Gallery: Added 6 screenshots showcasing desktop and mobile UI
Developer Guides: New wiki sections for forking, local development, contributing, and npm updates

v2.2.3

Security & Packaging — Feb 2025

Removed hardcoded paths from npm package
Improved template portability

v2.2.0

Vision Driver Bot & GitHub Epics — Jan 2025

Vision Driver Bot (VDB): Autonomous development with lint fixes
GitHub Epic System: Multi-issue epic workflows with /create-github-epic
Init for New Projects: /init-ccasp-new-project for Happy users
Modular Commands: 7 large files refactored for maintainability

Full v2.2.0 Release Notes →

View All Releases →

Top Features

Vision Mode Orchestration (NEW in v2.3.0)

Autonomous MVP development from natural language:

hljs language-bash

/vision-init "Build a task management app with drag-and-drop"

Vision Mode is an L0+ orchestration layer above Epics, enabling:

Natural Language → MVP: Describe your product, Claude builds it autonomously
8-Phase Architecture: Schema → Analysis → Architecture → Observer → Agent Factory → Security → Autonomous Execution → Integration
Drift Detection: Observer hook monitors PROGRESS.json and ROADMAP.json for alignment
Self-Healing: Autonomous loop retries failed tasks with intelligent fixes

hljs language-sql

Vision Hierarchy:
VISION (L0+) ← Natural language prompt
├── EPIC (L0) ← Generated epic with milestones
│   ├── ROADMAP (L1) ← Multi-phase roadmap
│   │   └── PHASE-DEV (L2) ← Individual phases
│   │       └── TASKS (L3) ← Atomic work units

Commands:

/vision-init — Initialize from prompt (decision engine auto-selects plan type)
/vision-status — View progress, alignment, and plan type
/vision-list — Multi-vision registry management
/vision-adjust — Adjust when drift detected

Vision Driver Bot (VDB) (Actively Being Developed)

Autonomous development workflows with automatic lint fixes:

hljs language-bash

VDB State (.claude/vdb/state.json)
├── Current task tracking
├── Lint error queue
├── Fix history
└── Session metrics

Workflow: Detect lint errors → Queue fixes → Apply → Verify

GitHub Epic System (Actively Being Developed)

Multi-issue epic workflows:

hljs language-bash

/create-github-epic "User Authentication System"

Creates parent epic issue
Links child issues automatically
Tracks completion across issues
Syncs with Project Board

Agent Orchestration

Hierarchical agent execution:

hljs language-java

L1 Orchestrator (You / Main Conversation)
├── L2 Frontend Specialist (Sonnet)
│   ├── L3 Component Search Worker (Haiku)
│   └── L3 Style Analyzer Worker (Haiku)
├── L2 Backend Specialist (Sonnet)
│   └── L3 API Discovery Worker (Haiku)
├── L2 Testing Specialist (Sonnet)
└── L2 Deployment Specialist (Sonnet)

Refactoring System

hljs language-bash

# Continuous test-fix until green
/ralph --watch

# Characterization tests before refactoring
/golden-master src/utils/calculate.ts

# Guided 8-step refactoring workflow
/refactor-workflow

Neovim Plugin (nvim-ccasp) (Production Ready)

Zero-Setup Launch:

hljs language-bash

ccasp neovim              # Launch with CCASP pre-loaded
ccasp neovim /path/to/dir # Launch in specific directory
ccasp nvim-setup          # Install permanently to Neovim config

Features:

Multi-Session Terminals: Up to 8 Claude CLI sessions with quadrant stacking
Appshell Layout: VS Code-inspired zone-based UI (icon rail, flyout, header, footer, content, right panel)
UI Testing Framework: Headless tests with plenary.nvim (/ui-test, /ui-smoke, /ui-snapshot)
Color-Coded Titlebars: 8 colors with rename, minimize, close buttons
Collapsible Sidebar: Mouse-clickable sections, all collapsed by default
Control Panel: Toggle features, change models, restart agents
Telescope Integration: Browse commands, skills, hooks with fuzzy finding

Keybindings:

Key	Action
`Ctrl+B`	Toggle sidebar
`Ctrl+Shift+N`	New Claude session
` (backtick)	Quick toggle sessions
`Tab`	Cycle sessions
`,p`	Control Panel
`,g`	Agent Grid
`,i`	Toggle Prompt Injector

lazy.nvim Config:

hljs language-lua

{
  dir = "path/to/nvim-ccasp",  -- Auto-generated by ccasp neovim
  config = function()
    require("ccasp").setup({
      layout = "classic",
      sidebar = { width = 40, auto_open = true },
      terminal = { shell = "claude", size = 60 },
    })
  end,
}

Auto-installs Neovim on first run (winget/brew/apt detected automatically).

Happy.engineering Mobile UI

Auto-detected. Mobile-optimized formatting:

hljs language-yaml

┌────────────────────────────────────┐
│ [1] Issue #42                      │
│ Add JWT authentication             │
├────────────────────────────────────┤
│ Status: Ready                      │
│ Priority: High                     │
│ @johndoe • 2h ago                  │
└────────────────────────────────────┘

PR Merge Workflow

hljs language-bash

/pr-merge        # Current branch
/pr-merge 123    # Specific PR
/pr-merge --dry-run

9 phases: Identify → Checkpoint → Detect blockers → Resolve → Message → Merge method → Execute → Cleanup → Summary

Roadmap Orchestration

hljs language-bash

ccasp create-roadmap          # Mode A: Natural language → phases
ccasp roadmap import          # Mode B: GitHub issues → phases

/roadmap-status               # Progress dashboard
/roadmap-edit                 # Reorder, merge, split phases
/roadmap-track                # Execute with dependency checking

Commands Reference

Terminal Commands (No AI)

Command	Description
`ccasp wizard`	Vibe-friendly setup wizard
`ccasp init`	Deploy to project
`ccasp detect-stack`	Auto-detect tech stack
`ccasp create-agent`	Create L1/L2/L3 agents
`ccasp create-hook`	Create enforcement hooks
`ccasp explore-mcp`	MCP server discovery
`ccasp neovim`	Launch Neovim with CCASP (zero-setup)
`ccasp nvim-setup`	Install nvim-ccasp permanently

Slash Commands (AI-Powered)

Command	Description
`/menu`	Interactive navigation
`/deploy-full`	Full-stack deployment
`/pr-merge`	Safe PR merge workflow
`/ralph`	Test-fix loops
`/phase-dev-plan`	Phased development
`/create-github-epic`	Epic workflows
`/refactor-workflow`	Guided refactoring
`/golden-master`	Characterization tests
`/vision-init`	Autonomous MVP from prompt
`/vision-status`	Vision progress dashboard
`/vision-adjust`	Adjust Vision plan
`/vision-list`	Multi-vision registry management
`/ui-test`	Neovim UI full test suite
`/ui-smoke`	Quick Neovim smoke test
`/ui-snapshot`	Layout snapshot + diff
`/ui-fix`	Guided UI debug/fix workflow
`/repo-guard`	Pre-commit quality gate
`/site-intel`	Website intelligence + dev scanning
`/site-intel-dashboard`	Dev scan dashboard viewer
`/competitor-research-build-mode`	Competitor research & build tier tracker
`/research-competitor`	6-phase competitive intelligence

Full Commands Reference →

Hook Templates (44)

Category	Hooks
Token & Session	token-usage-monitor, session-id-generator, context-guardian
Deployment	branch-merge-checker, deployment-orchestrator
Refactoring	ralph-loop-enforcer, refactor-verify, refactor-transaction
Agent Orchestration	hierarchy-validator, progress-tracker, l2-completion-reporter
Neovim UI Testing	nvim-after-edit-test, agent-limit-compact
Happy.engineering	happy-mode-detector, happy-checkpoint-manager

Tech Stack Detection

Detects 55+ frameworks by reading project files (no AI):

Category	Detected
Frontend	React, Vue, Angular, Svelte, Next.js, Nuxt, Astro
Backend	FastAPI, Express, NestJS, Django, Flask, Rails
Database	PostgreSQL, MySQL, MongoDB, SQLite, Redis
ORM	Prisma, TypeORM, SQLAlchemy, Drizzle
Testing	Jest, Vitest, Playwright, Cypress, pytest
Deployment	Railway, Vercel, Netlify, Cloudflare

MCP Server Integration

hljs language-bash

ccasp explore-mcp              # Interactive menu
ccasp explore-mcp --recommend  # Auto-recommend for your stack

Category	Servers
Testing	Playwright, Puppeteer, Skyvern
Deployment	Railway, Cloudflare, Vercel
Database	PostgreSQL, Supabase, Redis
Tunnel	ngrok, Cloudflare Tunnel

Contributing

hljs language-bash

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

Contributing Guidelines →

License

MIT © evan043

Stop configuring Claude Code for every project. CCASP gives you a complete, stack-customized setup in one command.

Get Started • Documentation • Issues • npm