Back to cookbook

AI Prompt to Generate Release Notes From Jira Tickets Using Atlassian's MCP Server

0 views Updated

Make this prompt yours

Share

This Jira MCP prompt turns a list of completed tickets into a readable set of release notes, built for engineering managers, release managers, and developer-relations teams who ship a changelog with every deploy or sprint close. Instead of manually scanning a fix version in Jira and rewriting ticket titles by hand, the AI reads the ticket data directly and drafts notes grouped by type, in language a non-technical stakeholder can follow.

The prompt assumes the model is connected to Jira through Atlassian's official remote MCP server, so it can pull tickets by project key, fix version, or sprint without anyone exporting a CSV first. It asks the model to separate features, fixes, and internal changes, strip Jira-specific jargon and ticket-key clutter, flag anything that needs a manual rewrite (security fixes, breaking changes), and keep the output format consistent release after release.

Because release notes quality depends heavily on how the prompt itself is structured, running a first draft of this prompt through a tool like Prompt Optimizer before using it on a real sprint can tighten the instructions and catch ambiguity in the grouping rules before they show up in a published changelog.

Prompt template

Make this prompt yours

prompt-template
355 tokens
ROLE: You are a release notes writer working from live Jira data retrieved through an MCP connection. CONTEXT: - Jira project key: [PROJECT_KEY] - Fix version or sprint to summarize: [FIX_VERSION_OR_SPRINT] - Audience for these notes: [AUDIENCE, e.g. end users, internal team, enterprise customers] - Tone: [TONE, e.g. plain and professional, upbeat and casual] TASK: 1. Retrieve all tickets in [PROJECT_KEY] tagged with fix version or sprint [FIX_VERSION_OR_SPRINT] via the connected Jira MCP server. 2. Group the tickets into exactly these sections: "New Features", "Improvements", "Bug Fixes", and "Internal Changes (not customer-facing)". 3. For each ticket, write one short sentence in plain language describing what changed and why it matters to [AUDIENCE] — do not copy the raw ticket title verbatim. 4. Exclude the "Internal Changes" section from the customer-facing version if [AUDIENCE] is external; include it only in the internal version. 5. Flag any ticket labeled "security", "breaking-change", or with no description under a separate "Needs Manual Review" heading instead of guessing at its content. CONSTRAINTS: - Do not invent functionality that isn't described in the ticket data. - Do not include Jira ticket keys in the customer-facing version; keep them in the internal version for traceability. - Keep each bullet to one sentence unless the change is a breaking change, which gets two sentences: what changed and what action is required. OUTPUT FORMAT: Return the release notes as Markdown with the four section headings above (omitting empty sections), followed by a "Needs Manual Review" list if applicable.

Want it sharper? Optimize this prompt with Prompt Optimizer, check it with the Prompt Debugger or shorten it with the Token Optimizer.

Example input

example-input
131 tokens
Project key: APP Fix version: v4.12.0 Audience: end users (customer-facing release notes) Tone: plain and professional Tickets in this fix version (retrieved via Jira MCP): - APP-2291: Add CSV export to reporting dashboard - APP-2305: Fix timezone bug causing incorrect timestamps on invoices - APP-2298: Refactor internal billing service for faster queries - APP-2312: Patch auth token validation (label: security) - APP-2287: Improve loading state on settings page - APP-2299: Remove unused legacy export endpoint (label: breaking-change)

When to use it

  • You're closing a sprint or fix version in Jira and need a changelog before a deploy goes out
  • A release manager wants notes split into features, fixes, and internal changes without touching raw ticket data
  • A support or customer success team needs a plain-language summary of what changed, not engineering shorthand
  • You're publishing recurring release notes (weekly, biweekly) and want a consistent format every time

Best practices

  • Scope the pull to a specific project key and fix version or sprint so the model isn't summarizing unrelated backlog tickets
  • Tell the model explicitly how to handle tickets with no description or a vague summary, rather than letting it guess at intent
  • Ask for a separate "needs human review" section for security fixes, breaking changes, or anything flagged with a specific label
  • Review the first output against the actual ticket list before publishing, since a dropped or miscategorized ticket is easy to miss in a long release

Common mistakes

  • Feeding the model every open ticket in the project instead of filtering to the fix version or sprint actually shipping
  • Not specifying tone, so notes swing between terse ticket titles and overly casual marketing language within the same release
  • Letting internal-only tickets (refactors, test fixes) appear in customer-facing notes without a separate internal section
  • Skipping a final human pass, which lets an incorrectly closed or mislabeled ticket make it into the published notes

FAQs

Can this prompt work without a live Jira MCP connection?

Yes, but you lose the main advantage. Without an MCP server, you'd need to manually export or paste ticket data into the prompt each time, which works for a one-off release but defeats the point for a recurring changelog workflow.

Does this replace a release manager's final review?

No. The prompt drafts a structured first pass, but ticket data is sometimes incomplete or mislabeled, so a human should still confirm the final notes before they go out, especially anything flagged under manual review.

What's the difference between this and a generic "summarize these tickets" prompt?

This prompt specifies exact section groupings, tells the model how to handle missing data instead of guessing, and separates customer-facing content from internal-only changes — a generic summary prompt usually blends all of that together.

Can I adapt this prompt for a different issue tracker instead of Jira?

Yes. The structure (group by type, write plain-language summaries, flag items needing review) works the same way if you swap the MCP connection for Linear, GitHub Issues, or another tracker's MCP server — just update the retrieval step.

Which Cuelara tool can help me tighten this prompt before using it on a real release?

Prompt Optimizer — restructures vague or messy engineering prompts into clearer, more specific instructions, which helps here since ambiguous grouping rules are what cause miscategorized release notes. Intelligence Score — grades the prompt's clarity and specificity before you run it on a live sprint, catching gaps in the manual-review criteria early.

Found this prompt useful? Share it.

Share

More in Engineering

Engineering

AI Prompt to Triage and Prioritize Engineering Issues Using Linear's MCP Server

This Linear MCP prompt helps engineering leads, team leads, and project managers use an AI assistant connected to Linear's Model Context Pro…

ROLE
You are an engineering triage assistant with access to a Linear workspace through its MCP server integration.

CONTEXT
Team or project: [TEAM_OR_PROJECT_NAME]
Time window: issues updated or opened in the last [TIME_WINDOW]
Priority scale in use: [PRIORITY_SCALE_DEFINITION]
Current sprint or cycle goal: [SPRINT_GOAL]

TASK
1. Pull all open issues matching the team, project, and time window above through the Linear MCP connection.
2. Group the issues into: blocked, in progress, and not started.
3. For each issue, assess severity using this rubric: [SEVERITY_RUBRIC], customer or revenue impact, how long it has been open, and whether it blocks other issues.
4. Flag any issue missing a priority, assignee, or label, and list it separately as a hygiene issue rather than ranking it.
5. Produce a prioritized list of the top [NUMBER] issues the team should work on next, with a one-line justification for each ranking.
6. Note any issues that appear to duplicate each other or contradict the stated sprint goal.

CONSTRAINTS
- Do not invent issue data that is not present in the Linear workspace; if a field is missing, say so explicitly.
- Keep each justification to one sentence.
- Do not take any write actions (status changes, reassignments) unless I explicitly confirm each one.

OUTPUT FORMAT
1. Hygiene issues (missing priority, assignee, or label) - bullet list
2. Blocked issues - bullet list with blocker noted
3. Prioritized list of top [NUMBER] issues - numbered, with one-line justification each
4. Possible duplicates or conflicts with sprint goal - bullet list

Make this prompt yours

Engineering

AI Prompt to Write a Technical Design Document (RFC) for a New Feature

This technical design document prompt , sometimes called an RFC prompt, is for engineers and tech leads who need to turn a feature idea into…

ROLE: You are a senior engineer writing a technical design document for team review.

CONTEXT:
- Feature or change: [WHAT IS BEING BUILT OR CHANGED]
- Problem it solves: [THE CONCRETE PROBLEM OR PAIN POINT]
- Current system constraints: [EXISTING ARCHITECTURE, TEAM SIZE, DEADLINE, OR OTHER LIMITS]
- Proposed approach: [HIGH-LEVEL DESCRIPTION OF THE SOLUTION]
- Known alternatives considered: [ANY OTHER APPROACHES ALREADY DISCUSSED, IF ANY]

CONSTRAINTS:
- Do not invent specific performance numbers, benchmarks, or capacity figures that were not provided
- Include at least one alternative approach and explain why it was not chosen
- Flag any open questions or risks explicitly rather than glossing over them
- Keep the document scannable: short paragraphs, no filler language

OUTPUT FORMAT:
1. Problem statement (what's broken or missing today)
2. Proposed solution (the approach, at a level engineers outside the immediate team can follow)
3. Alternatives considered (at least one, with reasons it was rejected)
4. Risks and open questions
5. Rollback plan (what happens if this needs to be reverted)

Write the design document now using only the information provided above.

Make this prompt yours

Engineering

AI Prompt to Design an API Error-Handling and Retry Strategy

This AI prompt for error handling helps engineers design a consistent retry and failure strategy for an API client or backend service before…

Role: You are a backend engineer designing a resilient API error-handling and retry strategy.

Context:
- API being called: [API_NAME_OR_DESCRIPTION]
- Language/framework: [LANGUAGE_OR_FRAMEWORK]
- Known behavior: [RATE_LIMITS_TIMEOUTS_ERROR_CODES]
- Call pattern: [SINGLE_REQUEST_OR_BATCH_OR_HIGH_VOLUME]
- Idempotency: [IS_THE_OPERATION_SAFE_TO_RETRY]

Task:
1. Classify likely failure modes for this API call into retryable and non-retryable categories.
2. Recommend a specific retry strategy (backoff type, max attempts, max total wait, jitter) for the retryable category.
3. Recommend how non-retryable errors should be handled (fail fast, surface to caller, alert).
4. Note where a circuit breaker or rate limit guard would help if call volume is high.
5. Provide implementation code in [LANGUAGE_OR_FRAMEWORK] that applies this strategy to the described call.

Constraints:
- Do not retry non-retryable errors.
- Include logging at each retry attempt and final failure.
- Keep the retry logic isolated so it can be reused across multiple API calls.

Output format:
- A short table of failure modes (error type, retryable: yes/no, handling)
- The recommended retry parameters
- The implementation code in a fenced code block

Make this prompt yours