@@ -60,7 +60,9 @@ Reason: Fixed database query bug
6060Files 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
6567Proceed? (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:**
89100Add 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
164190User: "Fixed the memory leak in the search function"
165191You: 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
173200User: "Added web search MCP integration"
174201You: 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)
182210User: "Rewrote storage layer, old data needs migration"
183211You: 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
219251head -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