- Introduced `/workflow:test-gen` command to automate test workflow generation based on completed implementation tasks, including detailed lifecycle phases, task decomposition, and agent assignment.
- Implemented `/workflow:concept-eval` command for pre-planning evaluation of concepts, assessing feasibility, risks, and optimization recommendations using strategic and technical analysis tools.
- Added `/workflow:docs` command for generating hierarchical architecture and API documentation, with structured task creation and session management.
- Developed `/workflow:status` command to provide on-demand views of workflow state, supporting multiple formats and validation checks for task integrity and relationships.
- Removed deprecated `gemini-init.md` command and migrated its functionality to a new structure under `.claude/commands/gemini/`.
- Introduced `auto-parallel.md` for parallel brainstorming automation with dynamic role selection and concurrent execution.
- Added `auto-squeeze.md` for sequential command coordination in brainstorming workflows, ensuring structured execution from framework generation to synthesis.
- Updated `plan.md` to improve clarity on project structure analysis and command execution strategies.
- Enhanced error handling and session management across all commands to ensure robustness and user guidance.
- Improved documentation for generated files and command options to facilitate user understanding and usage.
- Add "Task Merging Over Decomposition" as core principle
- Define concrete decomposition criteria (2500 lines or 6+ files)
- Standardize error messages to English for consistency
- Improve workflow planning efficiency by reducing unnecessary task splits
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Move MCP Tools Integration from prominent position to Task JSON Schema section
- Simplify complex command examples by breaking into multiple separate commands
- Remove repository URLs and make MCP integration information more concise
- Improve readability by avoiding complex bash conditionals in examples
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
## Documentation Enhancements
- **MCP Configuration Sections**: Added dedicated "MCP Tools Configuration" sections in both English and Chinese READMEs
- **Installation Guidance**: Clear step-by-step MCP server installation guides with direct repository links
- **Configuration Resources**: Comprehensive table with installation guides and purposes for each MCP server
- **Benefits Overview**: Detailed explanation of enhanced capabilities when MCP tools are enabled
## User Experience Improvements
- **Optional Enhancement Badging**: Blue "Optional" badges to indicate MCP tools are not required
- **Clear Navigation**: Direct links to GitHub repositories for easy access
- **Pro Tips**: Professional guidance on gradual adoption approach
- **Visual Structure**: Well-organized sections with emojis and clear headings
## Configuration Details
### English README.md
- Added "MCP Tools Configuration (Optional Enhancement)" section
- Quick MCP Setup with two installation options
- Benefits breakdown with specific capability improvements
- Configuration resources table with direct links
### Chinese README_CN.md
- Added "MCP 工具配置 (可选增强)" section
- Translated installation guides and benefits
- Localized professional tips and guidance
- Consistent structure with English version
## Technical Integration
- **Automatic Detection**: CCW automatically detects and uses available MCP tools
- **Fallback Strategy**: Traditional tools used when MCP unavailable
- **IDE Integration**: Simple restart-based activation process
- **No Breaking Changes**: Completely optional enhancement to existing functionality
🔧 Enhanced user onboarding and configuration guidance for MCP tools integration
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
## Documentation Updates
- **Badge Integration**: Added orange experimental MCP Tools badges to both English and Chinese READMEs
- **Version Updates**: Updated version badges to v2.1.0-experimental
- **Release Announcements**: Added prominent experimental release notifications with:
- MCP tools integration highlights
- Exa MCP Server and Code Index MCP mentions
- Experimental feature warnings
- **Key Innovations**: Added MCP Tools Integration to core innovations list
## Visual Improvements
- Orange "Experimental" badges for clear visual distinction
- Links to Model Context Protocol GitHub organization
- Clear experimental warnings in both languages
## Release Features
- Enhanced codebase analysis through MCP tools
- External API patterns via Exa MCP Server
- Advanced internal code search via Code Index MCP
- Automatic fallback to traditional tools
- Optional installation with backward compatibility
🧪 **Experimental**: MCP integration is currently experimental and optional
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
## New Features
- **MCP Tools Integration**: Added support for Model Context Protocol tools
- Exa MCP Server: External API patterns and best practices
- Code Index MCP: Advanced internal codebase search and indexing
- **Enhanced Workflow Planning**: Updated pre_analysis to include MCP tool steps
- **Documentation Updates**: Added MCP tool setup guides and usage examples
## Changes
### Core Components
- Updated `plan.md` with MCP integration principles and implementation approach guidelines
- Added MCP tool steps in pre_analysis workflow: `mcp_codebase_exploration`, `mcp_external_context`
- Enhanced context accumulation with external best practices lookup
### Documentation
- Added comprehensive MCP tools section in both English and Chinese README
- Updated installation requirements and integration guidelines
- Added GitHub repository links for required MCP servers
### Agent Enhancements
- Updated multiple agents to support MCP tool integration
- Enhanced context gathering capabilities with external pattern analysis
## Technical Details
- MCP tools provide faster analysis through direct codebase indexing
- Automatic fallback to traditional bash/CLI tools when MCP unavailable
- Enhanced pattern recognition and similarity detection capabilities
🧪 **Experimental**: MCP integration is currently experimental and optional
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add RELEASE_NOTES_v2.0.md with detailed feature overview and migration guide
- Update CHANGELOG.md with comprehensive v2.0 feature list and breaking changes
- Remove erroneous v1.3.0 release documentation and tags
- Document four-layer architecture, enhanced workflow lifecycle, and tech stack detection
- Include migration guide for breaking changes from v1.x to v2.0
- Add comprehensive command reference for new Issue Management and Qwen CLI integration
This documentation completes the v2.0 release preparation with full feature
coverage and upgrade guidance for existing users.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add intelligent task-based loading of tech stack guidelines
- Only load tech stacks for development and code review tasks
- Simplify detection logic using ls commands instead of complex find
- Support TypeScript, React, Python, Java, Go, and JavaScript stacks
- Optimize performance by skipping detection for non-relevant tasks
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Update agent definitions with enhanced context and flow control
- Standardize command templates for consistent CLI tool integration
- Improve gemini-wrapper with better token management and path handling
- Simplify qwen-wrapper for streamlined execution
- Enhance intelligent-tools-strategy with directory navigation patterns
- Add proper quoting for Windows path compatibility in all commands
- Update workflow planning documentation with current architectural insights
These changes align the command system with the four-layer architecture
analysis and improve cross-platform compatibility.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Sync version numbers: README_CN.md v1.2 → v2.0 to match English version
- Add four-layer architecture documentation with data flow and integration points
- Remove duplicate content: Automated Test Generation sections and script entries
- Standardize command syntax: /workflow:session:list and file naming conventions
- Add issue management commands to English README for feature parity
- Unify complexity management tables and workflow lifecycle descriptions
- Fix file path inconsistencies: .task/impl-*.json and .active-[session] markers
- Align v2.0 feature descriptions across both language versions
Based on Gemini command system analysis revealing actual workflow connections,
data flow patterns, and architectural layers for improved documentation accuracy.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Changes:
- Removed pycli backend references from README.md
- Removed pycli backend references from README_CN.md
- Deleted obsolete python-tools-strategy.md file
- Updated project structure documentation to reflect current scripts
- Replaced Python backend section with enhanced test generation features
This cleanup ensures documentation accurately reflects the current system
without the removed Python CLI components.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Major updates:
- Enhanced workflow lifecycle with 6-phase development process
- Updated README.md with comprehensive CLI command documentation
- Updated README_CN.md with Chinese documentation reflecting v2.0 features
- Added Qwen CLI commands and improved Gemini/Codex command descriptions
- Enhanced brainstorming role commands and workflow session management
- Updated integration requirements for all three CLI tools
Script cleanup:
- Removed unused Python CLI scripts (install_pycli.sh, pycli, pycli.conf)
- Removed deprecated path reading scripts (read-paths.sh, read-task-paths.sh)
- Removed tech-stack-loader.sh
- Kept core scripts: gemini-wrapper, qwen-wrapper, get_modules_by_depth.sh
Architecture improvements:
- JSON-First data model as single source of truth
- Atomic session management with marker files
- Multi-agent coordination for complex task execution
- Role-based brainstorming with synthesis capabilities
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add concept-eval.md command for concept evaluation workflow
- Add concept-eval.txt template for structured concept analysis
- Enhance plan.md with required IMPL_PLAN.md structure format
- Define standardized format for project planning documentation
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Add principle to match import patterns, naming conventions, and formatting of existing codebase.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add Qwen as third CLI tool for architecture analysis and code generation
- Update decision framework to include architecture/code generation workflow
- Enhance tool selection matrix with Qwen specialization areas
- Add Qwen command templates and directory context support
- Update workflow integration with dedicated architecture phase
- Provide comprehensive examples for all three tools (Gemini/Qwen/Codex)
- Clarify tool responsibilities and use cases
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add optional analyze_implementation step using Codex CLI tool
- Include -C parameter for directory-focused development analysis
- Enhance pre_analysis flow with both Gemini and Codex options
- Improve agent context loading with implementation-focused patterns
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Add "Simple solutions over complex architectures" principle to discourage over-engineering and premature optimization, promoting simpler approaches.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add -C parameter to gemini-wrapper for directory change before analysis
- Update intelligent-tools-strategy.md to use -C (uppercase) consistently
- Replace cd [directory] functionality with -C parameter throughout docs
- Add directory context examples for both Gemini and Codex tools
- Enhance context optimization strategy with -C parameter usage
- Test confirms -C parameter works correctly with token analysis in target directory
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Create new workflow command to initialize Gemini CLI configuration
- Generates .gemini file with contextfilename set to "CLAUDE.md"
- Creates .geminiignore with technology-specific filtering rules
- Uses get_modules_by_depth.sh for workspace analysis and tech stack detection
- Supports preview mode and custom output paths
- Includes backup functionality for existing files
- Supports major tech stacks: Node.js, Python, Java, Docker, etc.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Fix execute.md: Clarify that pre_analysis steps are passed to agents for execution, not executed by workflow:execute command
- Fix plan.md: Add explicit note that pre_analysis steps are generated for agent execution
- Streamline verbose sections while preserving critical operational details
- Maintain consistency between plan and execute commands regarding pre_analysis handling
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Added context optimization to decision principles
- Include guidance for using cd [directory] to reduce irrelevant context
- Added examples showing focused vs multi-scope analysis patterns
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Clarify that /workflow:plan creates plans but doesn't execute implementation.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Rename /workflow:verify to /workflow:plan-verify to better reflect its role in the workflow lifecycle between planning and execution phases.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Implement /workflow:test-gen command for generating comprehensive test workflows based on completed implementation tasks. Creates dedicated test sessions with full coverage planning including unit, integration, e2e, performance, security, and documentation tests.
Key features:
- Analyzes completed IMPL-* tasks to generate corresponding TEST-* tasks
- Follows established workflow architecture with 5-field JSON schema
- Integrates with existing TodoWrite progress tracking and agent orchestration
- Supports automatic session detection and manual session specification
- Maps implementation patterns to appropriate test strategies
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Create dedicated /workflow:brainstorm:artifacts command for topic discussion and decomposition
- Unify document structure between auto.md and artifacts.md commands
- Fix .brainstorming path references to use proper .workflow/WFS-[topic]/ structure
- Add discussion-summary.md and component-analysis.md as shared foundation documents
- Separate synthesis/ folder generation to dedicated synthesis command
- Update auto.md workflow to include Interactive Discussion → Topic Decomposition phases
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Create /workflow:verify command for plan validation before execution
- Implement gemini strategic analysis and codex technical analysis
- Add cross-validation framework with user approval workflow
- Enhance brainstorm auto.md with comprehensive pre_analysis configuration
- Include specialized verification prompt templates for structured analysis
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Transform from command reference to strategic decision framework
- Add core framework with decision principles and execution rules
- Include universal command template with PURPOSE/TASK/CONTEXT/EXPECTED structure
- Add tool selection matrix and workflow integration patterns
- Include planning checklist and best practices sections
- Add hierarchical vector system details and migration benefits
- Provide quick setup guide and decision framework
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Modify install_pycli.sh to add ~/.claude/scripts/ to PATH instead of creating alias
- Remove redundant alias configuration, use direct PATH registration
- Update documentation to reflect simplified installation process
- Delete README.md as requested by user
- Now users can call 'pycli' directly after installation without alias setup
Installation process:
1. Run install_pycli.sh
2. Reload shell configuration (source ~/.bashrc)
3. Use 'pycli' command directly
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
- Replace all planning-role-load.sh script references with $(cat template) calls
- Update conceptual-planning-agent.md to use direct template loading
- Update all brainstorm role command files to use bash($(cat template)) format
- Update auto.md documentation with new template loading syntax
- Remove obsolete planning-role-load.sh script file
- Align with $(cat template) standard format in intelligent-tools-strategy.md
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Replace markdown template with Claude Code TodoWrite tool usage
- Update documentation to use built-in TodoWrite API instead of manual TODO_LIST.md updates
- Align with JSON-only data model and real-time progress tracking principles
- Add proper TodoWrite integration rules and examples
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Convert direct agent name references to @agent-name format in documentation
- Preserve Task() function calls and subagent_type parameters unchanged
- Keep task content agent identifiers in original format (for display only)
- Maintain document reference paths in original format
- Update workflow architecture, task management, and execution files
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add new API indexer script for document processing
- Update embedding manager with improved functionality
- Remove old cache files and update dependencies
- Modify workflow execute documentation
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add dynamic task planning rules for module grouping
- Limit tasks to max 3 modules and 30 files each
- Calculate task count based on project architecture
- Group modules by dependency depth and similarity
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Clarify that 20-minute timeout applies specifically to bash() wrapped commands
- Add explicit examples of bash command format with gemini-wrapper and codex
- Align timeout description with actual usage in workflow-architecture.md
- Remove ambiguity about which CLI commands use the default timeout
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add explicit active marker creation with matching session folder name
- Update session management to use .active-WFS-docs-[timestamp] format
- Add comprehensive session management documentation with critical warnings
- Update document structure example to show proper marker-folder relationship
- Ensure consistency with workflow-architecture.md session management patterns
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Remove -t 1200000 timeout parameters from gemini-wrapper and codex commands
- Use default timeout behavior as defined in intelligent-tools-strategy.md
- Simplify command templates for better readability
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add pre-planning architecture analysis using get_modules_by_depth.sh
- Convert DOC tasks to IMPL naming for consistency with plan.md
- Update task decomposition to follow 5-field JSON schema
- Add structured session management with IMPL_PLAN.md and TODO_LIST.md
- Fix gemini-wrapper command format to use proper CLI syntax
- Integrate with workflow:execute for task-based documentation generation
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add pre-analysis documentation check as first step
- Reference specific paths from /workflow:docs output structure
- Update flow_control to selectively load relevant documentation
- Remove outdated plan-deep command
- Add new doc-generator agent and workflow files
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
