diff --git a/README.md b/README.md index 6bb7ee98..fee3af1d 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@
-[![Version](https://img.shields.io/badge/version-v1.3.0-blue.svg)](https://github.com/catlog22/Claude-Code-Workflow/releases) +[![Version](https://img.shields.io/badge/version-v2.0.0-blue.svg)](https://github.com/catlog22/Claude-Code-Workflow/releases) [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE) [![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey.svg)]() @@ -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. -> **๐ŸŽฏ 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 -- **๐Ÿง  Intelligent Task Decomposition**: New core standards prevent over-fragmentation with functional completeness principles -- **๐Ÿ” Advanced Search Strategies**: Powerful command combinations using ripgrep, grep, find, awk, sed for comprehensive analysis -- **โšก Free Exploration Phase**: Agents can gather supplementary context after structured analysis +- **๐Ÿ”„ Enhanced Workflow Lifecycle**: Complete development cycle: Brainstorm โ†’ Plan โ†’ Verify โ†’ Execute โ†’ Test โ†’ Review +- **๐Ÿ Python-Powered Backend**: Advanced `pycli` integration with hierarchical vector database support for semantic context discovery +- **๐Ÿงช 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 -- **๐Ÿค– 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** -Revolutionary task decomposition system with four core principles: +### ๐Ÿ”„ **Enhanced Workflow Lifecycle** +Complete development lifecycle with quality gates at each phase: -1. **๐ŸŽฏ Functional Completeness Principle** - Complete, runnable functional units -2. **๐Ÿ“ Minimum Size Threshold** - 3+ files or 200+ lines minimum -3. **๐Ÿ”— Dependency Cohesion Principle** - Tightly coupled components together -4. **๐Ÿ“Š Hierarchy Control Rule** - Flat โ‰ค5, hierarchical 6-10, re-scope >10 +1. **๐Ÿ’ก Brainstorm Phase** - Multi-perspective conceptual planning with role-based analysis +2. **๐Ÿ“‹ Plan Phase** - Structured implementation planning with task decomposition +3. **โœ… Verify Phase** - Pre-execution validation using Gemini (strategic) + Codex (technical) +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** -Powerful command combinations for comprehensive codebase analysis: +### ๐Ÿ **Python-Powered Backend (`pycli`)** +Advanced semantic context discovery system: ```bash -# Pattern discovery with context -rg -A 3 -B 3 'authenticate|login|jwt' --type ts --type js | head -50 +# Hierarchical vector database support +pycli --semantic-search "authentication patterns" -# Multi-tool analysis pipeline -find . -name '*.ts' | xargs rg -l 'auth' | head -15 +# Auto-detects parent directory vector DB +pycli --context-discovery --inherit-parent -# Interface extraction with awk -rg '^\\s*interface\\s+\\w+' --type ts -A 5 | awk '/interface/{p=1} p&&/^}/{p=0;print}' +# Intelligent file relevance scoring +pycli --analyze-relevance "jwt token validation" ``` -### ๐Ÿš€ **Free Exploration Phase** -Agents can enter supplementary context gathering using bash commands (grep, find, rg, awk, sed) after completing structured pre-analysis steps. +### ๐Ÿงช **Automated Test Generation** +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** -Smart automation with token management and approval modes: -- **Analysis Detection**: Keywords trigger `--approval-mode default` -- **Development Detection**: Action words trigger `--approval-mode yolo` -- **Auto Token Management**: Handles `--all-files` based on project size -- **Error Logging**: Comprehensive error tracking and recovery +### โœ… **Plan Verification System** +Dual-engine validation before execution: +- **Gemini Strategic Analysis**: High-level feasibility and architectural soundness +- **Codex Technical Analysis**: Implementation details and technical feasibility +- **Cross-Validation**: Identifies conflicts between strategic vision and technical constraints +- **Improvement Suggestions**: Actionable recommendations before implementation begins --- @@ -185,11 +192,13 @@ CCW automatically adapts workflow structure based on project complexity: #### ๐ŸŽฏ Workflow Operations | 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-deep` | Deep architectural planning | `/workflow:plan-deep "API redesign" --complexity=high` | -| `โšก /workflow:execute` | Implementation phase | `/workflow:execute --type=complex` | -| `โœ… /workflow:review` | Quality assurance | `/workflow:review --auto-fix` | +| `โœ… /workflow:plan-verify` | **NEW**: Pre-execution validation | `/workflow:plan-verify --dual-analysis` | +| `โšก /workflow:execute` | Implementation phase | `/workflow:execute --autonomous` | +| `๐Ÿงช /workflow:test-gen` | **NEW**: Generate test workflows | `/workflow:test-gen --coverage=comprehensive` | +| `๐Ÿ” /workflow:review` | Quality assurance | `/workflow:review --auto-fix` | #### ๐Ÿท๏ธ Task Management | Command | Function | Usage | @@ -272,11 +281,14 @@ graph TD โ”œโ”€โ”€ ๐Ÿ’ฌ prompt-templates/ # AI interaction templates โ”œโ”€โ”€ ๐Ÿ”ง scripts/ # Automation utilities โ”‚ โ”œโ”€โ”€ ๐Ÿ“Š gemini-wrapper # Intelligent Gemini wrapper +โ”‚ โ”œโ”€โ”€ ๐Ÿ pycli # NEW: Python CLI backend +โ”‚ โ”œโ”€โ”€ ๐Ÿ› ๏ธ install_pycli.sh # NEW: Python tools installer โ”‚ โ”œโ”€โ”€ ๐Ÿ“‹ read-task-paths.sh # Task path conversion โ”‚ โ””โ”€โ”€ ๐Ÿ—๏ธ get_modules_by_depth.sh # Project analysis โ”œโ”€โ”€ ๐Ÿ› ๏ธ workflows/ # Core workflow documentation โ”‚ โ”œโ”€โ”€ ๐Ÿ›๏ธ workflow-architecture.md # System architecture โ”‚ โ”œโ”€โ”€ ๐Ÿ“Š intelligent-tools-strategy.md # Tool selection guide +โ”‚ โ”œโ”€โ”€ ๐Ÿ python-tools-strategy.md # NEW: Python backend strategy โ”‚ โ””โ”€โ”€ ๐Ÿ”ง tools-implementation-guide.md # Implementation details โ””โ”€โ”€ โš™๏ธ settings.local.json # Local configuration @@ -287,7 +299,10 @@ graph TD โ”œโ”€โ”€ ๐Ÿ“Š .task/impl-*.json # Task definitions โ”œโ”€โ”€ ๐Ÿ“ IMPL_PLAN.md # Planning documents โ”œโ”€โ”€ โœ… 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 ``` ---