# Changelog

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

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [6.2.0] - 2025-12-20

### 🎯 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, and implements session clustering for intelligent memory management.

本次重大版本将外部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`*

#### ✨ 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
- *Ref: `a393601`, `5e91ba6`, `7adde91`, `3428642`*

**Dashboard New Views | Dashboard新视图**
- 📄 **CLAUDE.md Manager** | 配置管理器: File tree viewer with metadata actions (`d91477a`)
- 🎯 **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 (`d5d6f1f`, `51a61be`)
- ⚙️ **MCP Manager** | MCP管理器: Configure and monitor MCP servers (`8b927f3`)
- 🪝 **Hook Manager** | Hook管理器: Manage Claude Code hooks configuration (`c7ced2b`)
- 💻 **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`)

**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`)

#### 🔄 Improvements | 改进

**Backend & Architecture | 后端与架构**
- 📘 **TypeScript Migration** | TypeScript迁移: Full backend migration from JavaScript to TypeScript | 后端代码从JavaScript完全迁移至TypeScript (`25ac862`)
- 🔌 **CCW MCP Server** | CCW MCP服务器: Native MCP server with integrated tools | 原生MCP服务器集成多种工具 (`d4e5977`)
- 📦 **Storage Manager** | 存储管理器: Centralized storage management with cleanup | 集中式存储管理与清理 (`97640a5`)
- 🗄️ **Database Migrations** | 数据库迁移: Migration framework for schema updates | 数据库模式更新迁移框架 (`0529b57`)

**Search & Indexing | 搜索与索引**
- ⚡ **Batch Symbol Fetching** | 批量符号获取: Optimized FTS with batch database queries | 优化FTS批量数据库查询 (`3428642`)
- 📏 **Complete Method Blocks** | 完整方法块: FTS returns full method/function bodies | FTS返回完整方法/函数体 (`69049e3`)
- 🔧 **Embeddings Coverage** | 嵌入覆盖率: Fixed embeddings generation to achieve 100% coverage | 修复嵌入生成达到100%覆盖 (`74a8306`)
- ⏱️ **Indexing Timeout** | 索引超时: Increased to 30 minutes for large codebases | 大型代码库超时增至30分钟 (`ae07df6`)
- 📊 **Progress Bar** | 进度条: Real-time floating progress bar for indexing operations | 索引操作实时浮动进度条 (`d5d6f1f`, `b9d068d`)

**Performance | 性能优化**
- ⚡ **I/O Caching** | I/O缓存: Optimized I/O operations with caching layer | 通过缓存层优化I/O操作 (`7e70e4c`)
- 🔄 **Vectorized Operations** | 向量化操作: Optimized search performance | 优化搜索性能 (`08dc0a0`)
- 🎯 **Positive Caching** | 正向缓存: Only cache positive tool availability results | 仅缓存工具可用的正向结果 (`1c9716e`)

#### 🐛 Bug Fixes | 问题修复

- **MCP Installation** | MCP安装: Resolved installation issues and enhanced path resolution | 解决安装问题并增强路径解析 (`b22839c`)
- **MCP Manager** | MCP管理器: Fixed 13 critical issues in MCP Manager panel | 修复MCP管理器面板13个关键问题 (`8b927f3`)
- **Session Location** | 会话位置: Fixed session management location inference | 修复会话管理位置推断 (`c16da75`)
- **Settings Protection** | 设置保护: Prevent settings.json fields from being overwritten by hooks | 防止settings.json字段被hook覆盖 (`8d542b8`)
- **CLI Exception Handling** | CLI异常处理: Refined exception handling with specific error types | 细化异常处理使用特定错误类型 (`ac9060a`)
- **Template Paths** | 模板路径: Corrected template paths for TypeScript build | 修正TypeScript构建的模板路径 (`335f5e9`)
- **Obsolete Cleanup** | 过时文件清理: Added cleanup of obsolete files during reinstallation | 重装时添加过时文件清理 (`48ac43d`)

#### 📝 Documentation | 文档

- **Comprehensive Workflows** | 工作流文档: Added CLI tools usage, coding philosophy, context requirements guides | 添加CLI工具使用、编码哲学、上下文要求指南 (`d06a3ca`)
- **Hooks Integration** | Hooks集成: Added hooks configuration documentation | 添加Hooks配置文档 (`9f6e685`)
- **Windows Platform** | Windows平台: Updated platform-specific documentation | 更新平台特定文档 (`2f0cce0`)

#### 🧹 Technical Debt | 技术债务清理

- **Architecture Simplification** | 架构简化: Replaced external MCP with native CodexLens | 将外部MCP替换为原生CodexLens
- **Codebase Modernization** | 代码库现代化: TypeScript migration for type safety | TypeScript迁移提升类型安全
- **Removed Redundancy** | 移除冗余: Cleaned up unused LLM enhancement code | 清理未使用的LLM增强代码
- **Test Coverage** | 测试覆盖: Added comprehensive tests for vector search, parsing, and migrations | 添加向量搜索、解析和迁移的全面测试

#### 📊 Statistics | 统计

- **Total Commits**: 90 commits (2025-12-11 to 2025-12-20)
- **Features**: 46 new features
- **Fixes**: 10 bug fixes
- **Refactors**: 7 code refactors
- **Performance**: 2 performance optimizations

#### 🔗 Migration Guide | 迁移指南

**CLI Commands**:
```bash
# 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**:
```bash
# Initialize index (in ccw view dashboard)
# Navigate to CodexLens Manager → Click "Create Index"

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

**Session Clustering**:
```bash
# 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
```

---

## [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
```bash
# 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-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-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**:
```bash
/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**:
```bash
# 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`)

---