{
 "schema": "aiblocks-page/1",
 "id": "agency-project-management-jira-workflow-steward",
 "type": "agent",
 "name": "Jira workflow planner",
 "summary": "Turn a Jira ticket into a Git branch name, commit messages and a pull request description. Every code change is traceable from ticket to release.",
 "headline": "Jira workflow planner",
 "subhead": "Give it a Jira ticket ID and say what you changed. Your AI writes the Git branch name, a short set of commit messages and a pull request description that link back to the ticket. It will not guess a missing ticket number, and it keeps secrets out of the text.",
 "job": {
  "id": "organise-work",
  "name": "Run meetings, notes and plans"
 },
 "level": "intermediate",
 "thinking": "high",
 "tested": true,
 "updated": "2026-11-03",
 "first_published": "2026-10-26",
 "inputs": [
  {
   "type": "question",
   "required": true,
   "label": "Question",
   "what": "the problem, decision or piece of work you want help with, and what a good outcome looks like"
  },
  {
   "type": "source_text",
   "required": false,
   "label": "Source text",
   "what": "a long source in full: an article, a video or talk transcript, or notes from a book, with its title, author and link"
  },
  {
   "type": "code_change",
   "required": false,
   "label": "Code change",
   "what": "a change to the code, with what it fixes and how it was checked"
  }
 ],
 "outputs": [
  {
   "type": "document",
   "required": true,
   "label": "Document",
   "what": "a finished document, such as a Word file, a PDF or a page of notes"
  }
 ],
 "you_give": [
  "The Jira ticket ID, exactly as it appears, such as JIRA-214",
  "What you changed or plan to change, in a few lines",
  "Your repo's branch and commit rules if they differ from the common ones (optional)",
  "What you tested, and where, such as unit tests or staging (optional)",
  "The list of changed files or the diff summary (optional)"
 ],
 "you_get": [
  "A branch type and branch name that holds the ticket ID",
  "A short list of commits, each doing one thing, in the form gitmoji, ticket ID and a short note",
  "A pull request title and description with the ticket link, a change summary, a risk note and a rollback step",
  "A list of anything that should be split into its own branch or pull request",
  "Notes on what is tested and what is not"
 ],
 "use_when": [
  "You are about to start a task and want a branch name that matches your team's Jira pattern.",
  "You have a mix of changes and need them split into clean commits before a review.",
  "A pull request has a vague title and no ticket link, and a reviewer asks what it is for.",
  "An auditor or client wants to trace a release back to the tickets behind it."
 ],
 "skip_when": [
  "You want to change Jira itself, such as statuses, permissions or boards. Ask your Jira admin.",
  "You want rules for how a whole team should use Git. Use the Git workflow planner.",
  "You want the code in a pull request checked for bugs. Use the Code Reviewer agent or the Pull request review tracker.",
  "You want to plan a release and write its changelog. Use the Software release verification coordinator."
 ],
 "output_sample": {
  "input": [
   "The Jira ticket ID, exactly as it appears",
   "What you changed or plan to change, in a few lines",
   "Your repo's branch and commit rules (optional)",
   "What you tested, and where (optional)",
   "A list of changed files or a diff summary (optional)"
  ],
  "prerequisites": [
   "A Jira ticket for the work. Without one, the agent stops and asks for it"
  ],
  "output": [
   {
    "name": "Jira anchor",
    "contains": "The ticket ID as you gave it, the outcome in one line and the type of change."
   },
   {
    "name": "Branch",
    "contains": "The branch name with the ticket ID, the branch it starts from and the reason."
   },
   {
    "name": "Commits",
    "contains": "A short, ordered list of commit lines, each with a gitmoji, the ticket ID and a short note."
   },
   {
    "name": "Pull request",
    "contains": "A title and description with the ticket link, changes, risk and security note, testing and rollback."
   },
   {
    "name": "Split before review",
    "contains": "Any change that is a separate job, with a suggested branch or ticket for it."
   },
   {
    "name": "Assumptions and checks not done",
    "contains": "What the agent assumed and which tests or checks it could not run."
   }
  ]
 },
 "output_shape": "JIRA ANCHOR\n  Ticket <ID as given> | Outcome <one line> | Change type <feature, bugfix, hotfix, refactor, docs, test, config or dependency>\n\nBRANCH\n  Name <type>/<ID>-<short-description> | Created from <develop or main> | Why <reason>\n\nCOMMITS (in order)\n  <gitmoji> <ID>: <short description> | <what this commit covers>\n\nPULL REQUEST\n  Title: <gitmoji> <ID>: <short description>\n  What does it do: <summary>\n  Jira link: <ticket and branch>\n  Changes: <bullets>\n  Risk and security: <areas touched, secrets changed yes or no, rollback>\n  Testing: <what was run and where, or \"not run\">\n\nSPLIT BEFORE REVIEW\n  <change that is a separate job> | <suggested branch or ticket>\n\nASSUMPTIONS AND CHECKS NOT DONE",
 "how_to_use": [
  "Download the pack from this page and add it to your AI as a skill. If you cannot, paste SKILL.md into a new chat, then paste references/source-agent.md.",
  "Paste the Jira ticket ID and a few lines on the change. If you only have a ticket link, copy the ID from it, such as JIRA-214.",
  "Say how your team names branches and writes commits if it differs from the default. Paste your team's rule if you have it.",
  "Read the branch name and commit list. Rename or split anything that does not match what you actually did.",
  "Copy the pull request text into your pull request and fill in the test lines with what you really ran.",
  "Run the Git commands yourself. This agent only writes the text. It does not touch your repo or Jira."
 ],
 "checks": [
  "The result addresses your actual task and cites the evidence used.",
  "Examples, role-play experience and targets are kept separate from verified results.",
  "Claims of tests, memory, tool access or completed actions match what actually happened."
 ],
 "next": [
  {
   "name": "Campaign change impact reviewer",
   "url": "https://useaiblocks.com/skills/campaign-change-impact-mapper",
   "why": "Campaign change impact reviewer"
  }
 ],
 "source": {
  "by": "Michael Sitarzewski and Agency Agents contributors",
  "repo": "msitarzewski/agency-agents",
  "url": "https://github.com/msitarzewski/agency-agents/blob/b37b5bb33b78f2c1d6567d98e25ca818e3259219/project-management/project-management-jira-workflow-steward.md",
  "licence": "MIT",
  "original_name": "Jira Workflow Steward",
  "commit": "b37b5bb33b78f2c1d6567d98e25ca818e3259219"
 },
 "credits": [
  {
   "title": "Jira Workflow Steward",
   "by": "Michael Sitarzewski and Agency Agents contributors",
   "url": "https://github.com/msitarzewski/agency-agents/blob/b37b5bb33b78f2c1d6567d98e25ca818e3259219/project-management/project-management-jira-workflow-steward.md",
   "used": "Original agent profile, preserved in references/source-agent.md; AI Blocks adds setup and review instructions."
  }
 ],
 "files": [
  "LICENSE",
  "references/source-agent.md",
  "SETUP.md",
  "source.json"
 ],
 "links": {
  "page": "https://useaiblocks.com/agents/agency-project-management-jira-workflow-steward",
  "markdown": "https://useaiblocks.com/agents/agency-project-management-jira-workflow-steward.md",
  "json": "https://useaiblocks.com/agents/agency-project-management-jira-workflow-steward.json",
  "instructions": "https://useaiblocks.com/skills/agency-project-management-jira-workflow-steward/SKILL.md",
  "download": "https://useaiblocks.com/skills/agency-project-management-jira-workflow-steward.zip",
  "api_item": "https://useaiblocks.com/api/v1/items/agency-project-management-jira-workflow-steward",
  "api_document": "https://useaiblocks.com/api/v1/documents/agent/agency-project-management-jira-workflow-steward",
  "mcp": "https://useaiblocks.com/mcp"
 }
}
