Skip to content

ci: update release skill #172

Merged
quettabit merged 1 commit intomainfrom
qb/update-skill
Feb 5, 2026
Merged

ci: update release skill #172
quettabit merged 1 commit intomainfrom
qb/update-skill

Conversation

@quettabit
Copy link
Copy Markdown
Member

No description provided.

@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps bot commented Feb 5, 2026

Greptile Overview

Greptile Summary

Updated the /release skill documentation to accurately reflect the multi-package workspace release process. Key changes:

  • Clarified that each package (s2-cli, s2-lite, s2-api, s2-common) has independent versioning and changelogs
  • Documented that s2-cli and s2-lite are released together as part of the "s2" version_group
  • Updated instructions to check per-package changelogs and version bumps rather than a single project-wide changelog
  • Corrected workflow name from release.yml to release-plz.yml
  • Added detailed explanation of the release flow: release-crates.yml publishes to crates.io and creates per-package git tags, then tags like s2-cli-v* trigger release-cli.yml for binary builds and Homebrew updates
  • Updated git commands to work with per-package tags (e.g., git tag -l 's2-cli-v*')

The documentation now accurately matches the release-plz.toml configuration and GitHub workflow files.

Confidence Score: 5/5

  • Safe to merge - documentation update accurately reflects existing configuration
  • Documentation-only change that correctly describes the multi-package release workflow. All claims were verified against release-plz.toml and workflow files. No code changes, no risk of runtime issues.
  • No files require special attention

Important Files Changed

Filename Overview
.claude/skills/release/SKILL.md Updated release skill documentation to reflect per-package versioning and multi-package workspace structure

Sequence Diagram

sequenceDiagram
    participant Dev as Developer
    participant Main as Main Branch
    participant ReleaseBot as release-plz.yml
    participant ReleasePR as Release PR
    participant Crates as release-crates.yml
    participant CLI as release-cli.yml
    participant CratesIO as crates.io
    participant GitHub as GitHub Releases

    Note over Dev,Main: Changes merged to main with conventional commits

    Dev->>ReleaseBot: Trigger workflow (manual or scheduled)
    ReleaseBot->>Main: Analyze commits since last release per package
    ReleaseBot->>ReleasePR: Create/update PR with version bumps & changelogs
    Note over ReleasePR: Only packages with changes included<br/>s2-cli & s2-lite versioned together

    Dev->>ReleasePR: Review changelogs
    Dev->>ReleasePR: Run dry-run: cargo publish -p <package> --dry-run
    Dev->>ReleasePR: Merge PR (squash)

    ReleasePR->>Crates: Trigger on PR merge with 'release' label
    Crates->>CratesIO: Publish changed packages to crates.io
    Crates->>GitHub: Create per-package tags (s2-cli-v*, s2-api-v*, etc.)

    GitHub->>CLI: Tag push triggers for s2-cli-v* or s2-lite-v*
    CLI->>CLI: Build binaries for multiple platforms
    CLI->>CLI: Build & push Docker images
    CLI->>GitHub: Upload release artifacts
    CLI->>CLI: Update Homebrew formula
Loading

@quettabit quettabit merged commit 44ec870 into main Feb 5, 2026
1 check passed
@quettabit quettabit deleted the qb/update-skill branch February 5, 2026 19:36
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