release-prep
Skill915 starsChanged 5 days agoMITView on GitHub
Check a PnP PowerShell stable release before it is cut - version files agree, every user-visible PR merged since the last release has a changelog entry, the changelog section is well formed, contributors are credited - and draft the changelog rollover. Use before dispatching the major release workflow, or to lint CHANGELOG.md at any time.
25 other projects use a version of this.
Adopted by
Most recently taken up by
- ClickHouse/clickhouse-connecttheir own version, first seen Nov 16, 2026
- microsoft/durabletask-pythontheir own version, first seen Nov 10, 2026
- colonyops/hivetheir own version, first seen Nov 7, 2026
- Terryc21/sitreptheir own version, first seen Nov 1, 2026
- kala-project/acp-kittheir own version, first seen Oct 20, 2026
- finch-xu/cc-routertheir own version, first seen Oct 15, 2026
Other versions25 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 25
- dathere/qsv★ 3.8ksame name
- Devolutions/IronRDP★ 3.3ksame name
- johnhuang316/code-index-mcp★ 1ksame name
- ClickHouse/clickhouse-connect★ 536same name
- Trampoline-AI/predict-rlm★ 436same name
- Fu-Jie/awesome-openwebui★ 326same name
- Fu-Jie/openwebui-extensions★ 326same name
- finch-xu/cc-router★ 293same name
- ten9876/AetherSDR★ 263same name
- ayutaz/piper-plus★ 240same name
15 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository15 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- .github/copilot-instructions.mdCopilot instructions
- pages/llms.txtllms.txt
- api-surface-diffSkill
- cmdlet-scaffolderSkill
- code-reviewSkill
- docs-syncSkill
- dotnet-standardsSkill
- issue-triageSkill
- new-cmdletSkill
- permissions-auditorSkill
- whatif-auditSkill
- code-reviewSkill
- new-cmdletSkill
The file
We split this skill into the rules it gives an agent
4 rules. 0 are common, 4 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 23 edited versions we read keep these.
4
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 8
Check that a stable release is ready to cut, and draft the changelog work that goes with it.
- Distinctive: line 46
If the user has not said which version is being released, ask.
- Distinctive: line 62
No entry needed; list these so the reader can see they were considered.
- Distinctive: line 64
Read the diff before drafting an entry.
“Common” is measured: kept by at least 6 in 10 of the 23 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Playbook: release-prep
Check that a stable release is ready to cut, and draft the changelog work that goes with it.
Why
A release is assembled by hand from several files that must agree, and nothing checks them. The changelog is the part users read before upgrading, and it is the part that slips: a merged PR with no entry is invisible in the release notes, and nobody notices until a user asks what changed.
Read-only. This playbook produces a report and drafts. Never dispatch a workflow, create a tag, publish a release, commit, push, or open the dev-to-main PR — hand over the command instead. See Human in the loop. Do not edit
CHANGELOG.mdunless the user asks for the drafts to be applied.
1. Versions
Three places carry the version, and Build-Release.ps1 is edited by hand:
| File | What it holds |
build/Build-Release.ps1, line 1 | $version = "X.Y.Z" — the version the release will publish |
version.txt | The last published version, written by the build |
version.json | The same, as Version; nightly builds read it |
Check:
$versioninBuild-Release.ps1is the intended release, and is higher than the last stable tag. Stable tags are the bareX.Y.Zones; avX.Y.Ztag for the GitHub release exists beside each.git tag --sort=-creatordateversion.txtandversion.jsonagree with each other. The nightly build publishes Major.Minor.(Patch + 1) ofversion.json, or replaces a%in it with0, so a hand edit that leaves them different changes the next nightly number.src/Commands/PnP.PowerShell.csprojpins forPnP.FrameworkandPnP.Core. Report the version each pair of rows carries, and say so if the two rows of a pair disagree.
If the user has not said which version is being released, ask. Do not infer it from the files.
2. Merged work with no changelog entry
List what merged since the last stable tag:
git log --merges --first-parent <last-stable-tag>..HEAD --onelineFor each PR number, look for it in the [Current nightly] section of CHANGELOG.md, either as its
own /pull/NNNN link or through the issue it closes. Then sort the PRs that have no entry:
- User-visible — the PR touches
src/Commands/,documentation/, or anything else a user of the module would notice. This needs an entry. Draft one. - Not user-visible — CI, agent configuration, build scripts with no change to the shipped module. No entry needed; list these so the reader can see they were considered.
Read the diff before drafting an entry. The PR title is not enough to say what changed for a user.
3. Changelog form
Apply these to the section being released. They also work as a lint of any section.
- Headings appear in this order, and an empty heading is removed from a released section:
### Added,### Changed,### Fixed,### Removed,### Contributors. - Each entry starts with the word of its heading: "Added …", "Changed …", "Fixed …", "Removed …". "Fix …" under Fixed is a finding, and so is a "Changed …" entry sitting under Fixed.
- A change in behaviour sits under
Changedeven when it fixes a bug. - Cmdlet and parameter names are in backticks.
- Each entry ends with one link,
[#NNNN](https://github.com/pnp/powershell/pull/NNNN)or the/issues/NNNNform. The number in the label equals the number in the URL, and the URL has no trailing slash. - An entry says what changed for the user and why they would care, in the style of its neighbours.
4. Contributors
The ### Contributors list credits people as - Full Name [githubhandle], or - [handle] when no
name is known. Compare the authors of the PRs from step 2 against the list and report anyone
missing. The earlier sections show who is conventionally left out; follow them and say what you
assumed.
Author names need GitHub. Use the GitHub MCP server, or read-only gh pr view <n> --json author. If
neither is available, list the PR numbers whose authors you could not resolve.
5. Draft the rollover
Draft, as a diff the maintainer can apply:
## [Current nightly]renamed to## [X.Y.Z], with the fixes from steps 2 to 4 applied.- A new
## [Current nightly]above it with empty### Added,### Changedand### Fixedheadings.
6. Hand over
The release itself is the maintainer's. Print the remaining steps as a checklist, without running any of them:
- Dispatch
majorrelease.yml. It refuses to run unlessdevHEAD is the commit it was started on. - Open the PR from
devtomain. - Dispatch
stabledockerimages.ymlfrommain, after the module is on the PowerShell Gallery. - Publish the draft GitHub release the workflow created.
Reporting
Lead with whether the release is ready, in one sentence. Then:
- Versions — the three values, and any disagreement
- Missing entries — PR number, what it changes for a user, and the drafted entry
- Form — line number, the rule broken, and the corrected line
- Contributors — who is missing
- Rollover — the drafted diff
- Not checked — anything you could not resolve, and what would settle it
Finish with counts: PRs merged since the last tag, with an entry, without one and user-visible, without one and not user-visible.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

