name: pr-review-pipeline
description: "Reviews a pull request in layers: understand, correctness, security, tests, style, then a verdict."
inputs:
  - "pull request link or diff"
steps:
  - id: 1
    name: "Understand"
    do: "Summarise what the change is meant to do."
  - id: 2
    name: "Correctness"
    do: "Check logic, edge cases and error paths."
  - id: 3
    name: "Security"
    do: "Check inputs, secrets and permissions."
  - id: 4
    name: "Tests"
    do: "Check that behaviour is tested and tests would fail on a bug."
  - id: 5
    name: "Verdict"
    do: "List blocking and optional comments and give approve or request changes."
output: "A review with a clear verdict."