windy/my-vault
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: improve semantic versioning guidelines in release command

Browse Source
This commit is contained in:
Noah Brier
2025-09-13 22:00:14 -04:00
parent d052f4c007
commit 4af370eb0e
1 changed files with 12 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.claude/commands/release.md
+12 -2
View File
@@ -55,6 +55,11 @@ Automates the entire release process: analyzes recent commits to determine versi
### Semantic Versioning (MAJOR.MINOR.PATCH) ### Semantic Versioning (MAJOR.MINOR.PATCH)
**Quick Decision Guide:**
- Can users do something they couldn't do before? → **MINOR**
- Did something that worked break? → **MAJOR** (if breaking) or **PATCH** (if fixing)
- Did something that worked get better? → **PATCH**
**MAJOR** (1.0.0 → 2.0.0): **MAJOR** (1.0.0 → 2.0.0):
- Breaking changes that require users to change their code/config - Breaking changes that require users to change their code/config
- Removing features or commands - Removing features or commands
@@ -64,26 +69,31 @@ Automates the entire release process: analyzes recent commits to determine versi
**MINOR** (1.0.0 → 1.1.0): **MINOR** (1.0.0 → 1.1.0):
- **NEW capabilities** added (not enhancements to existing features) - **NEW capabilities** added (not enhancements to existing features)
- Making something possible that wasn't possible before
- New commands, new tools, new integrations - New commands, new tools, new integrations
- New optional features that don't affect existing functionality - New optional features that don't affect existing functionality
- Significant architectural changes that enable new functionality
- Commits starting with "feat:" that add NEW functionality - Commits starting with "feat:" that add NEW functionality
- Examples: - Examples:
- Adding a new `/command` - Adding a new `/command`
- Adding a new MCP server - Adding a new MCP server
- Adding vault import capability (first time) - Adding vault import capability (first time)
- Making upgrade work without git connection (was impossible before)
- Enabling a feature to work offline when it required internet before
**PATCH** (1.0.0 → 1.0.1): **PATCH** (1.0.0 → 1.0.1):
- Bug fixes and minor improvements - Bug fixes and minor improvements
- Enhancements to existing features - Enhancements to existing features (that already worked)
- Performance improvements - Performance improvements
- Documentation updates - Documentation updates
- Refactoring without changing behavior - Refactoring without changing behavior
- Commits with "fix:", "docs:", "style:", "refactor:", "perf:", "test:", "chore:" - Commits with "fix:", "docs:", "style:", "refactor:", "perf:", "test:", "chore:"
- Examples: - Examples:
- Making an existing command smarter - Making an existing command smarter (but not enabling new use cases)
- Improving error messages - Improving error messages
- Fixing bugs in existing features - Fixing bugs in existing features
- Enhancing existing import to be more intelligent - Enhancing existing import to be more intelligent
- Improving UI/formatting of existing features
### Commit Message Best Practices ### Commit Message Best Practices