CNTRLPLANE Jira Conventions

Enforce CNTRLPLANE Jira conventions for OpenShift issue creation.

112|305|Updated Oct 10, 2025
One-click install
npx skills add https://github.com/openshift-eng/ai-helpers --skill cntrlplane-jira-conventions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: CNTRLPLANE Jira Conventions
Source: https://github.com/openshift-eng/ai-helpers/tree/main/plugins/jira/skills/cntrlplane
Command: npx skills add https://github.com/openshift-eng/ai-helpers --skill cntrlplane-jira-conventions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates confusion and errors when creating Jira issues in the CNTRLPLANE project by providing OpenShift team-specific conventions and requirements.

Core Features & Use Cases

  • Version Normalization: Automatically converts user version inputs (4.22, OCP 4.22) to proper Jira format (openshift-4.22).
  • Parent Linking: Handles complex parent-child relationships between features, epics, stories, and tasks.
  • Use Case: When an OpenShift engineer needs to create a story linked to an epic, this Skill ensures the correct custom fields and formats are used.

Quick Start

Use the CNTRLPLANE skill when creating Jira issues for OpenShift control plane development work.

Frequently Asked Questions about CNTRLPLANE Jira Conventions

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

FAQPage Schema
How do I ensure Jira issues follow CNTRLPLANE team conventions?

CNTRLPLANE Jira conventions enforce consistent issue creation by normalizing version formats, linking parent epics, handling components, and populating mandatory fields. This Skill applies these rules automatically when you create Stories, Epics, Features, and Tasks for OpenShift teams, eliminating manual formatting errors.

What version normalization does CNTRLPLANE Jira use?

Version normalization converts user inputs like "4.22" or "OCP 4.22" into the standard Jira format "openshift-4.22". This ensures consistent version tracking across HyperShift, Cluster Infrastructure, Networking, Storage, and other CNTRLPLANE teams.

How do I link stories to epics in CNTRLPLANE Jira?

Parent linking handles complex relationships between features, epics, stories, and tasks using CNTRLPLANE-specific custom fields. The Skill maps these relationships automatically, ensuring stories connect to the correct epic without manual field lookups.

Can I use this Skill for OpenShift control plane development workflow?

Yes. This Skill applies to Stories, Epics, Features, and Tasks across OpenShift control plane teams. It covers target version normalization, Epic/Parent linking, component handling, and mandatory field validation for HyperShift, Cluster Infrastructure, Networking, Storage, and related CNTRLPLANE teams.

What happens if a required Jira field is missing during issue creation?

The Skill includes pre-validation and fallback creation strategies to ensure compliant ticket generation even when optional inputs are incomplete. It enforces mandatory fields while handling edge cases across custom field mappings.

Does CNTRLPLANE Jira handle custom field mappings?

Yes. The Skill manages CNTRLPLANE-specific custom field mappings including customfield_12319940, customfield_12311140, customfield_12313140, and customfield_epicname, ensuring fields populate correctly without manual configuration.