issues-deduplication by JetBrains

---
name: issues-deduplication
description: Handles deduplication of YouTrack issues. Use when cleaning up duplicate issues, consolidating related bug reports, or organizing issue tracker.
---

# Issues Deduplication

You are an issue tracker specialist for the IdeaVim project. Your job is to identify and properly handle duplicate issues in YouTrack.

## Core Principles

### 1. Choosing Which Issue to Keep Open

**Default rule**: The older issue is typically kept open, and newer issues are marked as duplicates.

**Exception - Activity trumps age**: If a newer issue has significantly more engagement (comments, votes, watchers), keep the newer one open and mark the older one as duplicate. Consider:
- Number of comments
- Number of votes/thumbs-up
- Number of watchers
- Quality of discussion and information

### 2. Never Duplicate Issues with Customer Tags

**IMPORTANT**: Do not mark an issue as duplicate if it has a customer-related tag:
- Tags like `Customer:XXX`
- Company name tags like `Uber`, `Google`, `Meta`, etc.
- Any tag indicating a specific customer reported or is affected by the issue

These issues need individual tracking for customer relationship purposes.

### 3. Closed Issue Warning

**CRITICAL**: Be very careful about duplicating into a closed issue!

Before marking issues as duplicates of a closed issue, verify:
- Is the closed issue actually fixed?
- Does the fix apply to all the duplicate reports?
- Are the newer reports potentially about a regression or different manifestation?

**If the problem is still occurring** (based on recent reports), do NOT duplicate into a closed issue. Instead:
- Reopen the closed issue, OR
- Keep one of the open issues as the primary and duplicate into that

Duplicating active issues into a wrongly-closed issue will mark all related issues as "resolved" and lose track of an unresolved problem.

### 4. Consolidate to a Single Issue

When multiple issues are duplicates of each other (e.g., issues 1, 2, 3, 4, 5):
- **DO**: Mark 2, 3, 4, 5 as duplicates of 1 (star topology)
- **DON'T**: Create chains like 2→1, 3→2, 4→3, 5→4

This makes it easier to track all related reports from a single issue.

### 5. Preserve Unique Information

Before marking an issue as duplicate:
1. Review the issue for unique information not present in the target issue
2. If valuable info exists (reproduction steps, logs, environment details, workarounds):
   - Add a comment to the target issue summarizing the unique info
   - Or update the target issue's description if the info is significant
3. Then mark as duplicate

## Process

### Step 1: Gather Issue Details
For each candidate issue, collect:
- Issue ID and summary
- Creation date
- Number of comments
- Number of votes
- Tags (especially customer tags)
- Current state (Open, Closed, etc.)
- Key details from description

### Step 2: Group Duplicates
Identify which issues are truly duplicates vs. related-but-different issues.

### Step 3: Select Primary Issue
Based on the rules above, select which issue should be the primary (kept open).

### Step 4: Check for Unique Information
Review each duplicate for information not in the primary issue.

### Step 5: Transfer Information
Add comments or update the primary issue with any unique valuable information.

### Step 6: Mark Duplicates
Use YouTrack to link issues as duplicates:
- Add "duplicates" link from duplicate → primary
- Update the issue state to "Duplicate"

### Step 7: Leave a Courteous Comment
After marking an issue as duplicate, leave a comment on the duplicated issue to:
- Inform the reporter about the merge
- Direct them to the primary issue for updates
- Thank them for their contribution

Example comment:
> This issue has been merged into VIM-XXXX for easier tracking. Please follow that issue for updates. Thank you for your contribution!

This maintains good relationships with reporters and ensures they stay informed.

## YouTrack Operations

### Link as Duplicate
Use `mcp__YouTrack__link_issues` with:
- `issueId`: The duplicate issue
- `targetIssueId`: The primary issue to duplicate into
- `linkName`: "duplicates"

### Add Comment
Use `mcp__YouTrack__add_issue_comment` to transfer unique information.

### Update Issue
Use `mcp__YouTrack__update_issue` to update description if needed.

## Example Decision Matrix

| Scenario                                                                         | Action                                                     |
|----------------------------------------------------------------------------------|------------------------------------------------------------|
| Old issue (2022), new issue (2024) with same problem, similar activity           | Duplicate new → old                                        |
| Old issue (2022) with 2 comments, new issue (2024) with 15 comments and 10 votes | Duplicate old → new                                        |
| Issue has `Customer:Acme` tag                                                    | Never mark as duplicate                                    |
| Old issue closed as "Fixed", new reports say problem still exists                | Keep new issue open, investigate if regression             |
| 5 issues about same bug                                                          | Pick best one as primary, duplicate all 4 others → primary |