pf-release_skill

Overview

This skill documents and automates the PF DEV mono-repo release flow for versioning, tagging, and deployment. It guides maintainers through checks, changeset creation, bumping versions, generating Git tags, deploying, and publishing release notes. Designed for TypeScript monorepos managed with pnpm, Turbo, Changesets, and GitHub Actions.

How this skill works

It inspects repository state and runs the documented steps: confirm main branch and CI status, create a changeset, run pnpm bump and pnpm tag, commit and push tags selectively, and trigger or verify deployments. The skill enforces required checks like build/lint, user approval before pushing tags, and package whitelist for tagging. It also helps compose GitHub Release notes and rollback commands.

When to use it

• Preparing a scheduled or hotfix release for PF DEV mono-repo
• After changes are merged to main and all CI checks pass
• When creating or updating package versions and Git tags
• Before triggering automated production deployments
• When drafting GitHub Release notes and publishing them

Best practices

• Always update and test main locally: git checkout main && git pull before starting
• Run build and lint (pnpm build, pnpm lint) and validate staging tests before tagging
• Create a Changeset (pnpm changeset) and review .changeset/*.md before bumping versions
• Commit version changes with issue number and use explicit tag pushes (do not use --follow-tags)
• Require explicit user approval before pushing tags and ensure only whitelisted packages are tagged

Example use cases

• Minor feature release: create changeset, pnpm bump, pnpm tag, push specified package tags, verify GH Actions run, publish GitHub Release
• Patch hotfix: apply fix on main, run pnpm changeset for patch, bump, tag single package, push after approval, deploy to production
• Staging-only deployment: bypass auto-deploy by running pnpm turbo build:staging --filter=app and manual SCP or script deployment
• Rollback scenario: revert last commit, reinstall, rebuild and push revert to quickly undo a bad release