name

prepare-release

description

Prepare a new NuGet release of this repository (version bump, release notes, release PR to main). Use this whenever the user mentions releasing, publishing, shipping, cutting a release, bumping the version, updating OpenTelemetry dependencies, or preparing release notes — even if they don't say "release" explicitly. Decides the next SemVer version automatically and proceeds when the shipped library project has dependency updates or there are any new commits since the last tag.

Prepare release

Prepare a new release of this NuGet package. You decide the next version yourself. You prepare the repository and open the release PR — then stop. Reviewing, merging, and publishing are admin-only and not part of your job:

You do not merge the release PR (or enable auto-merge). The admin reviews and merges every PR manually.
You do not trigger deploy-nuget.yml. The NuGet publish is a manual workflow_dispatch the admin runs after merging the release PR.

This skill must only be run by the admin (auto-opening PRs is admin-only).

Workflow

Check whether there is anything to release
- Run the helper: bash .claude/skills/prepare-release/scripts/check-otel-updates.sh
- The helper only inspects the shipped library project (src/OpenTelemetryExtension.Configuration/...csproj). Dependency updates in the Sample or Tests projects are ignored — they are never published and must not trigger a new version.
- Exit code 3 = nothing to release (no library dependency updates and no new commits since the last tag) → stop.
- Exit code 0 = library dependency updates and/or new commits exist → continue.
Determine current version & last tag
- Read <Version> in src/OpenTelemetryExtension.Configuration/OpenTelemetryExtension.Configuration.csproj.
- Latest tag: git tag --sort=-v:refname | head -1.
Decide the next version (SemVer) from git log --oneline <tag>..HEAD:
- MAJOR breaking API changes · MINOR new features · PATCH fixes/docs/deps.
- Must be strictly greater than the current version. State it + a one-line reason.
Confirm clean tree — git status --short; if dirty, ask how to proceed.
Branch from up-to-date main — git checkout main && git pull then git checkout -b release/v<version>. The repo uses GitHub Flow; release branches always cut from main.
Update the library project's NuGet packages to latest (src/OpenTelemetryExtension.Configuration/OpenTelemetryExtension.Configuration.csproj only — leave Sample/Tests packages alone), then dotnet restore OpenTelemetryExtension.slnx.
Build & test (green required)
- dotnet build OpenTelemetryExtension.slnx -c Release
- dotnet test OpenTelemetryExtension.slnx -c Release --filter "Category=Unit" (unit tests only; integration tests need the live OpenObserve/SQL stack)
End-to-end smoke test — prove telemetry actually reaches a backend. Requires a local Kubernetes cluster (k3s in WSL2) with Helm + kubectl. OpenObserve is used because it has a real query API, so the test can positively confirm ingested data. The helper starts OpenObserve via its Helm chart, runs the sample, generates traffic and queries the API for records:
- bash .claude/skills/prepare-release/scripts/smoke-test.sh
- Exit 0 = telemetry confirmed → continue. Non-zero = stop and report; do not release if telemetry does not arrive.
Bump <Version> in the csproj.
Extend docs — update README.md etc. for the changes/new dep versions.
Release notes — copy .claude/skills/prepare-release/assets/release-notes.md to release-notes/v<version>.md, fill in the {{VERSION}}/{{DATE}} placeholders and the Added / Changed / Fixed / Removed sections (omit empty ones). Add the new file to OpenTelemetryExtension.slnx (it tracks loose files explicitly — see AGENTS.md).
Commit (no tag) — stage csproj(s), docs, release notes, .slnx; message release: v<version>.
Push & open PR to main — then stop. Do NOT merge it.
- git push -u origin release/v<version>
- gh pr create --base main --head release/v<version> --title "release: v<version>" --body <notes>
- The admin reviews and merges the PR. You never merge it or enable auto-merge.
Report the PR link and remind the admin: after they merge it, they trigger Deploy Nuget manually (Actions → Deploy Nuget → Run workflow) — it tags v<version> and publishes. You do not trigger it.

Prepare release

You do not merge the release PR (or enable auto-merge). The admin reviews and merges every PR manually.

You do not trigger deploy-nuget.yml. The NuGet publish is a manual workflow_dispatch the admin runs after merging the release PR.

This skill must only be run by the admin (auto-opening PRs is admin-only).

Workflow

Check whether there is anything to release

Run the helper: bash .claude/skills/prepare-release/scripts/check-otel-updates.sh
The helper only inspects the shipped library project (src/OpenTelemetryExtension.Configuration/...csproj). Dependency updates in the Sample or Tests projects are ignored — they are never published and must not trigger a new version.
Exit code 3 = nothing to release (no library dependency updates and no new commits since the last tag) → stop.
Exit code 0 = library dependency updates and/or new commits exist → continue.

Determine current version & last tag

Read <Version> in src/OpenTelemetryExtension.Configuration/OpenTelemetryExtension.Configuration.csproj.
Latest tag: git tag --sort=-v:refname | head -1.

Decide the next version (SemVer) from git log --oneline <tag>..HEAD:

MAJOR breaking API changes · MINOR new features · PATCH fixes/docs/deps.
Must be strictly greater than the current version. State it + a one-line reason.

Confirm clean tree — git status --short; if dirty, ask how to proceed.

Branch from up-to-date main — git checkout main && git pull then git checkout -b release/v<version>. The repo uses GitHub Flow; release branches always cut from main.

Update the library project's NuGet packages to latest (src/OpenTelemetryExtension.Configuration/OpenTelemetryExtension.Configuration.csproj only — leave Sample/Tests packages alone), then dotnet restore OpenTelemetryExtension.slnx.

Build & test (green required)

dotnet build OpenTelemetryExtension.slnx -c Release
dotnet test OpenTelemetryExtension.slnx -c Release --filter "Category=Unit" (unit tests only; integration tests need the live OpenObserve/SQL stack)

End-to-end smoke test — prove telemetry actually reaches a backend. Requires a local Kubernetes cluster (k3s in WSL2) with Helm + kubectl. OpenObserve is used because it has a real query API, so the test can positively confirm ingested data. The helper starts OpenObserve via its Helm chart, runs the sample, generates traffic and queries the API for records:

bash .claude/skills/prepare-release/scripts/smoke-test.sh
Exit 0 = telemetry confirmed → continue. Non-zero = stop and report; do not release if telemetry does not arrive.

Bump <Version> in the csproj.

Extend docs — update README.md etc. for the changes/new dep versions.

Release notes — copy .claude/skills/prepare-release/assets/release-notes.md to release-notes/v<version>.md, fill in the {{VERSION}}/{{DATE}} placeholders and the Added / Changed / Fixed / Removed sections (omit empty ones). Add the new file to OpenTelemetryExtension.slnx (it tracks loose files explicitly — see AGENTS.md).

Commit (no tag) — stage csproj(s), docs, release notes, .slnx; message release: v<version>.

Push & open PR to main — then stop. Do NOT merge it.

git push -u origin release/v<version>
gh pr create --base main --head release/v<version> --title "release: v<version>" --body <notes>
The admin reviews and merges the PR. You never merge it or enable auto-merge.

Report the PR link and remind the admin: after they merge it, they trigger Deploy Nuget manually (Actions → Deploy Nuget → Run workflow) — it tags v<version> and publishes. You do not trigger it.