Skip to content

feat(plugins): replace prepare-release with workhub's own release-app skill - #93

Merged
atman-33 merged 1 commit into
mainfrom
feature/release-app-skill
Jul 27, 2026
Merged

feat(plugins): replace prepare-release with workhub's own release-app skill#93
atman-33 merged 1 commit into
mainfrom
feature/release-app-skill

Conversation

@atman-33

Copy link
Copy Markdown
Owner

Why

prepare-release (engineering plugin) prescribed a release-branch-and-PR flow
and explicitly refused to push tags or trigger the pipeline. workhub's actual
release procedure (.claude/rules/release-process.md) is the opposite: bump
the version, commit straight to main, and push the tag — that push is
what triggers the build-and-publish workflow. An agent reaching for the
generic skill inside this repo would be led away from the real procedure, and
most of what the skill said otherwise ("find every version-bearing file",
"prefer the repository's conventions") is behavior an agent already has by
default.

A release procedure is repository-specific, so it should live with the
repository: the contract in .claude/rules/, and the sequence that drives it
in a repository-specific skill.

What changed

  • Added plugins/workhub/skills/release-app/SKILL.md. It reads
    .claude/rules/release-process.md as its first step rather than restating
    the contract, so asset names and invariants keep one source of truth. Then:
    clean + current main → green CI → decide the version (handles the case
    where a bump landed but the tag never did) → draft the changelog → stop for
    explicit approval
    → commit + tag + push → verify the published release
    carries every required asset.
  • Removed plugins/engineering/skills/prepare-release/.
  • Updated the two references to it (plugins/engineering/README.md,
    plugins/productivity/skills/create-release-notes/SKILL.md) and
    docs/plugins.md's catalog entries for workhub and engineering.
  • Bumped plugin versions per .claude/rules/plugin-authoring.md: workhub
    0.17.0 → 0.18.0, engineering 0.23.0 → 0.24.0, productivity 0.22.0 →
    0.22.1 (wording only), in both plugin.json and marketplace.json.

Test plan

  • npm test — 124/124 passed
  • All plugin.json / marketplace.json entries parse and version-match
    (verified with a script, all 9 plugins)
  • Run release-app end to end on a real workhub release

🤖 Generated with Claude Code

…'s own

`prepare-release` prescribed a release-branch-and-PR flow and explicitly
refused to push tags or trigger the pipeline. workhub releases the opposite
way: `.claude/rules/release-process.md` commits the version bump straight to
main and *pushes the tag* to publish. An agent that reached for the generic
skill inside this repository was led away from the real procedure, and most of
what it said otherwise ("find every version-bearing file", "prefer the
repository's conventions") is what the agent does by default.

A release procedure is repository-specific, so it belongs to the repository:
the contract in `.claude/rules/`, and the sequence that drives it in a
repository-specific skill.

Add `workhub:release-app` for this app. It reads the release contract as its
first step rather than restating it, so the asset names and invariants keep a
single source of truth, then walks the sequence: clean and current main, green
CI, decide the version (handling the case where a bump landed but the tag never
did), draft the changelog, stop for approval, tag and push, and verify the
published release carries every required asset.

Drop `prepare-release` and update the two places that referenced it.

Plugin versions: workhub 0.18.0, engineering 0.24.0, productivity 0.22.1.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Jul 27, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 02b0680c-91e0-4700-a877-9416f2d7e2ea

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feature/release-app-skill

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@atman-33
atman-33 merged commit 16bc3aa into main Jul 27, 2026
2 checks passed
@atman-33
atman-33 deleted the feature/release-app-skill branch July 27, 2026 15:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant