Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -66,6 +66,12 @@
"description": "GitHub specification integration and verification",
"source": "./plugins/github-spec-kit",
"version": "2.2.0"
},
{
"name": "developer-kit-jira",
"description": "Jira integration with Atlassian MCP Server for automated SDLC workflows",
"source": "./plugins/developer-kit-jira",
"version": "2.2.0"
}
]
}
12 changes: 12 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

## [Unreleased]

### Added

- **New Plugin: developer-kit-jira** - Jira integration with Atlassian MCP Server for automated SDLC workflows
- `jira-mcp-workflow` skill for comprehensive workflow management
- 10 commands for complete Git-Jira integration:
- Ticket management: `devkit.jira.ticket.view`, `devkit.jira.ticket.comment`, `devkit.jira.ticket.transition`
- Workflow automation: `devkit.jira.workflow.start`, `devkit.jira.workflow.commit`, `devkit.jira.workflow.push`,
`devkit.jira.workflow.pr-create`, `devkit.jira.workflow.pr-ready`, `devkit.jira.workflow.pr-merge`, `devkit.jira.workflow.status`
- Automatic ticket inference from branch names (feature/PROJECT-123)
- User confirmations before all state changes
- MCP Server configuration via `.mcp.json`

## [2.2.0] - 2026-02-20

### Added
Expand Down
21 changes: 20 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ multiple languages and frameworks. Built as a modular marketplace, you can insta

## Architecture

Developer Kit is organized as a **modular marketplace** with 10 independent plugins (**92 skills, 43 agents, 36 commands**):
Developer Kit is organized as a **modular marketplace** with 11 independent plugins (**93 skills, 43 agents, 46 commands**):

```
plugins/
Expand All @@ -33,6 +33,7 @@ plugins/
├── developer-kit-aws/ # AWS CloudFormation/AWS Architecture
├── developer-kit-ai/ # Prompt Engineering/RAG/Chunking
├── developer-kit-devops/ # Docker/GitHub Actions
├── developer-kit-jira/ # Jira/Atlassian MCP Server integration
├── developer-kit-project-management/ # LRA workflow/Meetings
└── github-spec-kit/ # GitHub specification integration
```
Expand Down Expand Up @@ -169,6 +170,23 @@ DevOps and containerization expertise.

---

### developer-kit-jira

Jira integration with Atlassian MCP Server for automated SDLC workflows. Synchronizes Git operations with Jira ticket management.

**Commands**:

- **Ticket Management**: `/devkit.jira.ticket.view`, `/devkit.jira.ticket.comment`, `/devkit.jira.ticket.transition`
- **Workflow**: `/devkit.jira.workflow.start`, `/devkit.jira.workflow.commit`, `/devkit.jira.workflow.push`,
`/devkit.jira.workflow.pr-create`, `/devkit.jira.workflow.pr-ready`, `/devkit.jira.workflow.pr-merge`,
`/devkit.jira.workflow.status`

**Skills**: `jira-mcp-workflow`

**Setup**: Requires Atlassian MCP Server configuration in `claude_mcp_settings.json`

---

### developer-kit-project-management

Project management and workflow commands.
Expand Down Expand Up @@ -205,6 +223,7 @@ GitHub specification integration and verification.
| PHP/WordPress | `developer-kit-php` | 3 Skills, 5 Agents |
| AWS CloudFormation | `developer-kit-aws` | 16 Skills, 3 Agents |
| AI/ML | `developer-kit-ai` | 3 Skills, 1 Agent, 1 Command |
| Jira/Atlassian | `developer-kit-jira` | 1 Skill, 10 Commands |

---

Expand Down
35 changes: 35 additions & 0 deletions plugins/developer-kit-jira/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
{
"name": "developer-kit-jira",
"version": "2.2.0",
"description": "Jira integration with Atlassian MCP Server for automated SDLC workflows",
"author": {
"name": "Giuseppe Trisciuoglio",
"email": "giuseppe.trisciuoglio@gmail.com"
},
"homepage": "https://github.com/giuseppe-trisciuoglio/developer-kit",
"repository": "https://github.com/giuseppe-trisciuoglio/developer-kit.git",
"license": "MIT",
"keywords": [
"developer-kit",
"jira",
"atlassian",
"mcp",
"workflow",
"project-management"
],
"commands": [
"./commands/devkit.jira.ticket.view.md",
"./commands/devkit.jira.ticket.comment.md",
"./commands/devkit.jira.ticket.transition.md",
"./commands/devkit.jira.workflow.start.md",
"./commands/devkit.jira.workflow.commit.md",
"./commands/devkit.jira.workflow.push.md",
"./commands/devkit.jira.workflow.pr-create.md",
"./commands/devkit.jira.workflow.pr-ready.md",
"./commands/devkit.jira.workflow.pr-merge.md",
"./commands/devkit.jira.workflow.status.md"
],
"skills": [
"./skills/jira-mcp-workflow"
]
}
73 changes: 73 additions & 0 deletions plugins/developer-kit-jira/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
# Developer Kit Jira

Jira integration with Atlassian MCP Server for automated SDLC workflows.

## Overview

The `developer-kit-jira` plugin provides seamless integration between Git workflows and Jira using the official Atlassian MCP Server. It enables automatic inference of Jira tickets from git context (branch names, commits, PRs) and manages ticket state transitions with user confirmation.

## Agents

None - this plugin provides commands and skills only.

## Commands

### Ticket Management

- `devkit.jira.ticket.view` - View Jira ticket details including summary, status, assignee, and description
- `devkit.jira.ticket.comment` - Add comments to tickets
- `devkit.jira.ticket.transition` - Manage ticket status transitions

### Workflow Commands

- `devkit.jira.workflow.start` - Start development on a ticket (branch creation + Jira update)
- `devkit.jira.workflow.commit` - Commit with Jira reference + add comment
- `devkit.jira.workflow.push` - Push branch + update Jira
- `devkit.jira.workflow.pr-create` - Create PR + transition to "In Review"
- `devkit.jira.workflow.pr-ready` - Mark PR ready + transition to "Reviewing"
- `devkit.jira.workflow.pr-merge` - Merge PR + transition to "Done"
- `devkit.jira.workflow.status` - Show combined git and Jira status

## Skills

- **jira-mcp-workflow** - Comprehensive workflow management with MCP integration, including ticket inference from branch names, automated Jira updates, and complete SDLC workflow automation

## Dependencies

- `developer-kit` (required)
- Atlassian MCP Server (user-configured)
- GitHub CLI (`gh`) for PR operations

## Setup

### MCP Configuration

To use this plugin, you need to configure the Atlassian MCP Server in your `claude_mcp_settings.json`:

```json
{
"mcpServers": {
"atlassian": {
"command": "npx",
"args": ["-y", "@anthropic-ai/mcp-remote", "https://mcp.atlassian.com/v1/mcp"],
"env": {}
}
}
}
```

### Authentication

The Atlassian MCP Server uses OAuth 2.1 (3LO) flow:
1. First connection will prompt for Atlassian login
2. Grant permissions for Jira access
3. Session-based tokens are managed automatically

### Key Features

- **Automatic ticket inference** from branch names (feature/PROJECT-123)
- **Atlassian MCP Server integration** for all Jira operations
- **User confirmations** before all state changes
- **Git-Jira synchronization** for complete SDLC workflow
- **Input validation** with regex pattern `[A-Z]+-[0-9]+`
- **Branch name sanitization** to prevent injection
100 changes: 100 additions & 0 deletions plugins/developer-kit-jira/commands/devkit.jira.ticket.comment.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,100 @@
---
description: Provides functionality to add comments to Jira tickets. Use when you need to document progress, add notes, or update tickets with development information.
allowed-tools: Bash, AskUserQuestion
argument-hint: "[TICKET-ID] \"comment message\""
---

# Add Comment to Jira Ticket

## Overview

Adds a comment to a Jira ticket using the Atlassian MCP Server.

## Usage

```
/devkit.jira.ticket.comment [TICKET-ID] "comment message"
```

## Arguments

| Argument | Description | Required |
|----------|-------------|----------|
| `$1` | Jira ticket ID (e.g., TEST-123). Inferred from branch if omitted. | No |
| `$2` | Comment message to add | Yes |

## Execution

### Step 1: Parse Arguments

```bash
# Determine ticket ID and message
if [ $# -eq 1 ]; then
# Only message provided, infer ticket
MESSAGE="$1"
TICKET=$(git branch --show-current 2>/dev/null | grep -oE '[A-Z]+-[0-9]+' | head -1)
elif [ $# -ge 2 ]; then
TICKET="$1"
MESSAGE="$2"
else
echo "Error: Insufficient arguments"
echo "Usage: /devkit.jira.ticket.comment [TICKET-ID] \"message\""
exit 1
fi

if [ -z "$TICKET" ]; then
echo "Error: Could not infer ticket ID. Please provide it explicitly."
exit 1
fi

echo "Adding comment to $TICKET..."
echo "Comment: $MESSAGE"
```

### Step 2: Confirm with User

```bash
# Ask for confirmation before adding comment
# Use AskUserQuestion tool for confirmation
```

### Step 3: Add Comment via MCP

Use the `atlassian` MCP server:

```json
{
"tool": "jira_add_comment",
"arguments": {
"issueKey": "$TICKET",
"body": "$MESSAGE"
}
}
```

### Step 4: Confirm Success

```
Comment added successfully to $TICKET
```

## Examples

### Add comment to specific ticket

```
/devkit.jira.ticket.comment PROJ-456 "Started working on the authentication fix"
```

### Add comment to inferred ticket

```
/devkit.jira.ticket.comment "Fixed the login validation bug"
# Uses ticket ID from current branch
```

## Error Handling

- **Empty message**: Prompt user to provide a comment
- **Ticket not found**: Verify ticket ID exists
- **Permission denied**: Check Jira permissions for commenting
Loading