Rule Traceability, Priority Control, and Comment Coverage

Feature request for product/service

BugBot

Describe the request

I’m managing a large set of rules in my repository.
Some are general code guidelines, while others are critical rules designed to prevent high-impact errors.

To avoid duplication, I’ve centralized parts of the logic and referenced them via a BUTBOT.md file.
However, this creates a few challenges in practice:

  1. Lack of Rule Traceability
    Currently, it is difficult to identify which specific repository rule triggered a given comment.
  • Only rules coming from Manual / Team / Learned rules are clearly labelled.
  • For repository rules, there is no clear mapping from comment → originating rule.

Impact:
When a comment is incorrect (false positive) or misses an edge case, I cannot efficiently locate and refine the responsible rule.

Request:
Add explicit traceability from each comment to the exact rule (including repo rules), e.g. rule ID / name / source.

  1. Rule Priority Control
    From testing, rule priority appears implicit and not configurable:
  • Repository rules seem to have lower priority than Team / Learned rules.
  • This does not always match the desired behaviour.

Impact:
Critical repository rules may be overridden or under-enforced.

Request:

  • Allow explicit priority configuration:
    • Between rule sources (Repo vs Team vs Learned)
    • Within repository rules themselves
  • Ideally support priority levels (e.g., Critical / High / Medium / Low)
  1. Limited Comment Coverage
    In practice, not all violations are reported:
  • Only a subset of issues is commented
  • This may be an intentional trade-off (e.g., reducing noise), but it is not configurable

Impact:
When reviewing large code changes, important issues may be missed.

Request:
Provide control over comment coverage, for example:

  • Maximum number of comments per PR
  • Ability to enforce full coverage for high-priority rules
  • Option to limit or suppress lower-priority findings
  1. Priority-Aware Comment Strategy (Optional Enhancement)
    If prioritization is supported, an ideal behaviour would be:
  • Report all Critical / High issues
  • Limit Medium issues (e.g., top N)
  • Optionally ignore Low priority entirely

Summary

Key capabilities that would significantly improve usability:

  • Rule → comment traceability
  • Configurable rule priority (global + per-repo)
  • Control over comment volume and coverage
  • Priority-aware reporting behaviour

If any of these capabilities already exist (even partially), I’d appreciate pointers on how to configure them.

Hi @Michael_Negri

Thanks for the detailed breakdown. These are well thought-out requests.

On rule traceability — BugBot does track which rule triggered each comment internally, and for team-, learned-, and manual-rules, this attribution surfaces in the comment footer with a link to the rule on the dashboard. You can also view aggregate rule-trigger data via Rule analytics in the Bugbot dashboard. The gap you’re hitting is with repository rules (.cursor/BUGBOT.md) — those are currently identified by a content hash rather than a human-readable name, so the mapping back to a specific rule is much harder. That’s a fair limitation.

On rule priority, comment coverage control, and priority-aware reporting — none of these exist as configurable options today. All rule sources are concatenated in a fixed order and there’s no user-facing control over comment volume or priority-based filtering.

We’ll be tracking this post to gauge interest from the community, which helps our product team prioritize accordingly. If others are running into similar pain points, having them chime in here would help signal demand.

Thanks for the response

for labelling, here is what i added in the BUGBOT and saw it did posts the correct label for me (see picture below for the BUGBOT instruction and the second one for the comment)

however, will be happy to here once/if you will have the ability to control rules priority

That’s a smart approach! Using the BUGBOT.md to define a reporting contract that enforces rule labels in each comment is a great workaround for the traceability gap with repository rules. Nice to see it producing clean attribution like that.

On rule priority control, noted. No updates on that front yet, but the interest here helps inform prioritization.