Skip to main content
Version: Next

Review a pull request

The agent can evaluate a pull request that is already open in Bitbucket, without modifying it. It works as a second opinion before a person approves it.

How to ask for a review​

Mention the agent on the work item with an instruction such as "review this PR" or "validate this pull request". The agent finds the pull request:

  • Through the work item's link.
  • Through an open Bitbucket pull request that cites the work item key.
  • Through the URL you paste in the comment, including the one Jira copies from the Development panel.

If the pull request is closed or the agent cannot find it, it asks for the URL.

What it reviews​

The review is read-only:

StepWhat it does
DiffCompares the pull request against its target branch.
TestsRuns the repository's tests.
forge lintIf it is a Forge app, runs forge lint.
Forge reviewReviews the change against Forge's official practices.
Security reviewAdded when the change touches permissions, network, authentication, or storage.

The agent does not commit, push, or open another pull request.

Verdict​

The agent's reply states:

  • Whether the pull request addresses what the work item asks for.
  • What is wrong and in which file.
  • The result of the tests and forge lint.

When there are findings, the reply includes a table with the severity, finding, location (file and lines), and proposed fix. If the review finds blockers, the verdict says so: the pull request is not ready to be approved.

Example verdict:

Verdict: changes required. The pull request covers two of the three acceptance criteria; the email field validation is missing.

SeverityFileFinding
Blockersrc/resolvers/index.jsThe resolver does not check that the user has permission on the work item.
Blockermanifest.ymlforge lint fails: the scope used by the new call is missing.
Minorsrc/frontend/Form.jsxThe error message is not translated.

Tests: 24 pass, 1 fails (form.test.js). forge lint: fails.

If you mentioned the agent, the verdict is posted as a comment on the work item.

Agent comment with the pull request review verdict

After the review​

The pull request stays as it was. The person reviewing it decides what to fix. If the pull request belongs to the agent, you can ask it for the changes with another mention: it continues on the same branch and goes through the checks before publishing.