Skip to content
cccskills
FreePublished on GitHub

release-bump

Use when bumping ralph-orchestrator version for a new release, after fixes are committed and ready to publish

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md2.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Release Bump

Overview

Bump version and trigger release for ralph-orchestrator. All versions live in workspace Cargo.toml - individual crates inherit via version.workspace = true.

Confirm the new version with the user. Once the bump commit is pushed, track progress of the release.

Quick Reference

StepCommand/Action
1. Bump versionEdit Cargo.toml: replace all version = "X.Y.Z" (7 occurrences)
2. Buildcargo build (updates Cargo.lock)
3. Testcargo test
4. Commitgit add Cargo.toml Cargo.lock && git commit -m "chore: bump to vX.Y.Z"
5. Pushgit push origin main
6. Taggit tag vX.Y.Z && git push origin vX.Y.Z

Version Locations (All in Cargo.toml)

# Line ~17 - workspace version
[workspace.package]
version = "X.Y.Z"

# Lines ~113-118 - internal crate dependencies
ralph-proto = { version = "X.Y.Z", path = "crates/ralph-proto" }
ralph-core = { version = "X.Y.Z", path = "crates/ralph-core" }
ralph-adapters = { version = "X.Y.Z", path = "crates/ralph-adapters" }
ralph-tui = { version = "X.Y.Z", path = "crates/ralph-tui" }
ralph-cli = { version = "X.Y.Z", path = "crates/ralph-cli" }
ralph-bench = { version = "X.Y.Z", path = "crates/ralph-bench" }

Tip: Use Edit tool with replace_all: true on version = "OLD" → version = "NEW" to update all 7 at once.

What CI Does Automatically

Once you push the tag, .github/workflows/release.yml triggers and:

  1. Creates the GitHub Release with auto-generated notes
  2. Builds binaries for macOS (arm64, x64) and Linux (arm64, x64)
  3. Uploads artifacts to the GitHub Release
  4. Publishes to crates.io (in dependency order)
  5. Publishes to npm as @ralph-orchestrator/ralph

Common Mistakes

MistakeFix
Only updating workspace.package.versionMust update all 7 occurrences including internal deps
Forgetting to run testsAlways cargo test before commit
Creating release manually with gh release createJust push the tag - CI creates the release with artifacts
Pushing tag before mainPush main first, then push the tag

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Guides implementation of code tasks using test-driven development in an Explore, Plan, Code, Commit workflow. Acts as a Technical Implementation Partner and TDD Coach — following existing patterns, avoiding over-engineering, and producing idiomatic, modern code.

The English summary is being prepared. Showing the original description.

mikeyobrien/ralph-orchestrator3.2KUpdated Oct 16, 2026

Generates structured .code-task.md files from descriptions or PDD implementation plans. Auto-detects input type, creates properly formatted tasks with Given-When-Then acceptance criteria.

The English summary is being prepared. Showing the original description.

mikeyobrien/ralph-orchestrator3.2KUpdated Oct 16, 2026

Use when testing Ralph's hat collection presets, validating preset configurations, or auditing the preset library for bugs and UX issues.

The English summary is being prepared. Showing the original description.

mikeyobrien/ralph-orchestrator3.2KUpdated Oct 16, 2026

Lists all code tasks in the repository with their status, dates, and metadata. Useful for getting an overview of pending work or finding specific tasks.

The English summary is being prepared. Showing the original description.

mikeyobrien/ralph-orchestrator3.2KUpdated Oct 16, 2026

pdd

Free

Transforms a rough idea into a detailed design document with implementation plan. Follows Prompt-Driven Development — iterative requirements clarification, research, design, and planning.

The English summary is being prepared. Showing the original description.

mikeyobrien/ralph-orchestrator3.2KUpdated Oct 16, 2026

Browser automation via Playwriter (remorses) using persistent Chrome sessions and the full Playwright Page API.

The English summary is being prepared. Showing the original description.

mikeyobrien/ralph-orchestrator3.2KUpdated Oct 16, 2026

See all skills by mikeyobrien

Report a problem with this skill