From 661cb5be1c2ef6968fc88a10303886704715597d Mon Sep 17 00:00:00 2001 From: catlog22 Date: Thu, 2 Oct 2025 22:10:01 +0800 Subject: [PATCH] chore: Bump version to v3.2.1 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Update version badges in README.md, README_CN.md, PROJECT_INTRODUCTION.md - Add RELEASE_NOTES_v3.2.1.md with detailed documentation fix changelog - Document workflow-session.json path corrections ๐Ÿค– Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- PROJECT_INTRODUCTION.md | 2 +- README.md | 2 +- README_CN.md | 2 +- RELEASE_NOTES_v3.2.1.md | 142 ++++++++++++++++++++++++++++++++++++++++ 4 files changed, 145 insertions(+), 3 deletions(-) create mode 100644 RELEASE_NOTES_v3.2.1.md diff --git a/PROJECT_INTRODUCTION.md b/PROJECT_INTRODUCTION.md index a2752998..b1d2eeb6 100644 --- a/PROJECT_INTRODUCTION.md +++ b/PROJECT_INTRODUCTION.md @@ -1,6 +1,6 @@ # ๐Ÿš€ Claude Code Workflow (CCW): ไธ‹ไธ€ไปฃๅคšๆ™บ่ƒฝไฝ“่ฝฏไปถๅผ€ๅ‘่‡ชๅŠจๅŒ–ๆก†ๆžถ -[![Version](https://img.shields.io/badge/version-v2.1.0--experimental-blue.svg)](https://github.com/catlog22/Claude-Code-Workflow/releases) +[![Version](https://img.shields.io/badge/version-v3.2.1-blue.svg)](https://github.com/catlog22/Claude-Code-Workflow/releases) [![MCPๅทฅๅ…ท](https://img.shields.io/badge/๐Ÿ”ง_MCPๅทฅๅ…ท-ๅฎž้ชŒๆ€ง-orange.svg)](https://github.com/modelcontextprotocol) [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE) diff --git a/README.md b/README.md index dce51c0f..e987f010 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@
-[![Version](https://img.shields.io/badge/version-v3.2.0-blue.svg)](https://github.com/catlog22/Claude-Code-Workflow/releases) +[![Version](https://img.shields.io/badge/version-v3.2.1-blue.svg)](https://github.com/catlog22/Claude-Code-Workflow/releases) [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE) [![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey.svg)]() [![MCP Tools](https://img.shields.io/badge/๐Ÿ”ง_MCP_Tools-Experimental-orange.svg)](https://github.com/modelcontextprotocol) diff --git a/README_CN.md b/README_CN.md index ceab865d..06c82cc7 100644 --- a/README_CN.md +++ b/README_CN.md @@ -2,7 +2,7 @@
-[![Version](https://img.shields.io/badge/version-v3.2.0-blue.svg)](https://github.com/catlog22/Claude-Code-Workflow/releases) +[![Version](https://img.shields.io/badge/version-v3.2.1-blue.svg)](https://github.com/catlog22/Claude-Code-Workflow/releases) [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE) [![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey.svg)]() [![MCPๅทฅๅ…ท](https://img.shields.io/badge/๐Ÿ”ง_MCPๅทฅๅ…ท-ๅฎž้ชŒๆ€ง-orange.svg)](https://github.com/modelcontextprotocol) diff --git a/RELEASE_NOTES_v3.2.1.md b/RELEASE_NOTES_v3.2.1.md new file mode 100644 index 00000000..651b07f1 --- /dev/null +++ b/RELEASE_NOTES_v3.2.1.md @@ -0,0 +1,142 @@ +# ๐Ÿ”ง Claude Code Workflow (CCW) v3.2.1 Release Notes + +**Release Date**: October 2, 2025 +**Release Type**: Patch Release - Documentation Fix +**Repository**: https://github.com/catlog22/Claude-Code-Workflow + +--- + +## ๐Ÿ“‹ Overview + +CCW v3.2.1 is a critical documentation fix release that corrects `workflow-session.json` path references throughout the brainstorming workflow documentation. This ensures consistency with the architecture specification defined in `workflow-architecture.md`. + +--- + +## ๐Ÿ› Bug Fixes + +### **Documentation Path Corrections** + +**Issue**: Documentation incorrectly referenced `workflow-session.json` inside the `.brainstorming/` subdirectory + +**Impact**: +- Confusing path references in 9 brainstorming role documentation files +- Inconsistency with architectural specifications +- Potential runtime errors when commands attempt to read session metadata + +**Fixed Files** (9 total): +1. โœ… `data-architect.md` +2. โœ… `product-manager.md` +3. โœ… `product-owner.md` +4. โœ… `scrum-master.md` +5. โœ… `subject-matter-expert.md` +6. โœ… `ui-designer.md` +7. โœ… `ux-expert.md` +8. โœ… `auto-parallel.md` +9. โœ… `artifacts.md` + +**Corrections Applied**: +- โŒ **Incorrect**: `.workflow/WFS-{session}/.brainstorming/workflow-session.json` +- โœ… **Correct**: `.workflow/WFS-{session}/workflow-session.json` + +--- + +## ๐Ÿ“ Architecture Alignment + +### Confirmed Standard Structure +``` +.workflow/WFS-[topic-slug]/ +โ”œโ”€โ”€ workflow-session.json # โœ… Session metadata (root level) +โ”œโ”€โ”€ .brainstorming/ # Brainstorming artifacts subdirectory +โ”‚ โ””โ”€โ”€ topic-framework.md +โ”œโ”€โ”€ IMPL_PLAN.md +โ”œโ”€โ”€ TODO_LIST.md +โ””โ”€โ”€ .task/ + โ””โ”€โ”€ IMPL-*.json +``` + +### Key Points +- `workflow-session.json` is **always at session root level** +- `.brainstorming/` directory contains **only** framework and analysis files +- No session metadata files inside subdirectories + +--- + +## ๐Ÿ“Š Changes Summary + +| Category | Files Changed | Lines Modified | +|----------|--------------|----------------| +| Documentation Fixes | 9 | 19 insertions, 18 deletions | +| Path Corrections | 8 role files | 2 corrections per file | +| Structure Clarifications | 1 artifacts file | Added architectural note | + +--- + +## โœ… Verification + +**Pre-Release Checks**: +- โœ… No incorrect `.brainstorming/workflow-session.json` references +- โœ… No legacy `session.json` references +- โœ… All brainstorming roles use correct paths +- โœ… Architecture consistency verified with Gemini analysis + +--- + +## ๐Ÿ”„ Upgrade Instructions + +### For Existing Users + +**No action required** - This is a documentation-only fix. + +1. Pull the latest changes: + ```bash + git pull origin main + ``` + +2. Review updated documentation: + - `.claude/commands/workflow/brainstorm/*.md` + +### For New Users + +Simply clone the repository with the correct documentation: +```bash +git clone https://github.com/catlog22/Claude-Code-Workflow.git +``` + +--- + +## ๐Ÿ“š Related Documentation + +- **Architecture Reference**: `.claude/workflows/workflow-architecture.md` +- **Brainstorming Commands**: `.claude/commands/workflow/brainstorm/` +- **Session Management**: `.claude/commands/workflow/session/` + +--- + +## ๐Ÿ™ Acknowledgments + +Special thanks to the analysis tools used in this fix: +- **Gemini CLI**: Path verification and consistency checking +- **Codex**: Initial codebase analysis +- **Claude Code**: Documentation review and corrections + +--- + +## ๐Ÿ”— Links + +- **Full Changelog**: [v3.2.0...v3.2.1](https://github.com/catlog22/Claude-Code-Workflow/compare/v3.2.0...v3.2.1) +- **Issues Fixed**: Documentation consistency issue +- **Previous Release**: [v3.2.0 Release Notes](RELEASE_NOTES_v3.2.0.md) + +--- + +## ๐Ÿ“ Notes + +- This is a **non-breaking change** - existing workflows will continue to function +- Documentation now correctly reflects the implemented architecture +- No code changes were necessary - this was purely a documentation correction + +--- + +**Contributors**: Claude Code Development Team +**License**: MIT +**Support**: [GitHub Issues](https://github.com/catlog22/Claude-Code-Workflow/issues)