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
mzd-hseokkim