Skip to content

feat(rhdh-jira): add component catalog, freeze flags, gotchas, and validation#30

Merged
schultzp2020 merged 2 commits into
mainfrom
feat/rhdh-jira-session-learnings
May 19, 2026
Merged

feat(rhdh-jira): add component catalog, freeze flags, gotchas, and validation#30
schultzp2020 merged 2 commits into
mainfrom
feat/rhdh-jira-session-learnings

Conversation

@schultzp2020

Copy link
Copy Markdown
Collaborator

Summary

Session learnings from the 2.1 Feature Exploration readiness check. Fixes issues encountered when auditing COPE's 27 candidate features.

Sources

  • COPE 2.1 readiness check session (May 19)
  • COPE Standup 5/14 transcript
  • Hope Hadfield's feedback on component suggestion quality
  • RHDH Jira Component/Release Automation Sheet

Changes

File Change
scripts/parse_issues.py Added size to ENRICHED_SELECT — T-shirt sizing now appears in enriched output alongside story_points
scripts/validate_components.py New file: validates fields.md component catalog against live RHIDP + RHDHPLAN Jira projects. Reports drift in both directions. Supports --json.
SKILL.md Gotcha #16 (Parent Link for Feature→Epic, not issuelinks), Gotcha #17 (REST search 410 Gone), validate_components.py in scripts table
references/fields.md Full 90-component catalog with descriptions grouped by category, freeze exclusion flags (FF/CF/Post-CF/RN), component inference instructions, validation script reference
references/feature-exploration.md Clarified New status expected pre-exploration; Epic creation can happen before exploration to help sizing

Key Decisions Captured

  • Parent Link (customfield_10018) is the correct field for Feature→Epic parent-child relationships — not issuelinks. Checking issuelinks produces false "no child Epics" reports.
  • Size (T-shirt) is the primary sizing field for Featurescustomfield_10795, not Story Points (customfield_10028). Both should be checked.
  • REST /rest/api/3/search returns 410 Gone on this Jira instance. Use POST to /rest/api/3/search/jql instead.
  • Component descriptions and freeze flags now match the Release Automation Sheet. Descriptions also written directly to the Google Sheet (37 new, 40 improved — revertible via version history).

Verification

  • 273 tests pass ✅
  • All referenced files exist ✅
  • SKILL.md is 286 lines (under 500 limit) ✅
  • validate_components.py runs successfully against live Jira (90 documented, 125 live — 35 legacy/duplicates in Jira not in catalog, 0 missing from Jira) ✅

…lidation

Session learnings from 2.1 Feature Exploration readiness check:

parse_issues.py:
- Add 'size' to ENRICHED_SELECT so T-shirt sizing appears in
  enriched output alongside story_points

SKILL.md:
- Gotcha #16: Feature→Epic child links use Parent Link
  (customfield_10018), not issuelinks — prevents false 'no child
  Epics' reports
- Gotcha #17: REST /rest/api/3/search returns 410 Gone, use
  /rest/api/3/search/jql POST endpoint instead
- Add validate_components.py to scripts table

fields.md:
- Full 90-component catalog with descriptions, grouped by category
  (RHDH Core, Backstage, Extension Plugin, Program)
- Freeze exclusion flags (Excl FF, CF, Post CF, Excl RN) per
  component — matches the Release Automation Sheet
- Component inference instructions: inherit from parent, match
  keywords from summary, validate against project
- Validation section now references validate_components.py

feature-exploration.md:
- Clarify New status is expected going into Feature Exploration
- Epic creation can happen before exploration to help size Features

validate_components.py (new):
- Compares fields.md component catalog against live RHIDP + RHDHPLAN
  Jira components via REST API
- Reports drift in both directions
- Supports --json for structured output
- Remove dead parse_fields_md function from validate_components.py
- Fix grammar: 'Features in New status is' → 'are'
- Replace duplicated curl commands in feature-exploration.md with
  reference to fields.md component catalog and validate_components.py
@schultzp2020 schultzp2020 merged commit 765026f into main May 19, 2026
4 checks passed
@schultzp2020 schultzp2020 deleted the feat/rhdh-jira-session-learnings branch May 19, 2026 21:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant