Claude-Code-Workflow/RELEASE_NOTES_v3.2.1.md

🔧 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:

   git pull origin main
   

2. Review updated documentation:

   • .claude/commands/workflow/brainstorm/*.md

For New Users

Simply clone the repository with the correct documentation:

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
• Issues Fixed: Documentation consistency issue
• Previous Release: v3.2.0 Release Notes

---

📝 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