Skip to content

Commit 6d145c0

Browse files
committed
Update version-bump skill to include plugin.json and git tagging workflow
1 parent bd5ad6e commit 6d145c0

1 file changed

Lines changed: 44 additions & 9 deletions

File tree

.claude/skills/version-bump/SKILL.md

Lines changed: 44 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,9 @@ Reason: Fixed database query bug
6060
Files to update:
6161
- package.json: "version": "4.2.9"
6262
- marketplace.json: "version": "4.2.9"
63+
- plugin.json: "version": "4.2.9"
6364
- CLAUDE.md: Add v4.2.9 entry
65+
- Git tag: v4.2.9
6466
6567
Proceed? (yes/no)
6668
```
@@ -85,14 +87,23 @@ Proceed? (yes/no)
8587
}
8688
```
8789

90+
**Update plugin/.claude-plugin/plugin.json:**
91+
```json
92+
{
93+
"name": "claude-mem",
94+
"version": "4.2.9",
95+
...
96+
}
97+
```
98+
8899
**Update CLAUDE.md:**
89100
Add entry at top of Version History section following the template below.
90101

91102
### 6. Verify Consistency
92103
```bash
93104
# Check all versions match
94-
grep -n '"version"' package.json .claude-plugin/marketplace.json
95-
# Should show same version in both files
105+
grep -n '"version"' package.json .claude-plugin/marketplace.json plugin/.claude-plugin/plugin.json
106+
# Should show same version in all three files
96107
```
97108

98109
### 7. Test
@@ -102,6 +113,21 @@ npm run build
102113
# Or whatever build command is appropriate
103114
```
104115

116+
### 8. Commit and Tag
117+
```bash
118+
# Stage all version files
119+
git add package.json .claude-plugin/marketplace.json plugin/.claude-plugin/plugin.json CLAUDE.md plugin/scripts/
120+
121+
# Commit with descriptive message
122+
git commit -m "Release vX.Y.Z: [Brief description]"
123+
124+
# Create annotated git tag
125+
git tag vX.Y.Z -m "Release vX.Y.Z: [Brief description]"
126+
127+
# Push commit and tags
128+
git push && git push --tags
129+
```
130+
105131
## CLAUDE.md Templates
106132

107133
### PATCH Version Template
@@ -164,7 +190,8 @@ npm run build
164190
User: "Fixed the memory leak in the search function"
165191
You: Determine → PATCH
166192
Calculate → 4.2.8 → 4.2.9
167-
Update all three files
193+
Update all four files
194+
Create git tag v4.2.9
168195
CLAUDE.md: Focus on the fix and impact
169196
```
170197

@@ -173,7 +200,8 @@ You: Determine → PATCH
173200
User: "Added web search MCP integration"
174201
You: Determine → MINOR (new feature)
175202
Calculate → 4.2.8 → 4.3.0
176-
Update all three files
203+
Update all four files
204+
Create git tag v4.3.0
177205
CLAUDE.md: Describe feature and usage
178206
```
179207

@@ -182,22 +210,26 @@ You: Determine → MINOR (new feature)
182210
User: "Rewrote storage layer, old data needs migration"
183211
You: Determine → MAJOR (breaking change)
184212
Calculate → 4.2.8 → 5.0.0
185-
Update all three files
213+
Update all four files
214+
Create git tag v5.0.0
186215
CLAUDE.md: Include migration steps
187216
```
188217

189218
## Error Prevention
190219

191220
**ALWAYS verify:**
192-
- [ ] All three files have matching version numbers
221+
- [ ] All FOUR files have matching version numbers (package.json, marketplace.json, plugin.json, CLAUDE.md)
222+
- [ ] Git tag created with format vX.Y.Z
193223
- [ ] CLAUDE.md entry matches version type (patch/minor/major)
194224
- [ ] Breaking changes are clearly marked with ⚠️
195225
- [ ] File references use format: `path/to/file.ts:line_number`
196226
- [ ] CLAUDE.md entry is added at TOP of version history
227+
- [ ] Commit and tags pushed to remote
197228

198229
**NEVER:**
199-
- Update only one or two files
230+
- Update only one, two, or three files - ALL FOUR must be updated
200231
- Skip the verification step
232+
- Forget to create git tag
201233
- Forget to ask user if version type is unclear
202234
- Use vague descriptions in CLAUDE.md
203235

@@ -218,6 +250,9 @@ cat package.json | grep version
218250
# Check version history
219251
head -50 CLAUDE.md | grep "^###"
220252

221-
# Verify consistency
222-
diff <(jq -r .version package.json) <(jq -r .version .claude-plugin/marketplace.json)
253+
# Verify consistency across all version files
254+
grep '"version"' package.json .claude-plugin/marketplace.json plugin/.claude-plugin/plugin.json
255+
256+
# View git tags
257+
git tag -l -n1
223258
```

0 commit comments

Comments
 (0)