Back to cookbook

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

0 views Updated

Make this prompt yours

Share

This Linear MCP prompt helps engineering leads, team leads, and project managers use an AI assistant connected to Linear's Model Context Protocol server to triage a backlog of open issues, flag what's stale or mislabeled, and propose a prioritized order the team can act on immediately. It's built for anyone who manages a Linear workspace with ChatGPT, Claude, or Gemini and wants the model to read live issue data through the MCP connection rather than copy-pasting ticket lists by hand.

The prompt gives the model a clear triage rubric (severity, customer impact, age, blocked status) so it doesn't just summarize the backlog but actually ranks it and explains its reasoning for each recommendation. It also asks the model to flag issues with missing labels, no assignee, or conflicting priority fields, which is the kind of workspace hygiene problem that's tedious to catch manually across dozens or hundreds of tickets.

Because a full backlog pulled through an MCP connection can run into thousands of tokens of issue titles, descriptions, and comment threads, this is also a good candidate for trimming before you run it repeatedly. If your Linear exports are large, running the filled-in prompt through the Token Optimizer first can cut the context down and lower the cost of each triage pass without losing the fields the model needs to rank issues correctly.

Prompt template

Make this prompt yours

prompt-template
351 tokens
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

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
361 tokens
ROLE You are an engineering triage assistant with access to a Linear workspace through its MCP server integration. CONTEXT Team or project: Checkout Platform Time window: issues updated or opened in the last 30 days Priority scale in use: P0 = production outage or data loss, P1 = major feature broken for many users, P2 = minor bug or edge case, P3 = cosmetic or nice-to-have Current sprint or cycle goal: Reduce checkout error rate before the Q4 sale 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: P0-P3 as defined above, 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 8 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 unless I explicitly confirm each one. OUTPUT FORMAT 1. Hygiene issues - bullet list 2. Blocked issues - bullet list with blocker noted 3. Prioritized list of top 8 issues - numbered, with one-line justification each 4. Possible duplicates or conflicts with sprint goal - bullet list

When to use it

  • Running a weekly or sprint-start backlog grooming session across a shared Linear team
  • Onboarding a new engineering lead who needs a fast, ranked view of what's actually urgent
  • Auditing a backlog after a product pivot to find issues that no longer match current priorities
  • Catching data-hygiene problems like unassigned, unlabeled, or duplicate issues before planning

Best practices

  • Give the model your team's actual priority definitions (P0-P3 or whatever scale you use) instead of letting it invent its own severity scale
  • Scope the triage to one team or project per run so the ranked list stays short enough to act on in one sitting
  • Ask for the reasoning behind each ranking, not just the final order, so you can spot-check and override calls you disagree with
  • Re-run the triage on a fixed cadence (weekly or biweekly) so priority drift gets caught early instead of piling up

Common mistakes

  • Feeding in the entire backlog at once instead of a single team or sprint, which produces vague, unranked summaries
  • Not specifying what counts as 'blocked' or 'stale' in your workspace, leaving the model to guess
  • Treating the output as final instead of a draft ranking for a human to review and adjust
  • Skipping a check on whether the MCP connection actually has write access, then being surprised it can't update priority fields directly

FAQs

Does the AI need write access to my Linear workspace to triage issues?

No. Read access through the MCP connection is enough to pull issues, labels, and statuses for triage. Write access is only needed if you want the assistant to update priorities or assignees directly, and the prompt above explicitly withholds write actions unless you confirm each one.

Can this prompt work with ChatGPT, Claude, and Gemini the same way?

Yes, the prompt itself is written in plain role-context-task-constraints structure that works across models. What differs is how each model's client connects to Linear's MCP server, since MCP client support and setup steps vary by platform and are still evolving.

How is this different from just asking the AI to summarize my Linear backlog?

A plain summary request tends to produce a flat description of what exists. This prompt forces a ranking against an explicit severity rubric, separates data-hygiene problems from real prioritization, and asks for a one-line justification per ranked item, so the output is something a team can act on rather than just read.

What should I do if the triage results look off or inconsistent?

Check whether your priority scale and severity rubric were specific enough in the prompt. Vague definitions are the most common cause of inconsistent rankings, and tightening the rubric language usually fixes it faster than re-running the same prompt repeatedly.

Which Cuelara tool can help me tighten this prompt before running it on a real backlog?

Prompt Debugger — scans the triage prompt for vague constraints, like an undefined severity rubric, before you run it against live issue data. Intelligence Score — grades the overall clarity and specificity of the filled-in prompt so you can catch weak spots before relying on its output for planning.

Found this prompt useful? Share it.

Share

More in Engineering

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

Engineering

AI Prompt to Write a Rollback Plan for a Risky Deployment

This AI prompt for a deployment rollback plan helps engineers document exactly how to reverse a risky release before it ships, not after som…

ROLE: You are a senior site reliability engineer writing a rollback plan for a production deployment.

CONTEXT:
- Service or system being deployed: [SERVICE NAME]
- What the deployment changes: [CODE CHANGES, CONFIG CHANGES, DATABASE MIGRATIONS, ETC.]
- Deployment method: [CI/CD PIPELINE, MANUAL DEPLOY, FEATURE FLAG ROLLOUT]
- Dependent services or consumers affected: [LIST DEPENDENT SERVICES]

TASK:
Write a rollback plan for this deployment that includes:
1. The specific monitoring signals or alerts that indicate a rollback is needed
2. Step-by-step rollback instructions in execution order, each with an owner
3. Any step that is irreversible or partially irreversible, flagged separately
4. A verification step to confirm the rollback succeeded
5. An estimated time to complete the rollback

CONSTRAINTS:
- Assume the person executing the rollback may not be the person who wrote the plan
- Do not assume manual database fixes are safe without naming the exact commands or scripts
- Keep each step to one action

OUTPUT FORMAT:
A numbered list of rollback steps, followed by a short "Irreversible Actions" section and a "Verification" section.

Make this prompt yours