catlog22/Claude-Code-Workflow
1
0
Fork 0
mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-02-04 01:40:45 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
445ac823ba8b7fb495b709c4294a1c14e7c25a1c
Claude-Code-Workflow/INSTALL.md
catlog22 445ac823ba Initial release: Claude Code Workflow (CCW) v2.0 
🚀 Revolutionary AI-powered development workflow orchestration system

## 🔥 Core Innovations
- **Document-State Separation**: Markdown for planning, JSON for execution state
- **Progressive Complexity Management**: Level 0-2 adaptive workflow depth
- **5-Agent Orchestration**: Specialized AI agents with context preservation
- **Session-First Architecture**: Auto-discovery and state inheritance

## 🏗️ Key Features
- Intelligent workflow orchestration (Simple/Medium/Complex patterns)
- Real-time document-state synchronization with conflict resolution
- Hierarchical task management with 3-level JSON structure
- Gemini CLI integration with 12+ specialized templates
- Comprehensive file output generation for all workflow commands

## 📦 Installation
Remote one-liner installation:
```
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Claude-CCW/main/install-remote.ps1)
```

## 🎯 System Architecture
4-layer intelligent development architecture:
1. Command Layer - Smart routing and version management
2. Agent Layer - 5 specialized development agents
3. Workflow Layer - Gemini templates and task orchestration
4. Memory Layer - Distributed documentation and auto-sync

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-07 17:39:54 +08:00

7.2 KiB
Raw Blame History

Claude Code Workflow (CCW) - Installation Guide

English | 中文

Interactive installation guide for Claude Code with Agent workflow coordination and distributed memory system.

⚡ One-Line Remote Installation (Recommended)

All Platforms - Remote PowerShell Installation

# Interactive remote installation from feature branch (latest)
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Dmsflow/main/install-remote.ps1)

# Global installation with unified file output system
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Dmsflow/main/install-remote.ps1) -Global

# Force overwrite (non-interactive) - includes all new workflow file generation features
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Dmsflow/main/install-remote.ps1) -Force -NonInteractive

# One-click backup all existing files (no confirmations needed)
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Dmsflow/main/install-remote.ps1) -BackupAll

What the remote installer does:

  • ✅ Checks system requirements (PowerShell version, network connectivity)
  • ✅ Downloads latest version from GitHub (main branch)
  • ✅ Includes all new unified file output system features
  • ✅ Automatically extracts and runs local installer
  • ✅ Security confirmation and user prompts
  • ✅ Automatic cleanup of temporary files
  • ✅ Sets up .workflow/ directory structure for session management

Note: Interface is in English for cross-platform compatibility

📂 Local Installation

All Platforms (PowerShell)

# Clone the repository with latest features
git clone -b main https://github.com/catlog22/Claude-CCW.git
cd Dmsflow

# Windows PowerShell 5.1+ or PowerShell Core (Global installation only)
.\Install-Claude.ps1

# Linux/macOS PowerShell Core (Global installation only)
pwsh ./Install-Claude.ps1

Note: The feature branch contains all the latest unified file output system enhancements and should be used for new installations.

Installation Options

Remote Installation Parameters

All parameters can be passed to the remote installer:

# Global installation
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Dmsflow/main/install-remote.ps1) -Global

# Install to specific directory  
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Dmsflow/main/install-remote.ps1) -Directory "C:\MyProject"

# Force overwrite without prompts
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Dmsflow/main/install-remote.ps1) -Force -NonInteractive

# Install from specific branch
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Dmsflow/main/install-remote.ps1) -Branch "dev"

# Skip backups (overwrite without backup - not recommended)
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Dmsflow/main/install-remote.ps1) -NoBackup

# Explicit automatic backup all existing files (default behavior since v1.1.0)
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Dmsflow/main/install-remote.ps1) -BackupAll

Local Installation Options

Global Installation (Default and Only Mode)

Install to user home directory (~/.claude):

# All platforms - Global installation (default)
.\Install-Claude.ps1

# With automatic backup (default since v1.1.0)
.\Install-Claude.ps1 -BackupAll

# Disable automatic backup (not recommended)
.\Install-Claude.ps1 -NoBackup

# Non-interactive mode for automation
.\Install-Claude.ps1 -Force -NonInteractive

Global installation structure:

~/.claude/
├── agents/
├── commands/
├── output-styles/
├── settings.local.json
└── Claude.md

Note: Starting from v1.2.0, only global installation is supported. Local directory and custom path installations have been removed to simplify the installation process and ensure consistent behavior across all platforms.

Advanced Options

🛡️ Enhanced Backup Features (v1.1.0+)

The installer now includes automatic backup as the default behavior to protect your existing files:

Backup Modes:

  • Automatic Backup (default since v1.1.0): Automatically backs up all existing files without prompts
  • Explicit Backup (-BackupAll): Same as default behavior, explicitly specified for compatibility
  • No Backup (-NoBackup): Disable backup functionality (not recommended)

Backup Organization:

  • Creates timestamped backup folders (e.g., claude-backup-20240117-143022)
  • Preserves directory structure within backup folders
  • Maintains file relationships and paths

Force Installation

Overwrite existing files:

.\Install-Claude.ps1 -Force

One-Click Backup

Automatically backup all existing files without confirmations:

.\Install-Claude.ps1 -BackupAll

Skip Backups

Don't create backup files:

.\Install-Claude.ps1 -NoBackup

Uninstall

Remove installation:

.\Install-Claude.ps1 -Uninstall -Force

Platform Requirements

PowerShell (Recommended)

  • Windows: PowerShell 5.1+ or PowerShell Core 6+
  • Linux: PowerShell Core 6+
  • macOS: PowerShell Core 6+

Install PowerShell Core:

Complete Installation Examples

⚡ Super Quick (One-Liner)

# Complete installation in one command
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Dmsflow/main/install-remote.ps1) -Global

# Done! 🎉
# Start using Claude Code with Agent workflows!

📂 Manual Installation Method

# Manual installation steps:
# 1. Install PowerShell Core (if needed)
# Windows: Download from GitHub
# Linux: sudo apt install powershell
# macOS: brew install powershell

# 2. Download Claude Code Workflow System
git clone https://github.com/catlog22/Claude-CCW.git
cd Dmsflow

# 3. Install globally (interactive)
.\Install-Claude.ps1 -Global

# 4. Start using Claude Code with Agent workflows!
# Use /workflow commands and DMS system for development

Verification

After installation, verify:

  1. Check installation:

    # Global
ls ~/.claude

# Local
ls ./.claude

  2. Test Claude Code:

    • Open Claude Code in your project
    • Check that global .claude directory is recognized
    • Verify workflow commands and DMS commands are available
    • Test /workflow commands for agent coordination
    • Test /dmsflow version to check version information

Troubleshooting

PowerShell Execution Policy

If you get execution policy errors:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Workflow Commands Not Working

  • Ensure .claude directory exists in your project
  • Verify workflow.md and agent files are properly installed
  • Check that Claude Code recognizes the configuration

Permission Errors

  • Windows: Run as Administrator
  • Linux/macOS: Use sudo if needed for global PowerShell installation

Support

Reference in New Issue View Git Blame Copy Permalink