Skip to content

Add support for Claude Code and Bugbot#8139

Open
mcmire wants to merge 3 commits intomainfrom
add-support-for-claude-and-bugbot
Open

Add support for Claude Code and Bugbot#8139
mcmire wants to merge 3 commits intomainfrom
add-support-for-claude-and-bugbot

Conversation

@mcmire
Copy link
Contributor

@mcmire mcmire commented Mar 6, 2026

Explanation

We have an AGENTS.md to instruct agents on how to work with this repo, but neither Claude Code nor Cursor's Bugbot tool use this file. Instead, Claude Code uses CLAUDE.md (source) and Bugbot uses .cursor/BUGBOT.md (source).

To get these tools to follow our rules, we create new files that link to AGENTS.md. Note that both Claude Code supports the use of @ for file references; Bugbot does not, but we can use Markdown links to achieve a similar effect (source).

References

https://consensyssoftware.atlassian.net/browse/WPC-79

Checklist

  • I've updated the test suite for new or updated code as appropriate
  • I've updated documentation (JSDoc, Markdown, etc.) for new or updated code as appropriate
  • I've communicated my changes to consumers by updating changelogs for packages I've changed
  • I've introduced breaking changes in this PR and have prepared draft pull requests for clients and consumer packages to resolve them

Note

Low Risk
Low risk: adds tool-specific rule files/symlinks only and does not change runtime code or production behavior.

Overview
Adds CLAUDE.md and .cursor/BUGBOT.md as pointers to the existing AGENTS.md so Claude Code and Cursor Bugbot can reuse the repo’s agent instructions without duplicating content.

Written by Cursor Bugbot for commit 40f303e. This will update automatically on new commits. Configure here.

We have an `AGENTS.md` to instruct agents on how to work with this repo,
but neither Claude Code nor Cursor's Bugbot tool use this file. Instead,
Claude Code uses `CLAUDE.md` ([source][1]) and Bugbot uses
`.cursor/BUGBOT.md` ([source][2])

We don't need to make new files to support these tools; we can simply
symlink them to `AGENTS.md`.

[1]: https://code.claude.com/docs/en/memory
[2]: https://cursor.com/docs/bugbot#rules
@mcmire mcmire marked this pull request as ready for review March 6, 2026 20:23
Copy link

@cursor cursor bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.

@cryptodev-2s
Copy link
Contributor

We could also just use links to existing agent.md

@mcmire
Copy link
Contributor Author

mcmire commented Mar 6, 2026

@cryptodev-2s I figured that symlinks were more efficient than using file references. That said, this approach probably won't work on Windows. I just pushed up an update.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants