googlecloudplatform/cloud-foundation-fabric/release-process
Claude Code and agent skill by googlecloudplatform/cloud-foundation-fabric
- community
Checking that the SKILL.md file is still in the repository.
Guide for cutting a new release of the Cloud Foundation Fabric (CFF) repository. Use this skill when asked to create, prepare, or draft a new release.
Install
npx vskill@latest install googlecloudplatform/cloud-foundation-fabric/release-processSKILL.md
The same SKILL.md was published earlier as googlecloudplatform/cloud-foundation-fabric/release-process.
Cloud Foundation Fabric Release Process
This skill guides maintainers through the process of cutting a new release for the Cloud Foundation Fabric (CFF) repository.
CRITICAL: Release names and tags MUST ALWAYS be prefixed withv(e.g.,v55.1.0,v56.0.0).
Prerequisites
- Permissions: You must have write/release permissions on the repository.
- GitHub Token: A valid GitHub token (can be easily derived by running
gh auth token). - Environment: You can run the tools using either
uv(recommended) or a standard Python virtual environment withtools/requirements.txtinstalled.
1. Preparation
Start from the master branch and ensure you are up to date:
Identify the latest released version by extracting it from the default-versions.tf file:
2. Generate and Review Changelog
Run the changelog script, specifying the bump type (e.g., major, minor, patch):
Review the changes: Run git diff CHANGELOG.md and carefully inspect the output. Look for:
- PRs missing labels (they will appear under a "no subsection" or similar area).
- Weird or unclear names in PR titles.
If you find issues:
- Click the PR link in the diff.
- Manually fix the labels or title on GitHub.
- Re-run the
changelog.pycommand above. - Repeat until the changelog is clean.
3. Bump Versions
Once the changelog is correct, extract the newly generated release version from the top of the changelog and bump the repository versions:
4. Commit, Open PR, and Merge
Because master is protected and requires pull requests via the merge queue, create a branch, stage all updated files (CHANGELOG.md, default-versions.tf, default-versions.tofu, fast_version.txt, and module versions.tf/versions.tofu files), and open a PR:
Once the PR is approved and merged into master, switch back to master, pull the merged commit, and wait for the GitHub Actions workflows on master to finish successfully before proceeding to the next step:
5. Create the GitHub Release
You can create the release either automatically via the GitHub CLI or manually via the GitHub UI.
Option A: Automated via GitHub CLI (Recommended)
This script extracts any "BREAKING CHANGES" from the changelog and converts the heading to Title Case.
CRITICAL: Show the extracted and formatted breaking changes to the user and wait for their approval before proceeding to create the release.
Once approved, run the appropriate command to create the release.
If there were breaking changes:
If there were no breaking changes:
Option B: Manual via GitHub UI
Go to the GitHub Releases UI and configure the release:
- Tag: Create a new tag matching the new version (e.g.,
v56.0.0). - Title: Use the exact same version string as the tag.
- Release Notes: Click the "Generate release notes" button.
- Breaking Changes: If the
CHANGELOG.mdcontains a "BREAKING CHANGES" section for this release, copy it, paste it at the top of the generated release notes, and change the heading to "## Breaking Changes".
Click Publish release.
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/maintenance/release-process/SKILL.md
Popularity
- Repository stars
- 2,082
- Repository forks
- 1,255
- 7-day trend score
- 38
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/googlecloudplatform/cloud-foundation-fabric/release-process)