Product Intelligence Blueprint
Safety checkedGenerate Shipped Changelog From Sprint Tasks
Ship customer-facing changelogs with confidence by automatically verifying that completed sprint tasks actually merged to your release branch, deduplicating related changes, and rewriting them in plain language. Your PM reviews only what truly shipped before publishing.
2 Files Included
03-sprint-changelog-consolidated.md
24 KB
README.md
2 KB
What problem does this solve?
Product and engineering teams writing customer-facing changelogs often rely on task status alone, which overstates what actually shipped and buries customers in duplicate, engineering-worded entries. This workflow gives PMs a changelog that is provably accurate before it gets published.
How does it work?
- Matches every completed sprint task to its linked GitHub pull request and confirms the PR merged to the release branch, not just to main.
- Classifies verified changes as Feature, Improvement, or Fix, and filters out internal-only work like refactors and tooling changes.
- Merges tasks that deliver a single customer-visible change into one deduplicated entry, then rewrites it in plain customer language against a fixed voice profile.
- Routes the draft, plus any unverified or low-confidence entries, to the PM for approval via Chat.
- Commits the approved changelog to the docs repository as a pull request and verifies the merged diff matches what was approved.
- Announces the release in company and product channels and updates roadmap epic statuses to reflect what actually shipped.
What's the biggest win?
A publish-ready, customer-facing changelog where every entry traces back to a verified, merged pull request, with duplicate engineering tasks collapsed into single, correctly categorized customer-visible lines, plus roadmap and epic statuses automatically reconciled to match.
What's required to run this?
- Runs on ClickUp, using Sprints to track task completion and Docs, Chat, Goals, Dashboards, and Automations to draft, route, and announce the changelog
- Connects to GitHub through an MCP integration, with read access to pull requests to verify what merged and write access scoped only to the docs repository to commit the final changelog
- Needs a changelog voice profile Doc and a product glossary set up in advance, so the rewriting step has a consistent style and terminology to follow
- Needs a controlled product area taxonomy defined ahead of time, used to tag and group changelog entries consistently
What are the constraints?
- Runs on ClickUp, using Sprints to track task completion and Docs, Chat, Goals, Dashboards, and Automations to draft, route, and announce the changelog
- Connects to GitHub through an MCP integration, with read access to pull requests to verify what merged and write access scoped only to the docs repository to commit the final changelog
- Needs a changelog voice profile Doc and a product glossary set up in advance, so the rewriting step has a consistent style and terminology to follow
- Needs a controlled product area taxonomy defined ahead of time, used to tag and group changelog entries consistently
Tools in this Blueprint
About This Blueprint
- Industry
- Information Technology