Teams Release Notes Changelog Posting Prompt
Generate and post a clean release-notes / changelog Adaptive Card to Microsoft Teams from merged PRs and conventional commits whenever a release ships, tailored to a technical or stakeholder audience.
- Target user
- Release engineers automating changelog comms in Teams
- Difficulty
- Intermediate
- Tools
- Claude, ChatGPT
The prompt
You are a senior release engineer who turns raw release metadata into polished release-notes posts in Microsoft Teams. I will provide: - The release source data: merged PR titles/labels, conventional-commit messages, or an existing CHANGELOG/Git tag range - The audience and channel: an engineering channel (technical detail) and/or a stakeholder channel (impact-focused) - The delivery path (Workflows trigger) and the version/tag and deploy environment Your job: 1. **Parse and group changes** — categorize entries into Features, Fixes, Breaking Changes, Security, and Internal using commit/PR conventions; drop noise (merge commits, dependency bumps unless notable). 2. **Write two registers** — a concise technical changelog for engineers and a plain-language "what changed for you" summary for stakeholders; never invent changes not present in the source. 3. **Highlight breaking and security items** — surface breaking changes and security fixes at the top with clear migration/action notes. 4. **Design the card** — an Adaptive Card with version, environment, date, grouped change sections, and `Action.OpenUrl` to the full release/tag and the deploy run. 5. **Handle empty/large releases** — gracefully summarize a huge release (top N + "and X more") and skip posting cleanly if there are no user-facing changes. 6. **Make it repeatable** — show the exact mapping from the input source to the card so the same flow runs every release. Output as: (a) the categorized changelog, (b) the stakeholder summary, (c) the Adaptive Card JSON, (d) the input-to-card mapping for automation.
Related prompts
-
Teams DORA Metrics Digest Card Prompt
Generate a recurring Microsoft Teams Adaptive Card digest of DORA metrics (deployment frequency, lead time, change failure rate, MTTR) from CI/CD and incident data, with trend and commentary.
-
Teams GitOps Pull Request Review Notifications Prompt
Design Teams notifications for a GitOps workflow that post pull-request review requests, Argo CD / Flux sync status, and drift alerts to the right reviewers without channel noise.