Skip to content

Commit bd9ae8b

Browse files
catlog22claude
andcommitted
docs: update documentation for v5.0 release - "Less is More"
Major documentation updates reflecting v5.0 core philosophy: **Version Updates:** - Update all docs to v5.0.0 - Remove MCP code-index dependency references - Emphasize simplified, dependency-free architecture **Removed Features:** - Remove /workflow:concept-clarify command (deprecated) - Clean up all concept clarification workflow documentation **Command Corrections:** - Fix memory command names: /update-memory-* → /memory:update-* - Clarify test workflow execution pattern (generate → execute) **Dependency Clarifications:** - Replace "MCP code-index" with "ripgrep/find" in memory:load - Clarify MCP Chrome DevTools usage in UI design workflows - Update ui-design:capture to show multi-tier fallback strategy **Files Updated:** - README_CN.md - v5.0 version badge and core improvements - COMMAND_REFERENCE.md - Remove deprecated commands, update descriptions - COMMAND_SPEC.md - v5.0 version, clarify implementations - GETTING_STARTED.md - v5.0 features, fix command names - GETTING_STARTED_CN.md - v5.0 features (Chinese), fix command names - INSTALL_CN.md - v5.0 simplified installation notes 🎯 Core Philosophy: Simplify dependencies, focus on core features, improve stability with standard tools. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent da908d8 commit bd9ae8b

File tree

6 files changed

+48
-84
lines changed

6 files changed

+48
-84
lines changed

COMMAND_REFERENCE.md

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,8 @@
22

33
This document provides a comprehensive reference for all commands available in the Claude Code Workflow (CCW) system.
44

5+
> **Version 5.0 Update**: Streamlined command structure focusing on essential tools. Removed MCP code-index dependency for better stability and performance.
6+
57
## Unified CLI Commands (`/cli:*`)
68

79
These commands provide direct access to AI tools for quick analysis and interaction without initiating a full workflow.
@@ -47,7 +49,7 @@ These commands orchestrate complex, multi-phase development processes, from plan
4749
|---|---|
4850
| `/workflow:brainstorm:artifacts` | Generate role-specific guidance-specification.md dynamically based on selected roles. |
4951
| `/workflow:brainstorm:auto-parallel` | Parallel brainstorming automation with dynamic role selection and concurrent execution. |
50-
| `/workflow:brainstorm:synthesis` | Generate synthesis-specification.md from guidance-specification and role analyses with @ references using conceptual-planning-agent. |
52+
| `/workflow:brainstorm:synthesis` | Clarify and refine role analyses through intelligent Q&A and targeted updates. |
5153
| `/workflow:brainstorm:api-designer` | Generate or update api-designer/analysis.md addressing guidance-specification discussion points. |
5254
| `/workflow:brainstorm:data-architect` | Generate or update data-architect/analysis.md addressing guidance-specification discussion points. |
5355
| `/workflow:brainstorm:product-manager` | Generate or update product-manager/analysis.md addressing guidance-specification discussion points. |
@@ -62,7 +64,6 @@ These commands orchestrate complex, multi-phase development processes, from plan
6264

6365
| Command | Description |
6466
|---|---|
65-
| `/workflow:concept-clarify` | Identify underspecified areas in brainstorming artifacts through targeted clarification questions before action planning. |
6667
| `/workflow:action-plan-verify`| Perform non-destructive cross-artifact consistency and quality analysis of IMPL_PLAN.md and task.json before execution. |
6768

6869
### Test-Driven Development (TDD)
@@ -76,9 +77,9 @@ These commands orchestrate complex, multi-phase development processes, from plan
7677

7778
| Command | Description |
7879
|---|---|
79-
| `/workflow:test-gen` | Create independent test-fix workflow session by analyzing completed implementation. |
80-
| `/workflow:test-fix-gen` | Create independent test-fix workflow session from existing implementation (session or prompt-based). |
81-
| `/workflow:test-cycle-execute` | Execute test-fix workflow with dynamic task generation and iterative fix cycles. |
80+
| `/workflow:test-gen` | Generate test plan and tasks by analyzing completed implementation. Use `/workflow:execute` to run generated tasks. |
81+
| `/workflow:test-fix-gen` | Generate test-fix plan and tasks from existing implementation or prompt. Use `/workflow:execute` to run generated tasks. |
82+
| `/workflow:test-cycle-execute` | Execute test-fix workflow with dynamic task generation and iterative fix cycles. Tasks are executed by `/workflow:execute`. |
8283

8384
### UI Design Workflow
8485

COMMAND_SPEC.md

Lines changed: 11 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,15 @@
11

22
# Claude Code Workflow (CCW) - Command Specification
33

4-
**Version**: 4.6.0
5-
**Generated**: 2025年10月18日星期六
4+
**Version**: 5.0.0
5+
**Updated**: 2025年10月24日星期六
66

77
## 1. Introduction
88

99
This document provides a detailed technical specification for every command available in the Claude Code Workflow (CCW) system. It is intended for advanced users and developers who wish to understand the inner workings of CCW, customize commands, or build new workflows.
1010

11+
> **Version 5.0 Changes**: Removed MCP code-index dependency, streamlined TDD workflow with conflict resolution, and refocused brainstorming on role analysis instead of synthesis documents.
12+
1113
For a user-friendly overview, please see [COMMAND_REFERENCE.md](COMMAND_REFERENCE.md).
1214

1315
## 2. Command Categories
@@ -308,7 +310,7 @@ Commands for managing individual tasks within a workflow session.
308310
- **Agent-Driven Execution**: Fully delegates to general-purpose agent which autonomously:
309311
1. Analyzes project structure and documentation
310312
2. Extracts keywords from task description
311-
3. Discovers relevant files using MCP code-index or search tools
313+
3. Discovers relevant files using ripgrep/find search tools
312314
4. Executes Gemini/Qwen CLI for deep analysis
313315
5. Generates structured JSON content package
314316
- **Core Philosophy**: Read-only analysis, token-efficient (CLI analysis in agent), structured output
@@ -384,8 +386,8 @@ Specialized workflow for UI/UX design, from style extraction to prototype genera
384386

385387
### **/workflow:ui-design:capture**
386388
- **Syntax**: `/workflow:ui-design:capture --url-map "target:url,..." ...`
387-
- **Responsibilities**: Batch screenshot capture tool with MCP-first strategy and local fallbacks.
388-
- **Agent Calls**: None directly, uses MCP tools.
389+
- **Responsibilities**: Batch screenshot capture tool using MCP Chrome DevTools with multi-tier fallback strategy (MCP → Playwright → Chrome → Manual).
390+
- **Agent Calls**: None directly, uses MCP Chrome DevTools or browser automation as fallback.
389391
- **Example**:
390392
```bash
391393
/workflow:ui-design:capture --url-map "home:https://linear.app"
@@ -394,7 +396,7 @@ Specialized workflow for UI/UX design, from style extraction to prototype genera
394396
### **/workflow:ui-design:explore-layers**
395397
- **Syntax**: `/workflow:ui-design:explore-layers --url <url> --depth <1-5> ...`
396398
- **Responsibilities**: Performs a deep, interactive UI capture of a single URL, exploring layers from the full page down to the Shadow DOM.
397-
- **Agent Calls**: None directly, uses MCP tools.
399+
- **Agent Calls**: None directly, uses MCP Chrome DevTools for layer exploration.
398400
- **Example**:
399401
```bash
400402
/workflow:ui-design:explore-layers --url https://linear.app --depth 3
@@ -489,8 +491,9 @@ Workflows for Test-Driven Development (TDD) and post-implementation test generat
489491

490492
### **/workflow:test-cycle-execute**
491493
- **Syntax**: `/workflow:test-cycle-execute [--resume-session="session-id"] [--max-iterations=N]`
492-
- **Responsibilities**: Executes a dynamic test-fix workflow, creating intermediate fix tasks based on test results and analysis.
493-
- **Agent Calls**: `@code-developer`, `@test-fix-agent`.
494+
- **Responsibilities**: Executes a test-fix workflow by delegating to `/workflow:execute`. Generates test tasks dynamically and creates intermediate fix tasks based on test results.
495+
- **Agent Calls**: Delegates to `/workflow:execute` which invokes `@test-fix-agent` for task execution.
496+
- **Note**: This command generates tasks; actual execution is performed by `/workflow:execute`.
494497
- **Example**:
495498
```bash
496499
/workflow:test-cycle-execute --resume-session="WFS-test-user-auth"

GETTING_STARTED.md

Lines changed: 10 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,12 @@
11

22
# 🚀 Claude Code Workflow (CCW) - Getting Started Guide
33

4-
Welcome to Claude Code Workflow (CCW) v4.6.2! This guide will help you get up and running in 5 minutes and experience AI-driven automated software development with our latest workflow system optimizations.
4+
Welcome to Claude Code Workflow (CCW) v5.0! This guide will help you get up and running in 5 minutes and experience AI-driven automated software development with our streamlined, dependency-free workflow system.
55

66
**Project Repository**: [catlog22/Claude-Code-Workflow](https://github.com/catlog22/Claude-Code-Workflow)
77

8+
> **🎉 What's New in v5.0**: Less is more! We've removed external MCP dependencies and simplified workflows. CCW now uses standard tools (ripgrep/find) for better stability and performance. The brainstorming workflow focuses on role analysis for clearer planning.
9+
810
---
911

1012
## ⏱️ 5-Minute Quick Start
@@ -138,33 +140,7 @@ For complex features requiring thorough analysis, use the complete workflow: **b
138140
- Architectural decisions with significant impact
139141
- When you need thorough requirements before implementation
140142

141-
### Scenario 4: Quality Assurance - Concept Clarification
142-
143-
Before generating tasks, ensure your requirements are clear and unambiguous:
144-
145-
```bash
146-
# After brainstorming synthesis or planning analysis, verify conceptual clarity
147-
/workflow:concept-clarify
148-
149-
# The command will:
150-
# 1. Analyze artifacts for ambiguities and missing details
151-
# 2. Ask up to 5 targeted questions to resolve critical gaps
152-
# 3. Update synthesis-specification.md or ANALYSIS_RESULTS.md with clarifications
153-
# 4. Recommend whether to proceed or address outstanding issues
154-
```
155-
156-
**When to Use**:
157-
- After `/workflow:brainstorm:synthesis` (before `/workflow:plan`)
158-
- After Phase 3 of `/workflow:plan` (before task generation)
159-
- When you want to reduce planning errors and rework
160-
161-
**Benefits**:
162-
- Detects underspecified requirements early
163-
- Prevents downstream implementation errors
164-
- Ensures team alignment on critical decisions
165-
- Reduces costly rework during execution
166-
167-
### Scenario 5: Quality Assurance - Action Plan Verification
143+
### Scenario 4: Quality Assurance - Action Plan Verification
168144

169145
After planning, validate your implementation plan for consistency and completeness:
170146

@@ -302,12 +278,12 @@ Suitable for large-scale refactoring, architectural changes, or first-time CCW u
302278

303279
```bash
304280
# Rebuild entire project documentation index
305-
/update-memory-full
281+
/memory:update-full
306282

307283
# Use specific tool for indexing
308-
/update-memory-full --tool gemini # Comprehensive analysis (recommended)
309-
/update-memory-full --tool qwen # Architecture focus
310-
/update-memory-full --tool codex # Implementation details
284+
/memory:update-full --tool gemini # Comprehensive analysis (recommended)
285+
/memory:update-full --tool qwen # Architecture focus
286+
/memory:update-full --tool codex # Implementation details
311287
```
312288

313289
**When to Execute**:
@@ -347,10 +323,10 @@ Suitable for daily development, updating only modules affected by changes:
347323

348324
```bash
349325
# Update recently modified related documentation
350-
/update-memory-related
326+
/memory:update-related
351327

352328
# Specify tool for update
353-
/update-memory-related --tool gemini
329+
/memory:update-related --tool gemini
354330
```
355331

356332
**When to Execute**:

GETTING_STARTED_CN.md

Lines changed: 10 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,12 @@
11

22
# 🚀 Claude Code Workflow (CCW) - 快速上手指南
33

4-
欢迎来到 Claude Code Workflow (CCW) v4.6.2!本指南将帮助您在 5 分钟内快速入门,体验由 AI 驱动的自动化软件开发流程,以及我们最新的工作流系统优化
4+
欢迎来到 Claude Code Workflow (CCW) v5.0!本指南将帮助您在 5 分钟内快速入门,体验由 AI 驱动的自动化软件开发流程,以及我们全新的精简化、零外部依赖的工作流系统
55

66
**项目地址**[catlog22/Claude-Code-Workflow](https://github.com/catlog22/Claude-Code-Workflow)
77

8+
> **🎉 v5.0 新特性:少即是多**!我们移除了外部 MCP 依赖,简化了工作流程。CCW 现在使用标准工具(ripgrep/find)以获得更好的稳定性和性能。头脑风暴工作流专注于角色分析,使规划更加清晰。
9+
810
---
911

1012
## ⏱️ 5 分钟快速入门
@@ -138,33 +140,7 @@
138140
- 具有重大影响的架构决策
139141
- 实现前需要详尽需求分析
140142

141-
### 场景 4:质量保证 - 概念澄清
142-
143-
在生成任务之前,确保您的需求清晰且无歧义:
144-
145-
```bash
146-
# 在头脑风暴综合或规划分析后,验证概念清晰度
147-
/workflow:concept-clarify
148-
149-
# 该命令将:
150-
# 1. 分析工件中的歧义和缺失细节
151-
# 2. 提出最多 5 个针对性问题以解决关键差距
152-
# 3. 使用澄清更新 synthesis-specification.md 或 ANALYSIS_RESULTS.md
153-
# 4. 建议是继续进行还是解决未完成的问题
154-
```
155-
156-
**使用时机**
157-
-`/workflow:brainstorm:synthesis` 之后(在 `/workflow:plan` 之前)
158-
-`/workflow:plan` 的第 3 阶段之后(在任务生成之前)
159-
- 当您想减少规划错误和返工时
160-
161-
**优势**
162-
- 及早检测未明确的需求
163-
- 防止下游实现错误
164-
- 确保团队在关键决策上保持一致
165-
- 减少执行期间的昂贵返工
166-
167-
### 场景 5:质量保证 - 行动计划验证
143+
### 场景 4:质量保证 - 行动计划验证
168144

169145
规划后,验证您的实现计划的一致性和完整性:
170146

@@ -302,12 +278,12 @@ CCW 使用分层的 CLAUDE.md 文档系统维护项目上下文。定期更新
302278

303279
```bash
304280
# 重建整个项目的文档索引
305-
/update-memory-full
281+
/memory:update-full
306282

307283
# 使用特定工具进行索引
308-
/update-memory-full --tool gemini # 全面分析(推荐)
309-
/update-memory-full --tool qwen # 架构重点
310-
/update-memory-full --tool codex # 实现细节
284+
/memory:update-full --tool gemini # 全面分析(推荐)
285+
/memory:update-full --tool qwen # 架构重点
286+
/memory:update-full --tool codex # 实现细节
311287
```
312288

313289
**执行时机**
@@ -347,10 +323,10 @@ CCW 使用分层的 CLAUDE.md 文档系统维护项目上下文。定期更新
347323

348324
```bash
349325
# 更新最近修改相关的文档
350-
/update-memory-related
326+
/memory:update-related
351327

352328
# 指定工具进行更新
353-
/update-memory-related --tool gemini
329+
/memory:update-related --tool gemini
354330
```
355331

356332
**执行时机**

INSTALL_CN.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@
44

55
Claude Code Agent 工作流协调和分布式内存系统的交互式安装指南。
66

7+
> **版本 5.0:精简化安装** - 移除了外部 MCP 依赖,安装更简单、更稳定。使用标准工具(ripgrep/find)提供更好的性能和兼容性。
8+
79
## ⚡ 一键远程安装(推荐)
810

911
### 所有平台 - 远程 PowerShell 安装

README_CN.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,9 @@
22

33
<div align="center">
44

5-
[![Version](https://img.shields.io/badge/version-v4.6.2-blue.svg)](https://github.com/catlog22/Claude-Code-Workflow/releases)
5+
[![Version](https://img.shields.io/badge/version-v5.0.0-blue.svg)](https://github.com/catlog22/Claude-Code-Workflow/releases)
66
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
77
[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey.svg)]()
8-
[![MCP Tools](https://img.shields.io/badge/🔧_MCP_Tools-Experimental-orange.svg)](https://github.com/modelcontextprotocol)
98

109
**语言:** [English](README.md) | [中文](README_CN.md)
1110

@@ -15,7 +14,14 @@
1514

1615
**Claude Code Workflow (CCW)** 将 AI 开发从简单的提示词链接转变为一个强大的、上下文优先的编排系统。它通过结构化规划、确定性执行和智能多模型编排,解决了执行不确定性和误差累积的问题。
1716

18-
> **🎉 最新版本: v4.6.2** - 文档优化与 `/memory:load` 命令改进。详见 [CHANGELOG.md](CHANGELOG.md)
17+
> **🎉 版本 5.0: 少即是多**
18+
>
19+
> **核心改进**:
20+
> -**移除外部依赖** - 使用标准 ripgrep/find 替代 MCP code-index,提升稳定性
21+
> -**简化工作流** - 优化 TDD 流程,引入冲突解决机制
22+
> -**专注角色分析** - 以角色文档为核心,简化规划架构
23+
>
24+
> 详见 [CHANGELOG.md](CHANGELOG.md)
1925
2026
> 📚 **第一次使用 CCW?** 查看 [**快速上手指南**](GETTING_STARTED_CN.md) 获取新手友好的 5 分钟教程!
2127

0 commit comments

Comments
 (0)