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: approach → 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
Approach / Test docs	✅	❌	❌
Approach-Impl gap analysis	✅	❌	❌
Iterative review (auto-fix + retry)	✅	❌	❌
Progress tracking across sessions	✅	❌	❌

Workflow

graph LR
    DSC["/jira-task discover\nTopic → requirements doc"] -.-> N["/jira-task create\nNew issue + sub-tasks"]
    N -.-> A["/jira-task init\nBatch worktree setup"]
    A --> B["/jira-task start\nIn Progress"]
    B --> C["/jira-task approach\nApproach doc (L1/L2/L3)"]
    C --> 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 DSC fill:#A0522D,color:#fff
    style N fill:#8B4513,color:#fff
    style A fill:#2B50D4,color:#fff
    style J fill:#156030,color:#fff
    style AUTO fill:#7B2D8B,color:#fff

Discover (optional first step): /jira-task discover "<topic>" turns a free-form topic into a structured docs/requirements/<slug>.requirements.md, which /jira-task create --from-requirements <file> can then consume to bulk-register Epic/Story/Sub-tasks.

Shortcut: /jira-task auto <ID> runs start → approach → 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

Interactive Issue Creation (v0.12.0) /jira-task create [hint] registers a brand-new Jira issue from conversation context. If context is thin, it asks a few batched questions; if the scope warrants it, it proposes a sub-task breakdown (with Blocks links for dependencies so downstream init can auto-detect ready-to-start sub-tasks). Supports linking to an existing epic.

No raw jira_create_issue footguns: the skill encodes the exact mcp-atlassian schema (e.g. additional_fields is a JSON string, parent is a bare key, priority is {"name": "..."}, components is a CSV string, assignee must be top-level).
Auto sub-task decision: the skill judges whether to split based on scope; no flag needed.
Silent-skip guard: re-fetches created issues to verify priority/labels actually landed (unknown additional_fields keys are otherwise dropped with only a warning).

Auto Mode (v0.9.0) /jira-task auto PROJ-123 runs the full start → approach → 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.