merge-jira-postmortem

Generate and post structured Jira postmortems after GitHub merge.

Updated May 16, 2026
One-click install
npx skills add https://github.com/cedricfarinazzo/agile-skills --skill merge-jira-postmortem
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: merge-jira-postmortem
Source: https://github.com/cedricfarinazzo/agile-skills/tree/main/agile-merge-review/skills/merge-jira-postmortem
Command: npx skills add https://github.com/cedricfarinazzo/agile-skills --skill merge-jira-postmortem

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Post-merge reviews often lack a standardized, shareable format and timely Jira updates, creating gaps in traceability and accountability.

Core Features & Use Cases

  • Automatic generation and posting of structured Jira postmortems after PR merges.
  • Support both merged mode (transition to Done) and blocked mode (no transition) while documenting root causes and lessons.
  • Cross-PR conflict detection notes and recommendations to link related issues in Jira for sprint planning.

Quick Start

Run the postmortem by invoking the /jira-postmortem trigger after a merge to generate and publish the findings.

Frequently Asked Questions about merge-jira-postmortem

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

FAQPage Schema
How do I automate Jira postmortem comments after a PR merge?▼

You can automate Jira postmortem comments by invoking the /jira-postmortem trigger after a merge, which generates structured Markdown findings and posts them directly to Jira via APIs.

Can I automatically transition Jira issues to Done when a GitHub merge train succeeds?▼

Yes, when a PR merge succeeds, the postmortem automation transitions linked Jira issues to Done automatically, while blocked PRs are documented without a status transition.

Do I need a cloudId and ticket-prefix to post merge review findings to Jira?▼

Yes, you must provide a Jira cloudId and a ticket-prefix regex in your repo's CLAUDE.md, AGENTS.md, or environment variables to identify target issues for postmortem comments.

What is the best way to document blocked PRs and cross-PR conflicts in Jira?▼

The best way is to use merge-train postmortem automation, which detects cross-PR conflicts, documents root causes for blocked PRs, and recommends linking related issues for sprint planning.

Why does my merge train postmortem skip transitioning issues to Done?▼

Postmortem automation skips the Done transition when a PR is blocked, focusing instead on documenting the root cause and lessons learned without altering the Jira issue status.