chore: Bump version to v3.2.1

- 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 <noreply@anthropic.com>
2026-02-05 01:50:27 +08:00 · 2025-10-02 22:10:01 +08:00
parent 94a2150836
commit 661cb5be1c
4 changed files with 145 additions and 3 deletions
--- 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)

--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@

 <div align="center">

-[![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)
--- a/README_CN.md
+++ b/README_CN.md
@@ -2,7 +2,7 @@

 <div align="center">

-[![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)
--- a/RELEASE_NOTES_v3.2.1.md
+++ 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)