From be061dd2a23c05156da7b4bd438eddcdfcced23b Mon Sep 17 00:00:00 2001 From: catlog22 Date: Fri, 27 Feb 2026 22:35:05 +0800 Subject: [PATCH] Refactor and optimize various components and files - Removed deprecated `ccw-contentPattern-optimization-summary.md` and related files. - Updated `A2UIPopupCard.tsx` to clarify comments on interaction handling. - Enhanced `QueueListColumn.tsx` and `QueuePanel.tsx` to handle potential undefined values for `config`. - Added `useEffect` in `QueuePanel.tsx` to load scheduler state on mount. - Improved `SchedulerPanel.tsx` to handle potential undefined values for `sessionPool`. - Introduced auto-initialization logic in `queueSchedulerStore.ts` to prevent multiple initialization calls. - Updated `A2UIWebSocketHandler.ts` to refine selection handling logic. - Enhanced `hooks-routes.ts` to support multi-question surfaces. - Added submit and cancel buttons in `ask-question.ts` for better user interaction. - Deleted `codex_prompt.md` and `contentPattern-library-options.md` as part of cleanup. - Removed `status-reference.md` to streamline documentation. --- .../coordinator/commands/analyze-task.md | 23 +- .../roles/coordinator/role.md | 52 +- .../coordinator/commands/analyze-task.md | 28 +- .../team-coordinate/roles/coordinator/role.md | 52 +- .../roles/coordinator/role.md | 37 +- CHANGELOG.md | 1283 ----------- COMMAND_REFERENCE.md | 233 -- CONTRIBUTING.md | 715 ------ DASHBOARD_GUIDE.md | 464 ---- FAQ.md | 781 ------- GETTING_STARTED.md | 521 ----- GETTING_STARTED_CN.md | 531 ----- INSTALL.md | 180 -- INSTALL_CN.md | 207 -- META_SKILL_SUMMARY.md | 188 -- README.md | 47 +- README_CN.md | 45 +- TASK6_SUMMARY.md | 276 --- UNIFIED_EXECUTE_SUMMARY.md | 339 --- WORKFLOW_GUIDE.md | 1721 +++++---------- WORKFLOW_GUIDE_CN.md | 1944 +++++------------ ccw-contentPattern-optimization-summary.md | 133 -- .../src/components/a2ui/A2UIPopupCard.tsx | 14 +- .../terminal-dashboard/QueueListColumn.tsx | 5 +- .../terminal-dashboard/QueuePanel.tsx | 8 +- .../terminal-dashboard/SchedulerPanel.tsx | 6 +- .../src/pages/TerminalDashboardPage.tsx | 1 + .../src/stores/queueSchedulerStore.ts | 42 +- ccw/src/core/a2ui/A2UIWebSocketHandler.ts | 31 +- ccw/src/core/routes/hooks-routes.ts | 14 +- ccw/src/tools/ask-question.ts | 27 +- codex_prompt.md | 62 - contentPattern-library-options.md | 234 -- status-reference.md | 194 -- 34 files changed, 1543 insertions(+), 8895 deletions(-) delete mode 100644 CHANGELOG.md delete mode 100644 COMMAND_REFERENCE.md delete mode 100644 CONTRIBUTING.md delete mode 100644 DASHBOARD_GUIDE.md delete mode 100644 FAQ.md delete mode 100644 GETTING_STARTED.md delete mode 100644 GETTING_STARTED_CN.md delete mode 100644 INSTALL.md delete mode 100644 INSTALL_CN.md delete mode 100644 META_SKILL_SUMMARY.md delete mode 100644 TASK6_SUMMARY.md delete mode 100644 UNIFIED_EXECUTE_SUMMARY.md delete mode 100644 ccw-contentPattern-optimization-summary.md delete mode 100644 codex_prompt.md delete mode 100644 contentPattern-library-options.md delete mode 100644 status-reference.md diff --git a/.claude/skills/team-coordinate-v2/roles/coordinator/commands/analyze-task.md b/.claude/skills/team-coordinate-v2/roles/coordinator/commands/analyze-task.md index 3ab6c4b3..137914d9 100644 --- a/.claude/skills/team-coordinate-v2/roles/coordinator/commands/analyze-task.md +++ b/.claude/skills/team-coordinate-v2/roles/coordinator/commands/analyze-task.md @@ -154,6 +154,27 @@ Write `/task-analysis.json`: } ``` +## Complexity Interpretation + +**CRITICAL**: Complexity score is for **role design optimization**, NOT for skipping team workflow. + +| Complexity | Team Structure | Coordinator Action | +|------------|----------------|-------------------| +| Low (1-2 roles) | Minimal team | Generate 1-2 role-specs, create team, spawn workers | +| Medium (2-3 roles) | Standard team | Generate role-specs, create team, spawn workers | +| High (3-5 roles) | Full team | Generate role-specs, create team, spawn workers | + +**All complexity levels use team-worker architecture**: +- Single-role tasks still spawn team-worker agent +- Coordinator NEVER executes task work directly +- Team infrastructure provides session management, message bus, fast-advance + +**Purpose of complexity score**: +- ✅ Determine optimal role count (merge vs separate) +- ✅ Guide dependency graph design +- ✅ Inform user about task scope +- ❌ NOT for deciding whether to use team workflow + ## Error Handling | Scenario | Resolution | @@ -161,4 +182,4 @@ Write `/task-analysis.json`: | No capabilities detected | Default to single `general` role with TASK prefix | | Circular dependency in graph | Break cycle at lowest-tier edge, warn | | Task description too vague | Return minimal analysis, coordinator will AskUserQuestion | -| All capabilities merge into one | Valid -- single-role execution, no team overhead | +| All capabilities merge into one | Valid -- single-role execution via team-worker | diff --git a/.claude/skills/team-coordinate-v2/roles/coordinator/role.md b/.claude/skills/team-coordinate-v2/roles/coordinator/role.md index 47982b7c..e22c00c6 100644 --- a/.claude/skills/team-coordinate-v2/roles/coordinator/role.md +++ b/.claude/skills/team-coordinate-v2/roles/coordinator/role.md @@ -33,6 +33,27 @@ Orchestrate the team-coordinate workflow: task analysis, dynamic role-spec gener --- +## Command Execution Protocol + +When coordinator needs to execute a command (analyze-task, dispatch, monitor): + +1. **Read the command file**: `roles/coordinator/commands/.md` +2. **Follow the workflow** defined in the command file (Phase 2-4 structure) +3. **Commands are inline execution guides** - NOT separate agents or subprocesses +4. **Execute synchronously** - complete the command workflow before proceeding + +Example: +``` +Phase 1 needs task analysis + -> Read roles/coordinator/commands/analyze-task.md + -> Execute Phase 2 (Context Loading) + -> Execute Phase 3 (Task Analysis) + -> Execute Phase 4 (Output) + -> Continue to Phase 2 +``` + +--- + ## Entry Router When coordinator is invoked, first detect the invocation type: @@ -44,10 +65,24 @@ When coordinator is invoked, first detect the invocation type: | Manual resume | Arguments contain "resume" or "continue" | -> handleResume | | Capability gap | Message contains "capability_gap" | -> handleAdapt | | Pipeline complete | All tasks completed, no pending/in_progress | -> handleComplete | -| New session | None of above | -> Phase 0 | +| Interrupted session | Active/paused session exists in `.workflow/.team/TC-*` | -> Phase 0 (Resume Check) | +| New session | None of above | -> Phase 1 (Task Analysis) | For callback/check/resume/adapt/complete: load `commands/monitor.md` and execute the appropriate handler, then STOP. +### Router Implementation + +1. **Load session context** (if exists): + - Scan `.workflow/.team/TC-*/team-session.json` for active/paused sessions + - If found, extract `session.roles[].name` for callback detection + +2. **Parse $ARGUMENTS** for detection keywords + +3. **Route to handler**: + - For monitor handlers: Read `commands/monitor.md`, execute matched handler section, STOP + - For Phase 0: Execute Session Resume Check below + - For Phase 1: Execute Task Analysis below + --- ## Phase 0: Session Resume Check @@ -103,6 +138,21 @@ For callback/check/resume/adapt/complete: load `commands/monitor.md` and execute **Success**: Task analyzed, capabilities detected, dependency graph built, roles designed with role-spec metadata. +**CRITICAL - Team Workflow Enforcement**: + +Regardless of complexity score or role count, coordinator MUST: +- ✅ **Always proceed to Phase 2** (generate role-specs) +- ✅ **Always create team** and spawn workers via team-worker agent +- ❌ **NEVER execute task work directly**, even for single-role low-complexity tasks +- ❌ **NEVER skip team workflow** based on complexity assessment + +**Single-role execution is still team-based** - just with one worker. The team architecture provides: +- Consistent message bus communication +- Session state management +- Artifact tracking +- Fast-advance capability +- Resume/recovery mechanisms + --- ## Phase 2: Generate Role-Specs + Initialize Session diff --git a/.claude/skills/team-coordinate/roles/coordinator/commands/analyze-task.md b/.claude/skills/team-coordinate/roles/coordinator/commands/analyze-task.md index 40dc696a..96520c71 100644 --- a/.claude/skills/team-coordinate/roles/coordinator/commands/analyze-task.md +++ b/.claude/skills/team-coordinate/roles/coordinator/commands/analyze-task.md @@ -98,7 +98,6 @@ Apply merging rules to reduce role count: |------|-----------|--------| | Absorb trivial | Capability has exactly 1 task AND no explore needed | Merge into nearest related role | | Merge overlap | Two capabilities share >50% keywords from task description | Combine into single role | -| Coordinator inline | Planner capability with 1 task, no explore | Coordinator handles inline, no separate role | | Cap at 5 | More than 5 roles after initial assignment | Merge lowest-priority pairs (priority: researcher > designer > developer > writer > analyst > planner > tester) | **Merge priority** (when two must merge, keep the higher-priority one as the role name): @@ -108,9 +107,11 @@ Apply merging rules to reduce role count: 3. writer (document generation has specific patterns) 4. designer (design has specific outputs) 5. analyst (analysis can be absorbed by reviewer pattern) -6. planner (can be absorbed by coordinator) +6. planner (planning can be merged with researcher or designer) 7. tester (can be absorbed by developer or analyst) +**IMPORTANT**: Even after merging, coordinator MUST spawn workers for all roles. Single-role tasks still use team architecture. + ## Phase 4: Output Write `/task-analysis.json`: @@ -165,6 +166,27 @@ Write `/task-analysis.json`: } ``` +## Complexity Interpretation + +**CRITICAL**: Complexity score is for **role design optimization**, NOT for skipping team workflow. + +| Complexity | Team Structure | Coordinator Action | +|------------|----------------|-------------------| +| Low (1-2 roles) | Minimal team | Generate 1-2 roles, create team, spawn workers | +| Medium (2-3 roles) | Standard team | Generate roles, create team, spawn workers | +| High (3-5 roles) | Full team | Generate roles, create team, spawn workers | + +**All complexity levels use team architecture**: +- Single-role tasks still spawn worker via Skill +- Coordinator NEVER executes task work directly +- Team infrastructure provides session management, message bus, fast-advance + +**Purpose of complexity score**: +- ✅ Determine optimal role count (merge vs separate) +- ✅ Guide dependency graph design +- ✅ Inform user about task scope +- ❌ NOT for deciding whether to use team workflow + ## Error Handling | Scenario | Resolution | @@ -172,4 +194,4 @@ Write `/task-analysis.json`: | No capabilities detected | Default to single `general` role with TASK prefix | | Circular dependency in graph | Break cycle at lowest-tier edge, warn | | Task description too vague | Return minimal analysis, coordinator will AskUserQuestion | -| All capabilities merge into one | Valid -- single-role execution, no team overhead | +| All capabilities merge into one | Valid -- single-role execution via team worker | diff --git a/.claude/skills/team-coordinate/roles/coordinator/role.md b/.claude/skills/team-coordinate/roles/coordinator/role.md index 60b71e42..aca17948 100644 --- a/.claude/skills/team-coordinate/roles/coordinator/role.md +++ b/.claude/skills/team-coordinate/roles/coordinator/role.md @@ -32,6 +32,27 @@ Orchestrate the team-coordinate workflow: task analysis, dynamic role generation --- +## Command Execution Protocol + +When coordinator needs to execute a command (analyze-task, dispatch, monitor): + +1. **Read the command file**: `roles/coordinator/commands/.md` +2. **Follow the workflow** defined in the command file (Phase 2-4 structure) +3. **Commands are inline execution guides** - NOT separate agents or subprocesses +4. **Execute synchronously** - complete the command workflow before proceeding + +Example: +``` +Phase 1 needs task analysis + -> Read roles/coordinator/commands/analyze-task.md + -> Execute Phase 2 (Context Loading) + -> Execute Phase 3 (Task Analysis) + -> Execute Phase 4 (Output) + -> Continue to Phase 2 +``` + +--- + ## Entry Router When coordinator is invoked, first detect the invocation type: @@ -42,10 +63,24 @@ When coordinator is invoked, first detect the invocation type: | Status check | Arguments contain "check" or "status" | -> handleCheck | | Manual resume | Arguments contain "resume" or "continue" | -> handleResume | | Capability gap | Message contains "capability_gap" | -> handleAdapt | -| New session | None of above | -> Phase 0 | +| Interrupted session | Active/paused session exists in `.workflow/.team/TC-*` | -> Phase 0 (Resume Check) | +| New session | None of above | -> Phase 1 (Task Analysis) | For callback/check/resume/adapt: load `commands/monitor.md` and execute the appropriate handler, then STOP. +### Router Implementation + +1. **Load session context** (if exists): + - Scan `.workflow/.team/TC-*/team-session.json` for active/paused sessions + - If found, extract `session.roles[].name` for callback detection + +2. **Parse $ARGUMENTS** for detection keywords + +3. **Route to handler**: + - For monitor handlers: Read `commands/monitor.md`, execute matched handler section, STOP + - For Phase 0: Execute Session Resume Check below + - For Phase 1: Execute Task Analysis below + --- ## Phase 0: Session Resume Check @@ -96,6 +131,21 @@ For callback/check/resume/adapt: load `commands/monitor.md` and execute the appr **Success**: Task analyzed, capabilities detected, dependency graph built, roles designed. +**CRITICAL - Team Workflow Enforcement**: + +Regardless of complexity score or role count, coordinator MUST: +- ✅ **Always proceed to Phase 2** (generate roles) +- ✅ **Always create team** and spawn workers +- ❌ **NEVER execute task work directly**, even for single-role low-complexity tasks +- ❌ **NEVER skip team workflow** based on complexity assessment + +**Single-role execution is still team-based** - just with one worker. The team architecture provides: +- Consistent message bus communication +- Session state management +- Artifact tracking +- Fast-advance capability +- Resume/recovery mechanisms + --- ## Phase 2: Generate Roles + Initialize Session diff --git a/.claude/skills/team-lifecycle-v5/roles/coordinator/role.md b/.claude/skills/team-lifecycle-v5/roles/coordinator/role.md index fc7cf139..310bc6a7 100644 --- a/.claude/skills/team-lifecycle-v5/roles/coordinator/role.md +++ b/.claude/skills/team-lifecycle-v5/roles/coordinator/role.md @@ -24,6 +24,27 @@ Orchestrate the team-lifecycle-v5 workflow: team creation, task dispatching, pro --- +## Command Execution Protocol + +When coordinator needs to execute a command (dispatch, monitor): + +1. **Read the command file**: `roles/coordinator/commands/.md` +2. **Follow the workflow** defined in the command file (Phase 2-4 structure) +3. **Commands are inline execution guides** - NOT separate agents or subprocesses +4. **Execute synchronously** - complete the command workflow before proceeding + +Example: +``` +Phase 3 needs task dispatch + -> Read roles/coordinator/commands/dispatch.md + -> Execute Phase 2 (Context Loading) + -> Execute Phase 3 (Task Chain Creation) + -> Execute Phase 4 (Validation) + -> Continue to Phase 4 +``` + +--- + ## Entry Router When coordinator is invoked, detect invocation type: @@ -33,10 +54,24 @@ When coordinator is invoked, detect invocation type: | Worker callback | Message contains `[role-name]` tag from a known worker role | -> handleCallback | | Status check | Arguments contain "check" or "status" | -> handleCheck | | Manual resume | Arguments contain "resume" or "continue" | -> handleResume | -| New session | None of the above | -> Phase 0 | +| Interrupted session | Active/paused session exists in `.workflow/.team/TLS-*` | -> Phase 0 (Resume Check) | +| New session | None of above | -> Phase 1 (Requirement Clarification) | For callback/check/resume: load `commands/monitor.md` and execute the appropriate handler, then STOP. +### Router Implementation + +1. **Load session context** (if exists): + - Scan `.workflow/.team/TLS-*/team-session.json` for active/paused sessions + - If found, extract known worker roles from session or SKILL.md Role Registry + +2. **Parse $ARGUMENTS** for detection keywords + +3. **Route to handler**: + - For monitor handlers: Read `commands/monitor.md`, execute matched handler section, STOP + - For Phase 0: Execute Session Resume Check below + - For Phase 1: Execute Requirement Clarification below + --- ## Phase 0: Session Resume Check diff --git a/CHANGELOG.md b/CHANGELOG.md deleted file mode 100644 index 388500f3..00000000 --- a/CHANGELOG.md +++ /dev/null @@ -1,1283 +0,0 @@ -# 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). - -## [7.0.0] - 2026-02-27 - -### ✨ New Features | 新功能 - -#### Major Architecture Updates | 架构重大更新 -- **Added**: team-coordinate-v2 / team-executor-v2 with team-worker agent architecture | 添加 team-coordinate-v2 / team-executor-v2，引入 team-worker 代理架构 -- **Added**: team-lifecycle-v5 with unified team-worker agent and role-spec files | 添加 team-lifecycle-v5，统一 team-worker 代理和角色规范文件 -- **Added**: Phase-based execution model (Phase 1-5 built-in, Phase 2-4 role-specific) | 添加基于阶段的执行模型（阶段1-5内置，阶段2-4角色特定） -- **Added**: Inner loop framework for processing multiple same-prefix tasks | 添加内循环框架，用于处理多个相同前缀任务 -- **Added**: Discuss and Explore subagents for multi-perspective critique and code exploration | 添加 Discuss 和 Explore 子代理，用于多视角批判和代码探索 -- **Added**: Wisdom accumulation system (learnings.md, decisions.md, conventions.md, issues.md) | 添加智慧积累系统 -- **Added**: Message bus protocol with team coordination | 添加消息总线协议和团队协调 - -#### Queue Scheduler Service | 队列调度服务 -- **Added**: Background queue execution service with API endpoints | 添加后台队列执行服务和 API 端点 -- **Added**: QueueItemExecutor for unified execution handling | 添加 QueueItemExecutor 统一执行处理 -- **Added**: CLI execution settings integration | 添加 CLI 执行设置集成 - -#### Workflow Session Commands | 工作流会话命令 -- **Added**: `workflow:session:start` command for starting new workflow sessions | 添加启动新工作流会话的命令 -- **Added**: `workflow:session:resume` command for resuming paused sessions | 添加恢复暂停会话的命令 -- **Added**: `workflow:session:complete` command for marking sessions complete | 添加标记会话完成的命令 -- **Added**: `workflow:session:sync` command with auto-sync integration | 添加会话同步命令及自动同步集成 - -#### Spec Management | 规范管理 -- **Added**: Category and scope filtering for enhanced organization | 添加分类和范围过滤以增强组织 -- **Added**: SpecContentDialog component for viewing and editing spec content | 添加规范内容对话框组件 -- **Added**: SpecDialog component for editing spec frontmatter | 添加规范前言编辑对话框组件 -- **Enhanced**: Spec management with hooks integration and settings configuration | 增强规范管理，集成钩子和设置配置 - -#### Analysis Viewer Page | 分析查看器页面 -- **Added**: Analysis viewer page with grid layout for analysis sessions | 添加分析查看器页面，采用网格布局 -- **Added**: Filtering capabilities and fullscreen mode | 添加过滤功能和全屏模式 -- **Added**: Pagination support and concurrent processing | 添加分页支持和并发处理 - -#### Terminal Dashboard | 终端仪表板 -- **Added**: Terminal Dashboard with multi-terminal grid layout | 添加多终端网格布局的终端仪表板 -- **Added**: Execution monitor panel with agent list | 添加带代理列表的执行监控面板 -- **Added**: Pane/session management with improved UX | 添加窗格/会话管理，改进用户体验 -- **Simplified**: CLI launch to dialog-only mode | 简化 CLI 启动为仅对话框模式 - -#### Orchestrator Template Editor | 编排器模板编辑器 -- **Redesigned**: Orchestrator page as template editor with terminal execution | 重新设计编排器页面为模板编辑器，支持终端执行 -- **Added**: Slash command functionality | 添加斜杠命令功能 -- **Added**: Wave-based execution with PlanEx roles | 添加基于波浪的执行和 PlanEx 角色 -- **Added**: Observability panel and LSP document caching | 添加可观测性面板和 LSP 文档缓存 - -#### Skill Hub | 技能中心 -- **Added**: Skill Hub for managing community skills | 添加管理社区技能的技能中心 -- **Added**: Skill CRUD operations with remote skill index | 添加技能 CRUD 操作和远程技能索引 -- **Added**: Standalone repository for community skills | 添加社区技能的独立仓库 - -#### CLI Multi-Provider Support | CLI 多提供商支持 -- **Added**: Multi-provider configuration for Claude, Codex, and Gemini | 添加 Claude、Codex 和 Gemini 的多提供商配置 -- **Added**: CLI config preview API for Codex and Gemini | 添加 Codex 和 Gemini 的 CLI 配置预览 API -- **Added**: Effort level configuration for Claude CLI | 添加 Claude CLI 的努力级别配置 - -#### A2UI (Agent-to-User Interface) | 代理到用户界面 -- **Enhanced**: A2UI with multi-select questions and RadioGroup component | 增强 A2UI，支持多选问题和单选组组件 -- **Added**: Markdown support and Sheet/drawer components | 添加 Markdown 支持和工作表/抽屉组件 -- **Added**: WebSocket integration for real-time communication | 添加 WebSocket 集成用于实时通信 - -#### Documentation Templates | 文档模板 -- **Added**: Templates for architecture documents, epics, product briefs, and requirements PRD | 添加架构文档、史诗、产品简介和需求 PRD 模板 -- **Added**: Roadmap generation with CLI roadmap planning agent | 添加使用 CLI 路线图规划代理生成路线图 - -### 💥 Breaking Changes | 破坏性变更 - -#### Removed Features | 移除的功能 -- **Removed**: Vanilla JS/CSS frontend - React SPA is now the sole entry point | 移除原生 JS/CSS 前端，React SPA 现为唯一入口点 -- **Removed**: Issue management skills (`issue-discover`, `issue-new`, `issue-plan`, `issue-queue`) - replaced by unified `issue-devpipeline` | 移除 issue 管理技能，由统一的 `issue-devpipeline` 替代 -- **Removed**: VSCode Bridge (`ccw-vscode-bridge`) | 移除 VSCode 桥接器 -- **Removed**: Executions tab from Issue Hub | 移除 Issue Hub 中的执行标签页 -- **Removed**: Sessions Panel from Terminal Dashboard | 移除终端仪表板中的会话面板 -- **Removed**: Obsolete commands (TDD coverage, test concept enhancement, context gathering, task generation) | 移除过时命令 -- **Removed**: Obsolete spec dimensions from schema | 移除架构模式中的过时维度 -- **Removed**: skills_lib from remote tracking | 从远程跟踪中移除 skills_lib - -#### Behavior Changes | 行为变更 -- **Changed**: Team message protocol from `team-name` to `session-id` in team_msg calls | 更改 team_msg 调用从 `team-name` 到 `session-id` -- **Changed**: Codex skill execution to serial execution, removed agent/CLI delegation | 更改 Codex 技能执行为串行执行，移除代理/CLI 委托 -- **Changed**: Session artifacts - removed redundant `issues.jsonl` and `execution-plan.json` | 更改会话构件，移除冗余文件 -- **Changed**: Workflow execute - merged 10 team commands into unified `team-lifecycle` skill | 更改工作流执行，合并 10 个团队命令到统一的 `team-lifecycle` 技能 - -### 🛠️ Improvements | 改进 - -#### Performance | 性能 -- **Improved**: LSP document caching for faster symbol lookup | 改进 LSP 文档缓存，加快符号查找 -- **Improved**: Concurrent analysis processing with parallel session handling | 改进并发分析处理，支持并行会话处理 -- **Improved**: Queue execution service with background task processing | 改进队列执行服务，支持后台任务处理 -- **Improved**: AST-based indexing for static code analysis | 改进基于 AST 的索引，用于静态代码分析 - -#### CodexLens Enhancements | CodexLens 增强 -- **Enhanced**: CodexLens frontend integration with reranker configuration UI | 增强 CodexLens 前端集成和重排序器配置 UI -- **Added**: CCW-LiteLLM installation progress overlay | 添加 CCW-LiteLLM 安装进度叠加层 -- **Added**: Staged settings for advanced configuration | 添加高级配置的分阶段设置 - -### 🔒 Security | 安全 - -#### Critical Fixes | 关键修复 -- **Fixed**: Path traversal attack prevention in session handling | 修复会话处理中的路径遍历攻击防护 -- **Fixed**: CSRF protection across all API calls with csrfFetch | 修复所有 API 调用的 CSRF 保护 -- **Added**: CSRF token fallback mechanism with regression tests | 添加 CSRF 令牌回退机制及回归测试 - -### 📚 Documentation | 文档 - -- **Added**: New architecture documentation for team-lifecycle-v5 | 添加 team-lifecycle-v5 的新架构文档 -- **Added**: Updated command references for workflow session commands | 更新工作流会话命令的命令参考 -- **Added**: Enhanced workflow guides with migration instructions | 添加带迁移说明的增强工作流指南 -- **Added**: New skill templates and examples | 添加新技能模板和示例 -- **Added**: Chinese localization for all new features | 为所有新功能添加中文本地化 - -### 🧪 Testing | 测试 - -- **Added**: Integration tests for command creation | 添加命令创建的集成测试 -- **Added**: E2E tests for Graph Explorer, History, and Orchestrator | 添加 Graph Explorer、History 和 Orchestrator 的端到端测试 -- **Added**: Regression tests for CSRF handling | 添加 CSRF 处理的回归测试 -- **Enhanced**: Test coverage across all modules | 增强所有模块的测试覆盖率 - ---- - -## [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 --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**: -```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 , -``` - -**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=".") - -# Check index status -smart_search(action="status") -``` - -**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 --merge , - -# Deduplicate similar clusters -ccw core-memory cluster --dedup -``` - -**New Hook Commands**: -```bash -# Manage Claude Code hooks -ccw hooks list -ccw hooks add -ccw hooks remove -``` - ---- - -## [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-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): -- `~/.ccw/workflows/cli-templates/prompts/analysis/` - 8 templates reorganized -- `~/.ccw/workflows/cli-templates/prompts/development/` - 5 templates reorganized -- `~/.ccw/workflows/cli-templates/prompts/planning/` - 5 templates reorganized -- `~/.ccw/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**: -- `~/.ccw/workflows/intelligent-tools-strategy.md` -- `~/.ccw/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 "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 ] [--regenerate] [--mode ] [--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 -- `~/.ccw/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`) - ---- \ No newline at end of file diff --git a/COMMAND_REFERENCE.md b/COMMAND_REFERENCE.md deleted file mode 100644 index 4784893f..00000000 --- a/COMMAND_REFERENCE.md +++ /dev/null @@ -1,233 +0,0 @@ -# Command Reference - -This document provides a comprehensive reference for all commands available in the Claude Code Workflow (CCW) system. - -> **Version 7.0.0 Update**: team-coordinate-v2/team-executor-v2/team-lifecycle-v5 architecture with unified team-worker agent, workflow session commands (start/resume/complete/sync), queue scheduler service, spec management enhancements, CLI multi-provider support, analysis viewer page, security enhancements, skill hub, terminal dashboard, orchestrator template editor, A2UI multi-select questions. - -## CLI Commands (`/cli:*`) - -| Command | Description | -|---|---| -| `/cli:cli-init`| Initialize CLI tool configurations (Gemini and Qwen) based on workspace analysis. | - -> **Note**: For analysis, planning, and bug fixing, use workflow commands (`/workflow:lite-plan`, `/workflow:lite-fix`) or semantic invocation through natural language. - -## Workflow Commands (`/workflow:*`) - -These commands orchestrate complex, multi-phase development processes, from planning to execution. - -### Session Management - -| Command | Description | -|---|---| -| `/workflow:session:start` | Discover existing sessions or start a new workflow session with intelligent session management. | -| `/workflow:session:list` | List all workflow sessions with status. | -| `/workflow:session:resume` | Resume the most recently paused workflow session. | -| `/workflow:session:complete` | Mark the active workflow session as complete and remove active flag. | -| `/workflow:session:sync` | ⚡ **NEW** Sync workflow session state to disk during execution. | -| `/workflow:session:solidify` | ⚡ **NEW** Solidify workflow session artifacts and prepare for archiving. | - -### Core Workflow - -| Command | Description | -|---|---| -| `/workflow:plan` | Orchestrate 5-phase planning workflow with quality gate, executing commands and passing context between phases. | -| `/workflow:lite-plan` | Lightweight interactive planning and execution workflow with in-memory planning, smart code exploration, cost-aware parallel execution, and 50K context protection. | -| `/workflow:lite-fix` | ⚡ **NEW** Intelligent bug diagnosis and fix workflow with adaptive severity assessment, risk-aware verification, and optional hotfix mode. | -| `/workflow:lite-execute` | Execute tasks based on in-memory plan, prompt description, or file content. | -| `/workflow:replan` | Interactive workflow replanning with session-level artifact updates and boundary clarification through guided questioning. | -| `/workflow:execute` | Coordinate agents for existing workflow tasks with automatic discovery. | -| `/workflow:resume` | Intelligent workflow session resumption with automatic progress analysis. | -| `/workflow:review` | Optional specialized review (security, architecture, docs) for completed implementation. | -| `/workflow:status` | Generate on-demand views from JSON task data. | - -### Brainstorming - -| Command | Description | -|---|---| -| `/workflow:brainstorm:artifacts` | Generate role-specific guidance-specification.md dynamically based on selected roles. | -| `/workflow:brainstorm:auto-parallel` | Parallel brainstorming automation with dynamic role selection and concurrent execution. | -| `/workflow:brainstorm:synthesis` | Clarify and refine role analyses through intelligent Q&A and targeted updates. | -| `/workflow:brainstorm:api-designer` | Generate or update api-designer/analysis.md addressing guidance-specification discussion points. | -| `/workflow:brainstorm:data-architect` | Generate or update data-architect/analysis.md addressing guidance-specification discussion points. | -| `/workflow:brainstorm:product-manager` | Generate or update product-manager/analysis.md addressing guidance-specification discussion points. | -| `/workflow:brainstorm:product-owner` | Generate or update product-owner/analysis.md addressing guidance-specification discussion points. | -| `/workflow:brainstorm:scrum-master` | Generate or update scrum-master/analysis.md addressing guidance-specification discussion points. | -| `/workflow:brainstorm:subject-matter-expert` | Generate or update subject-matter-expert/analysis.md addressing guidance-specification discussion points. | -| `/workflow:brainstorm:system-architect` | Generate or update system-architect/analysis.md addressing guidance-specification discussion points. | -| `/workflow:brainstorm:ui-designer` | Generate or update ui-designer/analysis.md addressing guidance-specification discussion points. | -| `/workflow:brainstorm:ux-expert` | Generate or update ux-expert/analysis.md addressing guidance-specification discussion points. | - -### Quality & Verification - -| Command | Description | -|---|---| -| `/workflow:plan-verify`| Perform non-destructive cross-artifact consistency and quality analysis of IMPL_PLAN.md and task.json before execution. | - -### Code Review Cycle - -| Command | Description | -|---|---| -| `/workflow:review-module-cycle` | ⚡ **NEW** Independent multi-dimensional code review for specified modules/files across 7 dimensions with hybrid parallel-iterative execution. | -| `/workflow:review-session-cycle` | ⚡ **NEW** Session-based comprehensive code review analyzing git changes across 7 dimensions with deep-dive on critical issues. | -| `/workflow:review-fix` | ⚡ **NEW** Automated fixing of code review findings with AI-powered planning, intelligent grouping, and test-driven verification. | - -### Test-Driven Development (TDD) - -| Command | Description | -|---|---| -| `/workflow:tdd-plan` | Orchestrate TDD workflow planning with Red-Green-Refactor task chains. | -| `/workflow:tdd-verify` | Verify TDD workflow compliance and generate quality report. | - -### Test Generation & Execution - -| Command | Description | -|---|---| -| `/workflow:test-gen` | Generate test plan and tasks by analyzing completed implementation. Use `/workflow:execute` to run generated tasks. | -| `/workflow:test-fix-gen` | Generate test-fix plan and tasks from existing implementation or prompt. Use `/workflow:execute` to run generated tasks. | -| `/workflow:test-cycle-execute` | Execute test-fix workflow with dynamic task generation and iterative fix cycles. Tasks are executed by `/workflow:execute`. | - -### UI Design Workflow - -| Command | Description | -|---|---| -| `/workflow:ui-design:explore-auto` | Exploratory UI design workflow with style-centric batch generation. | -| `/workflow:ui-design:imitate-auto` | High-speed multi-page UI replication with batch screenshot capture. | -| `/workflow:ui-design:capture` | Batch screenshot capture for UI design workflows using MCP or local fallback. | -| `/workflow:ui-design:explore-layers` | Interactive deep UI capture with depth-controlled layer exploration. | -| `/workflow:ui-design:style-extract` | Extract design style from reference images or text prompts using Claude's analysis. | -| `/workflow:ui-design:layout-extract` | Extract structural layout information from reference images, URLs, or text prompts. | -| `/workflow:ui-design:generate` | Assemble UI prototypes by combining layout templates with design tokens (pure assembler). | -| `/workflow:ui-design:design-sync` | Synchronize finalized design system references to brainstorming artifacts. | -| `/workflow:ui-design:animation-extract` | Extract animation and transition patterns from URLs, CSS, or interactive questioning. | - -### Internal Tools - -These commands are primarily used internally by other workflow commands but can be used manually. - -| Command | Description | -|---|---| -| `/workflow:tools:concept-enhanced` | Enhanced intelligent analysis with parallel CLI execution and design blueprint generation. | -| `/workflow:tools:conflict-resolution` | Detect and resolve conflicts between plan and existing codebase using CLI-powered analysis. | -| `/workflow:tools:context-gather` | Intelligently collect project context using universal-executor agent based on task description and package into standardized JSON. | -| `/workflow:tools:task-generate` | Generate task JSON files and IMPL_PLAN.md from analysis results with artifacts integration. | -| `/workflow:tools:task-generate-agent` | Autonomous task generation using action-planning-agent with discovery and output phases. | -| `/workflow:tools:task-generate-tdd` | Generate TDD task chains with Red-Green-Refactor dependencies. | -| `/workflow:tools:tdd-coverage-analysis` | Analyze test coverage and TDD cycle execution. | -| `/workflow:tools:test-concept-enhanced` | Analyze test requirements and generate test generation strategy using Gemini. | -| `/workflow:tools:test-context-gather` | Collect test coverage context and identify files requiring test generation. | -| `/workflow:tools:test-task-generate` | Generate test-fix task JSON with iterative test-fix-retest cycle specification. | - -## Task Commands (`/task:*`) - -Commands for managing individual tasks within a workflow session. - -| Command | Description | -|---|---| -| `/task:create` | Create implementation tasks with automatic context awareness. | -| `/task:breakdown` | Intelligent task decomposition with context-aware subtask generation. | -| `/task:execute` | Execute tasks with appropriate agents and context-aware orchestration. | -| `/task:replan` | ⚠️ **DEPRECATED** Use `/workflow:replan` instead. Legacy command for task replanning (maintained for backward compatibility). | - -## Issue Commands (`/issue:*`) - -Commands for issue discovery, planning, and execution management. - -### Issue Discovery & Creation - -| Command | Description | -|---|---| -| `/issue:discover` | ⚡ **NEW** Discover issues from codebase analysis and error patterns. | -| `/issue:discover-by-prompt` | ⚡ **NEW** Discover issues based on natural language prompt description. | -| `/issue:new` | ⚡ **NEW** Create structured issue with title, context, priority, and labels. | - -### Issue Planning & Queue - -| Command | Description | -|---|---| -| `/issue:plan` | ⚡ **NEW** Generate solution plan for specified issue with task breakdown. | -| `/issue:queue` | ⚡ **NEW** Form execution queue from planned issues and tasks. | -| `/issue:execute` | ⚡ **NEW** Execute tasks from issue queue with orchestration. | -| `/issue:convert-to-plan` | ⚡ **NEW** Convert issue to executable implementation plan. | -| `/issue:from-brainstorm` | ⚡ **NEW** Create issue from brainstorming session artifacts. | - -### Issue Management - -| Command | Description | -|---|---| -| `/issue:manage` | ⚡ **NEW** Interactive issue management with menu-driven CRUD operations. | - -> **Note**: Issue commands use the `ccw issue` CLI endpoints for data storage and retrieval. - -## Memory and Versioning Commands - -| Command | Description | -|---|---| -| `/memory:docs` | Plan documentation workflow with dynamic grouping for module trees, README, ARCHITECTURE, and HTTP API docs. | -| `/memory:docs-full-cli` | ⚡ **NEW** Generate full project documentation using CLI execution with batched agents and fallback chain. | -| `/memory:docs-related-cli` | ⚡ **NEW** Generate/update documentation for git-changed modules using CLI execution with batched agents. | -| `/memory:update-full` | Complete project-wide CLAUDE.md documentation update with layer-based execution. | -| `/memory:update-related` | Context-aware CLAUDE.md documentation updates based on recent git changes. | -| `/memory:load` | Quickly load key project context into memory based on a task description. | -| `/memory:load-skill-memory` | Activate SKILL package and intelligently load documentation based on task intent. | -| `/memory:skill-memory` | 4-phase autonomous orchestrator to generate SKILL.md with progressive loading index. | -| `/memory:code-map-memory` | 3-phase orchestrator for code analysis and Mermaid documentation generation. | -| `/memory:tech-research` | 3-phase orchestrator for tech stack research and SKILL package generation. | -| `/memory:workflow-skill-memory` | Process archived sessions to generate workflow-progress SKILL package. | -| `/version` | Display version information and check for updates. | -| `/enhance-prompt` | Context-aware prompt enhancement using session memory and codebase analysis. | - -## Team Skills - -Unified team coordination and execution skills with role-spec based architecture. - -### Core Team Skills (v5/v2) - -| Skill | Description | -|-------|-------------| -| `team-lifecycle-v5` | ⚡ **NEW** Unified team skill for full lifecycle (spec/impl/test/review) with team-worker agent architecture. Roles: analyst, writer, planner, executor, tester, reviewer, architect, fe-developer, fe-qa. | -| `team-coordinate-v2` | ⚡ **NEW** Universal team coordination with dynamic role generation. Generates role-specs at runtime and spawns team-worker agents. | -| `team-executor-v2` | ⚡ **NEW** Lightweight session execution - resumes existing team-coordinate-v2 sessions for pure execution. | - -### V4/V3 Team Skills (Maintained) - -| Skill | Description | -|-------|-------------| -| `team-lifecycle-v4` | Previous version lifecycle skill. Maintained for backward compatibility. | -| `team-lifecycle-v3` | Earlier version lifecycle skill. Maintained for backward compatibility. | -| `team-coordinate` | Original team coordinator. Use `team-coordinate-v2` for new projects. | -| `team-executor` | Original team executor. Use `team-executor-v2` for new projects. | - -### Specialized Team Skills - -| Skill | Description | -|-------|-------------| -| `team-brainstorm` | Multi-role brainstorming with role-specific analysis generation. | -| `team-issue` | Issue-driven development pipeline with discover, plan, and execute phases. | -| `team-iterdev` | Iterative development workflow with planning, implementation, and testing cycles. | -| `team-planex` | Planning and execution workflow with wave-based task management. | -| `team-frontend` | Frontend-specific development workflow with UI design and QA cycles. | -| `team-quality-assurance` | Quality assurance and testing workflow. | -| `team-roadmap-dev` | Roadmap development and management workflow. | -| `team-tech-debt` | Technical debt identification and remediation workflow. | -| `team-testing` | Comprehensive testing workflow. | -| `team-uidesign` | UI/UX design workflow with style extraction and prototyping. | -| `team-ultra-analyze` | Deep codebase analysis with multi-angle exploration. | -| `team-review` | Multi-dimensional code review workflow. | - -### Deprecated Team Skills - -| Skill | Status | Replacement | -|-------|--------|-------------| -| Various team commands (team-planex, team-iterdev, etc.) | ⚠️ **DEPRECATED** | Use `team-lifecycle-v5` for unified lifecycle management. | - -## Internal Tools (Deprecated) - -| Command | Description | -|---|---| -| `/workflow:tools:tdd-coverage-analysis` | ⚠️ **DEPRECATED** Use integrated test coverage analysis. | -| `/workflow:tools:test-concept-enhanced` | ⚠️ **DEPRECATED** Use `/workflow:test-gen` instead. | -| `/workflow:tools:context-gather` | ⚠️ **DEPRECATED** Context gathering is now integrated into main workflows. | -| `/workflow:tools:task-generate` | ⚠️ **DEPRECATED** Use `/workflow:lite-plan` or team-lifecycle task generation. | -| `/workflow:tools:task-generate-agent` | ⚠️ **DEPRECATED** Use unified task generation in workflows. | - diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md deleted file mode 100644 index c373a791..00000000 --- a/CONTRIBUTING.md +++ /dev/null @@ -1,715 +0,0 @@ -# 🤝 Contributing to Claude Code Workflow - -Thank you for your interest in contributing to Claude Code Workflow (CCW)! This document provides guidelines and instructions for contributing to the project. - ---- - -## 📋 Table of Contents - -- [Code of Conduct](#code-of-conduct) -- [Getting Started](#getting-started) -- [Development Setup](#development-setup) -- [How to Contribute](#how-to-contribute) -- [Coding Standards](#coding-standards) -- [Testing Guidelines](#testing-guidelines) -- [Documentation Guidelines](#documentation-guidelines) -- [Submitting Changes](#submitting-changes) -- [Release Process](#release-process) - ---- - -## 📜 Code of Conduct - -### Our Pledge - -We are committed to providing a welcoming and inclusive environment for all contributors, regardless of: -- Experience level -- Background -- Identity -- Perspective - -### Our Standards - -**Positive behaviors**: -- Using welcoming and inclusive language -- Being respectful of differing viewpoints -- Gracefully accepting constructive criticism -- Focusing on what is best for the community -- Showing empathy towards other community members - -**Unacceptable behaviors**: -- Trolling, insulting/derogatory comments, and personal attacks -- Public or private harassment -- Publishing others' private information without permission -- Other conduct which could reasonably be considered inappropriate - ---- - -## 🚀 Getting Started - -### Prerequisites - -Before contributing, ensure you have: - -1. **Claude Code** - The latest version installed ([Installation Guide](INSTALL.md)) -2. **Git** - For version control -3. **Text Editor** - VS Code, Vim, or your preferred editor -4. **Basic Knowledge**: - - Bash scripting - - Markdown formatting - - JSON structure - - Git workflow - -### Understanding the Codebase - -Start by reading: -1. [README.md](README.md) - Project overview -2. [ARCHITECTURE.md](ARCHITECTURE.md) - System architecture -3. [GETTING_STARTED.md](GETTING_STARTED.md) - Basic usage -4. [COMMAND_SPEC.md](COMMAND_SPEC.md) - Command specifications - ---- - -## 💻 Development Setup - -### 1. Fork and Clone - -```bash -# Fork the repository on GitHub -# Then clone your fork -git clone https://github.com/YOUR_USERNAME/Claude-Code-Workflow.git -cd Claude-Code-Workflow -``` - -### 2. Set Up Upstream Remote - -```bash -git remote add upstream https://github.com/catlog22/Claude-Code-Workflow.git -git fetch upstream -``` - -### 3. Create Development Branch - -```bash -# Update your main branch -git checkout main -git pull upstream main - -# Create feature branch -git checkout -b feature/your-feature-name -``` - -### 4. Install CCW for Testing - -```bash -# Install dependencies -npm install - -# Link your development version globally -npm link - -# Verify installation -ccw --version -``` - ---- - -## 🛠️ How to Contribute - -### Types of Contributions - -#### 1. **Bug Fixes** -- Report bugs via [GitHub Issues](https://github.com/catlog22/Claude-Code-Workflow/issues) -- Include reproduction steps -- Provide system information (OS, Claude Code version) -- Submit PR with fix - -#### 2. **New Features** -- Discuss in [GitHub Discussions](https://github.com/catlog22/Claude-Code-Workflow/discussions) -- Create feature proposal issue -- Get community feedback -- Implement after approval - -#### 3. **Documentation** -- Fix typos or clarify existing docs -- Add missing documentation -- Improve examples -- Translate to other languages - -#### 4. **New Commands** -- Follow command template structure -- Include comprehensive documentation -- Add tests for command execution -- Update COMMAND_REFERENCE.md - -#### 5. **New Agents** -- Define agent role clearly -- Specify tools required -- Provide usage examples -- Document in ARCHITECTURE.md - ---- - -## 📏 Coding Standards - -### General Principles - -Follow the project's core beliefs (from [CLAUDE.md](CLAUDE.md)): - -1. **Pursue good taste** - Eliminate edge cases for natural, elegant code -2. **Embrace extreme simplicity** - Avoid unnecessary complexity -3. **Be pragmatic** - Solve real-world problems -4. **Data structures first** - Focus on data design -5. **Never break backward compatibility** - Existing functionality is sacred -6. **Incremental progress** - Small changes that compile and pass tests -7. **Learn from existing code** - Study patterns before implementing -8. **Clear intent over clever code** - Be boring and obvious - -### Bash Script Standards - -```bash -#!/usr/bin/env bash -# Command: /workflow:example -# Description: Brief description of what this command does - -set -euo pipefail # Exit on error, undefined vars, pipe failures - -# Function definitions -function example_function() { - local param1="$1" - local param2="${2:-default}" - - # Implementation -} - -# Main execution -function main() { - # Validate inputs - # Execute logic - # Handle errors -} - -# Run main if executed directly -if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then - main "$@" -fi -``` - -### JSON Standards - -```json -{ - "id": "IMPL-1", - "title": "Task title", - "status": "pending", - "meta": { - "type": "feature", - "agent": "code-developer", - "priority": "high" - }, - "context": { - "requirements": ["Requirement 1", "Requirement 2"], - "focus_paths": ["src/module/"], - "acceptance": ["Criterion 1", "Criterion 2"] - } -} -``` - -**Rules**: -- Use 2-space indentation -- Always validate JSON syntax -- Include all required fields -- Use clear, descriptive values - -### Markdown Standards - -```markdown -# Main Title (H1) - One per document - -## Section Title (H2) - -### Subsection (H3) - -- Use bullet points for lists -- Use `code blocks` for commands -- Use **bold** for emphasis -- Use *italics* for technical terms - -```bash -# Code blocks with language specification -command --flag value -``` - -> Use blockquotes for important notes -``` - -### File Organization - -``` -.claude/ -├── agents/ # Agent definitions -│ ├── agent-name.md -├── commands/ # Slash commands -│ └── workflow/ -│ ├── workflow-plan.md -├── skills/ # Agent skills -│ └── skill-name/ -│ ├── SKILL.md -└── workflows/ # Workflow docs - ├── workflow-architecture.md -``` - ---- - -## 🧪 Testing Guidelines - -### Manual Testing - -Before submitting PR: - -1. **Test the Happy Path** - ```bash - # Test basic functionality - /your:new:command "basic input" - ``` - -2. **Test Error Handling** - ```bash - # Test with invalid input - /your:new:command "" - /your:new:command --invalid-flag - ``` - -3. **Test Edge Cases** - ```bash - # Test with special characters - /your:new:command "input with 'quotes'" - - # Test with long input - /your:new:command "very long input string..." - ``` - -### Integration Testing - -Test how your changes interact with existing commands: - -```bash -# Example workflow test -/workflow:session:start "Test Feature" -/your:new:command "test input" -/workflow:status -/workflow:session:complete -``` - -### Testing Checklist - -- [ ] Command executes without errors -- [ ] Error messages are clear and helpful -- [ ] Session state is preserved correctly -- [ ] JSON files are created with correct structure -- [ ] Memory system updates work correctly -- [ ] Works on both Linux and Windows -- [ ] Documentation is accurate - ---- - -## 📚 Documentation Guidelines - -### Command Documentation - -Every new command must include: - -#### 1. **Inline Documentation** (in command file) - -```bash -#!/usr/bin/env bash -# Command: /workflow:example -# Description: One-line description -# Usage: /workflow:example [options] -# -# Options: -# --option1 Description of option1 -# --option2 Description of option2 -# -# Examples: -# /workflow:example "basic usage" -# /workflow:example --option1 value "advanced usage" -``` - -#### 2. **COMMAND_REFERENCE.md Entry** - -Add entry to the appropriate section: - -```markdown -| `/workflow:example` | Brief description of the command. | -``` - -#### 3. **COMMAND_SPEC.md Entry** - -Add detailed specification: - -```markdown -### `/workflow:example` - -**Purpose**: Detailed description of what this command does and when to use it. - -**Parameters**: -- `arg` (required): Description of argument -- `--option1` (optional): Description of option - -**Workflow**: -1. Step 1 -2. Step 2 -3. Step 3 - -**Output**: -- Creates: Files created -- Updates: Files updated -- Returns: Return value - -**Examples**: -```bash -/workflow:example "example input" -``` - -**Related Commands**: -- `/related:command1` - Description -- `/related:command2` - Description -``` - -### Agent Documentation - -Every new agent must include: - -```markdown -# Agent Name - -## Role -Clear description of agent's responsibility and purpose. - -## Specialization -What makes this agent unique and when to use it. - -## Tools Available -- Tool 1: Usage -- Tool 2: Usage -- Tool 3: Usage - -## Invocation -How the agent is typically invoked (manually or by workflow). - -## Context Requirements -What context the agent needs to function effectively. - -## Output -What the agent produces. - -## Examples -Real usage examples. - -## Prompt -The actual agent instructions... -``` - ---- - -## 📤 Submitting Changes - -### Commit Message Guidelines - -Follow the [Conventional Commits](https://www.conventionalcommits.org/) specification: - -``` -(): - - - -