An agentic skills framework & software development methodology that works.
Update RELEASE-NOTES.md for v3.1.0 release
Jesse Vincent0bc5a5989d8c
diff --git a/RELEASE-NOTES.md b/RELEASE-NOTES.mdindex a2b587f6a..167d9b988 100644--- a/RELEASE-NOTES.md+++ b/RELEASE-NOTES.md@@ -1,6 +1,65 @@# Superpowers Release Notes+## v3.1.0 (2025-10-17)++### Breaking Changes++**Skill names standardized to lowercase**+- All skill frontmatter `name:` fields now use lowercase kebab-case matching directory names+- Examples: `brainstorming`, `test-driven-development`, `using-git-worktrees`+- All skill announcements and cross-references updated to lowercase format+- This ensures consistent naming across directory names, frontmatter, and documentation++### New Features++**Enhanced brainstorming skill**+- Added Quick Reference table showing phases, activities, and tool usage+- Added copyable workflow checklist for tracking progress+- Added decision flowchart for when to revisit earlier phases+- Added comprehensive AskUserQuestion tool guidance with concrete examples+- Added "Question Patterns" section explaining when to use structured vs open-ended questions+- Restructured Key Principles as scannable table++**Anthropic best practices integration**+- Added `skills/writing-skills/anthropic-best-practices.md` - Official Anthropic skill authoring guide+- Referenced in writing-skills SKILL.md for comprehensive guidance+- Provides patterns for progressive disclosure, workflows, and evaluation++### Improvements++**Skill cross-reference clarity**+- All skill references now use explicit requirement markers:+ - `**REQUIRED BACKGROUND:**` - Prerequisites you must understand+ - `**REQUIRED SUB-SKILL:**` - Skills that must be used in workflow+ - `**Complementary skills:**` - Optional but helpful related skills+- Removed old path format (`skills/collaboration/X` → just `X`)+- Updated Integration sections with categorized relationships (Required vs Complementary)+- Updated cross-reference documentation with best practices++**Alignment with Anthropic best practices**+- Fixed description grammar and voice (fully third-person)+- Added Quick Reference tables for scanning+- Added workflow checklists Claude can copy and track+- Appropriate use of flowcharts for non-obvious decision points+- Improved scannable table formats+- All skills well under 500-line recommendation++### Bug Fixes++- **Re-added missing command redirects** - Restored `commands/brainstorm.md` and `commands/write-plan.md` that were accidentally removed in v3.0 migration+- Fixed `defense-in-depth` name mismatch (was `Defense-in-Depth-Validation`)+- Fixed `receiving-code-review` name mismatch (was `Code-Review-Reception`)+- Fixed `commands/brainstorm.md` reference to correct skill name+- Removed references to non-existent related skills++### Documentation++**writing-skills improvements**+- Updated cross-referencing guidance with explicit requirement markers+- Added reference to Anthropic's official best practices+- Improved examples showing proper skill reference format+## v3.0.1 (2025-10-16)### Changes