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:
113
.claude/workflows/agent-orchestration-patterns.md
Normal file
113
.claude/workflows/agent-orchestration-patterns.md
Normal file
@@ -0,0 +1,113 @@
|
||||
# Agent Orchestration Patterns
|
||||
|
||||
## Core Agent Coordination Features
|
||||
|
||||
- **Context Preservation**: Maintain original task context throughout Agent chain
|
||||
- **Quality Gates**: Each Agent validates input and ensures output standards
|
||||
- **Adaptive Complexity**: Workflow depth matches task complexity requirements
|
||||
- **Iterative Improvement**: Complex workflows include multiple review-fix cycles
|
||||
- **Structured Output**: Standardized Agent output formats ensure reliable coordination
|
||||
- **Error Recovery**: Graceful handling of Agent coordination failures
|
||||
|
||||
## Workflow Implementation Patterns
|
||||
|
||||
### Simple Workflow Pattern
|
||||
```pseudocode
|
||||
Flow: TodoWrite Creation → Context → Implementation → Review
|
||||
|
||||
1. MANDATORY TodoWrite Creation:
|
||||
- "Gather context for implementation"
|
||||
- "Implement solution"
|
||||
- "Review and validate code"
|
||||
- "Complete task"
|
||||
|
||||
2. Implementation Checkpoint:
|
||||
Task(code-developer): Direct implementation
|
||||
Output: SUMMARY, FILES_MODIFIED, TESTS, VERIFICATION
|
||||
|
||||
3. Review Checkpoint:
|
||||
Task(code-review-agent): Quick quality review
|
||||
Output: STATUS, SCORE, ISSUES, RECOMMENDATIONS
|
||||
|
||||
Resume Support: Load todos + context from checkpoint
|
||||
```
|
||||
|
||||
### Medium Workflow Pattern
|
||||
```pseudocode
|
||||
Flow: TodoWrite → Planning → Implementation → Review
|
||||
|
||||
1. MANDATORY TodoWrite Creation (5-7 todos):
|
||||
- "Create implementation plan"
|
||||
- "Gather context", "Implement with tests"
|
||||
- "Validate", "Review", "Complete"
|
||||
|
||||
2. Planning Checkpoint:
|
||||
Task(planning-agent): Create plan
|
||||
Trigger decomposition if >3 modules or >5 subtasks
|
||||
Output: PLAN_SUMMARY, STEPS, SUCCESS_CRITERIA
|
||||
|
||||
3. Implementation Checkpoint:
|
||||
Task(code-developer): Follow plan
|
||||
Update TODO_CHECKLIST.md if decomposition exists
|
||||
|
||||
4. Review Checkpoint:
|
||||
Task(code-review-agent): Comprehensive review
|
||||
Verify against plan and decomposition
|
||||
|
||||
Resume Support: Full state restoration at each checkpoint
|
||||
```
|
||||
|
||||
### Complex Workflow Pattern
|
||||
```pseudocode
|
||||
Flow: TodoWrite → Planning → Implementation → Review → Iterate (max 2)
|
||||
|
||||
1. MANDATORY TodoWrite Creation (7-10 todos):
|
||||
- "Create detailed plan", "Generate decomposition docs"
|
||||
- "Gather context", "Implement with testing"
|
||||
- "Validate criteria", "Review", "Iterate", "Complete"
|
||||
|
||||
2. Planning Checkpoint:
|
||||
Task(planning-agent): MANDATORY task decomposition
|
||||
Generate: IMPL_PLAN.md (enhanced structure), TODO_LIST.md
|
||||
Include risk assessment and quality gates
|
||||
|
||||
3. Implementation Checkpoint:
|
||||
Task(code-developer): Follow hierarchical breakdown
|
||||
Update TODO_CHECKLIST.md for each subtask completion
|
||||
|
||||
4. Review & Iteration Loop (max 2 iterations):
|
||||
Task(code-review-agent): Production-ready review
|
||||
If CRITICAL_ISSUES found: Task(code-developer) fixes issues
|
||||
Continue until no critical issues or max iterations reached
|
||||
|
||||
Document Validation: Verify decomposition docs generated
|
||||
Resume Support: Full state + iteration tracking
|
||||
```
|
||||
|
||||
## Workflow Characteristics by Pattern
|
||||
|
||||
| Pattern | Agent Chain | Quality Focus | Iteration Strategy |
|
||||
|---------|-------------|---------------|--------------------|
|
||||
| **Complex** | Full 3-stage + iterations | Production-ready quality | Multiple rounds until perfect |
|
||||
| **Medium** | Full 3-stage single-pass | Comprehensive quality | Single thorough review |
|
||||
| **Simple** | 2-stage direct | Basic quality | Quick validation |
|
||||
|
||||
## Task Invocation Examples
|
||||
|
||||
```bash
|
||||
# Research Task
|
||||
Task(subagent_type="general-purpose",
|
||||
prompt="Research authentication patterns in codebase")
|
||||
|
||||
# Planning Task
|
||||
Task(subagent_type="planning-agent",
|
||||
prompt="Plan OAuth2 implementation across API, middleware, and UI")
|
||||
|
||||
# Implementation Task
|
||||
Task(subagent_type="code-developer",
|
||||
prompt="Implement email validation function with tests")
|
||||
|
||||
# Review Task
|
||||
Task(subagent_type="code-review-agent",
|
||||
prompt="Review recently implemented authentication service")
|
||||
```
|
||||
Reference in New Issue
Block a user