Skip to content

Ultimate-Installer-Guide.md

Latest commit

 

History

History
270 lines (215 loc) · 7.38 KB

Ultimate-Installer-Guide.md

File metadata and controls

270 lines (215 loc) · 7.38 KB

CCDK i124q Ultimate Installer Guide

Overview

The Ultimate Installer (install-ultimate.sh) is the most advanced AI-powered development environment manager ever created for Claude Code. It provides comprehensive project detection, intelligent configuration, and seamless integration of all CCDK i124q components.

Key Features

1. Advanced Project Detection

  • Primary Method: Looks for CLAUDE.PROJECT marker files
  • Secondary Method: Traditional detection (package.json, requirements.txt, etc.)
  • Multi-threaded scanning with caching
  • Excludes common build/cache directories automatically

2. Main Command Center

The installer provides a professional grid-based interface with 20+ powerful features:

Project Management

  • [1] Browse Projects - Interactive project browser with grid/list/card views
  • [2] Quick Actions - Fast access to common operations
  • [3] Create Project - AI-powered project creation wizard
  • [4] Recent Projects - Quick access to recently modified projects

Advanced Tools

  • [H] Health Dashboard - Comprehensive project health monitoring
  • [B] Batch Operations - Apply changes to multiple projects
  • [T] Template Library - 10+ pre-configured project templates
  • [M] Migration Center - Migrate existing projects to CCDK

Intelligence

  • [G] Project Graph - Visual dependency mapping
  • [P] Analytics Hub - Advanced metrics and insights
  • [/] Universal Search - Search across all projects
  • [?] Learning Center - Interactive tutorials

Configuration

  • [A] AI Config Builder - Smart AI-powered configuration
  • [O] Model Optimizer - Optimize AI model selection
  • [D] Command Designer - Create custom commands
  • [X] Diagnostics Center - System health checks

Special Features

  • [V] Voice Control - Voice-activated commands
  • [W] Project Wizard - Guided project setup
  • [C] Configure Projects - Detailed integration configuration

3. Project Configuration Center

The new Configuration Center allows detailed setup of:

TaskMaster AI Integration

  • API key configuration (Perplexity, OpenRouter, Azure, Bedrock)
  • Model selection (main, fallback, research)
  • PRD parser settings
  • Task generation options
  • Analytics configuration
  • Git integration settings

SuperClaude Framework Integration

  • AI Personas management (11 specialized personas)
  • Command configuration (16 powerful commands)
  • ThinkChain streaming settings
  • Hook system configuration
  • MCP server integration
  • Response formatting options

4. Smart Project Detection with CLAUDE.PROJECT

To mark a directory as a Claude Code project, simply create a CLAUDE.PROJECT file:

# Create marker file
echo "# CLAUDE.PROJECT - Project Marker for CCDK i124q" > CLAUDE.PROJECT

The installer will prioritize these markers for faster, more accurate detection.

5. Batch Operations

Apply operations to multiple projects simultaneously:

  • Install CCDK across all projects
  • Update configurations in bulk
  • Generate reports for multiple projects
  • Synchronize settings

6. Template Library

Pre-configured templates for:

  • Next.js + TypeScript + CCDK
  • Python FastAPI + TaskMaster
  • React + Vite + SuperClaude
  • Node.js + Express + Full Stack
  • Vue 3 + Composition API
  • Django + REST Framework
  • Flutter + Dart
  • Rust + Actix Web
  • Go + Gin Framework
  • Java Spring Boot

7. AI-Powered Features

  • AI Config Builder: Analyzes your project and recommends optimal configurations
  • Smart Recommendations: Context-aware suggestions based on project type
  • Auto-Configuration: One-click setup based on AI analysis
  • Intelligent Defaults: Learns from your preferences

Installation Options

Per-Project Configuration

  1. TaskMaster AI:

    • Creates .taskmaster/ directory structure
    • Configures models and API keys
    • Sets up PRD parsing and task generation
    • Enables analytics and Git integration

  2. SuperClaude Framework:

    • Creates .claude/superclaude/ structure
    • Configures 16 commands with /sc: prefix
    • Enables 11 AI personas
    • Sets up ThinkChain streaming

  3. Full CCDK i124q:

    • Complete installation of all components
    • Unified configuration
    • All features enabled

Usage Examples

Quick Start

# Run the ultimate installer
bash install-ultimate.sh

# The installer will:
# 1. Scan for projects (prioritizing CLAUDE.PROJECT files)
# 2. Show the main command center
# 3. Allow you to configure each project

Configure a Specific Project

# From main menu, press 'C' for Configuration Center
# Select your project from the list
# Choose integration options:
#   1 - TaskMaster AI
#   2 - SuperClaude Framework
#   3 - Full CCDK i124q

Batch Operations

# From main menu, press 'B' for Batch Operations
# Select projects using spacebar
# Choose operation to apply

Advanced Configuration

TaskMaster AI Settings

The installer creates a .taskmaster/config.json:

{
  "version": "1.0.0",
  "models": {
    "main": "claude-3-5-sonnet-20241022",
    "fallback": "gpt-4o",
    "research": "sonar"
  },
  "features": {
    "autoExpand": true,
    "gitIntegration": true,
    "analytics": true
  },
  "rules": ["claude", "cursor", "windsurf"]
}

SuperClaude Framework Settings

The installer creates .claude/superclaude/config.json:

{
  "version": "2.0.0",
  "prefix": "/sc:",
  "personas": {
    "enabled": true,
    "autoActivation": true,
    "activePersonas": [
      "Architect",
      "Specialist",
      "Strategist",
      "Innovator"
    ]
  },
  "thinkchain": {
    "streaming": true,
    "toolDiscovery": true,
    "maxDepth": 5
  },
  "commands": {
    "implement": true,
    "analyze": true,
    "refactor": true,
    // ... all 16 commands
  }
}

Keyboard Shortcuts

  • Numbers (1-20): Quick access to features
  • Letters: Feature-specific shortcuts
  • C: Configuration Center
  • Q: Quit
  • R: Refresh data
  • /: Universal search
  • ?: Help

System Requirements

  • Bash 4.0+
  • Git
  • curl
  • tar
  • Optional: jq (for JSON processing)
  • Optional: Node.js (for TaskMaster AI)

Troubleshooting

Projects Not Detected

  1. Create a CLAUDE.PROJECT file in the project root
  2. Ensure the project is within the scan depth (default: 5 levels)
  3. Check that the directory isn't in the exclusion list

Installation Fails

  1. Check write permissions in the project directory
  2. Ensure required tools are installed
  3. Verify network connectivity for downloading components

Configuration Not Saving

  1. Check file permissions in .claude/ directory
  2. Ensure valid JSON syntax in config files
  3. Verify disk space availability

Best Practices

  1. Use CLAUDE.PROJECT markers for all your Claude Code projects
  2. Configure API keys securely through the configuration interface
  3. Start with templates for new projects to get optimal settings
  4. Use batch operations for managing multiple projects
  5. Regular health checks to maintain project quality

Future Enhancements

The Ultimate Installer is continuously evolving. Planned features include:

  • Cloud synchronization
  • Team collaboration features
  • Plugin marketplace
  • Custom template creation
  • Advanced analytics dashboard
  • CI/CD pipeline generation
  • Automated testing integration

For more information and updates, visit the CCDK i124q repository.