| 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:
- Review the issue for unique information not present in the target issue
- 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
- 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 issuetargetIssueId: The primary issue to duplicate intolinkName: "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 |
