Writing5.0 · 138 ratings

Product Changelog — User-Facing

Announce a feature ship. Lead with the job it does, not the feature name.

Role-BasedConstraintsOutput-Format

Prompt

**Role:** Product marketing lead who writes the public changelog for a SaaS used by 100,000+ active users. You know which entries get read and which get skipped.

**Context:** Feature shipped: [name + 1-sentence description]. The job it does: [what user task it makes faster/easier/possible]. The user who asked for this: [a real persona, paraphrased]. The trade-off (if any): [what changed that some users might not like].

**Task:** Write the changelog entry.

1. Title: 6-9 words. Lead with the JOB, not the feature name. NOT "New: Saved Views" but "Save and reuse your filtered dashboards."
2. Intro paragraph: 2-3 sentences. The job + the moment the user feels the win.
3. Visual: short caption for the screenshot/GIF that should accompany this. Describe what's IN the visual.
4. How it works: 3 numbered steps a user can follow today.
5. Why we shipped it: 1-2 sentences. Reference the user research or specific request (paraphrased) that drove it.
6. Trade-offs (if any): be honest about what changed. "Old behavior X is now Y. If you relied on X, here's the workaround."

**Constraints:**
- No "We're excited to announce"
- No "improved performance" without a number
- Steps must be testable (a user can do exactly what step 2 says)
- Trade-off section is required IF any default behavior changed

**Output format:** 6 sections · ≤300 words · with visual caption.

How to use this prompt

  1. 1

    Copy the prompt above and paste it into ChatGPT, Claude, or Gemini — or open it in the visual Studio to edit each part on a canvas and run it with your own key.

  2. 2

    Replace any bracketed placeholders with your specifics. The more concrete your context and constraints, the sharper the result — see the 5-part prompt structure.

  3. 3

    Run it, then refine. Ask the model to critique and improve its own answer with self-critique prompting.

Techniques in this prompt

Role-Based

Assigns the model an expert persona so it adopts the right vocabulary, depth, and standards for the task.

Learn this technique
Constraints

Sets the rules and boundaries — tone, length, what to avoid — that keep the output on-target.

Learn this technique
Output-Format

Specifies the exact shape of the result — sections, a table, JSON, a word count — so the output is predictable and ready to use.

Learn this technique

Recommended models

claudegpt-4o

Build on this prompt

Open it in the visual Studio to wire it into a full workflow with your own API key — or learn the craft behind prompts like this.

More in Writing