[Child of #649] Audit: Issue Labeling Rules in labeler.yml

[ashleyshaw]

Overview

Comprehensive audit of labeling rules in .github/labeler.yml to identify issue-specific rules, gaps, and opportunities for improvement.

Scope

• Review .github/labeler.yml for issue-specific rules
• Compare coverage between PR rules and issue rules
• Identify gaps (e.g., file path-based rules for issues)
• Document current issue detection heuristics
• Check if content/title-based rules exist for issues

Audit Checklist

• Extract all issue-specific rules from labeler.yml
• Extract all PR-specific rules from labeler.yml
• Compare coverage between issue and PR rules
• Identify types of rules present (branch-based, file-based, content-based)
• Determine what heuristics are used for issues vs. PRs
• Document gaps and opportunities

Deliverables

• Current issue rules inventory
• PR vs. issue rule comparison matrix
• Report of identified gaps
• Recommendations for adding issue rules

Related Files

• .github/labeler.yml
• .github/labels.yml (canonical label definitions)
• .github/issue-types.yml (issue type mapping)
• scripts/agents/includes/ (labeling agent code)

Related Documentation

• Label Strategy
• Labeler Configuration
• Automation Governance

---

Definition of Ready (DoR)

• Clear problem statement and expected outcome
• Acceptance criteria defined
• Related issues/dependencies identified
• Required resources/approvals listed

Definition of Done (DoD)

• All acceptance criteria met
• Changes tested and validated
• Documentation updated
• Changes merged and deployed
• Stakeholders notified

[linear-code]

LS-830

LS-1133

[ashleyshaw]

Audit complete. Deliverable report: .github/reports/audits/2026-06-03-issue-labeling-rules-in-labeler-audit-656.md\n\nKey outcomes:\n- Issue-specific vs PR-specific rule inventory in labeler.yml\n- Current heuristic path assessment\n- Rule-coverage gap report and recommended next steps

[github-actions]

⚠️ This issue does not follow a required issue template.

Missing required section(s): Definition of Ready (DoR), Definition of Done (DoD)

The issue will remain open and flagged until the body is corrected.
Please update the issue with one of the official templates:

• https://github.com/lightspeedwp/.github/issues/new/choose

If this was opened by automation, update the automation to preserve the template sections before creating the issue.