What's New

New Skill: team-arch-opt (Architecture Optimization)

• New team skill focused on structural architecture improvements: dependency cycles, coupling/cohesion, layering violations, God Classes, dead code
• Isomorphic to team-perf-opt with pipeline: ANALYZE → DESIGN → REFACTOR → VALIDATE + REVIEW
• 6 roles: coordinator, analyzer, designer, refactorer, validator, reviewer
• Supports single/fan-out/independent/auto parallel modes
• 2 subagents: explore (dependency graphs & module boundaries) + discuss (multi-perspective trade-off analysis)

Fixes & Improvements

• fix(analyze-with-file): add session termination boundary and optimize Phase 4 UX
• fix(planning-agent): clarify CLI output as markdown text, relax constraint wording
• fix(planning-agent): relax task parser regex and inject Prior Analysis into CLI context
• fix(planning-agent): remove skip-CLI logic, keep Prior Analysis as context
• fix(planning-agent): enforce blocking CLI calls overriding global default
• fix(planning-agent): add Prior Analysis fast path to skip CLI execution
• refactor(workflow-lite-planex): standardize phase naming and improve documentation

Full Changelog: https://github.com/anthropics/claude-code-workflow/compare/v7.2.0...v7.2.1

🎯 Structured Task Descriptions for Team Workflows

This release introduces a comprehensive structured task description format across all v5 team workflows, providing workers with clearer context and actionable guidance.

✨ Features

team-coordinate-v2: Enhanced Task Analysis & Dispatch

• Structured Task Schema: Tasks now include goal, steps[], key_files[], upstream_artifacts[], success_criteria, and constraints
• Key File Inference: New Step 2.5 in analyze-task.md automatically infers relevant files based on capability type and task keywords
• Structured Dispatch Template: dispatch.md now uses PURPOSE/TASK/CONTEXT/EXPECTED/CONSTRAINTS format

team-lifecycle-v5: Structured Task Descriptions

• Updated Task Templates: All task creation (standard, revision, improvement) now uses structured format
• Clear Worker Context: Workers receive explicit goals, actionable steps, file references, and success criteria
• Improved Traceability: Upstream artifacts and key files are explicitly listed in CONTEXT section

team-skill-designer-v4: Enforced Quality Standards

• Template Specification: Phase 3 now includes detailed task description template for dispatch.md generation
• Quality Verification: Updated quality standards and integration verification to check structured format
• Consistent Generation: All generated v5 skills will use structured task descriptions

📋 Task Description Format

PURPOSE: <what this task achieves> | Success: <measurable completion criteria>
TASK:
  - <step 1: specific action>
  - <step 2: specific action>
  - <step 3: specific action>
CONTEXT:
  - Session: <session-folder>
  - Scope: <scope>
  - Upstream artifacts: <artifact-1.md>, <artifact-2.md>
  - Key files: <file1>, <file2>
  - Shared memory: <session>/shared-memory.json
EXPECTED: <deliverable path> + <quality criteria>
CONSTRAINTS: <scope limits, focus areas>

🔄 Backward Compatibility

• Fully compatible with existing team-worker Phase 1 (reads descriptions as freeform text)
• No schema changes to team-session.json or role-spec templates
• Existing workflows continue to function without modification

📦 Files Changed

• .claude/skills/team-coordinate-v2/roles/coordinator/commands/analyze-task.md
• .claude/skills/team-coordinate-v2/roles/coordinator/commands/dispatch.md
• .claude/skills/team-lifecycle-v5/roles/coordinator/commands/dispatch.md
• .claude/skills_lib/team-skill-designer-v4/phases/03-skill-generation.md
• .claude/skills_lib/team-skill-designer-v4/phases/04-integration-verification.md
• .claude/skills_lib/team-skill-designer-v4/specs/quality-standards.md

🎁 Benefits

• Clearer Worker Context: Workers understand exactly what to do, why, and how to verify success
• Better File Discovery: Key files are inferred and provided upfront, reducing exploration time
• Improved Success Rates: Explicit success criteria and constraints reduce ambiguity
• Consistent Format: All v5 team workflows use the same structured approach

🐛 Bug Fix Release: v7.0.1

This is a critical bug fix release that resolves the frontend deployment issue in v7.0.0.

Fixed

• Frontend Deployment Issue: Fixed "Could not find React frontend directory" error when users install from npm
  • Added ccw/frontend/dist/ to package.json files field
  • Modified react-frontend.ts to detect and use production build (static files)
  • Added static file serving to server.ts with proper MIME type support
  • Updated prepublishOnly script to build frontend before publishing

Technical Details

The issue occurred because:

1. The npm package didn't include the frontend build directory
2. The server tried to start a Vite dev server which requires source files and node_modules
3. Users installing from npm only got the backend code without frontend assets

The fix implements:

• Production Mode: Serves pre-built static files from frontend/dist/
• Development Mode: Falls back to Vite dev server when source files are available
• Automatic Detection: Checks for production build first, then falls back to dev mode
• SPA Routing: Properly handles client-side routing by serving index.html for non-API routes

Installation

npm install -g [email protected]

Verification

After installation, run:

ccw view

The dashboard should now start successfully without the frontend directory error.

Full Changelog: v7.0.0...v7.0.1

🎉 Major Release: v7.0.0

335+ commits | 442+ new features | Complete architecture transformation

This is a massive release representing months of development work, introducing fundamental changes to the Claude Code Workflow architecture.

🏗️ Team Architecture Evolution (v0 → v5)

Team System Complete Redesign

• Team Lifecycle v2-v5: Progressive evolution with unified team-worker agent architecture
• Team Coordinate v2: Enhanced coordination with team-executor-v2 for improved agent orchestration
• 12 Team Skills Updated: All team skills migrated to v3 design patterns with role isolation
• New Team Skills:
  • team-roadmap-dev: Phased execution pipeline for roadmap-driven development
  • team-tech-debt: Tech debt identification with plan approval gates and worktree execution
  • team-iterdev: Phase 1-3 workflow optimizations for iterative development
  • team-frontend: Frontend development with ui-ux-pro-max integration
  • team-uidesign: UI design intelligence integration

Team Execution Improvements

• Stop-Wait Pattern: Replaced polling/pre-spawning across all team coordinators
• True Parallel Execution: Enabled with --agent-name mechanism
• Session-based Messaging: Use session-id instead of team-name for better isolation
• Checkpoint Handling: Enhanced lifecycle roles with inner loop execution
• Team Artifacts: Tree navigation and file preview for team outputs
• Shared Memory: Wisdom accumulation across team members

🔄 Workflow System Overhaul

Unified Workflow Engine

• Workflow Spec Command System: Unified command architecture for all workflows
• Lightweight Interactive Planning: In-memory execution with code exploration
• Session Management:
  • /workflow:session:start: Intelligent session discovery
  • /workflow:session:resume: Resume paused sessions
  • /workflow:session:sync: Quick-sync to specs/*.md
  • /workflow:session:complete: Archive with lessons learned
  • /workflow:session:solidify: Crystallize learnings to permanent memory

New Workflow Commands

• workflow:analyze-with-file: Interactive collaborative analysis with CLI assistance
• workflow:brainstorm-with-file: Multi-CLI collaboration with idea expansion
• workflow:collaborative-plan-with-file: Shared planning notes
• workflow:debug-with-file: Hypothesis-driven debugging
• workflow:roadmap-with-file: Strategic requirement roadmap
• workflow:unified-execute-with-file: Universal execution engine
• workflow:integration-test-cycle: Self-iterating integration tests
• workflow:refactor-cycle: Tech debt discovery and refactoring
• workflow:clean: Intelligent code cleanup with stale artifact discovery

📊 Dashboard & UI Revolution

Terminal Dashboard

• Orchestrator Page Redesign: Template editor with terminal execution
• Session Management: Session name/tag field for grouping
• Pane Management: Improved UX for terminal panes
• Session Close: Confirmation dialogs with i18n support
• CLI Viewer: Fixed duplicate output and sticky scroll issues
• Infinite Scrolling: For native sessions

Analysis & Monitoring

• Analysis Viewer Page: Grid layout with filters and fullscreen mode (#122)
• Pagination Support: Concurrent processing for analysis sessions
• Execution Monitor: Agent list moved to dedicated panel
• Queue Panel: Orchestrator tab with status management

Issue Management

• Multi-select Functionality: Batch operations in issue panel
• Send to Terminal: Direct execution from issue panel
• Issue Discovery: Multi-perspective discovery (bug, UX, test, quality)
• Issue Planning: Batch planning with issue-plan-agent
• Issue Queue: DAG-based parallel orchestration
• Issue Execution: One commit per solution

🎯 Queue Scheduler System

New Queue Management

• Queue Scheduler Service: Complete API routes implementation
• Reset Functionality: Queue scheduler reset capability
• DAG-based Orchestration: Parallel task execution with dependency resolution
• Standalone Controls: Toolbar/floating panel (not embedded in terminal)

🛠️ CLI & Tool Integration

Multi-Provider CLI Support

• CLI Settings: Export/import functionality
• Multi-provider Settings: Claude, Codex, Gemini, Qwen support
• CLI Config Preview: For Codex and Gemini
• Effort Level Configuration: For Claude CLI
• Windows CLI Support: cmd as preferred shell with improved error handling

Codex Integration

• Codex-native Skills: team-planex converted to Codex format
• Execution Logging: For planex-executor agents
• Review Conflict Detection: Prompt + target flags validation

CLI Tools Enhancement

• ccw-litellm: Status checks and file preview
• CodexLens: Enhanced bootstrapVenv with UV and pip fallback
• Staged Settings: Advanced configuration support
• Installation Progress: Overlay with localization

📚 Skill Hub & Community

Skill Hub Feature

• Community Skills Management: Browse and install community skills
• Remote Skills: Refresh parameter to bypass cache
• Skill Deletion: Improved UI/UX for skill management
• Skill Index: Full directory download support
• Test Skills: Added to skill hub index
• Standalone Repository: ccw-skill-hub moved to separate repo

Skill System Improvements

• Skill Router Templates: v3 style execution with role isolation
• Command Architecture: Generator-Critic loops with shared memory
• Dynamic Pipelines: Flexible execution flows
• TodoWrite Recovery: Compact protection replacement

📝 Specs & Documentation

Specs Management

• Category & Scope: Enhanced filtering and organization
• SpecDialog: Edit spec frontmatter
• SpecContentDialog: View and edit spec content
• Injection Preview: Preview spec injections
• Folder Structure: Updated dimensions and organization
• Hooks Integration: Spec management with hooks

Templates

• Architecture Documents: Design templates
• Epics & Product Briefs: Product management templates
• Requirements PRD: Detailed requirement templates
• Hook Templates: 7 templates with full install pipeline

🔐 Security & Stability

Security Enhancements

• Path Validation: Prevent traversal attacks in session handling
• Runtime Validation: GitHub API response validation
• Type Safety: Enhanced TypeScript coverage

Testing

• Integration Tests: Command creation feature tests
• E2E Tests: End-to-end workflow validation
• Visual Tests: UI regression testing
• Regression Tests: Empty request body handling

🎨 UI/UX Improvements

Design System

• ui-ux-pro-max Integration: 50 styles, 21 palettes, 50 font pairings
• Sheet Component: Bottom sheet with drag-to-dismiss
• Dialog & Drawer: Enhanced styles and functionality
• Immersive Mode: Global fullscreen support
• Chinese Localization: Improved CLI manager translations

User Experience

• Feature Flags: Dashboard feature flag support
• Project Context: Enhanced loading
• File Browser: Commands page file browser
• Explorer API: Extended file routes
• A2UI Enhancements: Navigation and session handling

🧠 Memory & Context

Core Memory System

• Tags System: Memory tagging and filtering
• Session Summaries: Automatic summarization
• Hook Injection: Memory integration with hooks
• Solidify Compress Mode: Crystallize learnings
• Recursive Discovery: Core-memory database discovery
• Project Listing: Multi-project memory management

🔧 Developer Experience

Build & Deployment

• Postbuild Hook: Executable permissions for Mac/Linux
• Prepublish Clean: Remove 69 dev artifacts
• GitHub Actions: Release workflows
• Package Optimization: Better .npmignore management

Configuration

• Config Store: Dashboard feature flags in initial state
• Environment Variables: CodexLens indexing group schema
• Settings Export: CLI settings portability

🐛 Bug Fixes & Refactoring

Major Fixes

• Team Skills: Name inconsistency and command execution protocol
• Session Resume: Robust state reconciliation for team-lifecycle
• CLI Endpoints: Corrected across team-planex and commands
• Duplicate Padding: TeamPage layout fix
• TypeScript Errors: Resolved 3 build errors
• Unused Imports: Cleanup in CliViewerToolbar and QueuePanel

Refactoring

• Executions Tab: Removed from Issue Hub
• ccw-vscode-bridge: Cleanup of obsolete code
• skills_lib: Removed from remote tracking
• Obsolete Docs: Team lifecycle specifications cleanup
• API Proxy: Updated path to avoid frontend conflicts

📦 Package Information

• Package Size: 3.3 MB
• Unpacked Size: 15.4 MB
• Total Files: 1,619
• Node Version: >=18.0.0

🔗 Links

• 📦 npm Package
• 📖 Documentation
• 🐛 Report Issues
• 🎯 Skill Hub

🙏 Breaking Changes

This release includes significant architectural changes:

• Team skills require migration to v3 patterns
• Workflow session management has new commands
• CLI configuration structure updated for multi-provider support
• Some obsolete features removed (executions tab, ccw-vscode-bridge)

Please review the documentation for migration guidance.

Full Changelog: https://github.com/catlog22/Claude-Code-Workflow/compare/v...

Changes in v6.3.52

Recent Fixes & Features

• fix: Improve command detail modal tab handling and error reporting
• Add command relationships, essential commands, and validation script
• fix: Unify execution IDs between broadcast events and session storage
• fix: Auto-detect JSON Lines output format for Codex CLI
• fix: Resolve API path resolution for document loading

What's New in v6.3.51

🚀 Features

• Command Orchestration: Add command relationships, essential commands, and validation script
• CCW Help System Enhancement: Optimize ccw-help skill with user-prompted update mechanism and new command orchestration dashboard
• Skill Generator Improvements: Convert skill-generator from Chinese to English and remove emoji icons
• Unified Execute Engine: Add Codex unified-execute-with-file prompt for multi-task coordination

🐛 Bug Fixes

• Execution IDs: Unify execution IDs between broadcast events and session storage
• Codex CLI Format: Auto-detect JSON Lines output format for Codex CLI
• API Path Resolution: Resolve API path resolution for document loading
• Command Modal: Improve command detail modal tab handling and error reporting

📚 Documentation

• Comprehensive summary of unified-execute-with-file implementation
• Comparison guide between Claude and Codex unified-execute versions
• Add reference-docs-spec and optimize skill-generator for proper document organization
• Optimize reference documents with phase-based guidance and usage timing
• Add comprehensive execution and planning agent prompts

🔧 Refactoring

• Optimize unified-execute-with-file command documentation
• Simplify issue creation documentation

📦 Installation

npm install [email protected]

GitHub: https://github.com/catlog22/Claude-Code-Workflow

Release v6.3.49 - 2026-01-28

✨ Highlights | 亮点

CLI Tools & Configuration | CLI工具与配置

• Added: In-memory configuration prioritization for CLI tool selection initialization
• Added: Codex CLI settings with toggle and refresh actions
• Added: ccw-cli-tools skill specification with unified execution framework
• Added: Commands management feature with API endpoints and UI integration

Skills & Workflows | 技能与工作流

• Enhanced: lite-skill-generator with single file output and improved validation
• Added: brainstorm-to-cycle adapter for converting brainstorm output to parallel-dev-cycle input
• Added: brainstorm-with-file prompt for interactive brainstorming workflow
• Added: Skill enable/disable functionality with enhanced moveDirectory rollback

🔒 Security | 安全

• Fixed: 3 critical security vulnerabilities

🛠️ Improvements | 改进

• Refactored: Orchestrator logic with enhanced problem taxonomy
• Enhanced: Planning & context management features
• Updated: Review commands to use review-cycle-fix for automated fixing

📚 Documentation | 文档

• Added: Level 5 intelligent orchestration workflow guide
• Added: /ccw and /ccw-coordinator as recommended commands
• Fixed: README_CN.md交流群二维码图片扩展名

📦 Installation | 安装

npm install [email protected]

📝 Full Changelog | 完整变更日志

See CHANGELOG.md for complete details.

🙏 Thanks | 感谢

Thanks to all contributors who made this release possible!

What's Changed

Features

• feat: enhance tdd-verify command with detailed compliance reporting and validation improvements
• feat: enhance project root detection with caching and debug logging
• feat: add --yes flag for auto-confirmation across multiple workflows
• feat: Update command validation tools and improve README documentation
• feat: Implement CCW Coordinator for interactive command orchestration
• feat: Enhance TDD workflow with specialized executor and optimized task generation

Fixes

• fix: replace hardcoded Windows paths with dynamic cross-platform paths in CodexLens error messages
• fix: resolve CodexLens installation failure with NPM global install by @ylc6223
• fix: auto-sync CLI tools availability on first config creation (Issue #95)

Refactors

• refactor: action plan verification command to plan verification
• refactor: Rename command-registry.js to command-registry.cjs and update references

Full Changelog: v6.3.43...v6.3.44

What's New

🚀 New Features

• CCW Loop-B Hybrid Orchestrator Skill - New coordinator + specialized workers architecture

  • Supports three execution modes: Interactive / Auto / Parallel
  • Specialized workers: init, develop, debug, validate, complete
  • Batch wait API for parallel execution
  • Unified state management at .workflow/.loop/

• Intelligent Cleanup Command - Refactored for clarity and efficiency

  • Mainline detection
  • Stale artifact discovery
  • Safe execution mode

• User Config Priority - User configuration now takes priority over default tools

  • No longer merges default tools into user config
  • Cleaner configuration management

🐛 Bug Fixes

• envFile Support - Fixed envFile preservation in config handling

  • Include envFile in getFullConfigResponse API response
  • Preserve envFile in ensureToolTags merge function

• Loop State Path - Unified all loop state paths to .workflow/.loop/

  • Resolves API compatibility issues
  • Consistent path across ccw-loop and ccw-loop-b skills

• Git Bash Install - Changed default for multi-line prompt fix to false

📁 Files Changed

New Skills:

• .codex/skills/ccw-loop-b/ - Hybrid orchestrator skill
• .codex/agents/ccw-loop-b-*.md - 5 specialized worker agents

Updated (16 files):

• All ccw-loop and ccw-loop-b files now use .workflow/.loop/ path

Full Changelog: v6.3.38...v6.3.39

What's New

Issue Discovery Features

• Multi-perspective issue discovery (/issue:discover): Discover potential issues from multiple perspectives (bug, UX, test, quality, security, performance, maintainability, best-practices)
• Prompt-based issue discovery (/issue:discover-by-prompt): Discover issues from user prompt with Gemini-planned iterative multi-agent exploration
• Structured issue creation (/issue:new): Create structured issues from GitHub URL or text description

CCW Loop Enhancements

• Validation action and orchestrator: Added validation phase support for CCW Loop workflow
• Queue status display improvements: Updated queue status display logic in renderQueueCard function

Bug Fixes

• Dashboard: Fixed showHidden state to match checkbox checked state

Full Changelog

v6.3.37...v6.3.38