Jira Workflow Steward

Enforces Jira-linked Git branch naming, atomic commits, and traceable pull request workflows.

2|Updated May 21, 2026
One-click install
npx skills add https://github.com/tcvdog/agency-agents-hermes --skill jira-workflow-steward-tcvdog
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: Jira Workflow Steward
Source: https://github.com/tcvdog/agency-agents-hermes/tree/main/project-management/jira-workflow-steward
Command: npx skills add https://github.com/tcvdog/agency-agents-hermes --skill jira-workflow-steward-tcvdog

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Software teams often lose traceability between requirements and shipped code, producing anonymous branches, vague commit messages, and pull requests that reviewers cannot map back to approved work. This Skill enforces a Jira-anchored Git workflow so every branch, commit, and PR links back to a ticket. ## Core Features & Use Cases - Jira-Gated Git Outputs: Refuses to generate branch names, commit messages, or workflow recommendations until a valid Jira task ID is provided. - Branch and Commit Standards: Applies patterns like feature/JIRA-214-add-sso-login and โœจ JIRA-214: add SSO login flow, with a decision matrix covering features, bugfixes, hotfixes, refactors, docs, tests, config, and dependencies. - Validation and Templates: Provides a Bash commit-msg validation hook, a pull request template with risk and security review sections, and a delivery planning template. - Use Case: A developer starting a production-critical auth fix asks for guidance; the Skill requires the Jira ID, then produces a hotfix/JIRA-411-patch-auth-bypass branch from main, atomic Gitmoji commits, and a PR with rollback notes. ## Quick Start Ask the agent to plan the branch, commits, and pull request for Jira ticket JIRA-315 fixing a token refresh race condition.

Frequently Asked Questions about Jira Workflow Steward

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

FAQPage Schema
How do I enforce Jira ticket IDs in Git branch names and commits?โ–ผ

Use branch patterns like feature/JIRA-214-add-sso-login and commit subjects formatted as <gitmoji> JIRA-ID: short description. The included Bash commit-msg hook validates both patterns with regex and rejects non-compliant branches or commits.

What Gitmoji should I use in commit messages?โ–ผ

Choose Gitmojis from the official catalog at gitmoji.dev based on the actual change type: โœจ for new features, ๐Ÿ› for bug fixes, โ™ป๏ธ for refactors, ๐Ÿ“š for docs, ๐Ÿงช for tests, ๐Ÿ”ง for config, and ๐Ÿ“ฆ for dependency updates.

When should a hotfix branch from main instead of develop?โ–ผ

Hotfix branches start from main only for production-critical defects that cannot wait for the normal release cycle. Feature and bugfix branches always start from develop, keeping main production-ready at all times.

Can I generate a commit message without a Jira ticket?โ–ผ

No. The Skill refuses to produce branch names, commit messages, or workflow recommendations without a Jira task ID, and it never invents or guesses ticket references. You must supply the exact ID first.

Why does the commit-msg hook reject my branch name?โ–ผ

The hook only accepts feature/JIRA-ID-description, bugfix/JIRA-ID-description, hotfix/JIRA-ID-description, or release/version formats. Check that your Jira ID uses uppercase letters and numbers, and the description uses lowercase hyphenated words.