# Jira Automation

A Jira automation suite featuring polling triggers, story creation from natural language chat, and AI-powered task decomposition. Streamlines sprint planning and backlog grooming by letting AI interpret requirements and create structured Jira issues.

❯cat jira-automation/ARCHITECTURE.md

## How It Works

The agent polls a configured Jira project for new issues or comments that match trigger patterns. When a trigger fires, Claude interprets the requirement and decomposes it into subtasks with acceptance criteria and story points. The resulting issues are created in Jira via the REST API and linked to the parent epic.

Jira Automation Agent
    └── Poll Jira REST API (triggers)
    └── Detect: new issue / keyword comment
    └── Claude API ── decompose requirement
    └── Create subtasks via Jira REST API
    └── Link to parent epic

❯jira-automation --demo

## Screenshots

jira-automation — story decomposition

❯  node dist/index.js

   Polling ENG project...  ✓
   Trigger: new issue ENG-100 · "User auth redesign"

   Sending to Claude for decomposition...
   ✓  Created 5 subtasks:
      ENG-101  Design new login screen mockups     (3 pts)
      ENG-102  Implement JWT refresh token flow     (5 pts)
      ENG-103  Add OAuth2 Google provider           (3 pts)
      ENG-104  Write auth unit tests               (2 pts)
      ENG-105  Update API docs                     (1 pt)

jira-automation — from chat

   Trigger: comment on ENG-100
   "@automation decompose: add dark mode toggle"

   Sending to Claude...
   ✓  Created 3 subtasks:
      ENG-110  Add theme context provider          (2 pts)
      ENG-111  Implement CSS variable switching    (3 pts)
      ENG-112  Persist preference to localStorage  (1 pt)

   ✓  All linked to ENG-100

❯grep -n "## Features" jira-automation/README.md

## Features

+Polling-based event triggers
+Story creation from chat messages
+AI-powered task decomposition
+Automated backlog grooming

❯jira-automation --compare

## vs. The Field

Feature	Jira Automation	Jira Automation (built-in)	Manual sprint planning
AI task decomposition	✓	✗	✗
Create from natural language	✓	✗	✗
Polling triggers	✓	✓	✗
Claude API powered	✓	✗	✗
Free / open source	✓	paid	free

❯cd jira-automation && cat INSTALL.md

## Installation

Get a Jira API token and Claude API key

Jira: id.atlassian.com → Security → API tokens. Claude: console.anthropic.com.

Install and build

npm install
npm run build

Configure environment

export JIRA_BASE_URL=https://yourcompany.atlassian.net
export JIRA_EMAIL=you@company.com
export JIRA_API_TOKEN=your-token
export ANTHROPIC_API_KEY=sk-ant-...
export JIRA_PROJECT_KEY=ENG

Run the agent

Runs as a long-lived process, polling Jira and reacting to triggers.

node dist/index.js

❯cat jira-automation/package.json | jq '.dependencies | keys'

## Tech Stack

Node.jsTypeScriptJira REST APIClaude API

←Jira Assignment Watcher ↑ all packages Local Marketplace→