Skip to main content
This page explains what happens when Oplane reviews a pull request (GitHub) or merge request (GitLab). For the steps to set up reviews and act on them, see Review pull and merge requests.

What a review produces

When you open or update a PR or MR, Oplane analyses the diff, creates a threat model scoped to the changes, and posts the requirements in a single Oplane Security Review summary comment on the PR or MR. Oplane reads the diff, identifies architectural and security-relevant changes, and generates security requirements specific to what changed. All findings appear in one summary comment that lists each requirement with its status and severity, and links to the generated threat model. Oplane updates the comment as requirements are resolved, so it always reflects the current review state. See Comment structure for what the comment contains. Oplane also reports the result as an Oplane Security Review check on the reviewed commit. By default the check doesn’t block a merge. See Merge gating to make it block.

What triggers a review

You configure how Oplane reviews PRs and MRs per workspace:
  • Analyse every PR/MR: Oplane runs automatically on every new pull request or merge request. Best for projects with active development.
  • On request: Mention oplane review, @oplane review, oplane run, or @oplane run in a comment on any PR or MR to trigger a review when you need it.
  • Disabled: No automatic reviews for this workspace.

Trigger filters

To review only some PRs or MRs automatically, add trigger filters to a linked repository. Filters match on the target branch, the source branch, or the paths of changed files. Reviews you request with a comment always run. See Trigger filters.

Organisation settings

Your organisation’s Security Context and policies shape what every review looks for. Security Context applies to every review. A policy applies when the change matches its trigger keywords.

Limit on automatic reviews

Oplane runs at most 25 automatic reviews on a single PR or MR. After that, Oplane stops reviewing new commits automatically, but reviews you request with a comment still run. See Limits for what counts toward the 25 and what you see on the PR or MR.