jira-git-workflow

What I do

I implement the standard JIRA-to-Git workflow by combining jira-git-integration, ticket-branch-workflow, and git framework skills:

1. •Identify JIRA Project: Use jira-git-integration to find project and cloud ID
2. •Create JIRA Ticket: Use jira-git-integration to create task/issue with summary and description
3. •Add Comments (Optional): Use jira-git-integration to add clarifying comments if needed
4. •Create Git Branch: Create branch named after JIRA ticket (format: PROJECT-NUM)
5. •Commit PLAN.md: Use ticket-branch-workflow to create PLAN.md, commit with semantic formatting, and push
6. •Update JIRA Ticket: Use git-issue-updater to add progress comment with commit details

When to use me

Framework: This skill combines two frameworks:

• •jira-git-integration - Handles JIRA-specific operations (project discovery, ticket creation, comments)
• •ticket-branch-workflow - Handles core workflow (branch creation, PLAN.md, commit, push)

Use this workflow when:

• •Starting a new development task tracked in JIRA
• •You need a systematic approach: JIRA ticket → branch → PLAN.md
• •Following the standard practice of planning before coding

Prerequisites

• •Active Atlassian/JIRA account with appropriate permissions
• •Git repository initialized
• •Write access to the repository

Steps

Step 1: Identify JIRA Project

• •Use jira-git-integration project discovery:
  • •Use atlassian_getVisibleJiraProjects to list available projects
  • •Identify the project key for your work (e.g., IBIS, DA, etc.)
  • •Get the cloud ID using atlassian_getAccessibleAtlassianResources

Step 2: Create JIRA Ticket

• •Use jira-git-integration ticket creation:
  • •Use atlassian_createJiraIssue with:
    • •cloudId: The Atlassian cloud ID
    • •projectKey: The project key (e.g., IBIS)
    • •issueTypeName: Typically "Task" or "Story"
    • •summary: Concise title for the work
    • •description: Detailed description with:
      • •Overview
      • •Scope/files affected
      • •Requirements
      • •Rationale
    • •assignee_account_id: Your account ID (optional, use atlassian_atlassianUserInfo to get it)
  • •Store the ticket key (e.g., IBIS-101)

Step 3: Add Comments (Optional)

• •If clarification is needed, use jira-git-integration comment features:
  • •Use atlassian_addCommentToJiraIssue with:
    • •cloudId: The cloud ID
    • •issueIdOrKey: The ticket key (e.g., IBIS-101)
    • •commentBody: The comment in Markdown format

Step 4: Create Git Branch

• •Create branch named after JIRA ticket: git checkout -b <TICKET-KEY>
• •Example: git checkout -b IBIS-101

Step 5: Execute Ticket-Branch-Workflow

• •Use ticket-branch-workflow to:
  • •Create PLAN.md with JIRA ticket reference
  • •Use git-semantic-commits for commit formatting:
    • •Commit PLAN.md with semantic format: git commit -m "feat: add PLAN.md for <TICKET-KEY>"
    • •Or with scope: git commit -m "docs(PLAN): add planning document for <TICKET-KEY>"
  • •Push branch to remote: git push -u origin <TICKET-KEY>

Step 6: Update JIRA Ticket with Initial Commit

• •Use git-issue-updater to add progress comment to JIRA ticket:
  • •Extract commit details: hash, message, author, date, time, files changed
  • •Use atlassian_addCommentToJiraIssue with:
    • •cloudId: The cloud ID
    • •issueIdOrKey: The ticket key (e.g., IBIS-101)
    • •commentBody: Formatted comment with:
      • •User who made the commit
      • •Date and time of commit
      • •Commit hash (with link if available)
      • •Commit message
      • •Files changed (from git diff --stat)
      • •Statistics summary
  • •Example comment format:
    markdown

    **Initial commit created**
    
    - **User**: [author name]
    - **Date**: [ISO 8601 date]
    - **Time**: [ISO 8601 time]
    - **Commit**: [commit hash]
    - **Message**: [commit message]
    - **Files changed**: [number]
    - **Insertions**: [number]
    - **Deletions**: [number]
    

Example PLAN.md Structure

The framework generates PLAN.md with JIRA reference:

# Plan: <Ticket Summary>

## Overview
Brief description of what this ticket implements.

## Ticket Reference
- Ticket: <TICKET-KEY>
- URL: <ticket-url>

## Files to Modify
1. `src/path/to/file1.ts` - Description
2. `src/path/to/file2.tsx` - Description

## Approach
Detailed steps or methodology for implementation.

## Success Criteria
- All files modified correctly
- No build errors
- Tests pass

Best Practices

• •Use jira-git-integration for all JIRA operations (project discovery, ticket creation, comments)
• •Use ticket-branch-workflow for branch, PLAN.md, commit, and push operations
• •Use git-semantic-commits for all commit formatting to ensure consistent semantic versioning
• •Use git-issue-updater after all commits to add progress comments to JIRA tickets
• •Keep the plan specific and actionable
• •Use the JIRA ticket key as the branch name for traceability
• •Include a clear rationale in both the JIRA ticket and PLAN.md
• •Commit the PLAN.md as the first commit on the new branch
• •Always update JIRA ticket with commit details after each significant commit
• •Use semantic commit types: feat, fix, docs, style, refactor, test, chore, perf, ci, build, revert
• •Use scopes to identify affected components (e.g., docs(PLAN):, feat(api):, fix(ui):)

Common Issues

Permission denied on JIRA

Issue: Cannot create JIRA ticket

Solution: Ensure your account has create permissions for the project (handled by jira-git-integration)

Branch already exists

Issue: Branch checkout fails due to existing branch

Solution: The framework handles this with -B flag to force branch creation

Missing cloud ID

Issue: Cannot create JIRA ticket without cloud ID

Solution: jira-git-integration provides tools to find your cloud ID: atlassian_getAccessibleAtlassianResources

Assignee error

Issue: Cannot assign ticket to yourself

Solution: Use atlassian_atlassianUserInfo to get your account ID (part of jira-git-integration)

Troubleshooting Checklist

Before starting:

• • Atlassian/JIRA account has project access
• • Git repository is initialized: git status
• • Current branch is clean (no uncommitted changes)
• • Remote repository is set up: git remote -v

After ticket creation:

• • Ticket key is captured (e.g., IBIS-101)
• • Ticket URL is accessible
• • Ticket is assigned (if needed)

After framework execution:

• • Branch is created and checked out successfully
• • PLAN.md is created with ticket reference
• • PLAN.md is committed with semantic message format
• • Branch is pushed to remote successfully
• • JIRA ticket is updated with initial commit details
• • JIRA ticket comment includes user, date, time, commit hash, message, and file changes

Related Skills

• •JIRA Integration:
  • •jira-git-integration - Provides JIRA-specific operations (project discovery, ticket creation, comments)
  • •jira-status-updater - Provides automated JIRA ticket status transitions after PR merge
• •Core Workflow Framework:
  • •ticket-branch-workflow - Provides core workflow (branch creation, PLAN.md, commit, push)
• •Git Frameworks:
  • •git-semantic-commits - Provides semantic commit message formatting following Conventional Commits spec
  • •git-issue-updater - Provides consistent issue/ticket update functionality for GitHub and JIRA
  • •git-issue-labeler - Provides intelligent label detection for GitHub issues
• •Next.js Specific:
  • •nextjs-pr-workflow - For creating PRs after completing the ticket
• •GitHub Integration:
  • •git-issue-creator - For GitHub-integrated workflows (uses same ticket-branch-workflow framework)

Complete JIRA-to-Git Workflow with Status Updates

The complete workflow ensures JIRA tickets are properly closed after PR merges:

1. •

   Create JIRA Ticket (via jira-git-integration)

   • •Use atlassian_createJiraIssue to create ticket
   • •Status: "To Do" or "Backlog"
2. •

   Create Git Branch (via ticket-branch-workflow)

   • •Create branch named after ticket key (e.g., IBIS-101)
   • •Status: "To Do"
3. •

   Commit PLAN.md (via ticket-branch-workflow)

   • •Commit planning document
   • •Add progress comment to JIRA (via git-issue-updater)
   • •Status: "In Progress"
4. •

   Implement Work

   • •Make commits and add progress comments
   • •Status: "In Progress"
5. •

   Create Pull Request (via pr-creation-workflow or git-pr-creator)

   • •Create PR with JIRA ticket reference
   • •Add PR comment to JIRA (via git-issue-updater)
   • •Status: "In Progress" or "In Review"
6. •

   Merge Pull Request

   • •PR successfully merged
   • •Update JIRA ticket status to "Done" (via jira-status-updater) ⭐ NEW
   • •Add final merge comment to JIRA
   • •Status: "Done" ✅

Result: Complete automation from ticket creation to closure without manual intervention.