jira-workflow

Synchronize Jira tickets with Markdown documentation in a structured folder hierarchy.

Updated Apr 5, 2026
One-click install
npx skills add https://github.com/joleques/northstar-ai --skill jira-workflow-joleques
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jira-workflow
Source: https://github.com/joleques/northstar-ai/tree/main/.codex/skills/jira-workflow
Command: npx skills add https://github.com/joleques/northstar-ai --skill jira-workflow-joleques

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction between issue tracking in Jira and local project documentation by standardizing how epics, tasks, and subtasks are recorded in Markdown and linked to Jira, preventing scattered notes and lost traceability.

Core Features & Use Cases

  • Structured folder hierarchy: Enforces documentacao/analises/jira/{Epic}/{Epic}.md and task files to keep project artifacts organized.
  • Standardized ticket template: Provides a template with description, Jira link, reason, definition of done, user story, and BDD scenarios to improve clarity and acceptance criteria.
  • Safe Jira integration workflow: Prompts for board selection, only creates Jira tickets when explicitly requested, and appends existing Jira links when present.

Quick Start

Ask the assistant to create an epic named Project Orion with local markdown files under documentacao/analises/jira/Project Orion, include task pages, prompt me for the Jira board, and only create Jira tickets if I confirm.

Frequently Asked Questions about jira-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync Jira tickets with local Markdown documentation?

To sync Jira tickets with local Markdown documentation, the workflow uses a standardized folder hierarchy to organize epics and tasks, appending existing Jira links to the docs and creating tickets only when explicitly requested.

What is the best way to keep Jira epics and tasks traceable in Markdown files?

Keeping Jira epics and tasks traceable in Markdown files requires a standardized template with description, definition of done, user story, and BDD scenarios, stored within a structured project folder hierarchy.

How do I create a Jira ticket from a local Markdown file?

Creating a Jira ticket from a local Markdown file happens only on explicit user request; the workflow prompts for board selection and then generates the ticket while linking it back to the document.

Can I use predefined templates for Jira documentation in Markdown?

Yes, you can use predefined templates for Jira documentation in Markdown that include fields for description, reason, definition of done, user story, and BDD scenarios to ensure clear acceptance criteria.

Does the Jira Markdown synchronization automatically create new tickets?

No, the Jira Markdown synchronization does not automatically create new tickets; it enforces a safe integration workflow that prompts for board selection and creates tickets only upon explicit confirmation.