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:
| Step | What it does |
|---|---|
| Diff | Compares the pull request against its target branch. |
| Tests | Runs the repository's tests. |
forge lint | If it is a Forge app, runs forge lint. |
| Forge review | Reviews the change against Forge's official practices. |
| Security review | Added 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.
Severity File Finding Blocker src/resolvers/index.jsThe resolver does not check that the user has permission on the work item. Blocker manifest.ymlforge lintfails: the scope used by the new call is missing.Minor src/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.

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.