Browse Source

chore: Release v2.4.10 — sharpen github-ops Recent Updates rule

Tighten readme-recent-updates.md against incidental bug-fix bullets:
explicit inclusion (3) and exclusion (4) criteria plus a self-check.
Replaces a soft single-bullet guideline that let pre-existing fixes
slip into feature-release entries silently.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
0xDarkMatter 1 month ago
parent
commit
fd556430e0
3 changed files with 25 additions and 2 deletions
  1. 1 1
      .claude-plugin/plugin.json
  2. 3 0
      README.md
  3. 21 1
      skills/github-ops/references/readme-recent-updates.md

+ 1 - 1
.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-mods",
-  "version": "2.4.9",
+  "version": "2.4.10",
   "description": "Custom commands, skills, and agents for Claude Code - session continuity, 23 expert agents, 71 skills, 3 commands, 6 rules, 4 hooks, 13 output styles, modern CLI tools",
   "author": "0xDarkMatter",
   "repository": "https://github.com/0xDarkMatter/claude-mods",

+ 3 - 0
README.md

@@ -22,6 +22,9 @@ From Python async patterns to Rust ownership models, from AWS Fargate deployment
 
 ## Recent Updates
 
+**v2.4.10** (April 2026)
+- 📌 **`github-ops` Recent Updates rule sharpened** - `references/readme-recent-updates.md` gains an explicit "Recent Updates is for *features*, not bugs" subsection with three inclusion criteria, four exclusion criteria, and a self-check ("are you writing this because *you* remembered the fix or because *the user* is waiting for it?"). Replaces a soft single-bullet rule that allowed pre-existing bug fixes to slip into feature-release entries silently.
+
 **v2.4.9** (April 2026)
 - 🔍 **`git-ops` hygiene checks** - `status.sh` now proactively flags bad git practices during every status read: main checkout sitting on a feature branch (feature work belongs in worktrees), and merged branches not yet deleted. `SKILL.md` documents all four anti-patterns (feature branch, stale merges, WIP commits, large uncommitted pile) with severity ratings and remediation steps.
 - 📖 **`docs/references/claude-desktop-internals.md`** - Comprehensive map of Claude Desktop's file system layout and session architecture, validated by live probing. Key findings: cross-account session transfer works by copying only the metadata JSON; sidebar population is filesystem-driven on login (not server cache); `react-query-cache-ls` probe confirmed 7/8 transferred sessions were absent from server data but appeared in sidebar.

+ 21 - 1
skills/github-ops/references/readme-recent-updates.md

@@ -43,12 +43,32 @@ Each bullet should be **scannable in one breath** — roughly 30–60 words afte
 
 - Drop parenthetical category lists ("(`PRUNABLE` / `WIP` / `GHOST` / `ORPHAN`)") — these belong in skill docs, not release notes
 - Drop sub-features ("Plus a harness whitelist on Gate 1: ...") — split into a separate bullet or omit
-- Drop bug fixes from feature releases unless they're the headline — move to a `🐛` bullet only if user-visible
 
 Rule of thumb: a release block of 4 bullets averaging 40 words each (~160 words total) reads cleanly. A block of 5 bullets averaging 80 words each (~400 words) becomes a wall and visitors skim past it.
 
 Long bullets erode the value of the section — visitors should see velocity at a glance, not have to read paragraphs to extract what shipped.
 
+### Recent Updates is for *features*, not bugs
+
+Recent Updates surfaces **capability changes and direction**. Bug fixes go in `CHANGELOG.md`.
+
+**Include a `🐛` bullet only when one of these is true:**
+
+1. **The bug fix IS the release.** A patch release whose entire purpose is the fix (e.g. `v2.0.1` shipped specifically to address a regression).
+2. **You're closing a loop.** The bug was previously called out in a Recent Updates entry as a known issue, and this release resolves it.
+3. **The fix is the headline of a larger release.** If the most important thing a minor release ships is fixing a long-standing issue, lead with it.
+
+**Exclude bug fixes that are:**
+
+- Pre-existing issues squashed during unrelated feature work (the most common silent failure)
+- Fixes for bugs that weren't user-visible enough to be previously flagged
+- "Technically user-visible" but discovered and fixed without anyone reporting them
+- Anything where the fix is one of several changes in the release rather than the focus
+
+**Test for inclusion:** if the bullet starts with `🐛` and you're writing it because *you remembered the fix happened*, not because *the user is waiting for it* — it doesn't go here. Send it to `CHANGELOG.md`.
+
+The failure mode is silent: a 🐛 bullet appears that probably shouldn't, and there's nothing in the rule that flags it. The section drifts toward CHANGELOG. Recent Updates should answer "*what's new in capability?*", not "*what got fixed?*"
+
 ## Alternate style — flarecrawl (table)
 
 Only use when the project ships so frequently that the per-version block format would dominate the README.