nfr-jira-epic

star 45

Create a Jira Epic with one story per applicable NFR for tracking NFR compliance as sprint work

DavidROliverBA By DavidROliverBA schedule Updated 2/23/2026

name: nfr-jira-epic skill: nfr-jira-epic description: Create a Jira Epic with one story per applicable NFR for tracking NFR compliance as sprint work context: fork arguments:

  • name: system description: System name (e.g., "ERPSystem", "DataPlatform", "AlertHub") required: true
  • name: tier description: CS tier (CS1-CS4) required: true
  • name: types description: Comma-separated project types (all,pci,gdpr,caa_nis) required: true
  • name: project description: Jira project key (e.g., "ARCH", "ENG") — if omitted, skill will ask required: false model: opus

/nfr-jira-epic

Create a Jira Epic with one story per applicable NFR, turning the NFR compliance table into trackable sprint work. Each story includes the requirement, evidence guidance, and acceptance criteria.

Usage

/nfr-jira-epic ERPSystem CS1 all,gdpr
/nfr-jira-epic "AlertHub" CS1 all,gdpr ARCH
/nfr-jira-epic DataPlatform CS2 all,pci,gdpr,caa_nis

Data Source

All NFR data is read from .claude/data/nfr-reference.yaml — the single source of truth for all 66 NFRs. Do NOT hard-code NFR content; always read from the YAML.

Prerequisites

  • Atlassian MCP tools must be available (Jira access via createJiraIssue)
  • User must have permissions to create issues in the target Jira project

Instructions

Phase 1: Load NFR Data

  1. Read .claude/data/nfr-reference.yaml
  2. Parse sections and NFRs
  3. Read .claude/data/nfr-evidence-rules.yaml for automated check references

Phase 2: Filter NFRs

  1. Parse the types argument into a list (split on comma)
  2. Always include all in the types list
  3. Filter sections by applicability (same logic as /nfr-capture)
  4. Map CS tier to SL tier: CS1→SL1, CS2→SL2, CS3→SL3, CS4→SL4

Phase 3: Determine Jira Project

If project argument is provided, use it. Otherwise, ask the user:

Which Jira project should the NFR Epic be created in?
Enter the Jira project key (e.g., ARCH, ENG, OPS):

Phase 4: Create Epic

Use the Atlassian MCP createJiraIssue tool to create the Epic:

  • Issue Type: Epic
  • Project: [project key]
  • Summary: NFR Compliance — [System Name] ([CS tier]/[SL tier])
  • Description:
h2. NFR Compliance Epic

*System:* [System Name]
*Classification:* [CS tier] / [SL tier]
*Applicability:* [types list]
*Sections:* [included count] of 13
*NFRs:* [included NFR count] of 66

This epic tracks NFR compliance for [System Name] as defined in the BA NFR Template (Confluence page 664765269, v0.2).

Each story represents one NFR requirement. Stories close when evidence is attached and reviewed.

*Generated by:* /nfr-jira-epic skill
*NFR Reference:* .claude/data/nfr-reference.yaml
  • Labels: nfr-compliance, nfr-epic

Phase 5: Create Stories

For each applicable NFR, create a Jira story linked to the Epic:

  • Issue Type: Story
  • Project: [project key]
  • Summary: [NFR ID] — [NFR title]
  • Description:
h2. [NFR ID]: [NFR title]

h3. Requirement
[nfr.requirement]

h3. Guidance
[nfr.guidance]

h3. Target ([SL tier])
[tier_values for SL tier if tiered, else "Not tiered — applies uniformly"]

h3. Evidence Guidance
[nfr.evidence_guidance]

h3. Evidence Type
[nfr.evidence_type] — [If automated: "Automated checks available via nfr-evidence-collect.sh"]

h3. Acceptance Criteria
* Evidence is documented and linked to this story
* Evidence matches the format described in Evidence Guidance
* Status is confirmed as Met, Partial, or N/A with justification
[If evidence_type == automated]:
* Automated check results attached (AWS Config / CLI output)
  • Labels: nfr-compliance, nfr-[section-id lowercase] (e.g., nfr-sec, nfr-rel)
  • Priority: Mapped from CS tier:
    • CS1 → Critical
    • CS2 → High
    • CS3 → Medium
    • CS4 → Low
  • Epic Link: Link to the Epic created in Phase 4

Rate limiting: Pause briefly between story creation calls to avoid Jira API rate limits. Create stories section by section.

Phase 6: Summary

After creating all stories, print a summary:

NFR Jira Epic Created for [System Name] ([CS tier]/[SL tier])

Epic: [PROJ]-[ID] — NFR Compliance — [System Name] ([CS tier]/[SL tier])
URL: [epic URL]

Stories created: [count] of [total applicable NFRs]

| Section | Stories | IDs |
|---------|---------|-----|
| [Section Name] | [count] | [PROJ-ID, PROJ-ID, ...] |
| ... | ... | ... |

Priority: [CS1→Critical/CS2→High/CS3→Medium/CS4→Low]
Labels: nfr-compliance, nfr-[section-ids]

Next steps:
1. Assign stories to team members or squads
2. Add to sprint backlog
3. Use /nfr-capture with-evidence-prompts for guidance on completing each NFR
4. Close stories when evidence is attached and reviewed

Related

  • .claude/data/nfr-reference.yaml — NFR single source of truth
  • .claude/data/nfr-evidence-rules.yaml — Automated AWS evidence checks
  • .claude/skills/nfr-capture/SKILL.md — Generate NFR tables
  • .claude/skills/nfr-review/SKILL.md — Gap analysis against existing HLDs
Install via CLI
npx skills add https://github.com/DavidROliverBA/ArchitectKB --skill nfr-jira-epic
Repository Details
star Stars 45
call_split Forks 11
navigation Branch main
article Path SKILL.md
More from Creator
DavidROliverBA
DavidROliverBA Explore all skills →