Claude-Code-Workflow/CHANGELOG.md

Changelog

All notable changes to Claude Code Workflow (CCW) will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[6.3.49] - 2026-01-28

✨ New Features | 新功能

CLI Tools & Configuration | CLI工具与配置

• Added: In-memory configuration prioritization for CLI tool selection initialization | CLI工具选择初始化的内存配置优先级
• Added: Codex CLI settings with toggle and refresh actions | Codex CLI设置的切换和刷新操作
• Added: Codex CLI enhancement settings with API integration and UI toggle | Codex CLI增强设置，包含API集成和UI切换
• Added: ccw-cli-tools skill specification with unified execution framework and configuration-driven tool selection | ccw-cli-tools技能规范，包含统一执行框架和配置驱动的工具选择
• Added: Commands management feature with API endpoints and UI integration | 命令管理功能，包含API端点和UI集成

Skills & Workflows | 技能与工作流

• Enhanced: lite-skill-generator with single file output and improved validation | lite-skill-generator单文件输出和验证增强
• Added: brainstorm-to-cycle adapter for converting brainstorm output to parallel-dev-cycle input | brainstorm-to-cycle适配器，用于将brainstorm输出转换为parallel-dev-cycle输入
• Added: brainstorm-with-file prompt for interactive brainstorming workflow | 交互式brainstorm工作流的brainstorm-with-file提示
• Added: Document consolidation, assembly, and compliance refinement phases | 文档整合、汇编和合规性细化阶段
• Added: Skill enable/disable functionality with enhanced moveDirectory rollback on failure | 技能启用/禁用功能，增强的moveDirectory失败回滚

Review & Quality | 审查与质量

• Updated: Review commands to use review-cycle-fix for automated fixing | 审查命令更新为使用review-cycle-fix进行自动修复
• Fixed: Changelog workflow references from review-fix to review-cycle-fix for consistency | 更改changelog工作流引用从review-fix到review-cycle-fix以保持一致性

Documentation & CLI Integration | 文档与CLI集成

• Added: CLI endpoints documentation and unified script template for Bash and Python | CLI端点文档和Bash/Python统一脚本模板
• Enhanced: Skill generator documentation and templates | 技能生成器文档和模板增强
• Added: Skill tuning diagnosis report for skill-generator | skill-generator的技能调优诊断报告

🔒 Security | 安全

Critical Fixes | 关键修复

• Fixed: 3 critical security vulnerabilities | 修复3个关键安全漏洞

🛠️ Improvements | 改进

Core Logic | 核心逻辑

• Refactored: Orchestrator logic with enhanced problem taxonomy | 重构编排器逻辑，增强问题分类
• Improved: Skills enable/disable operations robustness | 改进技能启用/禁用操作的健壮性

Planning & Context Management | 规划与上下文管理

• Enhanced: Workflow commands and context management | 增强工作流命令和上下文管理
• Enhanced: CLI Lite Planning Agent with mandatory quality check | 增强CLI Lite规划代理的强制性质量检查
• Added: Planning notes feature for task generation and constraint management | 规划笔记功能，用于任务生成和约束管理

Issue Management | Issue管理

• Added: convert-to-plan command to convert planning documents to issue solutions | convert-to-plan命令，将规划文档转换为问题解决方案
• Enhanced: Queue status validation with "merged" status | 队列状态验证，增加"merged"状态
• Refactored: Issue queue management to use "archived" instead of "merged" | 重构issue队列管理，使用"archived"代替"merged"

Multi-CLI Analysis | 多CLI分析

• Added: Interactive analysis workflow with documented discussions and CLI exploration | 交互式分析工作流，包含文档化讨论和CLI探索
• Added: Parent/child directory lookup for ccw cli output | ccw cli输出的父/子目录查找

📚 Documentation | 文档

• Added: Level 5 intelligent orchestration workflow guide to English version | 英文版添加Level 5智能编排工作流指南
• Added: Level 5 workflow guide with CCW Coordinator and decision flowchart | Level 5工作流指南，包含CCW协调器和决策流程图
• Added: /ccw and /ccw-coordinator as recommended commands | 添加/ccw和/ccw-coordinator作为推荐命令
• Removed: Codex Subagent usage documentation | 移除Codex Subagent使用规范文档
• Removed: CLI endpoints section from Codex Code Guidelines | 从Codex代码指南中移除CLI端点部分
• Fixed: README_CN.md交流群二维码图片扩展名 | 修复README_CN.md交流群二维码图片扩展名
• Archived: Unused test scripts and temporary documents | 归档未使用的测试脚本和临时文档

🎨 UI & Integration | UI与集成

• Refactored: CLI Config Manager and added Provider Model Routes | 重构CLI配置管理器并添加Provider模型路由

---

[6.3.29] - 2026-01-15

✨ New Features | 新功能

Multi-CLI Task & Discussion Enhancements | 多CLI任务与讨论增强

• Added: Internationalization support for multi-CLI tasks and discussion tabs | 多CLI任务和讨论标签的国际化支持
• Added: Collapsible sections for discussion and summary tabs with enhanced layout | 讨论和摘要标签的可折叠区域及增强布局
• Added: Post-Completion Expansion feature for execution commands | 执行命令的完成后扩展功能

Session & UI Improvements | 会话与UI改进

• Enhanced: Multi-CLI session handling with improved UI updates | 多CLI会话处理及UI更新优化
• Refactored: Code structure for improved readability and maintainability | 代码结构重构以提升可读性和可维护性

---

[6.3.19] - 2026-01-12

🚀 Major New Features | 主要新功能

SPLADE & Dense Reranker Search System | SPLADE 与密集重排序搜索系统

• Added: SPLADE sparse encoder implementation for precise semantic search (currently hidden, dense mode primary)
• Added: Cross-Encoder reranking with FastEmbed integration for improved result relevance
• Added: Unified reranker architecture with file watcher support
• Added: Centralized vector storage and metadata management for embeddings
• Added: Dynamic batch size calculation for embedding generation
• Added: Multiple embedding backends for cascade retrieval

CLI Tools System Overhaul | CLI 工具系统全面升级

• Added: OpenCode AI assistant support with full CLI integration
• Added: CLI Wrapper endpoints management with Dashboard UI
• Added: Smart Content Formatter for intelligent output processing
• Added: Structured Intermediate Representation (IR) for CLI output
• Added: High-availability model pool with path resolution
• Added: Custom API header support and tool type descriptions

Service Architecture | 服务架构

• Added: Core service modules: cache-manager, event-manager, preload-service
• Added: CLI state caching with preload optimization
• Added: UV package manager support for optimized installation
• Added: ccw-litellm installation improvements with venv prioritization

Issue Management | Issue 管理

• Added: Multi-queue parallel execution support
• Added: Worktree auto-detection with user choice (merge/PR/keep)
• Added: Enhanced worktree management with recovery support

🎨 Dashboard & UI Improvements | Dashboard 与 UI 改进

• Added: Workspace index status interface with real-time monitoring
• Added: Watcher status handling and control modal
• Added: CLI stream viewer with active execution synchronization
• Added: Danger protection hooks with i18n confirmation dialogs
• Added: Navigation status routes with badge aggregation

🛠️ Skills & Templates | 技能与模板

• Added: CCW orchestrator skill for workflow automation
• Added: Code analysis and LLM action templates
• Added: Autonomous actions and sequential phase templates
• Added: Swagger docs command for RESTful API documentation
• Added: Debug explore agent with 5-phase workflow and NDJSON logging

🔒 Security & Quality | 安全与质量

• Fixed: Command injection prevention with strengthened input validation
• Fixed: Path validation for CLI executor --cd parameter
• Added: E2E tests for MCP tool execution and session lifecycle
• Added: Integration tests for CodexLens UV installation

🌐 Internationalization | 国际化

• Added: Index management, incremental update translations
• Added: Environment variables and dynamic batch size i18n support

---

[6.3.11] - 2025-12-28

🔧 Issue System Enhancements | Issue系统增强

CLI Improvements | CLI改进

• Added: ccw issue update <id> --status <status> command for pure field updates
• Added: Support for --priority, --title, --description in update command
• Added: Auto-timestamp setting based on status (planned_at, queued_at, completed_at)

Issue Plan Command | Issue Plan命令

• Changed: Agent execution from sequential to parallel (max 10 concurrent)
• Added: Multi-solution user selection prompt with clear notification
• Added: Explicit binding check (solutions.length === 1) before auto-bind

Issue Queue Command | Issue Queue命令

• Fixed: Queue ID generation moved from agent to command (avoid duplicate IDs)
• Fixed: Strict output file control (exactly 2 files per execution)
• Added: Clear documentation for update vs done/queue add usage

Discovery System | Discovery系统

• Enhanced: Discovery progress reading with new schema support
• Enhanced: Discovery index reading and issue exporting

[6.3.9] - 2025-12-27

🔧 Issue System Consistency | Issue系统一致性修复

Schema Unification | Schema统一

• Upgraded: solution-schema.json to Rich Plan model with full lifecycle fields
• Added: test, regression, commit, lifecycle_status objects to task schema
• Changed: acceptance from string[] to object {criteria[], verification[]}
• Added: analysis and score fields for multi-solution evaluation
• Removed: Redundant issue-task-jsonl-schema.json and solutions-jsonl-schema.json
• Fixed: queue-schema.json field naming (queue_id → item_id)

Agent Updates | Agent更新

• Added: Multi-solution generation support based on complexity
• Added: Search tool fallback chain (ACE → smart_search → Grep → rg → Glob)
• Added: lifecycle_requirements propagation from issue to tasks
• Added: Priority mapping formula (1-5 → 0.0-1.0 semantic priority)
• Fixed: Task decomposition to match Rich Plan schema

Type Safety | 类型安全

• Added: QueueConflict and ExecutionGroup interfaces to issue.ts
• Fixed: conflicts array typing (from any[] to QueueConflict[])

[6.2.0] - 2025-12-21

🎯 Native CodexLens & Dashboard Revolution | 原生CodexLens与Dashboard革新

This major release replaces external Code Index MCP with native CodexLens, introduces multiple new Dashboard views, migrates backend to TypeScript, implements session clustering for intelligent memory management, and significantly improves memory stability with streaming embeddings generation.

本次重大版本将外部Code Index MCP替换为原生CodexLens，新增多个Dashboard视图，后端迁移至TypeScript，实现会话聚类智能记忆管理，并通过流式嵌入生成显著提升内存稳定性。

🚨 Breaking Changes | 破坏性变更

CLI Command Structure Refactor | CLI命令结构重构

• Changed: ccw cli exec --prompt "..." → ccw cli -p "..."
• 命令行执行方式简化，所有使用旧命令的脚本需要更新
• Ref: 8dd4a51

Native CodexLens Replacement | 原生CodexLens替换

• Removed: External "Code Index MCP" dependency
• Added: Native CCW CodexLens implementation with full local code intelligence
• 底层代码索引引擎完全替换，API和数据结构不向后兼容
• Ref: d4499cc, a393601

Session Clustering System | 会话聚类系统

• Replaced: Knowledge Graph memory model → Session Clustering system
• 移除知识图谱记忆模型，采用更轻量高效的会话聚类系统
• Ref: 68f9de0

LLM Enhancement Removal | LLM增强功能移除

• Removed: Experimental LLM-based prompt enhancement features
• 为简化系统聚焦核心能力，移除实验性LLM增强功能
• Ref: b702791

Graph Index Removal | 图索引功能移除

• Removed: Graph index functionality for simplified architecture
• 移除图索引功能以简化架构
• Ref: 3e9a309

✨ New Features | 新功能

Native CodexLens Platform | 原生CodexLens平台

• 🔍 Full-Text Search (FTS) | 全文搜索: SQLite-based fast keyword search with symbol extraction
• 🧠 Semantic Search | 语义搜索: Embedding-based similarity search with vector store
• 🔀 Hybrid Search | 混合搜索: RRF (Reciprocal Rank Fusion) combining FTS and semantic results
• ⚡ HNSW Index | HNSW索引: Approximate Nearest Neighbor index for significantly faster vector search
• 📊 Search Result Grouping | 结果分组: Automatic grouping by similarity score
• 🚫 Cancel & Status API | 取消与状态API: Cancel ongoing indexing and check index status (11d8187)
• Ref: a393601, 5e91ba6, 7adde91, 3428642

Dashboard New Views | Dashboard新视图

• 📄 CLAUDE.md Manager | 配置管理器: File tree viewer with metadata actions and freshness tracking (d91477a, b27d8a9)
• 🎯 Skills Manager | 技能管理器: View and manage Claude Code skills (ac43cf8)
• 🕸️ Graph Explorer | 图浏览器: Interactive code relationship visualization with Cytoscape.js (894b93e)
• 🧠 Core Memory View | 核心记忆视图: Session clustering visualization with cluster management (9f6e685)
• ❓ Help View | 帮助视图: Internationalization support with dynamic help content (154a928, 17af615)
• 📊 CodexLens Manager | CodexLens管理器: Index management with real-time progress bar and status display (d5d6f1f, 51a61be, 89b3475)
• ⚙️ MCP Manager | MCP管理器: Configure and monitor MCP servers (8b927f3)
• 🪝 Hook Manager | Hook管理器: Manage Claude Code hooks configuration with enhanced UI (c7ced2b, 7759284)
• 💻 CLI Manager | CLI管理器: CLI execution history with conversation tracking (93d3df1)

Session & CLI Enhancements | 会话与CLI增强

• 🔄 Multi-Session Resume | 多会话恢复: Resume from last session or merge multiple sessions (440314c)
• 💾 SQLite History Storage | SQLite历史存储: Persistent CLI execution history with conversation tracking (029384c)
• 🆔 Custom Execution IDs | 自定义执行ID: Support for custom IDs and multi-turn conversations (c780544)
• 📋 Task Queue Sidebar | 任务队列侧边栏: Real-time task progress with resume functionality (93d3df1)
• 🪝 Hook Commands | 钩子命令: Simplified Claude Code hooks interface with session context and notifications (210f0f1)
• 🧹 Smart Cleanup | 智能清理: Mainline detection and obsolete artifact discovery (09483c9)

Core Memory & Clustering | 核心记忆与聚类

• 📊 Session Clustering | 会话聚类: Intelligent grouping of related sessions (68f9de0)
• 🎨 Cluster Visualization | 聚类可视化: Interactive cluster display with Cytoscape.js (9f6e685)
• 🔢 Count-Based Updates | 计数更新策略: Memory update strategy based on session count (c7ced2b)
• 🗑️ Cluster Management | 聚类管理: Delete, merge, and deduplicate cluster commands (ea284d7)
• 📤 Cross-Project Export | 跨项目导出: Export core memory across projects with compact output (c12ef3e)

File & Search Improvements | 文件与搜索改进

• 📄 Line Pagination | 行分页支持: Paginated file reading for large files (6d3f10d)
• 🔍 Multi-Word Query | 多词查询: Improved smart search multi-word matching (6d3f10d)
• 🔒 Path Validation | 路径验证: Centralized MCP tool path validation for security (45f92fe)

🔄 Improvements | 改进

Backend & Architecture | 后端与架构

• 📘 TypeScript Migration | TypeScript迁移: Full backend migration from JavaScript to TypeScript (25ac862)
• 🔌 CCW MCP Server | CCW MCP服务器: Native MCP server with integrated tools (d4e5977)
• 📦 Storage Manager | 存储管理器: Centralized storage management with cleanup (97640a5)
• 🗄️ Database Migrations | 数据库迁移: Migration framework for schema updates (0529b57)
• 🔧 Exception Handling | 异常处理: Refined CLI exception handling with specific error types, removed overly broad exception catches (f492f48, fa81793)
• 📋 RelationshipType Enum | 关系类型枚举: Standardized relationship types with enum (fa81793)

Search & Indexing | 搜索与索引

• ⚡ Batch Symbol Fetching | 批量符号获取: Optimized FTS with batch database queries (3428642)
• 📏 Complete Method Blocks | 完整方法块: FTS returns full method/function bodies (69049e3)
• 🔧 Embeddings Coverage | 嵌入覆盖率: Fixed embeddings generation to achieve 100% coverage (74a8306)
• ⏱️ Indexing Timeout | 索引超时: Increased to 30 minutes for large codebases (ae07df6)
• 📊 Progress Bar | 进度条: Real-time floating progress bar for indexing operations (d5d6f1f, b9d068d)
• 🌊 Streaming Embeddings | 流式嵌入: Memory-efficient streaming generator for embeddings generation (fc4a9af)
• ⚙️ Batch Size Optimization | 批处理优化: Optimized batch processing size and memory management strategy (fa64e11)

Performance | 性能优化

• ⚡ I/O Caching | I/O缓存: Optimized I/O operations with caching layer (7e70e4c)
• 🔄 Vectorized Operations | 向量化操作: Optimized search performance (08dc0a0)
• 🎯 Positive Caching | 正向缓存: Only cache positive tool availability results (1c9716e)
• 🧠 Memory Leak Fixes | 内存泄漏修复: Multiple memory leak fixes in embeddings generation (5849f75, 6eebdb8, 3e9a309)

Dashboard & UI | Dashboard与UI

• 🎨 Navigation Styling | 导航样式: Improved sidebar hierarchy visualization and font sizing (c3a31f2, 6e30153)
• 📂 File Manager UX | 文件管理器体验: Async freshness loading with loading indicators (f1ee46e)
• 🔔 CLI Notifications | CLI通知: Timeout settings and proper process exit handling (559b1e0, c3a31f2, 15d5890)
• 📐 CSS Layout | CSS布局: Enhanced component flexibility and responsive design (6dab381)
• 📝 Text Line Limiting | 文本行限制: CSS classes for limiting text lines (15d5890)

🐛 Bug Fixes | 问题修复

• Memory Leaks | 内存泄漏: Fixed multiple memory leaks in embeddings generation process (5849f75, 6eebdb8, 3e9a309)
• Vector Progress | 向量进度: Fixed progress bar showing completion prematurely (2871950)
• Chunking Logic | 分块逻辑: Improved chunking in Chunker class (fd4a15c)
• Install Cleanup | 安装清理: Use manifest-based cleanup for clean install (fa31552, a3ccf5b)
• Semantic Status | 语义状态: Aligned semantic status check with CodexLens checkSemanticStatus (4a3ff82)
• MCP Installation | MCP安装: Resolved installation issues and enhanced path resolution (b22839c)
• MCP Manager | MCP管理器: Fixed 13 critical issues in MCP Manager panel (8b927f3)
• Session Location | 会话位置: Fixed session management location inference (c16da75)
• Settings Protection | 设置保护: Prevent settings.json fields from being overwritten by hooks (8d542b8)
• CLI Exception Handling | CLI异常处理: Refined exception handling with specific error types (ac9060a)
• Template Paths | 模板路径: Corrected template paths for TypeScript build (335f5e9)
• Obsolete Cleanup | 过时文件清理: Added cleanup of obsolete files during reinstallation (48ac43d)
• Process Exit | 进程退出: Ensure proper process exit after notifications (15d5890, c3a31f2)

📝 Documentation | 文档

• Comprehensive Workflows | 工作流文档: Added CLI tools usage, coding philosophy, context requirements guides (d06a3ca)
• Hooks Integration | Hooks集成: Added hooks configuration documentation (9f6e685)
• Windows Platform | Windows平台: Updated platform-specific documentation (2f0cce0)
• Dashboard Guides | Dashboard指南: Added dashboard operation guides (8c6225b)
• MCP Tool Descriptions | MCP工具描述: Improved tool descriptions for clarity and completeness (bfbab44, 89e77c0)
• CLAUDE.md Freshness | CLAUDE.md新鲜度: Added freshness tracking and update reminders feature (b27d8a9)

🧹 Technical Debt | 技术债务清理

• Architecture Simplification | 架构简化: Replaced external MCP with native CodexLens, removed graph index (3e9a309)
• Codebase Modernization | 代码库现代化: TypeScript migration for type safety (25ac862)
• Removed Redundancy | 移除冗余: Cleaned up unused LLM enhancement code, removed unused reindex scripts (b702791, be725ce)
• Test Coverage | 测试覆盖: Added comprehensive tests for vector search, parsing, and migrations
• Exception Handling | 异常处理: Removed overly broad exception catches in CLI (f492f48)

📊 Statistics | 统计

• Total Commits: 122 commits (2025-12-11 to 2025-12-21)
• Features: 62 new features
• Fixes: 17 bug fixes
• Refactors: 11 code refactors
• Performance: 6 performance optimizations
• Documentation: 5 documentation updates

🔗 Migration Guide | 迁移指南

CLI Commands:

# Old (deprecated)
ccw cli exec --prompt "analyze code"

# New
ccw cli -p "analyze code"

# With resume
ccw cli -p "continue analysis" --resume
ccw cli -p "merge findings" --resume <id1>,<id2>

CodexLens Index:

# Initialize index (in ccw view dashboard)
# Navigate to CodexLens Manager → Click "Create Index"

# Or via MCP tool
smart_search(action="init", path=".")

# Check index status
smart_search(action="status")

Session Clustering:

# View all clusters
ccw core-memory clusters

# Auto-create clusters from sessions
ccw core-memory cluster --auto

# Merge clusters (move sessions from source clusters to target)
ccw core-memory cluster <target-id> --merge <source-id1>,<source-id2>

# Deduplicate similar clusters
ccw core-memory cluster --dedup

New Hook Commands:

# Manage Claude Code hooks
ccw hooks list
ccw hooks add <hook-name>
ccw hooks remove <hook-name>

---

[6.1.3] - 2025-12-09

🔧 CLI Tool Simplification

This release simplifies the ccw tool exec edit_file command for better usability.

🔄 Changed

• Simplified edit_file CLI: Added parameter-based CLI input (--path, --old, --new) for easier command-line usage
• Updated tool-strategy.md: Added sed as alternative for complex line operations

Note

: The edit_file MCP tool still fully supports both line mode and edits array for programmatic use. The CLI simplification only affects the ccw tool exec command interface.

Usage

# CLI parameter mode (simplified)
ccw tool exec edit_file --path "file.txt" --old "old text" --new "new text"

# MCP tool still supports all modes
edit_file(path="f.js", mode="line", operation="insert_after", line=10, text="new line")
edit_file(path="f.js", edits=[{oldText: "a", newText: "b"}, {oldText: "c", newText: "d"}])

[6.1.2] - 2025-12-09

🔔 Dashboard Update Notification & Bug Fixes

✨ Added

• Version Update Notification: Dashboard now checks npm registry for updates and displays upgrade banner
• Version Check API: New /api/version-check endpoint with 1-hour cache

🐛 Fixed

• Hook Manager: Fixed button click event handling for edit/delete operations (changed e.target to e.currentTarget)

[5.9.6] - 2025-11-28

🚀 Review Cycle & Dashboard Enhancement

This release significantly enhances the code review capabilities with a new fix-dashboard, real-time progress tracking, and improved agent coordination.

✨ Added

• fix-dashboard.html: New independent dashboard for tracking fix progress with theme support (84b428b).
• Real-time Progress: The review-cycle dashboard now features real-time progress updates and advanced filtering for better visibility (f759338).
• Enhanced Export Notifications: Export notifications now include detailed usage instructions and recommended file locations (6467480).

🔄 Changed

• Dashboard Data Integration: fix-dashboard.html now consumes more JSON fields from the review-cycle-fix workflow for richer data display (b000359).
• Dashboard Generation: Optimized the generation process for the review cycle dashboard and merged JSON state files for efficiency (2cf8efe).
• Agent Schema Requirements: Added explicit JSON schema requirements to review cycle agent prompts to ensure structured output (34a9a23).
• Standardized Naming: Standardized "Execution Flow" phase naming across commands and removed redundant REVIEW-SUMMARY.md output (ef09914).

[5.9.5] - 2025-11-27

🎯 Test Cycle & Agent Behavior Refinement

This version focuses on improving the test-cycle execution with intelligent strategies and refining agent behavior for more reliable and predictable execution.

✨ Added

• Intelligent Iteration Strategies: Enhanced test-cycle-execute with smart iteration strategies for more effective testing (97b2247).
• Universal Test-Fix Agent: Introduced a universal @test-fix-agent invocation template for standardized bug fixing (32c9595).
• Agent Guidelines: Added new guidelines for the @test-fix-agent to avoid complex bash pipe chains and to enforce run_in_background=false for stability (edda988, a896176).

🔄 Changed

• Dashboard Access: Replaced file:// URLs with a local HTTP server for accessing dashboards to prevent browser security issues (75ad427).
• Agent Prompts: Prioritized syntax checks in the @test-fix-agent prompt for faster error detection (d99448f).
• CLI Execution Timeout: Increased the timeout for CLI execution to 10 minutes to handle long-running tasks (5375c99).
• Session Start: Added a non-interrupting execution guideline to the session start command to prevent accidental termination (2b80a02).

[5.9.4] - 2025-11-25

⚡ Lite-Fix Workflow & Multi-Angle Exploration

This release introduces the new lite-fix workflow for streamlined bug resolution and enhances the exploration capabilities of lite-plan.

✨ Added

• lite-fix Workflow: A new, intelligent workflow for bug diagnosis and resolution. Documented in WORKFLOW_DECISION_GUIDE (7453987, c8dd1ad).
• docs-related-cli Command: New command for CLI-related documentation (7453987).
• Session Artifacts: lite-fix workflow now creates a dedicated session folder with artifacts like diagnosis.json and fix-plan.json (0207677).
• review-session-cycle Command: A comprehensive command for multi-dimensional code analysis (93d8e79).
• review-cycle-fix Workflow: Automated workflow for reviewing fixes with an enhanced exploration schema (a6561a7).
• JSON Schemas: Added new JSON schemas for deep-dive results and dimension analysis to structure agent outputs (cd206f2).

🔄 Changed

• Exploration Context: Enhanced the multi-angle exploration context in lite-execute and lite-plan command outputs (4bd732c).
• cli-explore-agent: Simplified the agent with a prompt-driven architecture, making it more flexible (cf6a0f1).
• TodoWrite Format: Optimized the TodoWrite format with a hierarchical display across all workflow commands for better readability (152303f).
• Session Requirement: Review commands now require an active session and use a unified output directory structure (8f21266).

[5.9.3] - 2025-11-24

🛠️ Lite-Plan Optimization & Documentation Overhaul

This version marks a major overhaul of the lite-plan workflow, introducing parallel exploration, cost-aware execution, and a comprehensive documentation update.

✨ Added

• Exploration & Plan Schemas: Added exploration-json-schema.json and plan-json-schema.json to standardize task context and planning artifacts (19acaea, 247db0d).
• Cost-Aware Parallel Execution: lite-plan now supports execution_group in tasks, enabling cost-aware parallel execution of independent tasks (cde17bd, 697a646).
• Agent-Task Execution Rules: Enforced a one-agent-per-task-JSON rule to ensure reliable and traceable execution (20aa0f3).
• 50K Context Protection: Added a context threshold in lite-plan to automatically delegate large inputs to cli-explore-agent, preventing orchestrator overflow (96dd9be).

🔄 Changed

• lite-plan Refactor: The workflow was significantly refactored to support the new plan.json format, improving task structure and exploration angle assignment (247db0d).
• Complexity Assessment: lite-plan now uses an intelligent analysis from Claude to assess task complexity, simplifying the logic (964bbbf).
• Task Generation Rules: Updated task generation to allow for 2-7 structured tasks per plan, with refined grouping principles for better granularity (87d5a12).
• Documentation: Major updates to workflow initialization, task generation, and agent documentation to reflect new progressive loading strategies and path-based context loading (481a716, adbb207, 4bb4bdc).
• UI Design Templates: Consolidated workflow commands and added new UI design templates (f798dd4).

[5.8.1] - 2025-01-16

⚡ Lite-Plan Workflow & CLI Tools Enhancement

This release introduces a powerful new lightweight planning workflow with intelligent automation and optimized CLI tool usage.

✨ Added

Lite-Plan Workflow (/workflow:lite-plan):

• ✨ Interactive Lightweight Workflow - Fast, in-memory planning and execution
  • Phase 1: Task Analysis & Smart Exploration (30-90s)
    • Auto-detects when codebase context is needed
    • Optional @cli-explore-agent for code understanding
    • Force exploration with -e or --explore flag
  • Phase 2: Interactive Clarification (user-dependent)
    • Ask follow-up questions based on exploration findings
    • Gather missing information before planning
  • Phase 3: Adaptive Planning (20-60s)
    • Low complexity: Direct planning by Claude
    • Medium/High complexity: Delegate to @cli-planning-agent
  • Phase 4: Three-Dimensional Multi-Select Confirmation (user-dependent)
    • ✅ Task Approval: Allow / Modify / Cancel (with optional supplements)
    • 🔧 Execution Method: Agent / Provide Plan / CLI (Gemini/Qwen/Codex)
    • 🔍 Code Review: No / Claude / Gemini / Qwen / Codex
  • Phase 5: Live Execution & Tracking (5-120min)
    • Real-time TodoWrite progress updates
    • Parallel task execution for independent tasks
    • Optional post-execution code review
• ✨ Parallel Task Execution - Identifies independent tasks for concurrent execution
• ✨ Flexible Tool Selection - Preset with --tool flag or choose during confirmation
• ✨ No File Artifacts - All planning stays in memory for faster workflow

🔄 Changed

CLI Tools Optimization:

• 🔄 Simplified Command Syntax - Removed -m parameter requirement
  • Gemini: Auto-selects gemini-2.5-pro (default) or gemini-2.5-flash
  • Qwen: Auto-selects coder-model (default) or vision-model
  • Codex: Auto-selects gpt-5.1 (default), gpt-5.1-codex, or gpt-5.1-codex-mini
• 🔄 Improved Model Selection - Tools now auto-select best model for task
• 🔄 Updated Documentation - Clearer guidelines in intelligent-tools-strategy.md

Execution Workflow Enhancement:

• 🔄 Streamlined Phases - Simplified execution phases with lazy loading strategy
• 🔄 Enhanced Error Handling - Improved error messages and recovery options
• 🔄 Clarified Resume Mode - Better documentation for workflow resumption

CLI Explore Agent:

• 🎨 Improved Visibility - Changed color scheme from blue to yellow

📝 Documentation

Updated Files:

• 🔄 README.md / README_CN.md - Added Lite-Plan workflow usage examples
• 🔄 COMMAND_REFERENCE.md - Added /workflow:lite-plan entry
• 🔄 COMMAND_SPEC.md - Added detailed technical specification for Lite-Plan
• 🔄 intelligent-tools-strategy.md - Updated model selection guidelines

🐛 Bug Fixes

• Fixed command syntax inconsistencies in CLI tool documentation
• Improved task dependency detection for parallel execution

---

[5.5.0] - 2025-11-06

🎯 Interactive Command Guide & Enhanced Documentation

This release introduces a comprehensive command-guide skill with interactive help, enhanced command descriptions, and an organized 5-index command system for better discoverability and workflow guidance.

✨ Added

Command-Guide Skill:

• ✨ Interactive Help System - New command-guide skill activated by CCW-help and CCW-issue keywords
  • 🔍 Mode 1: Command Search - Find commands by keyword, category, or use-case
  • 🤖 Mode 2: Smart Recommendations - Context-aware next-step suggestions
  • 📖 Mode 3: Full Documentation - Detailed parameter info, examples, best practices
  • 🎓 Mode 4: Beginner Onboarding - Top 14 essential commands with learning path
  • 📝 Mode 5: Issue Reporting - Guided bug report and feature request templates

5-Index Command System:

• ✨ all-commands.json (30KB) - Complete catalog of 69 commands with full metadata
• ✨ by-category.json (33KB) - Hierarchical organization (workflow/cli/memory/task/general)
• ✨ by-use-case.json (32KB) - Grouped by 10 usage scenarios
• ✨ essential-commands.json (5.8KB) - Top 14 most-used commands for quick reference
• ✨ command-relationships.json (13KB) - Workflow guidance with next-steps and dependencies

Issue Templates:

• ✨ Bug Report Template - Standardized bug reporting with environment info
• ✨ Feature Request Template - Structured feature proposals with use cases
• ✨ Question Template - Help request format for user support

🔄 Changed

Command Descriptions Enhanced (69 files):

• 🔄 Detailed Functionality - All command descriptions updated from basic to comprehensive
  • Includes tools used (Gemini/Qwen/Codex)
  • Specifies agents invoked
  • Lists workflow phases
  • Documents output files
  • Mentions key flags and modes
• 🔄 Example Updates:
  • workflow:plan: "5-phase planning workflow with Gemini analysis and action-planning-agent task generation, outputs IMPL_PLAN.md and task JSONs with optional CLI auto-execution"
  • cli:execute: "Autonomous code implementation with YOLO auto-approval using Gemini/Qwen/Codex, supports task ID or description input with automatic file pattern detection"
  • memory:update-related: "Update CLAUDE.md for git-changed modules using batched agent execution (4 modules/agent) with gemini→qwen→codex fallback"

Index Organization:

• 🔄 Use-Case Categories Expanded - From 2 to 10 distinct scenarios
  • session-management, implementation, documentation, planning, ui-design, testing, brainstorming, analysis, monitoring, utilities
• 🔄 Command Relationships Comprehensive - All 69 commands mapped with:
  • calls_internally - Commands auto-invoked (built-in)
  • next_steps - User-executed next commands (sequential)
  • prerequisites - Commands to run before
  • alternatives - Similar-purpose commands

Maintenance Tools:

• 🔄 analyze_commands.py - Moved to scripts/ directory
  • Auto-generates all 5 index files from command frontmatter
  • Validates JSON syntax
  • Provides statistical reports

📝 Documentation

New Files:

• ✨ guides/index-structure.md - Complete index file schema documentation
• ✨ guides/implementation-details.md - 5-mode implementation logic
• ✨ guides/examples.md - Usage examples for all modes
• ✨ guides/getting-started.md - 5-minute quickstart guide
• ✨ guides/workflow-patterns.md - Common workflow examples
• ✨ guides/cli-tools-guide.md - Gemini/Qwen/Codex usage
• ✨ guides/troubleshooting.md - Common issues and solutions

Updated Files:

• 🔄 README.md - Added "Need Help?" section with CCW-help/CCW-issue usage
• 🔄 README_CN.md - Chinese version of help documentation
• 🔄 SKILL.md - Optimized to 179 lines (from 412, 56.6% reduction)
  • Clear 5-mode operation structure
  • Explicit CCW-help and CCW-issue triggers
  • Progressive disclosure pattern

🎯 Benefits

User Experience:

• 📦 Easier Discovery - CCW-help provides instant command search and recommendations
• 📦 Better Guidance - Smart next-step suggestions based on workflow context
• 📦 Faster Onboarding - Essential commands list gets beginners started quickly
• 📦 Simplified Reporting - CCW-issue generates proper bug/feature templates

Developer Experience:

• ⚡ Comprehensive Metadata - All 69 commands fully documented with tools, agents, phases
• ⚡ Workflow Clarity - Command relationships show built-in vs sequential execution
• ⚡ Automated Maintenance - analyze_commands.py regenerates indexes from source
• ⚡ Quality Documentation - 7 guide files cover all aspects of the system

System Organization:

• 🏗️ Structured Indexes - 5 JSON files provide multiple access patterns
• 🏗️ Clear Relationships - Distinguish built-in calls from user workflows
• 🏗️ Scalable Architecture - Easy to add new commands with auto-indexing

---

[5.4.0] - 2025-11-06

🎯 CLI Template System Reorganization

This release introduces a comprehensive reorganization of the CLI template system with priority-based naming and enhanced error handling for Gemini models.

✨ Added

Template Priority System:

• ✨ Priority-Based Naming - All templates now use priority prefixes for better organization
  • 01-* prefix: Universal, high-frequency templates (e.g., trace-code-execution, diagnose-bug-root-cause)
  • 02-* prefix: Common specialized templates (e.g., implement-feature, analyze-code-patterns)
  • 03-* prefix: Domain-specific, less frequent templates (e.g., assess-security-risks, debug-runtime-issues)
• ✨ 19 Templates Reorganized - Complete template system restructure across 4 directories
  • analysis/ (8 templates): Code analysis, bug diagnosis, architecture review, security assessment
  • development/ (5 templates): Feature implementation, refactoring, testing, UI components
  • planning/ (5 templates): Architecture design, task breakdown, component specs, migration
  • memory/ (1 template): Module documentation
• ✨ Template Selection Guidance - Choose templates based on task needs, not sequence numbers

Error Handling Enhancement:

• ✨ Gemini 404 Fallback Strategy - Automatic model fallback for improved reliability
  • If gemini-3-pro-preview-11-2025 returns 404 error, automatically fallback to gemini-2.5-pro
  • Comprehensive error handling documentation for HTTP 429 and HTTP 404 errors
  • Added to both Model Selection and Tool Specifications sections

🔄 Changed

Template File Reorganization (19 files):

Analysis Templates:

• code-execution-tracing.txt → 01-trace-code-execution.txt
• bug-diagnosis.txt → 01-diagnose-bug-root-cause.txt (moved from development/)
• pattern.txt → 02-analyze-code-patterns.txt
• architecture.txt → 02-review-architecture.txt
• code-review.txt → 02-review-code-quality.txt (moved from review/)
• performance.txt → 03-analyze-performance.txt
• security.txt → 03-assess-security-risks.txt
• quality.txt → 03-review-quality-standards.txt

Development Templates:

• feature.txt → 02-implement-feature.txt
• refactor.txt → 02-refactor-codebase.txt
• testing.txt → 02-generate-tests.txt
• component.txt → 02-implement-component-ui.txt
• debugging.txt → 03-debug-runtime-issues.txt

Planning Templates:

• architecture-planning.txt → 01-plan-architecture-design.txt
• task-breakdown.txt → 02-breakdown-task-steps.txt
• component.txt → 02-design-component-spec.txt (moved from implementation/)
• concept-eval.txt → 03-evaluate-concept-feasibility.txt
• migration.txt → 03-plan-migration-strategy.txt

Memory Templates:

• claude-module-unified.txt → 02-document-module-structure.txt

Directory Structure Optimization:

• 🔄 Bug Diagnosis Reclassified - Moved from development/ to analysis/ (diagnostic work, not implementation)
• 🔄 Removed Redundant Directories - Eliminated implementation/ and review/ folders
• 🔄 Unified Path References - All command files now use full path format

Command File Updates (21 references across 5 files):

• cli/mode/bug-diagnosis.md - 6 template references updated
• cli/mode/code-analysis.md - 6 template references updated
• cli/mode/plan.md - 6 template references updated
• task/execute.md - 1 template reference updated
• workflow/tools/test-task-generate.md - 2 template references updated

📝 Documentation

Updated Files:

• 🔄 intelligent-tools-strategy.md - Complete template system guide with new naming convention
  • Updated Available Templates section with all new template names
  • Enhanced Task-Template Matrix with priority-based organization
  • Added Gemini error handling documentation (404 and 429)
  • Removed star symbols (⭐) - redundant with priority numbers
• ✨ command-template-update-summary.md - New file documenting all template reference changes

🎯 Benefits

Template System Improvements:

• 📦 Better Discoverability - Priority prefixes make it easy to find appropriate templates
• 📦 Clearer Organization - Templates grouped by usage frequency and specialization
• 📦 Consistent Naming - Descriptive names following [Priority]-[Action]-[Object]-[Context].txt pattern
• 📦 No Breaking Changes - All command references updated, backward compatible

Error Handling Enhancements:

• ⚡ Improved Reliability - Automatic fallback prevents workflow interruption
• ⚡ Better Documentation - Clear guidance for both HTTP 429 and 404 errors
• ⚡ User-Friendly - Transparent error handling without manual intervention

Workflow Integration:

• 🔗 All 5 command files seamlessly updated with new template paths
• 🔗 Full path references ensure clarity and maintainability
• 🔗 No user action required - all updates applied systematically

📦 Modified Files

Templates (19 renames, 2 directory removals):

• .claude/workflows/cli-templates/prompts/analysis/ - 8 templates reorganized
• .claude/workflows/cli-templates/prompts/development/ - 5 templates reorganized
• .claude/workflows/cli-templates/prompts/planning/ - 5 templates reorganized
• .claude/workflows/cli-templates/prompts/memory/ - 1 template reorganized
• Removed: implementation/, review/ directories

Commands (5 files, 21 references):

• .claude/commands/cli/mode/bug-diagnosis.md
• .claude/commands/cli/mode/code-analysis.md
• .claude/commands/cli/mode/plan.md
• .claude/commands/task/execute.md
• .claude/commands/workflow/tools/test-task-generate.md

Documentation:

• .claude/workflows/intelligent-tools-strategy.md
• .claude/workflows/command-template-update-summary.md (new)

🔗 Upgrade Notes

No User Action Required:

• All template references automatically updated
• Commands work with new template paths
• No breaking changes to existing workflows

Template Selection:

• Use priority prefix as a guide, not a requirement
• Choose templates based on your specific task needs
• Number indicates category and frequency, not usage order

Error Handling:

• Gemini 404 errors now automatically fallback to gemini-2.5-pro
• HTTP 429 errors continue with existing handling (check results existence)

---

[5.2.2] - 2025-11-03

✨ Added

/memory:skill-memory Intelligent Skip Logic:

• ✨ Smart Documentation Generation - Automatically detects existing documentation and skips regeneration
  • If docs exist AND no --regenerate flag: Skip Phase 2 (planning) and Phase 3 (generation)
  • Jump directly to Phase 4 (SKILL.md index generation) for fast SKILL updates
  • If docs exist AND --regenerate flag: Delete existing docs and regenerate from scratch
  • If no docs exist: Run full 4-phase workflow
• ✨ Phase 4 Always Executes - SKILL.md index is never skipped, always generated or updated
  • Ensures SKILL index stays synchronized with documentation structure
  • Lightweight operation suitable for frequent execution
• ✨ Skip Path Documentation - Added comprehensive TodoWrite patterns for both execution paths
  • Full Path: All 4 phases (no existing docs or --regenerate specified)
  • Skip Path: Phase 1 → Phase 4 (existing docs found, no --regenerate)
  • Auto-Continue flow diagrams for both paths

🔄 Changed

Parameter Naming Correction:

• 🔄 --regenerate Flag - Reverted --update back to --regenerate in /memory:skill-memory
  • More accurate naming: "regenerate" means delete and recreate (destructive)
  • "update" was misleading as it implied incremental update (not implemented)
  • Fixed naming consistency across all documentation and examples

Phase 1 Enhancement:

• 🔄 Step 4: Determine Execution Path - Added decision logic to Phase 1
  • Checks existing documentation count
  • Evaluates --regenerate flag presence
  • Sets SKIP_DOCS_GENERATION flag based on conditions
  • Displays appropriate skip or regeneration messages

🎯 Benefits

Performance Optimization:

• ⚡ Faster SKILL Updates - Skip documentation generation when docs already exist (~5-10x faster)
• ⚡ Always Fresh Index - SKILL.md regenerated every time to reflect current documentation structure
• ⚡ Conditional Regeneration - Explicit --regenerate flag for full documentation refresh

Workflow Efficiency:

• 🔗 Smart detection reduces unnecessary documentation regeneration
• 🔗 Clear separation between SKILL index updates and documentation generation
• 🔗 Explicit control via --regenerate flag when full refresh needed

📦 Modified Files

• .claude/commands/memory/skill-memory.md - Added skip logic, reverted parameter naming, comprehensive execution path documentation

---

[5.2.1] - 2025-11-03

🔄 Changed

/memory:load-skill-memory Command Redesign:

• 🔄 Manual Activation - Changed from automatic SKILL discovery to manual activation tool
  • User explicitly specifies SKILL name: /memory:load-skill-memory <skill_name> "intent"
  • Removed complex 3-tier matching algorithm (path/keyword/action scoring)
  • Complements automatic SKILL triggering system (use when auto-activation doesn't occur)
• 🔄 Intent-Driven Documentation Loading - Intelligently loads docs based on task description
  • Quick Understanding: "了解" → README.md (~2K)
  • Module Analysis: "分析XXX模块" → Module README+API (~5K)
  • Architecture Review: "架构" → README+ARCHITECTURE (~10K)
  • Implementation: "修改", "增强" → Module+EXAMPLES (~15K)
  • Comprehensive: "完整", "深入" → All docs (~40K)
• 🔄 Memory-Based Validation - Removed bash validation, uses conversation memory to check SKILL existence
• 🔄 Simplified Structure - Reduced from 355 lines to 132 lines (-62.8%)
  • Single representative example instead of 4 examples
  • Generic use case (OAuth authentication) instead of domain-specific examples
  • Removed verbose error handling, integration notes, and confirmation outputs

Context Search Strategy Enhancement:

• ✨ SKILL Packages First Priority - Added to Core Search Tools with highest priority
  • Fastest way to understand projects - use BEFORE Gemini analysis
  • Intelligent activation via Skill() tool with automatic discovery
  • Emphasized in Tool Selection Matrix and Quick Command Reference

Parameter Naming Consistency:

• 🔄 --update Flag - Renamed --regenerate to --update in /memory:skill-memory
  • Consistent naming convention across documentation commands
  • Updated all references and examples

🎯 Benefits

Improved SKILL Workflow:

• ⚡ Clearer Purpose - Distinction between automatic (normal) and manual (override) SKILL activation
• ⚡ Token Optimization - Loads only relevant documentation scope based on intent
• ⚡ Better Discoverability - SKILL packages now prominently featured as first-priority search tool
• ⚡ Simpler Execution - Removed unnecessary validation steps, relies on memory

[5.2.0] - 2025-11-03

🎉 New Command: /memory:skill-memory - SKILL Package Generator

This release introduces a powerful new command that automatically generates progressive-loading SKILL packages from project documentation with intelligent orchestration and path mirroring.

✅ Added

New /memory:skill-memory Command:

• ✨ 4-Phase Orchestrator - Automated workflow from documentation to SKILL package
  • Phase 1: Parse arguments and prepare environment
  • Phase 2: Call /memory:docs to plan documentation
  • Phase 3: Call /workflow:execute to generate documentation
  • Phase 4: Generate SKILL.md index with progressive loading
• ✨ Auto-Continue Mechanism - All phases run autonomously via TodoList tracking
• ✨ Path Mirroring - SKILL knowledge structure mirrors source code hierarchy
• ✨ Progressive Loading - 4-level token-budgeted documentation access
  • Level 0: Quick Start (~2K tokens) - README only
  • Level 1: Core Modules (~8K tokens) - Module READMEs
  • Level 2: Complete (~25K tokens) - All modules + Architecture
  • Level 3: Deep Dive (~40K tokens) - Everything + Examples
• ✨ Intelligent Description Generation - Auto-extracts capabilities and triggers from documentation
• ✨ Regeneration Support - --regenerate flag to force fresh documentation
• ✨ Multi-Tool Support - Supports gemini, qwen, and codex for documentation generation

Command Parameters:

/memory:skill-memory [path] [--tool <gemini|qwen|codex>] [--regenerate] [--mode <full|partial>] [--cli-execute]

Path Mirroring Strategy:

Source: my_app/src/modules/auth/
  ↓
Docs: .workflow/docs/my_app/src/modules/auth/API.md
  ↓
SKILL: .claude/skills/my_app/knowledge/src/modules/auth/API.md

4-Phase Workflow:

1. Prepare: Parse arguments, check existing docs, handle --regenerate
2. Plan: Call /memory:docs to create documentation tasks
3. Execute: Call /workflow:execute to generate documentation files
4. Index: Generate SKILL.md with progressive loading structure

SKILL Package Output:

• .claude/skills/{project_name}/SKILL.md - Index with progressive loading levels
• .claude/skills/{project_name}/knowledge/ - Mirrored documentation structure
• Automatic capability detection and trigger phrase generation

📝 Changed

Enhanced /memory:docs Command:

• 🔄 Smart Task Grouping - ≤7 documents per task (up from 5)
• 🔄 Context Sharing - Prefer grouping 2 top-level directories for shared Gemini analysis
• 🔄 Batch Processing - Reduced task count through intelligent grouping
• 🔄 Dual Execution Modes - Agent Mode (default) and CLI Mode (--cli-execute)
• 🔄 Pre-computed Analysis - Phase 2 unified analysis eliminates redundant CLI calls
• 🔄 Conflict Resolution - Automatic splitting when exceeding document limit

Documentation Workflow Improvements:

• 🔄 CLI Execute Support - Direct documentation generation via CLI tools (gemini/qwen/codex)
• 🔄 workflow-session.json - Unified session metadata storage
• 🔄 Improved Structure Quality - Enhanced documentation generation guidelines

🎯 Benefits

SKILL Package Features:

• 📦 Progressive Loading - Load only what you need (2K → 40K tokens)
• 📦 Path Mirroring - Easy navigation matching source structure
• 📦 Auto-Discovery - Intelligent capability and trigger detection
• 📦 Regeneration - Force fresh docs with single flag
• 📦 Zero Manual Steps - Fully automated 4-phase workflow

Performance Optimization:

• ⚡ Parallel Processing - Multiple directory groups execute concurrently
• ⚡ Context Sharing - Single Gemini call per task group (2 directories)
• ⚡ Efficient Analysis - One-time analysis in Phase 2, reused by all tasks
• ⚡ Predictable Sizing - ≤7 docs per task ensures reliable completion
• ⚡ Failure Isolation - Task-level failures don't block entire workflow

Workflow Integration:

• 🔗 Seamless integration with existing /memory:docs command
• 🔗 Compatible with /workflow:execute system
• 🔗 Auto-continue mechanism eliminates manual steps
• 🔗 TodoList progress tracking throughout workflow

📦 New/Modified Files

New:

• .claude/commands/memory/skill-memory.md - Complete command specification (822 lines)

Modified:

• .claude/commands/memory/docs.md - Enhanced with batch processing and smart grouping
• .claude/agents/doc-generator.md - Mode-aware execution support

🔗 Usage Examples

Basic Usage:

# Generate SKILL package for current project
/memory:skill-memory

# Specify target directory
/memory:skill-memory /path/to/project

# Force regeneration with Qwen
/memory:skill-memory --tool qwen --regenerate

# Partial mode (modules only)
/memory:skill-memory --mode partial

# CLI execution mode
/memory:skill-memory --cli-execute

Output:

✅ SKILL Package Generation Complete

Project: my_project
Documentation: .workflow/docs/my_project/ (15 files)
SKILL Index: .claude/skills/my_project/SKILL.md

Generated:
- 4 documentation tasks completed
- SKILL.md with progressive loading (4 levels)
- Module index with 8 modules

Usage:
- Load Level 0: Quick project overview (~2K tokens)
- Load Level 1: Core modules (~8K tokens)
- Load Level 2: Complete docs (~25K tokens)
- Load Level 3: Everything (~40K tokens)

---

[5.1.0] - 2025-10-27

🔄 Agent Architecture Consolidation

This release consolidates the agent architecture and enhances workflow commands for better reliability and clarity.

✅ Added

Agent System:

• ✅ Universal Executor Agent - New consolidated agent replacing general-purpose agent
• ✅ Enhanced agent specialization - Better separation of concerns across agent types

Workflow Improvements:

• ✅ Advanced context filtering - Context-gather command now supports more sophisticated validation
• ✅ Session state management - Enhanced session completion with better cleanup logic

📝 Changed

Agent Architecture:

• 🔄 Removed general-purpose agent - Consolidated into universal-executor for clarity
• 🔄 Improved agent naming - More descriptive agent names matching their specific roles

Command Enhancements:

• 🔄 /workflow:session:complete - Better state management and cleanup procedures
• 🔄 /workflow:tools:context-gather - Enhanced filtering and validation capabilities

🗂️ Maintenance

Code Organization:

• 📦 Archived legacy templates - Moved outdated prompt templates to archive folder
• 📦 Documentation cleanup - Improved consistency across workflow documentation

📦 Updated Files

• .claude/agents/universal-executor.md - New consolidated agent definition
• .claude/commands/workflow/session/complete.md - Enhanced session management
• .claude/commands/workflow/tools/context-gather.md - Improved context filtering
• .claude/workflows/cli-templates/prompts/archive/ - Legacy template archive

---

[5.0.0] - 2025-10-24

🎉 Less is More - Simplified Architecture Release

This major release embraces the "less is more" philosophy, removing external dependencies, streamlining workflows, and focusing on core functionality with standard, proven tools.

🚀 Breaking Changes

Removed Features:

• ❌ /workflow:concept-clarify - Concept enhancement feature removed for simplification
• ❌ MCP code-index dependency - Replaced with standard ripgrep and find tools
• ❌ synthesis-specification.md workflow - Replaced with direct role analysis approach

Command Changes:

• ⚠️ Memory commands renamed for consistency:
  • /update-memory-full → /memory:update-full
  • /update-memory-related → /memory:update-related

✅ Added

Standard Tool Integration:

• ✅ ripgrep (rg) - Fast content search replacing MCP code-index
• ✅ find - Native filesystem discovery for better cross-platform compatibility
• ✅ Multi-tier fallback - Graceful degradation when advanced tools unavailable

Enhanced TDD Workflow:

• ✅ Conflict resolution mechanism - Better handling of test-implementation conflicts
• ✅ Improved task generation - Enhanced phase coordination and quality gates
• ✅ Updated workflow phases - Clearer separation of concerns

Role-Based Planning:

• ✅ Direct role analysis - Simplified brainstorming focused on role documents
• ✅ Removed synthesis layer - Less abstraction, clearer intent
• ✅ Better documentation flow - From role analysis directly to action planning

📝 Changed

Documentation Updates:

• ✅ All docs updated to v5.0.0 - Consistent versioning across all files
• ✅ Removed MCP badge - No longer advertising experimental MCP features
• ✅ Clarified test workflows - Better explanation of generate → execute pattern
• ✅ Fixed command references - Corrected all memory command names
• ✅ Updated UI design notes - Clarified MCP Chrome DevTools retention for UI workflows

File Discovery:

• ✅ /memory:load - Now uses ripgrep/find instead of MCP code-index
• ✅ Faster search - Native tools provide better performance
• ✅ Better reliability - No external service dependencies

UI Design Workflows:

• ℹ️ MCP Chrome DevTools retained - Specialized tool for browser automation
• ℹ️ Multi-tier fallback - MCP → Playwright → Chrome → Manual
• ℹ️ Purpose-built integration - UI workflows require browser control

🐛 Fixed

Documentation Inconsistencies:

• 🔧 Removed references to deprecated /workflow:concept-clarify command
• 🔧 Fixed incorrect memory command names in getting started guides
• 🔧 Clarified test workflow execution patterns
• 🔧 Updated MCP dependency references throughout specs
• 🔧 Corrected UI design tool descriptions

📦 Updated Files

• README.md / README_CN.md - v5.0 version badge and core improvements
• COMMAND_REFERENCE.md - Updated command descriptions, removed deprecated commands
• COMMAND_SPEC.md - v5.0 technical specifications, clarified implementations
• GETTING_STARTED.md / GETTING_STARTED_CN.md - v5.0 features, fixed command names
• INSTALL_CN.md - v5.0 simplified installation notes

🔍 Technical Details

Performance Improvements:

• Faster file discovery using native ripgrep
• Reduced external dependencies improves installation reliability
• Better cross-platform compatibility with standard Unix tools

Architectural Benefits:

• Simpler dependency tree
• Easier troubleshooting with standard tools
• More predictable behavior without external services

Migration Notes:

• Update memory command usage (see command changes above)
• Remove any usage of /workflow:concept-clarify
• No changes needed for core workflow commands (/workflow:plan, /workflow:execute)

---