mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-02-04 01:40:45 +08:00

Files

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

2.5 KiB

Raw Blame History

Workflow System Core Principles

Architecture Philosophy

Document-State Separation

"Documents store plans, JSON manages state"

Markdown Files → Planning, requirements, task structure, implementation strategies
JSON Files → Execution state, progress tracking, session metadata, dynamic changes
Auto-sync → Bidirectional coordination with clear ownership rules

Progressive Complexity

"Minimal overhead → comprehensive structure"

Simple → Lightweight JSON + optional docs
Medium → Structured planning + conditional documents
Complex → Complete document suite + full coordination

Embedded Document Logic

"No command dependencies for document operations"

Built-in → Document splitting internal to commands
Trigger-based → Auto-splitting on complexity/task thresholds
Maintenance → docs:manage for manual operations only

Command Pre-execution Protocol

"All commands check active session for context"

Commands automatically discover and inherit context from active sessions for seamless workflow integration.

Fundamental Design Patterns

Session-First Architecture

All workflow operations inherit from active session context
Multi-session support with single active session pattern
Context switching preserves complete state

Hierarchical Task Management

JSON-based task definitions with up to 3 levels of decomposition
Bidirectional sync between task files and visualization
Progress tracking with dependency management

Complexity-Driven Structure

File structure scales automatically with task complexity
Document generation triggered by complexity thresholds
Progressive enhancement without breaking simple workflows

Real-time Coordination

TodoWrite tool provides immediate task visibility
Persistent TODO_LIST.md maintains cross-session continuity
Agent coordination through unified task interface

Quality Assurance Principles

Data Integrity

Single source of truth for each data type
Automatic validation and consistency checks
Error recovery with graceful degradation

Performance Guidelines

Lazy loading of complex structures
Minimal overhead for simple workflows
Real-time updates without blocking operations

Extensibility Rules

Plugin architecture for specialized agents
Template-based document generation
Configurable complexity thresholds

Core Philosophy: Consistent scalable workflow management with simplicity for basic tasks → comprehensive structure for complex projects

2.5 KiB Raw Blame History