Release notes
Skill bromso/metapowers/plugins/project-management/skills/release-notes
A Claude Code plugin that adds an agentic skills framework, with MCP's and a meta prompting processes. Inspired by "Superpowers" & "Figma Console MCP", but not just for development or design; but for all aspect within the digital production cycle.
npx -y skills add bromso/metapowers --skill release-notesAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Draft release notes for shipped features
SKILL.md
4.1 KB, as published. Nobody here has run it
Release Notes
Draft release notes for "$ARGUMENTS". List all shipped features with user-facing descriptions, note breaking changes and migration steps, list known issues, and organize by category.
Prerequisites
Check that .project/$ARGUMENTS/00-initiate.md exists. If it does not, tell the user to run an Initiate skill first (e.g., project-charter) and stop.
If the user passes --skip-checks, skip the prerequisite check and log the skip to .project/$ARGUMENTS/skip-log.md with a timestamp and reason.
Process
-
Read existing context:
- Read
.project/$ARGUMENTS/00-initiate.mdfor project context and product vision - Read
.project/$ARGUMENTS/03-review.mdif it exists (for sprint review and completed stories) - Read
.project/$ARGUMENTS/02-sprint.mdif it exists (for sprint state and delivery details) - Read
.project/$ARGUMENTS/01-plan.mdif it exists (for backlog, story descriptions, and acceptance criteria)
- Read
-
List all features shipped in the release/sprint:
- Gather all completed stories from the sprint review or sprint backlog
- Include bug fixes that were resolved in this release
- Include improvements or enhancements to existing features
- Exclude internal-only changes (refactoring, test improvements, CI changes) unless they affect users
- Note the version number and release date
-
Write user-facing descriptions for each feature:
- Write in benefit-focused language: what the user can now do, not how it was implemented
- Use plain language — avoid internal jargon, code references, or ticket numbers
- Keep each description to 1-2 sentences
- Include examples or before/after comparisons where they clarify the change
- For technical features, explain the user-visible impact ("Faster page loads" not "Optimized database queries")
-
Note breaking changes and migration steps:
- List any changes that break existing behavior, APIs, or integrations
- For each breaking change, explain: what changed, why it changed, and what users need to do
- Provide step-by-step migration instructions if applicable
- Note the deprecation timeline if old behavior is being phased out gradually
- Mark breaking changes prominently so they are not missed
-
List known issues and workarounds:
- List any known bugs or limitations in this release
- For each known issue, provide a workaround if one exists
- Note which issues are planned to be fixed in the next release
- Be honest about known issues — users trust transparency more than perfection
-
Group by category:
- Organize release notes into clear categories:
- New Features — entirely new capabilities
- Improvements — enhancements to existing features
- Bug Fixes — resolved issues
- Breaking Changes — changes requiring user action
- Known Issues — current limitations with workarounds
- Within each category, order by user impact (most impactful first)
- Organize release notes into clear categories:
-
Add version number and date:
- Include the version number (e.g., v1.2.0) following semantic versioning if applicable
- Include the release date
- If this is a pre-release or beta, note the stability level
- Reference the previous version for context ("Changes since v1.1.0")
-
Write the artifact — append to
.project/$ARGUMENTS/03-review.mdunder a## Release Notessection:- Version & Date — version number, release date, previous version reference
- New Features — user-facing descriptions of new capabilities
- Improvements — enhancements to existing features
- Bug Fixes — resolved issues with brief descriptions
- Breaking Changes — changes requiring user action with migration steps
- Known Issues — current limitations with workarounds
Output
Release notes appended to .project/$ARGUMENTS/03-review.md. Present a summary highlighting:
- Version number and release date
- Number of new features, improvements, and bug fixes
- Any breaking changes requiring user action
- Number of known issues
- Overall release theme (one sentence describing the release focus)