Skip to main content

​
How bug-fix prompts work

This page is for engineering teams. A pull request is a proposed code change opened for review; Claude opens them under its own GitHub identity, so they appear in your review queue like any other pull request. Each prompt below is a Slack message. You paste it in the channel or thread where the bug lives, Claude works on it in an isolated workspace Anthropic hosts and posts progress in that thread, and the result lands there too. What the result is depends on the prompt, and each one below says what it returns, like a draft pull request, a root-cause writeup, or a standing watch that triages new reports as they arrive. Anything it opens on GitHub is authored by the Claude GitHub App.

​
Check the channel’s connections

Check that the channel has the connections below. Ask @Claude what can you access from this channel? to check; an admin can add a connection the channel is missing.

​
Prompts to paste

​
Fix a reported bug

A bug report arrives with reproduction steps and nobody free to take it. This gets you a draft pull request with the fix, linked back to the thread. Name the repository in the prompt so it’s cloned before work starts.
The done definition, CI green and the PR linking back, gives the session a finish line it can check itself against. The pull request appears under the Claude GitHub App and links back to the Slack thread it came from. See how agent identity works.

​
Watch a bug channel

Reports arrive faster than the team triages them. The standing form watches the channel and opens drafts for anything reproducible.
With the if/can’t branch, every report gets a reply, either a draft or a list of what was tried. To list or cancel scheduled work later, see Manage standing work.

​
Diagnose a failure without a fix

Not every failure needs a pull request. Ask for the diagnosis alone, and the decision about what to do with it stays with the team.
Naming the deliverable, a cause rather than a patch, keeps the session from jumping ahead to code changes nobody asked for.

​
See a pull request through CI

Once a pull request exists, one Claude opened or one a person did, Claude can watch it instead of you refreshing the page. It subscribes to that pull request and posts when CI status changes.
“Tag me if anything failed” is the filter. Green runs land quietly in the thread, and only a failure interrupts you. For repository conventions that should hold across every session that touches the code, like where files go or what a pull request must include, see Make repo conventions stick.

Watch monitors and alerts

Catching the problem before the bug report

Good habits

Definitions of done for code tasks