Skip to content

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

Open

Description

@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


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

Activity

  1. linear-code commented on May 31, 2026

    @linear-code
  2. added this to the milestone on Jun 1, 2026
  3. ashleyshaw commented on Jun 3, 2026

    @ashleyshaw
    MemberAuthor

    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

  4. github-actions commented on Jun 19, 2026

    @github-actions
    Contributor

    ⚠️ 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:

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

  5. modified the milestones: , v1.2 on Jul 22, 2026
  6. self-assigned this
    on Sep 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Type

Fields

Priority

None yet

Projects

No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions