Atlassian Jira Usage

Atlassian Jira Usage — Stellar Integration

Project Constants

Use these values directly. Never search for or ask the user about them.

Label Requirement

Every ticket, epic, story, task, or bug created in NONEVM must include the stellar label. This is how the board filters work — tickets without this label will not appear on the Stellar board.

When calling createJiraIssue, always include:

additional_fields={
  "labels": ["stellar"]
}

When adding labels to an existing issue, preserve any existing labels and append stellar if missing.

Creating Tickets

Use createJiraIssue from the Atlassian MCP. Always provide:

• projectKey: "NONEVM"
• labels: ["stellar"] via additional_fields

createJiraIssue(
  cloudId="...",
  projectKey="NONEVM",
  issueTypeName="Task",        # or Story, Bug, Epic
  summary="...",
  description="...",
  additional_fields={
    "labels": ["stellar"]
  }
)

For epics with child tickets, create the epic first, capture its key, then create children with parent set to the epic key. Every child also needs the stellar label.

Searching Issues

Pre-built JQL patterns for this project. Replace placeholders as needed.

All open Stellar issues:

project = NONEVM AND labels = stellar AND status != Done ORDER BY priority DESC, updated DESC

Stellar issues by status:

project = NONEVM AND labels = stellar AND status = "In Progress" ORDER BY updated DESC

Recently completed:

project = NONEVM AND labels = stellar AND status = Done AND resolved >= -7d ORDER BY resolved DESC

Blocked or high-priority:

project = NONEVM AND labels = stellar AND (priority IN (Highest, High) OR status = Blocked) AND status != Done ORDER BY priority DESC

Issues under an epic:

parent = "NONEVM-XXX" AND labels = stellar ORDER BY priority DESC

Text search within Stellar scope:

project = NONEVM AND labels = stellar AND text ~ "search terms" ORDER BY updated DESC

Unassigned Stellar issues:

project = NONEVM AND labels = stellar AND assignee is EMPTY AND status != Done ORDER BY priority DESC

Triaging Bugs

When triaging errors or bugs for this project, scope duplicate searches to the Stellar label:

project = NONEVM AND labels = stellar AND type = Bug AND text ~ "error signature" ORDER BY created DESC

Always create new bugs with issueTypeName="Bug" and include the stellar label.

Status Reports

When generating status reports, use the Stellar-scoped JQL patterns above. Group by status:

1. Query completed: status = Done AND resolved >= -7d
2. Query in-progress: status = "In Progress"
3. Query blocked: status = Blocked
4. Query high-priority open: priority IN (Highest, High) AND status != Done

All queries should include project = NONEVM AND labels = stellar.

Quick Reference