Skip to content

claude: sync zerover release-type guidance and add changelog skill#10

Merged
Liam-DeVoe merged 1 commit into
mainfrom
zerover-changelog-guidance
Jul 9, 2026
Merged

claude: sync zerover release-type guidance and add changelog skill#10
Liam-DeVoe merged 1 commit into
mainfrom
zerover-changelog-guidance

Conversation

@Liam-DeVoe

Copy link
Copy Markdown
Member
Claude-written description

Part of a cross-repo effort syncing zerover (0.x) release-type guidance across all Hegel libraries; this PR covers hegel-java.

  • RELEASE-sample.md: replaces the stale classic-semver type bullets with the zerover mapping — patch for bug fixes, internal changes, and new non-breaking features (the default); minor for breaking changes only; major unused while pre-1.0.
  • Adds a changelog skill at .claude/skills/changelog/SKILL.md (from the canonical cross-repo template) describing the zerover RELEASE_TYPE mapping and Hypothesis-style changelog conventions, with examples written against real hegel-java APIs (Generators.fromRegex, Settings.suppressHealthCheck, Generators.maps, Generators.text().minSize).
  • .gitignore: extends the .claude/ whitelist so the changelog skill is tracked (other local-only skills remain ignored), mirroring hegel-core's approach.

Docs-only: no source files touched and no RELEASE.md (the skip release label applies per this repo's convention).

Self-review note: the reviewer flagged that the skill's table maps deprecations to minor, which sits in tension with the "minor — breaking changes only" rule (a deprecation is technically non-breaking). Left as-is because the table is part of the canonical template shared across all seven repos — deprecations are deliberately treated as advance warning of a break. If we'd rather map deprecations to patch, that should be changed template-wide, not just here.

@Liam-DeVoe Liam-DeVoe added the skip release merging this PR will not cut a new release label Jul 9, 2026
@Liam-DeVoe Liam-DeVoe merged commit 297326a into main Jul 9, 2026
8 checks passed
@Liam-DeVoe Liam-DeVoe deleted the zerover-changelog-guidance branch July 9, 2026 22:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

skip release merging this PR will not cut a new release

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant