/jira-sync

name: jira-issue-sync
description: Sync Jira issues with local tasks. Use during daily planning or when user asks about Jira issues.

Jira Issue Sync

Check Jira for assigned issues and sync with local task management.

Instructions

Step 1: Fetch Assigned Issues

Call `jira_search` with JQL:

assignee = currentUser() AND status != Done ORDER BY priority DESC

Step 2: Compare with Local Tasks

Check `Tasks/` for existing files with Jira references:

• Look for `jira_key` in YAML frontmatter
• Identify new issues not yet in Tasks/

Step 3: Present Summary

Jira Issues (8 active):

**Blockers/Critical**
- PROJ-123: Production bug in auth [In Progress]

**High Priority**
- PROJ-124: API rate limiting [To Do]
- PROJ-125: Update deployment docs [In Review]

**Normal**
- PROJ-126: Refactor logging [Backlog]

3 issues not yet in local Tasks. Create them?

Step 4: Sync Options

| Option | Description | |--------|-------------| | Create all | Add all new issues as local tasks | | Select specific | Choose which to sync | | Skip | Continue without syncing |

Step 5: Create Local Tasks

For each issue to sync, create task file:

---
title: [Issue summary]
category: technical
priority: [Map from Jira priority]
status: n
jira_key: PROJ-XXX
---

Priority Mapping

| Jira | Personal OS | |------|-------------| | Blocker | P0 | | Critical | P0 | | High | P1 | | Medium | P2 | | Low | P3 |

Example Flow

**User:** "What should I work on today?"

**Agent:** 1. Fetches Jira issues 2. Compares with local tasks 3. "You have 5 Jira tickets..." 4. Offers to create local tasks 5. Continues with planning

Notes

• Keep `jira_key` in frontmatter for bidirectional sync
• Update Jira status when local task completes
• Include Jira link in task context section