### Command Updates
- Remove test-strategist and user-researcher brainstorming roles
- Update to 8 core brainstorming roles for focused efficiency
### Documentation
- Update version badges to v3.0.1
- Add release notes to CHANGELOG.md
- Update version references in README files
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Reduced content by 81% while maintaining all essential information
- Improved structure with clearer sections and better navigation
- Added Quick Start guide for immediate usability
- Consolidated redundant sections and removed verbose explanations
- Simplified command reference tables
- Maintained all installation steps, badges, and links
- Ensured consistent structure between English and Chinese versions
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Remove test-strategist from documentation as it only has a planning
template but no corresponding brainstorm command implementation.
Current active brainstorming roles (8):
- system-architect
- data-architect
- subject-matter-expert
- product-manager
- product-owner
- scrum-master
- ui-designer
- ux-expert
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Major role restructuring to improve workflow efficiency and clarity:
## New Roles Added (4)
- product-owner: Backlog management and user story definition
- scrum-master: Sprint planning and agile process facilitation
- ux-expert: User experience optimization and usability testing
- subject-matter-expert: Domain expertise and industry standards
## Roles Removed (5)
- business-analyst → functionality split to product-owner and scrum-master
- feature-planner → merged into product-owner responsibilities
- innovation-lead → integrated into subject-matter-expert
- security-expert → integrated into subject-matter-expert
- user-researcher → merged into ux-expert
## Files Updated
### Command Files (.claude/commands/workflow/brainstorm/)
- Created: product-owner.md, scrum-master.md, ux-expert.md, subject-matter-expert.md
- Deleted: business-analyst.md, feature-planner.md, innovation-lead.md, security-expert.md, user-researcher.md
- Updated: artifacts.md, auto-parallel.md, auto-squeeze.md, synthesis.md
### Planning Templates (.claude/workflows/cli-templates/planning-roles/)
- Created: product-owner.md, scrum-master.md, ux-expert.md, subject-matter-expert.md
- Archived: Moved 5 deprecated roles to _deprecated/ with migration guide
- Added: _deprecated/README.md with deprecation details and migration paths
### Agent Configurations
- Updated conceptual-planning-agent.md with new role mappings
- Updated action-planning-agent.md with new role references
### Documentation
- Updated README.md brainstorming role tables and descriptions
- Updated README_CN.md with Chinese translations for new roles
- Updated workflow documentation files with new role references
## Breaking Changes
Commands for removed roles are no longer available. Use replacement roles:
- /workflow:brainstorm:business-analyst → use product-owner or scrum-master
- /workflow:brainstorm:feature-planner → use product-owner
- /workflow:brainstorm:innovation-lead → use subject-matter-expert
- /workflow:brainstorm:security-expert → use subject-matter-expert
- /workflow:brainstorm:user-researcher → use ux-expert
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add detailed installation section with both remote and local options
- Document all four installation scripts (ps1/sh for remote/local)
- Add installation scripts overview table
- Clarify platform-specific requirements
- Add verification steps
- Highlight native support without cross-platform dependencies
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Change complex task strategy from "Brainstorm → Planning → Execution"
to "Use /workflow:plan for structured planning and execution"
Rationale:
- Bug fixes and feature additions typically don't need brainstorming
- /workflow:plan is the appropriate entry point for complex tasks
- Brainstorming is reserved for large-scale architectural changes
Updated in both English and Chinese README files.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
English README (README.md):
- Translate complete workflow guide from Chinese to English
- Maintain workflow structure and examples
- Update all technical terms to English
Chinese README (README_CN.md):
- Add comprehensive workflow guide
- Include brainstorming, planning, execution, and testing phases
- Add context package and task JSON structure examples
- Include LINUX DO community discussion link
Both versions now have consistent workflow documentation.
🤖 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>
- 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 6 new detailed mermaid diagrams showing complete development workflow from brainstorming to execution
- Document workflow vs task command relationships and dependencies
- Include planning method selection flow based on project complexity
- Add brainstorming to execution pipeline with multi-agent coordination
- Show task command hierarchy with execution modes and agent selection
- Integrate CLI tools (Gemini/Codex) within workflow context
- Update README files with workflow examples and planning method guides
- Provide clear visual guidance for choosing appropriate development paths
Enhanced documentation now covers complete workflow orchestration from
initial requirements through planning, execution, and final delivery.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add detailed mermaid workflow diagrams in WORKFLOW_DIAGRAMS.md
- Update README.md and README_CN.md with v1.2 features and architecture visualization
- Enhance system architecture diagrams with CLI routing and agent coordination flows
- Document major enhancements since v1.0: task saturation control, Gemini wrapper intelligence
- Add command execution flow diagrams and comprehensive workflow visualizations
- Update CLI guidelines in codex-unified.md and gemini-unified.md with bash() syntax
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add 'paths' field to task JSON schema with semicolon-separated concrete paths
- Create read-task-paths.sh script to convert paths to Gemini @ format
- Update all agents to use task-specific paths instead of --all-files
- Integrate get_modules_by_depth.sh for project structure discovery
- Update workflow planning to populate paths field automatically
- Enhance execute command to pass task-specific paths to agents
- Update documentation for new path management system
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
## Configuration Section Correction:
### Removed Unnecessary Configurations:
- **Gemini CLI**: Removed `outputFormat` and `templateDirectory` - these are not standard or required
- **Codex CLI**: Removed entire section - Codex CLI configuration is not part of CCW setup
- **Local Settings**: Removed `.claude/settings.local.json` section - not part of core configuration
### Retained Essential Setting:
- **Only `contextFileName: "CLAUDE.md"`**: This is the critical setting needed for CCW integration with Gemini CLI
- **Clear explanation**: Added description of why this setting is necessary
### Benefits:
- **Simplified setup**: Users only need to configure what's actually required
- **Reduced confusion**: No more unnecessary or potentially incorrect configuration examples
- **Focus on essentials**: Streamlined to core functionality requirements
- **Bilingual consistency**: Applied same fixes to both English and Chinese versions
The configuration section now accurately reflects only the settings that are necessary for CCW to function properly.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
## Major Documentation Updates:
### README Transformation:
- **English README.md**: Rewritten as "The Neural Network for Software Development" with compelling storytelling, vivid metaphors, and emotional connection
- **Chinese README_CN.md**: Culturally adapted with engaging Chinese expressions while maintaining technical accuracy
- Added "AI Dream Team" concept, real-world scenarios, and developer transformation narratives
- Enhanced visual hierarchy with rich emojis and progressive disclosure of complex concepts
### Codex CLI Guidelines Enhancement:
- **Emphasized --full-auto as PRIMARY mode**: Added prominent golden rule section for autonomous development
- **Updated all examples**: Every code sample now leads with --full-auto approach, alternatives moved to secondary position
- **Critical guidance added**: Clear 90% usage recommendation for autonomous mode with explicit exception criteria
- **Comprehensive workflow updates**: Multi-phase development, quality assurance, and cross-project learning all prioritize autonomous execution
### Key Improvements:
- Transformed technical specifications into compelling developer stories
- Made complex architecture concepts accessible through analogies
- Added emotional resonance for both English and Chinese audiences
- Strengthened autonomous development workflow recommendations
- Enhanced developer experience focus with before/after scenarios
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Based on Gemini analysis findings:
- Fix /update-memory command documentation to reflect actual separate commands
- Correct /codex:--full-auto to /codex:mode:auto matching actual implementation
- Remove --yolo flag from examples (behavior is default in execute commands)
- Update documentation management examples to use correct command syntax
- Standardize command reference tables in both English and Chinese READMEs
This ensures documentation accuracy matches the current codebase structure with 44 command files.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Update README.md and README_CN.md to v1.1 with unified Gemini/Codex CLI integration
- Add comprehensive Codex command documentation with autonomous development capabilities
- Enhance CLI tool guidelines with shared template system architecture
- Consolidate documentation structure removing outdated CLAUDE.md files
- Reflect current project state with dual CLI workflow coordination
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Major Changes:
- Update README.md and README_CN.md to reflect v1.0 release instead of v2.0
- Add Gemini CLI integration highlights: dynamic template discovery, auto-selection
- Correct command references from /gemini:pre:* to /gemini:mode:*
- Add Smart Template Auto-Selection usage examples
- Reorganize Gemini commands from /pre/ to /mode/ directory structure
Documentation Improvements:
- Replace v2.0 architecture claims with actual v1.0 achievements
- Highlight 500+ lines of documentation streamlining
- Add practical examples for new auto-selection template system
- Maintain consistency between English and Chinese versions
Command Structure Updates:
- Move auto.md, bug-index.md, plan.md from /pre/ to /mode/ directory
- Update gemini-unified.md path references
- Ensure all command references are accurate and functional
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add prerequisites section referencing official Gemini CLI repository
- Add essential configuration section showing proper settings.json setup
- Emphasize importance of "contextFileName": "CLAUDE.md" setting
- Update both English and Chinese README files
- Fix filename references from "Claude.md" to "CLAUDE.md" in install docs
- Improve user onboarding with proper configuration guidance
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Simplify /gemini:chat by removing complex template selection logic
- Create /gemini:chat:bug-fix for specialized bug analysis with diagnostic template
- Create /gemini:chat:plan for project planning with architecture template
- Remove dependencies on chat-template-load.sh script
- Organize template commands in gemini/chat/ folder structure
- Update README documentation for new command structure
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
## Changes Made
- Add architecture v2.0 highlights with quantified benefits
- Update directory structure to show new core files
- Emphasize JSON-only data model and marker file session management
- Update complexity strategies with unified task-count thresholds
- Reference comprehensive upgrade documentation
## Key Updates
- JSON-only data model: Single source of truth with <1ms operations
- Marker file sessions: 95% performance improvement
- Progressive complexity: Unified thresholds (Simple <5, Medium 5-15, Complex >15)
- Architecture benefits: 40-50% maintenance reduction, 50% faster onboarding
## Documentation
- Link to WORKFLOW_SYSTEM_UPGRADE.md for detailed technical analysis
- Updated both English and Chinese README files
- Maintained consistency between language versions
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Updated both English and Chinese README files to align with current command structure:
## Command Updates
- Replaced deprecated `/workflow:context` and `/workflow:sync` with unified `/context` command
- Removed deprecated `/task:context` and `/task:sync` from task execution sections
- Updated command descriptions to reflect Single Source of Truth architecture
## README.md Changes
- Updated workflow management table to show `/context` with proper syntax and description
- Removed 2 deprecated task commands from task execution table
- Maintained consistency with actual command implementation
## README_CN.md Changes
- Updated Chinese workflow management table with `/context` command
- Removed deprecated Chinese task commands from task execution table
- Maintained translation consistency for unified context command
## Documentation Alignment
- Both README files now accurately reflect the current command structure
- Eliminated confusion about removed synchronization commands
- Provides users with correct command references for current system
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Added language switcher buttons at the top of both README files
- English README displays: Languages: [English](README.md) | [中文](README_CN.md)
- Chinese README displays: 语言: [English](README.md) | [中文](README_CN.md)
- Positioned switcher in right-aligned div for clean header layout
- Enhanced user experience for multilingual documentation access
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Added complete command reference with syntax and descriptions for all CCW commands
- Included detailed usage workflows for different complexity levels
- Provided practical examples for complex feature development, bug fixes, and code analysis
- Added complexity-based strategy guide (Simple/Medium/Complex)
- Simplified installation section to focus on one-liner quick start
- Updated both English and Chinese versions with gemini CLI analysis insights
- Restructured documentation to prioritize command usage over installation details
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Changed remote repository URL from Claude-CCW to Claude-Code-Workflow
- Updated all GitHub links in README.md and README_CN.md
- Updated repository references in install-remote.ps1 script
- Maintained consistent naming convention (CCW) throughout documentation
- Repository now accessible at github.com/catlog22/Claude-Code-Workflow
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Added Quick Install section with one-liner PowerShell command
- Included installation parameters and options table
- Updated repository URLs to reflect catlog22/Claude-CCW naming
- Provided both English and Chinese documentation for remote installation
- Enhanced installation guide with manual and automated options
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
