Skill: Jira Bug Management

Purpose

Create and manage bug reports in the dedicated bugs project.

When to Use

• QA Engineer finds a defect during testing
• User/stakeholder reports a bug
• Developer discovers a bug during implementation

MCP Tools Used

Tool	Purpose
Atlassian:createJiraIssue	Create bug reports
Atlassian:editJiraIssue	Update bug status/details
Atlassian:addCommentToJiraIssue	Add investigation notes
Atlassian:transitionJiraIssue	Move bug through workflow
Atlassian:searchJiraIssuesUsingJql	Find related bugs

Configuration

{
  "cloudId": "{{jira.cloudId}}",
  "projectKey": "{{jira.bugs.projectKey}}",
  "issueTypes": {
    "bug": "{{jira.bugs.issueTypes.bug}}"
  }
}

Creating a Bug

Bug Report Format

## Summary
[Clear, specific description of the bug]

## Environment
- **Browser/Device:** [e.g., Chrome 120, Windows 11]
- **Environment:** [Dev/Staging/Production]
- **Version/Build:** [If applicable]
- **User Role:** [If relevant]

## Steps to Reproduce
1. [Specific step 1]
2. [Specific step 2]
3. [Specific step 3]

## Expected Result
[What should happen]

## Actual Result
[What actually happens]

## Evidence
- Screenshots: [Attached]
- Console Errors: [If any]
- Logs: [If relevant]

## Severity
[Critical/Major/Minor/Trivial]

## Impact
[Who is affected and how badly]

## Workaround
[If any workaround exists]

## Related
- Story: [PROJECT-XX] (if related to a story)
- Similar bugs: [BUG-XX] (if related to other bugs)

Example: Create Bug

Atlassian:createJiraIssue({
  cloudId: "{{jira.cloudId}}",
  projectKey: "{{jira.bugs.projectKey}}",
  issueTypeName: "Bug",
  summary: "Password reset email not sent for Gmail addresses",
  description: `## Summary
Password reset emails are not being delivered to Gmail addresses. Other email providers work correctly.

## Environment
- **Browser/Device:** Chrome 120, Windows 11
- **Environment:** Staging
- **Version/Build:** v2.3.1

## Steps to Reproduce
1. Go to login page
2. Click "Forgot Password"
3. Enter a Gmail address (e.g., test@gmail.com)
4. Click "Send Reset Link"
5. Wait 10+ minutes

## Expected Result
User receives password reset email within 5 minutes.

## Actual Result
No email is received. No error is shown to user. Email appears in send queue but marked as "failed".

## Evidence
- Screenshot of email queue showing failed status attached
- Server logs show "550 5.7.1 rejected by Gmail" error

## Severity
Major

## Impact
~40% of users use Gmail and cannot reset their passwords.

## Workaround
Users can contact support for manual password reset.

## Related
- Story: MDDEV-45 (Password reset feature)`,
  labels: ["agent-generated", "email", "authentication"]
})

Severity Definitions

Severity	Definition	Response
Critical	System down, data loss, security breach	Immediate fix required
Major	Feature completely broken, no workaround	Fix in current sprint
Minor	Feature broken but workaround exists	Fix when possible
Trivial	Cosmetic issue, typo	Low priority

Adding Investigation Notes

Atlassian:addCommentToJiraIssue({
  cloudId: "{{jira.cloudId}}",
  issueIdOrKey: "MDB-15",
  commentBody: `🤖 **QA Engineer Agent**

**Investigation Notes:**

Root cause identified: Gmail is rejecting emails due to missing SPF record for new sending domain.

**Technical Details:**
- Error: 550 5.7.1 SPF check failed
- Domain: notifications.example.com
- Missing: SPF TXT record

**Recommended Fix:**
Add SPF record to DNS:
\`v=spf1 include:_spf.google.com include:sendgrid.net ~all\`

Assigning to DevOps for DNS update.`
})

Used By Agents

• QA Engineer - Primary user, creates and tracks bugs
• Senior Developer - Updates with investigation findings
• Junior Developer - Updates when fixing bugs