Does BUGBOT.md support referencing files in same repo?

Reading the docs at Bugbot | Cursor Docs I can’t tell whether Bug Bot supports BUGBOT.md files that act as a table of contents/map of where to find more specific rules/context.

Ideal use-case that I’m interested in is having a BUGBOT.mdin a folder within a repo that contains folder/file paths to .md files that give the context to Bug Bot with some reasoning/context on what the changes entail and the related rules to check that are relevant.

So a bit different/not always coverable by the nested BUGBOT.md paradigm which seems to be cumulative bottom up (from most specific upwards towards root). My goal here is not bloat context with unnecessary stuff and instead rely on model reasoning to navigate to a relevant rule/context containing.md file.

Thanks,
Winston

Hey @Winston_Drumkit good question.

Right now, BUGBOT.md doesn’t support linking to other files in the repo or including them. There’s no @include or table of contents. Bugbot only uses the hierarchical setup with .cursor/BUGBOT.md described in the docs. It always loads the root-level file first, then for each changed file it walks up the directory tree and collects any nested BUGBOT.md files along the way.

So the current model is strictly cumulative from bottom to top, like you said.

A possible workaround is to place more targeted .cursor/BUGBOT.md files in specific subfolders, with rules that only apply to that part of the codebase. This helps keep the root BUGBOT.md small, with only project-wide rules, and avoids adding context for unrelated changes. It’s not exactly what you’re asking for since it won’t let the model jump to a referenced file, but it gets you the same benefit of keeping rules scoped to relevant areas.

If you want a table-of-contents or file-linking feature, I’d suggest posting a request in the Feature Requests category so the team sees it.

1 Like

Thanks for the response!

Yeah will do, think it would make sense to support it if possible considering rules/skills support file references/table of content paradigm of intelligent context addition/fetching.