e-volv

Review playbook

APIContractBreaking-ChangeDetector

Detects breaking changes in published API contracts, names affected consumers, and labels the PR.

Detects when a pull request changes a published interface in a breaking way, names the consumers it can find, states the semver impact, and applies a breaking-change label when confirmed.

Identifier
breaking-change-detector
Version
1.0.1
Steps
3
Triggers
1
  • review
  • api
  • contract
  • breaking-change
  • automated

When it runs

Pull requestpull_request.opened
Settle delay
15s after the event

Only when all hold

  • pullRequest.state not equals closed
  • actor.username not contains [bot]

The pipeline

The graph below is the one the workflow opens with in the builder — same steps, same layout, drawn on the same canvas. The run playing through it is a simulation; the branches and conditions are real.

React Flow
  1. 01
    PR Openedtrigger

    The event that starts the run.

  2. 02
    Clone PR Head Refgit.clone

    Shallow-clones the repository at the right ref.

  3. 03
    Detect Breaking Changesagent.run

    One agent works the task with its toolkit.

The agent

API Contract Reviewer

Base type
Code Reviewer
Temperature
0.1
Max iterations
40
Tools
10

Git provider · 5

  • get_pull_request_diffGet Pull Request Diff · read
  • read_pull_requestRead Pull Request · read
  • add_pull_request_review_threadAdd PR Review Thread · write
  • submit_reviewSubmit Review · write
  • add_labelsAdd Labels · write

Filesystem · 2

  • read_fileRead File · read
  • list_dirList Directory · read

Code search · 1

  • code_searchCode Search · read

Terminal · 1

  • run_terminal_cmdRun Terminal Command · write

Status · 1

  • update_statusUpdate Status · write