mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-09 02:24:11 +08:00
661cb5be1c
- 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>
143 lines
4.0 KiB
Markdown
143 lines
4.0 KiB
Markdown
# 🔧 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)
|