30 Claude Prompts That Write Changelogs
Describe a release, paste a git log, or list what changed and Claude returns a finished changelog you can ship: Keep-a-Changelog entries, user-facing "what's new" notes, technical and versioned logs, and migration guides. Not "summarize these commits".
In short: This page contains 30 copy-paste ready prompts, organized into 6 categories with a description and pro tip for each. The first 15 prompts are free instantly โ no signup needed. Hand-curated and tested by the AI Academy team.
Keep-a-Changelog Format
5 promptsFull CHANGELOG.md From Scratch
1/30You are a release engineer who maintains changelogs to the Keep a Changelog 1.1 standard. <context> I need a complete CHANGELOG.md for my project, returned as one ready-to-commit Markdown file that follows keepachangelog.com and Semantic Versioning. </context> <inputs> - Project name: [PROJECT] - Current version and date: [E.G. 1.4.0, 2026-07-02] - What shipped in this release: [LIST OF CHANGES] - Notable past versions to seed history: [OPTIONAL PRIOR RELEASES] - Repo URL for compare links: [E.G. github.com/org/repo] </inputs> <task> Produce a full CHANGELOG.md: a header with the standard intro line, an [Unreleased] section, then the current release as [version] - date, sorting each change under the correct heading (Added, Changed, Deprecated, Removed, Fixed, Security). Bottom-anchor version compare links. Write each entry as a clear, past-tense, user-legible line. </task> <constraints> - Valid Markdown, exact Keep a Changelog section names and ordering, reverse-chronological versions. - No empty headings; omit categories with no entries. ISO dates. No marketing fluff. </constraints> <format> Return the complete CHANGELOG.md in a code block, then a short note on how to add the next release and keep the compare links correct. </format>
Generates a complete, standards-compliant CHANGELOG.md with compare links, ready to commit.
Pro tip: Paste your existing tags and Claude will pre-fill the compare-link footer so every version diffs correctly.
New Release Entry (Added / Changed / Fixed)
2/30You are a maintainer adding a single release block to an existing Keep a Changelog file. <context> I already have a CHANGELOG.md. I need one new release entry that drops cleanly under [Unreleased], returned as a ready-to-paste Markdown block. </context> <inputs> - New version and date: [E.G. 2.1.0, 2026-07-02] - Raw list of what changed (any order): [PASTE CHANGES] - Anything user-visible vs internal: [OPTIONAL NOTES] - Any breaking changes: [YES/NO PLUS DETAIL] </inputs> <task> Write the release block as ## [version] - date, then bucket every change under the correct Keep a Changelog heading. Rewrite raw notes into crisp past-tense lines a reader understands. Flag breaking changes explicitly with a **BREAKING** prefix under Changed or Removed. </task> <constraints> - Only the standard six headings, only those that have entries, alphabetized headings per the spec order. - No duplicate entries, no internal jargon in user-facing lines, valid Markdown. </constraints> <format> Return the single release block in a code block, then note which items you judged breaking and why. </format>
Produces one clean, correctly-bucketed release entry ready to paste under Unreleased.
Pro tip: Add a line saying which audience reads this file (users vs devs) so Claude pitches every entry at the right level.
Unreleased Section From Pending Work
3/30You are a release manager curating the [Unreleased] section of a Keep a Changelog file. <context> Work has merged since the last tag but nothing is released yet. I need a well-organized [Unreleased] section, returned as a ready-to-commit Markdown block that I keep updating until cut day. </context> <inputs> - Merged work since last release: [PASTE PR TITLES OR NOTES] - Last released version: [E.G. 3.2.1] - Target next version (if known): [OPTIONAL] - Items still in progress to exclude: [OPTIONAL] </inputs> <task> Build the ## [Unreleased] block, sorting merged work into Added/Changed/Deprecated/Removed/Fixed/Security. Suggest the correct next SemVer bump (major/minor/patch) based on the contents and justify it in one line. </task> <constraints> - Exclude anything marked in-progress. Standard headings only, no empties. - Each line is user-legible and past tense; valid Markdown. </constraints> <format> Return the [Unreleased] block in a code block, then state the recommended next version and the one change that forced that bump. </format>
Builds a tidy Unreleased section with a justified next-version recommendation, ready to commit.
Pro tip: Re-run this each time you merge a batch; Claude keeps the bump recommendation honest as scope grows.
Backfill CHANGELOG.md From Tag History
4/30You are a release historian reconstructing a changelog from a project's version history. <context> My project has git tags but no CHANGELOG.md. I need one backfilled from the history, returned as a complete ready-to-commit Markdown file in Keep a Changelog format. </context> <inputs> - Tags with dates: [PASTE `git tag` OR RELEASE LIST] - Notes or commit summaries per tag (if any): [OPTIONAL PER-TAG NOTES] - Repo URL for compare links: [github.com/org/repo] - Point where history is uncertain: [OPTIONAL CUTOFF] </inputs> <task> Generate the full CHANGELOG.md with one dated section per tag, reverse-chronological, changes bucketed under standard headings. Where notes are thin, write conservative, accurate lines and mark uncertain sections rather than inventing detail. Add the compare-link footer across all versions. </task> <constraints> - Never fabricate features; if a tag has no info, use a single honest placeholder line. - Valid Markdown, exact heading names, ISO dates, correct compare links. </constraints> <format> Return the full CHANGELOG.md in a code block, then list which versions need a human to verify the sparse entries. </format>
Reconstructs a full Keep-a-Changelog CHANGELOG.md from tag history, ready to commit.
Pro tip: Feed Claude `git log --tags --simplify-by-decoration` output so it dates every tag correctly.
Convert a Messy Changelog to the Standard
5/30You are an editor who normalizes chaotic changelogs into the Keep a Changelog standard. <context> My current changelog is inconsistent (mixed formats, wrong headings, marketing lines). I need it rewritten to strict Keep a Changelog format, returned as one ready-to-commit CHANGELOG.md. </context> <inputs> - Current changelog content: [PASTE EXISTING FILE] - Repo URL for compare links: [github.com/org/repo] - Anything to keep verbatim: [OPTIONAL] </inputs> <task> Rewrite the whole file: normalize version headers to [version] - ISO date, re-bucket every line under the six standard headings, split combined entries, strip marketing fluff, and preserve real information. Keep the same versions and dates; only fix structure and wording. Add a compare-link footer. </task> <constraints> - Do not drop factual content or invent new entries. Standard heading names and order only. - Consistent past-tense phrasing, valid Markdown, no empty sections. </constraints> <format> Return the reformatted CHANGELOG.md in a code block, then a short list of the structural problems you fixed. </format>
Rewrites a messy changelog into strict Keep-a-Changelog format with no lost content, ready to commit.
Pro tip: Ask Claude to flag any line it could not confidently categorize so you can double-check the edge cases.
XML tags are just the start. Learn the full Claude workflow.
A growing library of 300+ hands-on AI tutorials covering Claude, ChatGPT, and 50+ tools. New tutorials added every week.
User-Facing Changelog
5 promptsIn-App "What's New" Release Notes
6/30You are a product copywriter who writes friendly in-app release notes for non-technical users. <context> I need in-app "What's New" notes for our latest release, returned as a ready-to-ship block of copy that renders in a modal or update panel. </context> <inputs> - Product and version: [PRODUCT, VERSION] - What changed (technical list): [PASTE CHANGES] - Top thing users asked for: [HEADLINE FEATURE] - Tone: [FRIENDLY, PLAYFUL, CRISP PROFESSIONAL] </inputs> <task> Write the release notes: a short benefit-led headline, a one-line intro, then 3-6 grouped highlights each with a bolded feature name and a plain-language sentence on what the user can now do, plus a compact "Also improved" list of smaller fixes. Lead with the most-requested feature. Translate every technical change into a user outcome. </task> <constraints> - No version numbers in the body copy (keep it human), no internal jargon, no filler. - Each highlight names a concrete thing the user can now do; scannable formatting. </constraints> <format> Return the release-notes copy as a formatted block, then a shorter 2-line variant for a toast or badge. </format>
Writes benefit-led in-app What's New notes plus a short toast variant, ready to ship.
Pro tip: Tell Claude the one feature most people will care about and it will lead with that instead of listing changes in dev order.
Public Changelog Page Entry (Blog-Style)
7/30You are a developer-relations writer who runs a public product changelog. <context> I publish a dated changelog feed on our site. I need one entry for the newest release, returned as a ready-to-publish Markdown post styled like a changelog card. </context> <inputs> - Release date and version: [DATE, VERSION] - Changes shipped: [PASTE LIST] - Category tags used on our feed: [E.G. NEW, IMPROVED, FIXED] - Link to docs or PRs (optional): [URLS] </inputs> <task> Write a changelog entry: a dated title, a one-paragraph summary of the theme of this release, then labeled sections (New / Improved / Fixed) with short punchy bullets. Add an optional "Heads up" callout for anything users should act on. Keep it skimmable and human but precise. </task> <constraints> - Publish-ready Markdown with headings and bullets; each bullet is one clear sentence. - Link docs where it helps; no marketing hype, no empty sections. </constraints> <format> Return the changelog entry in a code block, then a one-line summary suitable for the feed's RSS description. </format>
Produces a dated, skimmable public changelog entry plus an RSS blurb, ready to publish.
Pro tip: Give Claude 2-3 past entries so it matches your feed's exact voice and category labels.
Release Announcement Email
8/30You are a lifecycle email copywriter announcing a product update to the user base. <context> We shipped a release and I want to email users about it. I need a ready-to-send announcement email, returned as subject lines plus body copy. </context> <inputs> - Product and audience: [PRODUCT, WHO GETS THIS] - Headline change and its benefit: [BIG NEW THING] - Supporting changes worth mentioning: [2-4 ITEMS] - Primary CTA: [E.G. TRY IT NOW, UPDATE THE APP] </inputs> <task> Write the email: 3 subject-line options, a preview text, a warm opener, one hero paragraph on the headline change and why it matters, a short "also new" bulleted list, a single clear CTA button label plus link placeholder, and a one-line sign-off. Keep it benefit-led and short enough to read on mobile. </task> <constraints> - One dominant CTA, no more than 4 secondary bullets, no jargon, plain text friendly. - Subject lines under 55 characters; specific, not clickbait. </constraints> <format> Return the subject options and full email body as a formatted block, then note the single metric this email should move. </format>
Writes a mobile-friendly release announcement email with subject options and one CTA, ready to send.
Pro tip: Tell Claude whether readers must take an action (update, migrate) so it either sells or instructs, not both.
App Store / Play Store "What's New" Text
9/30You are a mobile ASO writer producing store release notes within platform limits. <context> I need the "What's New" text for an app store update, returned as ready-to-paste copy that fits App Store and Google Play conventions. </context> <inputs> - App name and version: [APP, VERSION] - Changes in this build: [PASTE LIST] - Whether it is a feature release or bugfix build: [FEATURE / MAINTENANCE] - Tone: [DESCRIBE] </inputs> <task> Write store release notes: an optional one-line hook, then short user-facing bullets grouped as new features first and fixes last. For a maintenance build, write a warm, honest "bug fixes and performance improvements" style note that still names one real fix. Keep it well under 4000 characters and scannable on a phone. </task> <constraints> - No version numbers or internal ticket IDs, no jargon; emoji only if the tone calls for it. - Lead with user value; concise bullets; nothing that would trip store review. </constraints> <format> Return the store notes as plain text ready to paste, then a shorter variant for the tighter Play Store early lines. </format>
Produces store-ready What's New text with a concise variant for both platforms, ready to paste.
Pro tip: Even for a bugfix build, hand Claude one real fix so the note names it instead of the generic filler line.
Hosted Changelog Page (HTML Artifact)
10/30You are a front-end developer building a self-hosted public changelog page. <context> I want a standalone changelog page I can host, built as one self-contained, responsive HTML file with inline CSS, previewable instantly as an artifact. </context> <inputs> - Product name and brand vibe: [PRODUCT, STYLE/COLORS] - Recent releases to render: [3-6 ENTRIES WITH DATE, VERSION, CHANGES] - Category labels and colors: [E.G. NEW, IMPROVED, FIXED] - Optional subscribe CTA: [EMAIL / RSS] </inputs> <task> Build a changelog feed page: a header with title and optional subscribe input, then a vertical timeline of dated entry cards, each showing version, date, colored category tags, and grouped bullets. Include an anchor link per entry and a subtle filter-by-category control (CSS/JS-light). Render the provided releases as real content. </task> <constraints> - One self-contained responsive HTML file; Google Fonts only; accessible contrast and semantic markup. - Clean timeline layout, consistent card design, no dependencies or frameworks. </constraints> <format> Return the full HTML as an artifact, then explain the card data structure so I can add new releases. </format>
Builds a hosted changelog timeline page with tagged entry cards as a previewable artifact.
Pro tip: Ask Claude to output an entry-object template so adding future releases is a copy-paste, not a redesign.
Technical Changelog
5 promptsLibrary / SDK Release Changelog
11/30You are a library maintainer writing a precise technical changelog for developer consumers. <context> I am releasing a new version of a code library. I need a developer-facing changelog for the release, returned as a ready-to-commit Markdown block. </context> <inputs> - Library name and version: [LIB, VERSION] - Public API changes: [ADDED/CHANGED/REMOVED SIGNATURES] - Behavioral changes and bug fixes: [PASTE LIST] - Breaking changes: [DETAIL OR NONE] - Minimum runtime / dependency changes: [OPTIONAL] </inputs> <task> Write the changelog: a version header, a prominent Breaking Changes section (if any) with the old vs new API and a one-line reason each, then Added, Changed, Deprecated, Fixed, and Dependencies sections. Reference exact function/class names in backticks. Note the SemVer implication of each breaking change. </task> <constraints> - Precise, terse, developer-legible; real symbol names in code font. - Breaking changes first and unmissable; no user-marketing tone; valid Markdown. </constraints> <format> Return the changelog block in a code block, then state the required SemVer bump and why. </format>
Writes a precise SDK release changelog with a breaking-changes section and SemVer call, ready to commit.
Pro tip: Paste the actual before/after signatures; Claude will render them as diff-style lines developers can scan instantly.
REST / API Changelog Entry
12/30You are an API technical writer maintaining a versioned API changelog. <context> Our API changed and I need a changelog entry for developers integrating against it, returned as a ready-to-publish Markdown block. </context> <inputs> - API name and version/date: [API, VERSION OR DATE] - Endpoints added/changed/removed: [PASTE, WITH METHOD + PATH] - Request/response field changes: [ADDED, RENAMED, REMOVED FIELDS] - Deprecations with sunset dates: [OPTIONAL] - Auth or rate-limit changes: [OPTIONAL] </inputs> <task> Write the entry with sections: Breaking Changes, New Endpoints, Changed Endpoints, Deprecated (with sunset dates), and Fixed. For each item show the method and path in code font, the exact field-level change, and a one-line migration hint. Note which changes require consumer action before a date. </task> <constraints> - Endpoint and field names in backticks; explicit deprecation timelines; no vague wording. - Separate breaking from additive changes clearly; valid Markdown. </constraints> <format> Return the API changelog entry in a code block, then a one-line summary developers can paste into their upgrade ticket. </format>
Produces a field-level API changelog entry with deprecation timelines, ready to publish.
Pro tip: List field renames as old -> new pairs and Claude will build an exact mapping integrators can follow line by line.
Internal Service Deploy Notes
13/30You are a platform engineer writing deploy notes for an internal service release. <context> We are deploying a backend service and I need engineer-facing deploy notes for the release channel, returned as a ready-to-post Markdown block. </context> <inputs> - Service name and version/build: [SERVICE, VERSION] - Changes in this deploy: [PASTE LIST] - Config/env var changes: [OPTIONAL] - Migrations or feature flags: [OPTIONAL] - Rollback plan: [HOW TO REVERT] </inputs> <task> Write deploy notes: a summary line, What Changed (grouped by user-impacting vs internal), Config Changes (new/changed env vars with defaults), Migrations & Flags (order-sensitive steps), Monitoring (what metrics/alerts to watch post-deploy), and a Rollback section with exact steps. Flag anything that needs coordination. </task> <constraints> - Action-oriented and unambiguous; commands and env vars in code font. - Call out order-sensitive steps and irreversible actions explicitly; valid Markdown. </constraints> <format> Return the deploy notes in a code block, then a 3-item pre-deploy checklist to confirm before shipping. </format>
Writes engineer-facing deploy notes with config, rollback, and monitoring steps, ready to post.
Pro tip: Tell Claude which changes are irreversible and it will separate them so on-call knows what cannot be rolled back.
Dependency-Bump Changelog
14/30You are a maintainer documenting a dependency-update release. <context> This release is mostly dependency and tooling bumps. I need a clear changelog entry that tells developers what to expect, returned as a ready-to-commit Markdown block. </context> <inputs> - Project and version: [PROJECT, VERSION] - Dependencies bumped: [NAME old -> new PAIRS] - Any that carry breaking or behavioral changes: [WHICH ONES] - Toolchain/build changes: [OPTIONAL] - Security-relevant updates (CVEs): [OPTIONAL] </inputs> <task> Write the entry with sections: Security (CVE fixes via updates, if any), Dependencies (a table of name, old, new, and note), Changed (behavioral shifts caused by a bump), and Action Required (anything consumers must change). Highlight security-driven bumps and any that alter runtime behavior. </task> <constraints> - Render dependency versions in a clean table; call out breaking transitive changes. - Do not bury security updates; valid Markdown; concise notes only. </constraints> <format> Return the changelog entry in a code block, then a one-line risk assessment for upgrading. </format>
Produces a dependency-bump changelog with a version table and action-required notes, ready to commit.
Pro tip: Paste your lockfile diff and Claude will turn it into the old->new table and flag the risky majors.
Database / Schema Migration Changelog
15/30You are a backend engineer documenting database schema changes for a release. <context> This release changes the database schema and I need a changelog entry that captures the migration for other engineers and ops, returned as a ready-to-commit Markdown block. </context> <inputs> - Service/DB and version: [SERVICE, VERSION] - Schema changes: [TABLES/COLUMNS ADDED, RENAMED, DROPPED] - Data backfills required: [OPTIONAL] - Migration ordering vs code deploy: [DB-FIRST / CODE-FIRST] - Reversibility: [REVERSIBLE / NOT] </inputs> <task> Write the entry: Schema Changes (each change with table.column and type), Migration Steps (exact ordered steps, marking DB-before-code or code-tolerates-both), Backfill notes, Downtime/locking impact, and a Rollback section. Flag any destructive or non-reversible operation prominently. </task> <constraints> - Table and column names in code font; explicit ordering; call out locking and destructive steps. - Never imply a drop is safe; valid Markdown; concise, accurate lines. </constraints> <format> Return the changelog entry in a code block, then a short safe-deploy sequence (expand -> migrate -> contract) for this change. </format>
Writes a schema-migration changelog with ordered steps and rollback, ready to commit.
Pro tip: State whether the deploy is DB-first or code-first and Claude will order the steps to avoid the classic missing-column outage.
Versioned Entries & Releases
5 promptsSemVer Bump Decision + Entry
16/30You are a release owner applying Semantic Versioning rigorously. <context> I have a set of changes and need to decide the correct next version, then produce the matching changelog entry, returned as a ready-to-commit Markdown block plus the version decision. </context> <inputs> - Current version: [E.G. 2.3.4] - Changes in this release: [PASTE LIST] - Public API surface (what counts as breaking here): [DESCRIBE] - Pre-1.0 or stable: [E.G. 0.x OR 1.x+] </inputs> <task> Classify each change as major/minor/patch impact, decide the resulting version per SemVer (respecting 0.x rules if pre-1.0), then write the changelog entry under that version with standard headings. Show your bump reasoning as a short table of change -> impact. </task> <constraints> - Follow SemVer strictly; the highest-impact change sets the bump. - Justify each classification in one line; valid Markdown. </constraints> <format> Return the impact table, the chosen version with a one-line rationale, and the changelog entry in a code block. </format>
Decides the correct SemVer bump and produces the matching versioned entry, ready to commit.
Pro tip: Define what 'public API' means for your project up front so Claude classifies breaking changes correctly.
GitHub Release Notes (Tag Body)
17/30You are a maintainer writing the body of a GitHub Release for a tag. <context> I am publishing a GitHub Release and need the release-notes body, returned as ready-to-paste Markdown that renders well on the Releases page. </context> <inputs> - Tag/version and previous tag: [E.G. v1.5.0, prev v1.4.2] - Changes shipped: [PASTE LIST OR PR TITLES] - Contributors to credit: [OPTIONAL HANDLES] - Repo URL: [github.com/org/repo] </inputs> <task> Write the release body: a one-line headline of the release theme, Highlights (2-4 bullets on the biggest changes), then What's Changed grouped by type with PR-style bullets, a New Contributors section if provided, and a Full Changelog compare link (prev...current). Keep it GitHub-flavored-Markdown clean. </task> <constraints> - Include the compare link in the exact `prev...tag` form; credit contributors with @ handles. - Skimmable, no fluff, valid GitHub Markdown. </constraints> <format> Return the release body in a code block, then the one-line release title to put in the tag's name field. </format>
Produces a GitHub Release body with highlights, changes, and a compare link, ready to paste.
Pro tip: Paste the auto-generated 'What's Changed' list and Claude will rewrite it into human highlights while keeping the PR links.
Multi-Version Release History Table
18/30You are a documentation writer building a release-history overview. <context> I need a compact release-history table that summarizes several versions at a glance for a docs page, returned as a ready-to-publish Markdown table plus short notes. </context> <inputs> - Versions with dates: [PASTE LIST] - Headline change per version: [ONE LINE EACH] - Support/EOL status per version: [OPTIONAL] - Whether each is LTS/stable/deprecated: [OPTIONAL] </inputs> <task> Build a table with columns: Version, Date, Highlights, Status (Current / Supported / Deprecated / EOL). Sort newest first. Below the table, add a short legend for the status values and a one-line note on which version most users should be on. </task> <constraints> - Clean Markdown table, consistent date format, one concise highlight per row. - Accurate status labels; no invented versions. </constraints> <format> Return the release-history table and legend in a code block, then a one-line upgrade recommendation. </format>
Builds a newest-first release-history table with support status, ready to publish.
Pro tip: Add EOL dates and Claude will bold the versions that are past support so readers upgrade off them.
Hotfix / Patch Release Entry
19/30You are an on-call engineer writing the changelog for an urgent patch release. <context> We shipped a hotfix and I need a focused patch changelog entry, returned as a ready-to-commit Markdown block that makes the fix and its impact unmistakable. </context> <inputs> - Version and date: [E.G. 2.3.5, 2026-07-02] - What was broken and its impact: [THE BUG] - The fix: [WHAT CHANGED] - Affected versions: [WHICH RELEASES HAD THE BUG] - Any user action needed: [OPTIONAL] </inputs> <task> Write a patch entry: a version header, a Fixed section describing the bug, its user impact, and the resolution in plain terms, plus a Security section if the bug had security implications. Note which versions were affected and whether users must upgrade urgently. </task> <constraints> - Patch-scope only; no unrelated changes. State affected versions explicitly. - Clear on urgency without alarmism; valid Markdown. </constraints> <format> Return the patch changelog entry in a code block, then a one-line advisory users can read to decide whether to upgrade now. </format>
Writes a focused hotfix changelog entry with affected-versions and urgency, ready to commit.
Pro tip: Say whether the bug had a security angle and Claude will add a Security section with the right severity framing.
Beta / RC Pre-Release Entry
20/30You are a release manager documenting a pre-release (alpha/beta/RC) build. <context> I am cutting a pre-release and need a changelog entry that sets tester expectations, returned as a ready-to-commit Markdown block using a SemVer pre-release identifier. </context> <inputs> - Pre-release version: [E.G. 3.0.0-beta.1] - What's new to test: [PASTE LIST] - Known issues / not-yet-done: [LIST] - How to install the pre-release: [CHANNEL/COMMAND] - Feedback channel: [WHERE TO REPORT] </inputs> <task> Write the pre-release entry: a header with the pre-release version, a short 'this is a pre-release, expect changes' note, Added/Changed sections for what to test, a Known Issues section, install instructions, and a line on how to give feedback. Make clear which items are still unstable. </task> <constraints> - Use the correct SemVer pre-release tag; label unstable features explicitly. - Do not present beta features as final; valid Markdown; install command in code font. </constraints> <format> Return the pre-release changelog entry in a code block, then a short call-to-test blurb for the announcement. </format>
Produces a pre-release changelog with known issues and a call-to-test, ready to commit.
Pro tip: List what is deliberately unfinished; Claude will separate it from real features so testers file useful bugs, not dupes.
Migration & Upgrade Notes
5 promptsMajor-Version Upgrade Guide
21/30You are a maintainer writing a major-version upgrade guide for consumers of your project. <context> We are releasing a major version with breaking changes. I need a complete upgrade guide (vOLD to vNEW), returned as one ready-to-publish Markdown document. </context> <inputs> - Project and versions: [PROJECT, vOLD -> vNEW] - Breaking changes: [PASTE LIST WITH OLD vs NEW] - New required config or setup: [OPTIONAL] - Estimated migration effort: [SMALL/MEDIUM/LARGE] - Deprecations removed in this version: [OPTIONAL] </inputs> <task> Write the guide: an intro on why the major bump and expected effort, a Breaking Changes summary table, then a step-by-step Migration section with before/after code for each breaking change, a Removed Deprecations list, a Troubleshooting section for common upgrade errors, and a final verification checklist. Order steps so the codebase stays runnable between them where possible. </task> <constraints> - Every breaking change gets concrete before/after code in fenced blocks. - Steps are ordered and testable; no hand-waving; valid Markdown. </constraints> <format> Return the upgrade guide in a code block, then a condensed 'quick migration' checklist for experienced users. </format>
Writes a full major-version upgrade guide with before/after code and a checklist, ready to publish.
Pro tip: Paste your real deprecation warnings; Claude maps each one to the exact code edit that clears it.
Breaking-Change Migration Steps
22/30You are a developer-experience engineer documenting a single breaking change. <context> One specific breaking change needs a focused migration note so consumers can adapt quickly, returned as a ready-to-publish Markdown block with before/after code. </context> <inputs> - What changed (the breaking change): [DESCRIBE] - Old usage: [CODE OR CONFIG] - New usage: [CODE OR CONFIG] - Why it changed: [REASON] - Codemod or shortcut available: [OPTIONAL] </inputs> <task> Write the migration note: a one-line 'what changed', a short 'why', a Before block and an After block side by side in fenced code, a step list to make the change, edge cases to watch, and any find/replace or codemod shortcut. Make it copy-paste actionable. </task> <constraints> - Before/after code must be complete and runnable, not pseudocode. - Cover at least one edge case; valid Markdown; concise. </constraints> <format> Return the migration note in a code block, then a single search pattern users can grep to find every affected spot. </format>
Produces a focused breaking-change migration note with runnable before/after code, ready to publish.
Pro tip: Ask Claude for the exact grep or codemod so users can locate every call site instead of hunting manually.
Deprecation Notice + Timeline
23/30You are an API owner publishing a formal deprecation notice. <context> We are deprecating a feature and need a clear notice with a timeline and a replacement path, returned as a ready-to-publish Markdown block. </context> <inputs> - What's being deprecated: [FEATURE/ENDPOINT/OPTION] - Replacement (if any): [WHAT TO USE INSTEAD] - Deprecation date and removal date: [DATES OR VERSIONS] - Migration effort: [DESCRIBE] - Who is affected: [AUDIENCE] </inputs> <task> Write the notice: a clear statement of what is deprecated as of when and removed when, why it is being retired, the recommended replacement with a short before/after example, a migration checklist, and a bold callout of the removal date. Keep the tone respectful of users' time. </task> <constraints> - State both the deprecation and removal dates/versions unambiguously. - Always give a replacement path or say clearly there is none; valid Markdown. </constraints> <format> Return the deprecation notice in a code block, then a one-line in-product warning message to show users of the old feature. </format>
Writes a formal deprecation notice with timeline and replacement path, ready to publish.
Pro tip: Give both the deprecation and removal dates; Claude will produce the in-app warning copy for the whole grace period.
Config / Environment Migration Guide
24/30You are a platform engineer documenting configuration changes for an upgrade. <context> An upgrade changes required configuration or environment variables. I need a config migration guide, returned as a ready-to-publish Markdown document. </context> <inputs> - Product and versions: [PRODUCT, vOLD -> vNEW] - Env/config changes: [ADDED, RENAMED, REMOVED, NEW DEFAULTS] - Secrets or credentials changes: [OPTIONAL] - Deployment surfaces affected: [E.G. DOCKER, CI, .ENV] </inputs> <task> Write the guide: a summary table of every config key (old name, new name, required?, default, note), a Migration Steps section per deployment surface, an example old .env vs new .env diff, and a verification step to confirm the app boots with the new config. Flag any key that is now required and had no default before. </task> <constraints> - Config keys in code font; a clear old->new mapping for renames. - Call out newly required keys prominently; valid Markdown. </constraints> <format> Return the config migration guide in a code block, then a copy-paste diff of the .env changes. </format>
Produces a config/env migration guide with a key-mapping table and .env diff, ready to publish.
Pro tip: Paste your old and new .env.example files and Claude will generate the exact key-by-key mapping and diff.
Data-Migration Upgrade Runbook
25/30You are an SRE writing a data-migration runbook for a risky upgrade. <context> This upgrade requires migrating production data. I need a step-by-step runbook the on-call team can execute safely, returned as a ready-to-publish Markdown document. </context> <inputs> - System and versions: [SYSTEM, vOLD -> vNEW] - The data migration required: [DESCRIBE] - Estimated data volume and downtime tolerance: [DETAIL] - Backup and rollback capability: [DESCRIBE] - Validation queries or checks available: [OPTIONAL] </inputs> <task> Write the runbook: Pre-flight (backups, maintenance window, prerequisites), Migration Steps (numbered, each with the command and expected result), Validation (checks that prove success), Rollback (exact reversal steps), and a Post-migration monitoring list. Mark any irreversible step in bold and require a checkpoint before it. </task> <constraints> - Every step has a verifiable expected outcome; commands in code font. - Irreversible actions gated behind an explicit backup-confirmed checkpoint; valid Markdown. </constraints> <format> Return the runbook in a code block, then a go/no-go checklist to run at the start of the maintenance window. </format>
Writes a step-by-step data-migration runbook with rollback and validation, ready to publish.
Pro tip: Tell Claude your downtime tolerance and it will choose an online vs maintenance-window strategy and note the tradeoffs.
Most people use 10% of Claude. Tutorials unlock the rest.
AI Academy: 300+ hands-on tutorials on Claude, ChatGPT, Midjourney, and 50+ AI tools. New tutorials added every week.
Auto-Summarized From Commits
5 promptsChangelog From Raw Git Log
26/30You are a release tool that turns raw commit history into a clean changelog. <context> I will paste raw git log output. Turn it into a polished release changelog, returned as a ready-to-commit Markdown block in Keep a Changelog format. </context> <inputs> - Git log (paste): [OUTPUT OF `git log --oneline` SINCE LAST TAG] - Version and date for this release: [VERSION, DATE] - Audience: [DEVELOPERS / USERS] - Commits to exclude (chores, merges): [OPTIONAL RULES] </inputs> <task> Parse the commits, drop noise (merge commits, formatting, chores unless requested), then rewrite the meaningful ones into user-legible past-tense lines and bucket them under Added/Changed/Deprecated/Removed/Fixed/Security. Collapse related commits into one entry where they describe a single change. </task> <constraints> - Do not invent changes not present in the log; merge duplicates. - Rewrite terse commit messages into clear entries; valid Markdown; standard headings only. </constraints> <format> Return the changelog entry in a code block, then list any commits you excluded and why. </format>
Turns raw git log output into a clean, bucketed Keep-a-Changelog entry, ready to commit.
Pro tip: Pipe `git log --oneline PREV_TAG..HEAD`; Claude collapses the noise and rewrites cryptic messages into readable lines.
Group Conventional Commits Into a Release
27/30You are a release-notes generator that understands Conventional Commits. <context> Our commits follow the Conventional Commits spec (feat, fix, chore, etc.). Turn them into a grouped release changelog, returned as a ready-to-commit Markdown block. </context> <inputs> - Conventional commit list: [PASTE COMMITS] - Version and date: [VERSION, DATE] - Scopes to surface or hide: [OPTIONAL] - Treat any commit as breaking (BREAKING CHANGE / !): [NOTE] </inputs> <task> Group commits by type into standard sections: Features (feat), Bug Fixes (fix), Performance (perf), and a Breaking Changes section for any '!' or BREAKING CHANGE footer. Within each section, group by scope and rewrite the description into a clear line. Recommend the SemVer bump implied by the commit types. </task> <constraints> - Honor the '!' and BREAKING CHANGE conventions for the bump; hide chore/ci/docs unless requested. - Preserve scopes as prefixes where useful; valid Markdown. </constraints> <format> Return the grouped changelog in a code block, then the recommended version bump with the commit that forced it. </format>
Groups Conventional Commits into a typed release changelog with a bump call, ready to commit.
Pro tip: Include the full commit bodies so Claude catches BREAKING CHANGE footers, not just the ! in the subject.
Changelog From Merged PR Titles
28/30You are a maintainer building release notes from a list of merged pull requests. <context> I have the merged PRs for this release. Turn them into a clean changelog, returned as a ready-to-publish Markdown block that keeps PR references. </context> <inputs> - Merged PRs (title, number, author): [PASTE LIST] - Version and date: [VERSION, DATE] - Labels used for categorization: [E.G. feature, bug, docs] - Repo URL: [github.com/org/repo] </inputs> <task> Rewrite each PR title into a user-legible entry, bucket by category (using labels if present, otherwise inferring), append the PR reference like (#123) with a link, and credit first-time contributors. Merge PRs that are parts of one feature into a single line. Drop pure-internal PRs unless they affect users. </task> <constraints> - Keep (#number) references and links; do not invent PRs. - Rewrite titles into outcomes, not raw PR names; valid Markdown. </constraints> <format> Return the changelog in a code block, then a New Contributors list for anyone shipping their first PR. </format>
Converts merged PR titles into a categorized changelog with references, ready to publish.
Pro tip: Paste PR labels alongside titles and Claude will bucket entries by label instead of guessing the category.
Diff / PR Summary Into User Highlights
29/30You are a product communicator translating a technical diff into user-facing highlights. <context> I have a code diff or PR description that is technical. Turn it into a short user-facing highlight for a changelog, returned as ready-to-publish copy. </context> <inputs> - The diff or PR summary: [PASTE] - What the product does: [ONE LINE] - The user who benefits: [AUDIENCE] - Tone: [DESCRIBE] </inputs> <task> Read the technical change and write 1-3 user-facing highlight lines that describe what the user can now do or what got better, not how it was implemented. Include a short 'why it matters' clause per highlight. Ignore purely internal refactors that have no user impact and say so. </task> <constraints> - No implementation detail in the user-facing copy; benefit-led. - Be honest when a change is internal-only; no overselling; concise. </constraints> <format> Return the user-facing highlights as a formatted block, then the one-line internal note explaining what actually changed. </format>
Translates a technical diff into benefit-led user highlights plus an internal note, ready to publish.
Pro tip: Paste the whole PR body; Claude separates the user-visible win from the refactor noise so you don't overclaim.
Weekly / Sprint Changelog From a Commit Range
30/30You are a team lead producing a recurring shipped-this-week changelog. <context> Each week I summarize what shipped for the team and stakeholders. Turn a commit range into a weekly changelog, returned as a ready-to-publish Markdown update. </context> <inputs> - Commits or PRs for the period: [PASTE] - Date range: [E.G. WEEK OF 2026-06-30] - Audience: [ENGINEERING / WHOLE COMPANY / CUSTOMERS] - Themes or projects to group under: [OPTIONAL] </inputs> <task> Write a weekly update: a one-line summary of the week, Shipped (grouped by theme or project with plain-language bullets), In Progress if referenced, and Fixed. Tailor the language to the audience (deeper for engineering, outcome-focused for company-wide). Keep it short and skimmable. </task> <constraints> - Group by theme, not by commit; rewrite messages into outcomes. - Match depth to the stated audience; no filler; valid Markdown. </constraints> <format> Return the weekly changelog in a code block, then a 2-line TL;DR suitable for a Slack post. </format>
Turns a commit range into a themed weekly/sprint changelog plus a Slack TL;DR, ready to publish.
Pro tip: Give Claude the audience up front; the same commits become a deep eng log or a crisp company update accordingly.
Frequently Asked Questions
Prompts are the starting line. Tutorials are the finish.
A growing library of 300+ hands-on tutorials on ChatGPT, Claude, Midjourney, and 50+ AI tools. New tutorials added every week.
7-day free trial. Cancel anytime.