Claude Cli Advanced Starter Pack

# Claude CLI Advanced Starter Pack (CCASP) <div align="center"> ``` ╔═══════════════════════════════════════════════════════════════════════════════╗ ║ ║ ║ ╔═╗╦ ╔═╗╦ ╦╔╦╗╔═╗ ╔═╗╔╦╗╦ ╦╔═╗╔╗╔╔═╗╔═╗╔╦╗ ╔═╗╔╦╗╔═╗╦═╗╔╦╗╔═╗╦═╗ ║ ║ ║ ║ ╠═╣║ ║ ║║║╣ ╠═╣ ║║╚╗╔╝╠═╣║║║║ ║╣ ║║ ╚═╗ ║ ╠═╣╠╦╝ ║ ║╣ ╠╦╝ ║ ║ ╚═╝╩═╝╩ ╩╚═╝═╩╝╚═╝ ╩ ╩═╩╝ ╚╝ ╩ ╩╝╚╝╚═╝╚═╝═╩╝ ╚═╝ ╩ ╩ ╩╩╚═ ╩ ╚═╝╩╚═ ║ ║ ║ ║ v2.11.4 • Production Ready ║ ║ ║ ╚═══════════════════════════════════════════════════════════════════════════════╝ ``` <img src="./assets/slideshow.gif" alt="CCASP Demo" width="720"> [](https://www.npmjs.com/package/claude-cli-advanced-starter-pack) [](https://nodejs.org) [](https://opensource.org/licenses/MIT) </div> --- <div align="center"> ### Your entire Claude Code setup — customized for your stack — deployed in one command. ```bash npx claude-cli-advanced-starter-pack init ``` [Quick Start](#quick-start) • [What You Get](#what-you-get) • [📚 Wiki](https://github.com/evan043/claude-cli-advanced-starter-pack/wiki) • [Roadmap](#roadmap) </div> --- <div align="center"> ## v2.11.4 Feature Update — Neovim Deploy Panel & Session Management </div> > **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 <table> <tr> <td width="50%"> #### 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 </td> <td width="50%"> #### 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 </td> </tr> <tr> <td width="50%"> #### 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 </td> <td width="50%"> #### 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` </td> </tr> </table> ### Upgrade Now ```bash # Update to v2.11.4 npm update -g claude-cli-advanced-starter-pack # Sync new commands to your project ccasp init ``` --- <details> <summary><strong>v2.11.1 — Competitor Research & MVP Build Mode</strong> (click to expand)</summary> > **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 </details> <details> <summary><strong>v2.8.1 — Getting Started Onboarding + Help System (nvim-ccasp)</strong> (click to expand)</summary> > **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 </details> <details> <summary><strong>v2.7.0 — Vision Multi-Instance & Decision Engine</strong> (click to expand)</summary> > **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` </details> <details> <summary><strong>v2.6.1 — Smart Todo List with AI Intent Routing</strong> (click to expand)</summary> > **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 </details> --- <div align="center"> ## 🚀 v2.6.0 Feature Update — Smart Site Intel Dev-Scan System </div> > **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 <table> <tr> <td width="50%"> #### 🔬 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) </td> <td width="50%"> #### 📊 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 </td> </tr> <tr> <td width="50%"> #### 🔌 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 </td> <td width="50%"> #### 📦 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) </td> </tr> </table> ### Upgrade Now ```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.** ```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 ```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 1. **Capture** - Playwright screenshots of app routes at configurable viewports 2. **Frame** - Composite into device bezels (MacBook Pro, iPhone 15, iPad, etc.) 3. **Generate GIFs** - Stitch framed screenshots into animated marketing GIFs 4. **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 <details> <summary><strong>📸 Screenshots Gallery</strong> (click to expand/collapse)</summary> <br> ### Desktop UI <table> <tr> <td align="center" width="50%"> <strong>/menu — Interactive Navigation</strong><br><br> <a href="./assets/screenshots/desktop/menu.jpg"> <img src="./assets/screenshots/desktop/menu.jpg" alt="CCASP Desktop Menu" width="400"> </a> <br><em>Full-featured menu with all options</em> </td> <td align="center" width="50%"> <strong>Project Configuration Settings</strong><br><br> <a href="./assets/screenshots/desktop/project-settings.jpg"> <img src="./assets/screenshots/desktop/project-settings.jpg" alt="CCASP Project Settings" width="400"> </a> <br><em>GitHub, deployment, tunnels, tokens</em> </td> </tr> </table> ### Mobile UI (Happy.engineering) <table> <tr> <td align="center" width="50%"> <strong>/menu — Mobile Navigation</strong><br><br> <a href="./assets/screenshots/mobile/menu.jpg"> <img src="./assets/screenshots/mobile/menu.jpg" alt="CCASP Mobile Menu" width="400"> </a> <br><em>Single-key navigation, 40-char width</em> </td> <td align="center" width="50%"> <strong>Setup Wizard — Feature Selection</strong><br><br> <a href="./assets/screenshots/mobile/setup-wizard.jpg"> <img src="./assets/screenshots/mobile/setup-wizard.jpg" alt="CCASP Setup Wizard" width="400"> </a> <br><em>Choose commands, agents, hooks, skills</em> </td> </tr> <tr> <td align="center" width="50%"> <strong>GitHub Project Setup</strong><br><br> <a href="./assets/screenshots/mobile/github-setup.jpg"> <img src="./assets/screenshots/mobile/github-setup.jpg" alt="GitHub Project Setup" width="400"> </a> <br><em>One-click repo and Project Board sync</em> </td> <td align="center" width="50%"> <strong>/claude-audit — Analysis Report</strong><br><br> <a href="./assets/screenshots/mobile/claude-audit-1.jpg"> <img src="./assets/screenshots/mobile/claude-audit-1.jpg" alt="Claude Audit Report" width="400"> </a> <br><em>CLAUDE.md analysis with score</em> </td> </tr> <tr> <td align="center" width="50%"> <strong>Audit Score Breakdown</strong><br><br> <a href="./assets/screenshots/mobile/claude-audit-2.jpg"> <img src="./assets/screenshots/mobile/claude-audit-2.jpg" alt="Audit Score Breakdown" width="400"> </a> <br><em>Detailed scoring and summary</em> </td> <td align="center" width="50%"> <strong>Actionable Recommendations</strong><br><br> <a href="./assets/screenshots/mobile/recommendations.jpg"> <img src="./assets/screenshots/mobile/recommendations.jpg" alt="Audit Recommendations" width="400"> </a> <br><em>Priority-ordered improvements</em> </td> </tr> </table> </details> --- ## Highlight Features <table> <tr> <td width="50%"> ### 🎯 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 </td> <td width="50%"> ### 🔄 Ralph Loop Testing Continuous test-fix cycle until green: ```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. </td> </tr> <tr> <td width="50%"> ### 🗺️ Multi-Phase Roadmaps Coordinate full-stack, multi-feature development: ```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 </td> <td width="50%"> ### 🚀 One-Command Deployment Full-stack deploy to Railway + Cloudflare: ```bash /deploy-full ``` - Backend and frontend in parallel - Pre-flight validation - Automatic rollback on failure </td> </tr> <tr> <td width="50%"> ### 📋 Phased Development Break complex features into phases: ```bash /phase-dev-plan "Add user authentication" ``` - 95%+ success probability planning - PROGRESS.json state tracking - GitHub issue sync - L1/L2/L3 agent orchestration </td> <td width="50%"> ### 🔀 Safe PR Merges 9-phase merge workflow with safety: ```bash /pr-merge ``` - Auto-stash uncommitted changes - Resolve conflicts, CI failures, reviews - Automatic rollback on any failure </td> </tr> <tr> <td width="50%"> ### 🎫 GitHub Epic System Multi-issue epic workflows: ```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 </td> <td width="50%"> ### 📱 Mobile-First UI Works with [Happy.engineering](https://github.com/slopus/happy): - 40-character max width - Card-based layouts - Single-character inputs - Auto-detected via environment </td> </tr> <tr> <td colspan="2"> ### 👁️ Vision Mode — Autonomous MVP Development Transform natural language into complete, working MVPs: ```bash ccasp vision init "Build a kanban board with real-time collaboration" ``` **8-Stage Orchestrated Workflow:** 1. **Initialize** — Parse prompt, detect intent, extract features 2. **Analyze** — Web search for inspiration, discover npm/pip packages, match MCP servers 3. **Architect** — Generate Mermaid diagrams, API contracts, ASCII wireframes 4. **Security** — Scan dependencies with npm audit, pip-audit, OSV Scanner 5. **Create Agents** — Spawn specialized agents for detected tech stack 6. **Execute** — Autonomous development loop with self-healing 7. **Validate** — Run tests, verify MVP completeness 8. **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` ```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 ``` </td> </tr> </table> --- ## Architecture After running `ccasp init`, your project gets: ``` .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 ```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) ```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 →](https://github.com/evan043/claude-cli-advanced-starter-pack/releases/tag/v2.2.0) [View All Releases →](https://github.com/evan043/claude-cli-advanced-starter-pack/releases) --- ## Top Features ### Vision Mode Orchestration *(NEW in v2.3.0)* Autonomous MVP development from natural 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 ``` 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: ``` 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: ```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: ``` 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 ```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:** ```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:** ```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: ``` ┌────────────────────────────────────┐ │ [1] Issue #42 │ │ Add JWT authentication │ ├────────────────────────────────────┤ │ Status: Ready │ │ Priority: High │ │ @johndoe • 2h ago │ └────────────────────────────────────┘ ``` ### PR Merge Workflow ```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 ```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 →](./docs/WIKI.md) --- ## 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 ```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 ```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 →](./CONTRIBUTING.md) --- ## License MIT © [evan043](https://github.com/evan043) --- <div align="center"> **Stop configuring Claude Code for every project.** **CCASP gives you a complete, stack-customized setup in one command.** [Get Started](#quick-start) • [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) </div>