mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-12 02:37:45 +08:00
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>
This commit is contained in:
72
.claude/workflows/core-principles.md
Normal file
72
.claude/workflows/core-principles.md
Normal file
@@ -0,0 +1,72 @@
|
||||
# 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
|
||||
Reference in New Issue
Block a user