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>
- Updated the `/workflow:plan` command description to clarify its orchestration of a 4-phase planning workflow.
- Revised the execution flow and core planning principles for improved clarity and structure.
- Removed the `ANALYSIS_RESULTS.md` file as it is no longer needed in the workflow.
- Enhanced the `concept-enhanced` tool documentation to specify mandatory first steps and output requirements.
- Expanded the `ui-designer` role template to include detailed design workflows, output requirements, and collaboration strategies.
- Introduced new design phases with clear outputs and user approval checkpoints in the UI designer template.
- Implemented task-generate-agent for autonomous task generation using action-planning-agent with discovery and output phases.
- Introduced task-generate command to generate task JSON files and IMPL_PLAN.md from analysis results with automatic artifact detection and integration.
- Enhanced documentation for both commands, detailing execution lifecycle, phases, and output structures.
- Established clear integration points and error handling for improved user experience.
- Updated intelligent-tools-strategy.md to include `--skip-git-repo-check` for Codex write access and development commands.
- Improved context gathering and analysis processes in mcp-tool-strategy.md with additional examples and guidelines for file searching.
- Introduced new command concept-enhanced.md for enhanced intelligent analysis with parallel CLI execution and design blueprint generation.
- Added context-gather.md command for intelligent collection of project context based on task descriptions, generating standardized JSON context packages.
- Implemented `/workflow:plan` for creating detailed implementation plans with task decomposition and context gathering.
- Added `/workflow:resume` for intelligent session resumption with automatic progress analysis.
- Introduced `/workflow:review` for executing the final phase of quality validation and generating review reports.
- Developed `/workflow:status` to provide on-demand views of workflow status and task progress.
- Created `/workflow:test-gen` to generate comprehensive test workflows based on completed implementation tasks, ensuring full test coverage.
- 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>
## 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 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>
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 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 -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>
