What happened
PR #1302 was generated by Claude Code. The commit message correctly used the Jira-first format matching the Prow/Jira integration ('PROJQUAY-12344: operator: validate BOOTSTRAP_TOKEN_OWNER...'), but the PR title omitted the subsystem prefix ('PROJQUAY-12344: validate BOOTSTRAP_TOKEN_OWNER...'). The human reviewer approved but noted 'PR title needs to be updated'; the feedback was not addressed before merge.
What could go better
AGENTS.md documents the commit format as ': (PROJQUAY-####)' with the Jira reference at the end, but most recent PRs in this repo use the Jira-first format 'PROJQUAY-####: : ' — which is what the Prow Jira bot validates against. PR title format is not documented at all. This disconnect means AI agents following AGENTS.md produce titles that conflict with the actual repo convention and miss required elements like the subsystem prefix.
Proposed change
Update the 'Contributing' section of AGENTS.md to: (1) document both commit message and PR title formats, explicitly stating that the Jira reference comes first since the Prow integration requires it; (2) clarify that the subsystem prefix is required in both the PR title and commit message. Suggested format: 'PROJQUAY-####: : ' with a note that 'NO-ISSUE:' replaces the Jira reference for non-Jira changes. This aligns AGENTS.md with the dominant convention observed in recent commits and PRs (#1302, #1295, #1294, #1303).
Validation criteria
AGENTS.md Contributing section shows Jira-first format matching actual repo usage. PR title format is explicitly documented alongside commit message format. Next AI-generated PR title includes the subsystem prefix without reviewer intervention.
Generated by retro agent from #1302
What happened
PR #1302 was generated by Claude Code. The commit message correctly used the Jira-first format matching the Prow/Jira integration ('PROJQUAY-12344: operator: validate BOOTSTRAP_TOKEN_OWNER...'), but the PR title omitted the subsystem prefix ('PROJQUAY-12344: validate BOOTSTRAP_TOKEN_OWNER...'). The human reviewer approved but noted 'PR title needs to be updated'; the feedback was not addressed before merge.
What could go better
AGENTS.md documents the commit format as ': (PROJQUAY-####)' with the Jira reference at the end, but most recent PRs in this repo use the Jira-first format 'PROJQUAY-####: : ' — which is what the Prow Jira bot validates against. PR title format is not documented at all. This disconnect means AI agents following AGENTS.md produce titles that conflict with the actual repo convention and miss required elements like the subsystem prefix.
Proposed change
Update the 'Contributing' section of AGENTS.md to: (1) document both commit message and PR title formats, explicitly stating that the Jira reference comes first since the Prow integration requires it; (2) clarify that the subsystem prefix is required in both the PR title and commit message. Suggested format: 'PROJQUAY-####: : ' with a note that 'NO-ISSUE:' replaces the Jira reference for non-Jira changes. This aligns AGENTS.md with the dominant convention observed in recent commits and PRs (#1302, #1295, #1294, #1303).
Validation criteria
AGENTS.md Contributing section shows Jira-first format matching actual repo usage. PR title format is explicitly documented alongside commit message format. Next AI-generated PR title includes the subsystem prefix without reviewer intervention.
Generated by retro agent from #1302