e-volv

Review playbook

DesignTokenDrift

Finds hard-coded visual values in frontend PRs and maps each violation to the correct design token or primitive.

On every pull request that touches frontend source, scans the diff for hard-coded visual values — hex colors, rgb/rgba literals, raw pixel spacing, font sizes, border radii, box shadows, and Carbon --cds-* variables redefined with literals — and maps each violation to the correct Schematic design token or primitive. Where the mapping is unambiguous, it opens a follow-up PR that applies the fix. Runs automatically on pull request events; no manual configuration is required beyond a connected git provider.

Identifier
design-token-drift
Version
1.0.0
Steps
4
Triggers
2
  • design-system
  • tokens
  • frontend
  • css
  • review
  • automated

When it runs

Pull requestpull_request.opened
Settle delay
15s after the event

Only when all hold

  • actor.username not in dependabot, dependabot[bot], renovate, renovate[bot], github-actions, github-actions[bot]
  • actor.username not contains [bot]
Pull requestpull_request.synchronize
Settle delay
15s after the event

Only when all hold

  • actor.username not in dependabot, dependabot[bot], renovate, renovate[bot], github-actions, github-actions[bot]
  • 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.

  1. 01
    PR Opened / Updatedtrigger

    The event that starts the run.

  2. 02
    Clone Repositorygit.clone

    Shallow-clones the repository at the right ref.

  3. 03
    Scan for Token Driftagent.run

    One agent works the task with its toolkit.

  4. 04
    Publish Drift Reportreport.publish

    Posts or updates a deduplicated report comment.

The agent

Design Token Drift Reviewer

Base type
Code Reviewer
Temperature
0.2
Max iterations
30
Tools
8

Git provider · 4

  • get_pull_request_diffGet Pull Request Diff · read
  • create_branchCreate Branch · write
  • create_or_update_fileCreate or Update File · write
  • create_pull_requestCreate Pull Request · write

Filesystem · 2

  • read_fileRead File · read
  • edit_fileEdit File · write

Code search · 1

  • code_searchCode Search · read

Status · 1

  • update_statusUpdate Status · write