Skip to content
jira-workflow logo

Jira Workflow

jira-workflow

Jira ticket creation and management for AI agent commands, with severity-based processing and proper integration

SKILL.md

Full skill instructions

Jira Workflow

Best practices for AI agents to create and manage Jira tickets when performing automated work like fixing vulnerabilities, resolving SonarQube issues, or improving test coverage.

Core Principles

  1. Create Ticket Before Work - Always create/​find a Jira ticket before starting
  2. Discover Project Key - Never hardcode project keys
  3. Search Before Creating - Check for existing tickets first
  4. Severity-Based Processing - Process issues one severity level at a time
  5. Link Everything - Connect Jira → Branch → Commits → PR

Skill Contents

Sections

Available Resources

📚 references/​ - Detailed documentation


Workflow Overview

StepDescriptionReference
0. DiscoverFind user's Jira project keyreferences/​project-discovery.md
1. SearchCheck for existing open ticketsreferences/​ticket-search.md
2. CreateCreate ticket if none existsreferences/​ticket-creation.md
3. BranchCreate branch with Jira keyreferences/​branch-naming.md
4. ProcessFix by severity levelreferences/​severity-processing.md

Quick Reference

Emoji Conventions

Work TypeEmojiExample
AI-assisted (all)🤖Required in ALL AI commits/​PRs
Security/​Vulnerability🛡️🤖 🛡️ fix(security): resolve critical CVE
Code Quality/​SonarQube✅🤖 ✅ fix(quality): resolve BLOCKER issues
Test Coverage🧪🤖 🧪 test: improve coverage
Dependency Updates📦🤖 📦 chore(deps): update Spring Boot
Documentation📝🤖 📝 docs: update API documentation
Performance⚡🤖 ⚡ perf: optimize queries
Refactoring♻️🤖 ♻️ refactor: simplify error handling

Ticket Summary Format

🤖🛡️ Fix [SEVERITY] Dependabot vulnerabilities in [repo-name]
🤖✅ Resolve [SEVERITY] SonarQube issues in [repo-name]
🤖🧪 Improve test coverage for [module/​class]
🤖📦 Update [dependency] to [version]

Branch Naming

{type}/​{JIRA-KEY}-{short-description}

Examples:

  • fix/​PROJ-123-critical-vulnerabilities
  • fix/​PROJ-456-blocker-sonar-issues
  • test/​PROJ-789-coverage-payment-service

References

ReferenceContent
references/​project-discovery.mdHow to discover user's Jira project key
references/​ticket-search.mdJQL queries to find existing tickets
references/​ticket-creation.mdCreate tickets with proper format
references/​branch-naming.mdBranch naming with Jira keys
references/​severity-processing.mdProcess by severity level

Severity-Based Processing

Vulnerability Severity Order

  1. CRITICAL - Fix first
  2. HIGH - Only after no CRITICAL remain
  3. MEDIUM/​MODERATE - Only after no HIGH remain
  4. LOW - Only after no MEDIUM remain

SonarQube Severity Order

  1. BLOCKER - Fix first
  2. CRITICAL - Only after no BLOCKER remain
  3. MAJOR - Only after no CRITICAL remain
  4. MINOR - Only after no MAJOR remain
  5. INFO - Only after no MINOR remain

Best Practices

  1. One severity per PR - Keep PRs focused and reviewable
  2. Batch related fixes - Group similar issues in one commit
  3. Clear descriptions - Document what was fixed and why
  4. Link everything - Jira ticket ↔ Branch ↔ Commits ↔ PR
  5. Update ticket status - Move ticket through workflow as work progresses

Skill Dependencies

SkillPurpose
pr-lifecyclePR creation, commit formats, GitHub CLI

Related

  • .claude/​skills/​pr-lifecycle - PR creation and management
  • .claude/​skills/​stacked-prs - Stacked PR workflows
<!-- AUTO-GENERATED FILE - DO NOT EDIT DIRECTLY --> <!-- Source: bitsoex/​ai-code-instructions → global/​skills/​jira-workflow/​SKILL.md --> <!-- To modify, edit the source file and run the distribution workflow -->

More Security skills

supabase logo
Security

supabase

Handles the full Supabase workflow from schema changes to deployment, with built-in security guardrails that catch common traps like RLS...

2.7K 308.9K
View

Comprehensive guides and best practices for Neon Serverless Postgres, covering setup, connection methods, authentication, and platform APIs.

98 216.2K
View

Guide for setting up and using Firebase Authentication. Use this skill when the user's app requires user sign-in, user management, or secure data access using auth rules.

462 163.8K
View

A skill to evaluate how secure Firestore security rules are. Use this when Firestore security rules are updated to ensure that the generated rules are extremely secure and robust.

462 127.7K
View

Official skill for integrating Firebase AI Logic (Gemini API) into web applications. Covers setup, multimodal inference, structured output, and security.

462 125.1K
View

Complete Better Auth server and client setup with database adapters, session management, plugins, and security configuration.

222 118.2K
View

Deploy and manage projects on Vercel using token-based authentication. Use when working with Vercel CLI using access tokens rather than interactive login — e.g. "deploy to vercel", "set up vercel", "add environment variables to vercel".

31.9K 116.1K
View
cloudflare logo
Security

cloudflare

Complete Cloudflare platform integration with decision trees for compute, storage, AI, networking, security, and infrastructure-as-code.

3K 110.7K
View

Run Azure compliance and security audits with azqr plus Key Vault expiration checks. Covers best-practice assessment, resource review, policy/compliance validation, and security posture checks. WHEN: compliance scan, security audit, BEFORE running azqr (compliance cli tool), Azure best practices, Key Vault expiration check, expired certificates, expiring secrets, orphaned resources, compliance assessment.

253 103K
View
gws-gmail logo
Security

gws-gmail

Send, read, and manage Gmail messages, drafts, labels, and account settings.

31.2K 78.9K
View

Comprehensive website auditing across 230+ rules in 21 categories including SEO, performance, security, and accessibility.

94 72.3K
View
gws-shared logo
Security

gws-shared

Shared authentication, CLI syntax, and output formatting patterns for gws Google Workspace commands.

31.2K 63.4K
View

Security AI tools

StarByFace logo
Security

StarByFace

Discover your celebrity doppelgänger with StarByFace!

Free
View
GeoSpy logo
Security

GeoSpy

GeoSpy: Pricing, Features, FAQs, and Alternatives for AI Teams

Free
View

Detect AI-generated voices to protect against audio fraud.

Paid
View

Ensure Your Content's Originality with AI Plagiarism Checker

Freemium
View
Img Upscaler logo
Security

Img Upscaler

Upscale images by 400% without quality loss

Freemium
View
AICheatCheck logo
Security

AICheatCheck

Accurately Detect AI-Generated Content with TheChecker.AI

Free
View
D
Security

Detect GPT

Chrome extension that detects and flags AI-generated content

Free
View