diff --git a/README.md b/README.md
index 6bb7ee98..fee3af1d 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
-[](https://github.com/catlog22/Claude-Code-Workflow/releases)
+[](https://github.com/catlog22/Claude-Code-Workflow/releases)
[](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.
-> **๐ฏ 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
```
---