run-release — Claude Code command: orchestrate releases
run-release — a Claude Code command that triggers a release workflow using semantic version tags. It automates creation of annotated tags, draft releases, and requires approval before publishing.
MIT ★ 907 updated 2025-11-12
.claude/commands/run-release.mdWhat run-release does
Call the command with a required version parameter in vX.Y.Z format and an optional target branch (defaults to main). Before running, complete the Release Checklist and verify that /review and /security-scan pass on the target branch.
When invoked, the command runs the GitHub workflow release-orchestrator.yml with the specified version and target branch. The workflow pauses at the environment approval step for the release environment—you must approve it to publish the annotated tag and draft release.
Once approved, the workflow completes and the draft release appears on GitHub. The final step is to review and publish the draft manually.
What it helps with
- trigger a release workflow with the correct version and target branch
- create an annotated tag and draft release on GitHub
- enforce review and security scan checks before release
- require manual approval before publishing a release
Example prompts for the agent
- Run release version
v1.2.3onmain:/run-release v1.2.3 - Run release version
v2.0.0onrelease/2.0branch:/run-release v2.0.0 release/2.0 - Create a draft release
v1.0.0with approval gate:/run-release v1.0.0
How to install run-release
Manually: put the files in place
.claude/commands/run-release.mdCall it with /run-release. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/run-release.mdCall it with /prompts:run-release. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/run-release.prompt.mdManually: put the files in place
.gemini/commands/run-release.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about run-release
How do I install run-release in Claude Code?
Create a .claude/commands/run-release.md file in your project root with the command definition. After that, the command becomes available in Claude Code.
What does run-release do?
The command triggers a GitHub workflow to orchestrate a release using semantic version tags. It creates an annotated tag, draft release, and requires approval before publishing.
What checks must pass before I run it?
Complete the Release Checklist issue and ensure /review and /security-scan are green on the target branch.
Source text
run-release.md · MIT
---
description: Orchestrate a tagged release using the release workflow.
argument-hint: <version> [target]
---
## Pre-flight
- Complete the Release Checklist issue.
- Ensure `/review` and `/security-scan` are green on the target branch.
## Trigger Workflow
```
/run-release vX.Y.Z [target]
```
- `vX.Y.Z`: Required semantic version tag (include the `v`).
- `target`: Optional branch/commit (defaults to `main`).
### Command
```bash
gh workflow run release-orchestrator.yml \
--ref ${target:-main} \
-f version=${version} \
-f target=${target:-main}
```
## After Triggering
1. Wait for the `Release Orchestrator` workflow to reach the environment approval step.
2. Approve the `release` environment to publish the annotated tag and draft release.
3. Review and publish the draft release on GitHub.
© alirezarezvani · MIT · alirezarezvani/claude-code-skill-factory