jira-claude-code-integration

jira-integration · Claude Code Plugin

[English] | 한국어

Automate your entire dev workflow — from Jira issue to merged PR — inside Claude Code.

---

Why This Plugin?

Most Jira + AI tools stop at CRUD (read/create/update issues). This plugin automates the entire development lifecycle: planning → design → implementation → testing → review → PR → done, with every step synced back to Jira automatically.

	This Plugin	Atlassian Official AI	netresearch/jira-skill
Jira MCP integration	✅	✅	❌ Python scripts
Full PDCA lifecycle	✅	❌ code gen only	❌ CRUD only
Multi-worktree batch setup	✅	❌	❌
Auto Jira status transitions	✅	✅	manual
Plan / Design / Test docs	✅	❌	❌
Design-Impl gap analysis	✅	❌	❌
Iterative review (auto-fix + retry)	✅	❌	❌
Progress tracking across sessions	✅	❌	❌

---

Workflow

graph LR
    A["/jira-task init\nBatch worktree setup"] --> B["/jira-task start\nIn Progress"]
    B --> C["/jira-task plan\nPlanning doc"]
    C --> D["/jira-task design\nDesign doc"]
    D --> E["/jira-task impl\nImplement"]
    E --> F["/jira-task test\nE2E + unit tests"]
    F --> G["/jira-task review\nGap analysis + review"]
    G --> H["/jira-task merge\nLocal merge"]
    H --> I["/jira-task pr\nCreate GitHub PR"]
    I --> J["/jira-task done\nDone"]

    AUTO["⚡ /jira-task auto\nstart→review (auto)"]

    style A fill:#2B50D4,color:#fff
    style J fill:#156030,color:#fff
    style AUTO fill:#7B2D8B,color:#fff

Shortcut: /jira-task auto <ID> runs start → plan → design → impl → test → review automatically. Each step runs as an isolated sub-agent, and already-completed steps are skipped. If review fails, it auto-fixes and retries (up to 2×).

Each step automatically posts a comment and/or attachment to the Jira issue and transitions its status.

---

Key Features

Auto Mode (v0.9.0) /jira-task auto PROJ-123 runs the full start → plan → design → impl → test → review pipeline automatically.

• Sub-agent isolation: Each step runs as an independent sub-agent, preventing context pollution between stages.
• Iterative review: When review finds issues (gap analysis or code quality), auto-fix → test → review retries up to 2 times before stopping.
• Smart resume: Already-completed steps are skipped based on .jira-context.json.
• Scope boundary: merge, pr, done are excluded (cross-worktree / externally visible actions require manual confirmation).

Interactive Setup Wizard (v0.6.0) /jira setup guides you through prerequisites (uv, Python 3.10+), credential collection, MCP server registration, and connection validation — no manual CLI commands needed.

Multi-Worktree Parallel Development (v0.7.0) /jira-task init supports three argument modes: count (init 5 — bulk setup), issue key (init PROJ-123 — sub-task analysis), or natural language (init "auth 관련 작업" — filtered search). Creates isolated git worktrees for each task.

Document Auto-generation Generates plan.md, design.md, test reports, and review results — then immediately posts them as Jira attachments and comments. No copy-paste required.

Status Transition Automation start → In Progress, merge → In Review, done → Done. Jira stays up to date without opening a browser.

Design-Impl Gap Analysis /jira-task review compares your design document against actual code changes and flags discrepancies alongside code quality issues.

Session Continuity Progress is tracked in .jira-context.json. Reopen Claude Code anytime and see exactly where you left off:

Progress: init ✓ → start ✓ → plan ✓ → design → impl → test → review → merge → pr → done

---

Prerequisites

Requirement	Required	Purpose
Claude Code	Yes	CLI environment
Python 3.10+ + uv	Yes	Run MCP server (uvx mcp-atlassian)
Git	Yes	Branch / worktree management
Jira Cloud account + API Token	Yes	Jira integration
GitHub CLI (gh)	PR step only	Create GitHub PRs

---

Quick Start

# 1. Install the plugin
claude plugin marketplace add mzd-hseokkim/jira-claude-code-integration
claude plugin install jira-integration@jira-claude-code-integration