mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-10 02:24:35 +08:00
docs: Update README for v2.0 with comprehensive architectural changes
Major updates reflecting the architectural evolution from v1.3 to v2.0: **Enhanced Workflow Lifecycle**: - Complete 6-phase development cycle: Brainstorm → Plan → Verify → Execute → Test → Review - New pre-execution validation with dual Gemini/Codex analysis - Automated test workflow generation with comprehensive coverage **Python-Powered Backend**: - Advanced `pycli` integration with hierarchical vector database support - Semantic context discovery replacing syntactic search patterns - Intelligent file relevance scoring and auto-parent inheritance **New Commands Added**: - `/workflow:brainstorm:*` - Multi-perspective planning with role-based analysis - `/workflow:brainstorm:artifacts` - Generate structured planning documents - `/workflow:plan-verify` - Pre-execution validation system - `/workflow:test-gen` - Comprehensive test workflow generation **Architecture Updates**: - Updated project structure showing new Python scripts and workflows - Enhanced command reference with new capabilities - Updated key innovations reflecting semantic search and automated testing 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
83
README.md
83
README.md
@@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
<div align="center">
|
<div align="center">
|
||||||
|
|
||||||
[](https://github.com/catlog22/Claude-Code-Workflow/releases)
|
[](https://github.com/catlog22/Claude-Code-Workflow/releases)
|
||||||
[](LICENSE)
|
[](LICENSE)
|
||||||
[]()
|
[]()
|
||||||
|
|
||||||
@@ -16,15 +16,16 @@
|
|||||||
|
|
||||||
**Claude Code Workflow (CCW)** is a next-generation multi-agent automation framework for software development that orchestrates complex development tasks through intelligent workflow management and autonomous execution.
|
**Claude Code Workflow (CCW)** is a next-generation multi-agent automation framework for software development that orchestrates complex development tasks through intelligent workflow management and autonomous execution.
|
||||||
|
|
||||||
> **🎯 Latest Release v1.3**: Enhanced task decomposition standards, advanced search strategies with bash command combinations, free exploration phases for agents, and comprehensive workflow system improvements. See [CHANGELOG.md](CHANGELOG.md) for details.
|
> **🎯 Latest Release v2.0**: Major architectural evolution with enhanced workflow lifecycle, Python-powered backend (`pycli`), comprehensive test workflow generation, plan verification system, and brainstorm artifacts integration. See [CHANGELOG.md](CHANGELOG.md) for details.
|
||||||
|
|
||||||
### 🌟 Key Innovations
|
### 🌟 Key Innovations
|
||||||
|
|
||||||
- **🧠 Intelligent Task Decomposition**: New core standards prevent over-fragmentation with functional completeness principles
|
- **🔄 Enhanced Workflow Lifecycle**: Complete development cycle: Brainstorm → Plan → Verify → Execute → Test → Review
|
||||||
- **🔍 Advanced Search Strategies**: Powerful command combinations using ripgrep, grep, find, awk, sed for comprehensive analysis
|
- **🐍 Python-Powered Backend**: Advanced `pycli` integration with hierarchical vector database support for semantic context discovery
|
||||||
- **⚡ Free Exploration Phase**: Agents can gather supplementary context after structured analysis
|
- **🧪 Automated Test Generation**: Comprehensive test workflow generation (`/workflow:test-gen`) with full coverage planning
|
||||||
|
- **✅ Plan Verification System**: Pre-execution validation using dual Gemini/Codex analysis (`/workflow:plan-verify`)
|
||||||
- **🎯 JSON-First Architecture**: Single source of truth with atomic session management
|
- **🎯 JSON-First Architecture**: Single source of truth with atomic session management
|
||||||
- **🤖 Dual CLI Integration**: Gemini for analysis, Codex for autonomous development
|
- **💡 Brainstorm Artifacts**: Multi-perspective planning with synthesis and structured document generation
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -92,39 +93,45 @@ graph TB
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## ✨ Major Enhancements v1.3
|
## ✨ Major Enhancements v2.0
|
||||||
|
|
||||||
### 🎯 **Core Task Decomposition Standards**
|
### 🔄 **Enhanced Workflow Lifecycle**
|
||||||
Revolutionary task decomposition system with four core principles:
|
Complete development lifecycle with quality gates at each phase:
|
||||||
|
|
||||||
1. **🎯 Functional Completeness Principle** - Complete, runnable functional units
|
1. **💡 Brainstorm Phase** - Multi-perspective conceptual planning with role-based analysis
|
||||||
2. **📏 Minimum Size Threshold** - 3+ files or 200+ lines minimum
|
2. **📋 Plan Phase** - Structured implementation planning with task decomposition
|
||||||
3. **🔗 Dependency Cohesion Principle** - Tightly coupled components together
|
3. **✅ Verify Phase** - Pre-execution validation using Gemini (strategic) + Codex (technical)
|
||||||
4. **📊 Hierarchy Control Rule** - Flat ≤5, hierarchical 6-10, re-scope >10
|
4. **⚡ Execute Phase** - Autonomous implementation with multi-agent orchestration
|
||||||
|
5. **🧪 Test Phase** - Automated test workflow generation with comprehensive coverage
|
||||||
|
6. **🔍 Review Phase** - Quality assurance and completion validation
|
||||||
|
|
||||||
### 🔍 **Advanced Search Strategies**
|
### 🐍 **Python-Powered Backend (`pycli`)**
|
||||||
Powerful command combinations for comprehensive codebase analysis:
|
Advanced semantic context discovery system:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Pattern discovery with context
|
# Hierarchical vector database support
|
||||||
rg -A 3 -B 3 'authenticate|login|jwt' --type ts --type js | head -50
|
pycli --semantic-search "authentication patterns"
|
||||||
|
|
||||||
# Multi-tool analysis pipeline
|
# Auto-detects parent directory vector DB
|
||||||
find . -name '*.ts' | xargs rg -l 'auth' | head -15
|
pycli --context-discovery --inherit-parent
|
||||||
|
|
||||||
# Interface extraction with awk
|
# Intelligent file relevance scoring
|
||||||
rg '^\\s*interface\\s+\\w+' --type ts -A 5 | awk '/interface/{p=1} p&&/^}/{p=0;print}'
|
pycli --analyze-relevance "jwt token validation"
|
||||||
```
|
```
|
||||||
|
|
||||||
### 🚀 **Free Exploration Phase**
|
### 🧪 **Automated Test Generation**
|
||||||
Agents can enter supplementary context gathering using bash commands (grep, find, rg, awk, sed) after completing structured pre-analysis steps.
|
Comprehensive test workflow creation:
|
||||||
|
- **Implementation Analysis**: Scans completed IMPL-* tasks for test requirements
|
||||||
|
- **Multi-layered Testing**: Unit, Integration, E2E, Performance, Security tests
|
||||||
|
- **Agent Assignment**: Specialized test agents for different test types
|
||||||
|
- **Dependency Mapping**: Test execution follows implementation dependency chains
|
||||||
|
|
||||||
### 🧠 **Intelligent Gemini Wrapper**
|
### ✅ **Plan Verification System**
|
||||||
Smart automation with token management and approval modes:
|
Dual-engine validation before execution:
|
||||||
- **Analysis Detection**: Keywords trigger `--approval-mode default`
|
- **Gemini Strategic Analysis**: High-level feasibility and architectural soundness
|
||||||
- **Development Detection**: Action words trigger `--approval-mode yolo`
|
- **Codex Technical Analysis**: Implementation details and technical feasibility
|
||||||
- **Auto Token Management**: Handles `--all-files` based on project size
|
- **Cross-Validation**: Identifies conflicts between strategic vision and technical constraints
|
||||||
- **Error Logging**: Comprehensive error tracking and recovery
|
- **Improvement Suggestions**: Actionable recommendations before implementation begins
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -185,11 +192,13 @@ CCW automatically adapts workflow structure based on project complexity:
|
|||||||
#### 🎯 Workflow Operations
|
#### 🎯 Workflow Operations
|
||||||
| Command | Function | Usage |
|
| Command | Function | Usage |
|
||||||
|---------|----------|-------|
|
|---------|----------|-------|
|
||||||
| `💭 /workflow:brainstorm` | Multi-agent planning | `/workflow:brainstorm "microservices architecture"` |
|
| `💭 /workflow:brainstorm:*` | **NEW**: Multi-perspective planning | `/workflow:brainstorm:system-architect "microservices"` |
|
||||||
|
| `🎨 /workflow:brainstorm:artifacts` | **NEW**: Generate planning documents | `/workflow:brainstorm:artifacts --synthesis` |
|
||||||
| `📋 /workflow:plan` | Convert to executable plans | `/workflow:plan --from-brainstorming` |
|
| `📋 /workflow:plan` | Convert to executable plans | `/workflow:plan --from-brainstorming` |
|
||||||
| `🔍 /workflow:plan-deep` | Deep architectural planning | `/workflow:plan-deep "API redesign" --complexity=high` |
|
| `✅ /workflow:plan-verify` | **NEW**: Pre-execution validation | `/workflow:plan-verify --dual-analysis` |
|
||||||
| `⚡ /workflow:execute` | Implementation phase | `/workflow:execute --type=complex` |
|
| `⚡ /workflow:execute` | Implementation phase | `/workflow:execute --autonomous` |
|
||||||
| `✅ /workflow:review` | Quality assurance | `/workflow:review --auto-fix` |
|
| `🧪 /workflow:test-gen` | **NEW**: Generate test workflows | `/workflow:test-gen --coverage=comprehensive` |
|
||||||
|
| `🔍 /workflow:review` | Quality assurance | `/workflow:review --auto-fix` |
|
||||||
|
|
||||||
#### 🏷️ Task Management
|
#### 🏷️ Task Management
|
||||||
| Command | Function | Usage |
|
| Command | Function | Usage |
|
||||||
@@ -272,11 +281,14 @@ graph TD
|
|||||||
├── 💬 prompt-templates/ # AI interaction templates
|
├── 💬 prompt-templates/ # AI interaction templates
|
||||||
├── 🔧 scripts/ # Automation utilities
|
├── 🔧 scripts/ # Automation utilities
|
||||||
│ ├── 📊 gemini-wrapper # Intelligent Gemini wrapper
|
│ ├── 📊 gemini-wrapper # Intelligent Gemini wrapper
|
||||||
|
│ ├── 🐍 pycli # NEW: Python CLI backend
|
||||||
|
│ ├── 🛠️ install_pycli.sh # NEW: Python tools installer
|
||||||
│ ├── 📋 read-task-paths.sh # Task path conversion
|
│ ├── 📋 read-task-paths.sh # Task path conversion
|
||||||
│ └── 🏗️ get_modules_by_depth.sh # Project analysis
|
│ └── 🏗️ get_modules_by_depth.sh # Project analysis
|
||||||
├── 🛠️ workflows/ # Core workflow documentation
|
├── 🛠️ workflows/ # Core workflow documentation
|
||||||
│ ├── 🏛️ workflow-architecture.md # System architecture
|
│ ├── 🏛️ workflow-architecture.md # System architecture
|
||||||
│ ├── 📊 intelligent-tools-strategy.md # Tool selection guide
|
│ ├── 📊 intelligent-tools-strategy.md # Tool selection guide
|
||||||
|
│ ├── 🐍 python-tools-strategy.md # NEW: Python backend strategy
|
||||||
│ └── 🔧 tools-implementation-guide.md # Implementation details
|
│ └── 🔧 tools-implementation-guide.md # Implementation details
|
||||||
└── ⚙️ settings.local.json # Local configuration
|
└── ⚙️ settings.local.json # Local configuration
|
||||||
|
|
||||||
@@ -287,7 +299,10 @@ graph TD
|
|||||||
├── 📊 .task/impl-*.json # Task definitions
|
├── 📊 .task/impl-*.json # Task definitions
|
||||||
├── 📝 IMPL_PLAN.md # Planning documents
|
├── 📝 IMPL_PLAN.md # Planning documents
|
||||||
├── ✅ TODO_LIST.md # Progress tracking
|
├── ✅ TODO_LIST.md # Progress tracking
|
||||||
└── 📚 .summaries/ # Completion summaries
|
├── 📚 .summaries/ # Completion summaries
|
||||||
|
├── 🧠 .process/ # NEW: Planning artifacts
|
||||||
|
│ └── 📈 ANALYSIS_RESULTS.md # Analysis results
|
||||||
|
└── 🧪 WFS-test-[session]/ # NEW: Generated test workflows
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|||||||
Reference in New Issue
Block a user