mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-11 02:33:51 +08:00
445ac823ba
🚀 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>
113 lines
3.8 KiB
Markdown
113 lines
3.8 KiB
Markdown
# 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")
|
|
``` |