ENGINEERING

Detect GraphQL schema breaking changes and file owner tickets in Linear

On a schema change PR, runs a GraphQL breaking-change check against the deployed schema, posts a summary to MS Teams.

CategoryEngineering
Enginesim
Difficultyadvanced
Triggerevent
Steps6
Setup~25 min

How it runs

The automated pipeline, trigger to output.

  • TriggerSchema-change PR openedGitHubGitHub
  • ActionFetch proposed + production schemaGitHubGitHub
  • LogicFind breaking changes, map to owning teams
  • LogicStop if purely additive
  • ActionOpen Linear issue per affected teamLinearLinear
  • OutputPost breaking-change digest to MS TeamsMicrosoft Teams

What it does

Guards a shared GraphQL schema. When a PR changes the schema, it compares against the live schema, finds breaking changes (removed fields, type narrowing, argument changes), maps each broken operation to the team that uses it via an ownership map, and creates a tracked Linear issue for that team plus a heads-up in MS Teams.

When to use it

You run a federated or shared GraphQL API where many clients query overlapping fields, and a single removed field can silently break a downstream app. Use this to convert breaking edits into accountable, assigned work.

How it works

  1. 1A PR touching the schema file triggers the flow.
  2. 2Fetch the proposed schema from the PR and the current production schema via GitHub.
  3. 3Run the breaking-change comparison and resolve each break to an owning team using the ownership map.
  4. 4Branch: stop if the change is purely additive.
  5. 5Open a Linear issue per affected team with the broken operation and PR link.
  6. 6Post a consolidated breaking-change digest to the platform MS Teams channel.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect GitHubRepos, issues, pull requests, actions.
  2. 2
    Connect LinearIssues, projects, cycles, triage.
  3. 3
    Connect Microsoft TeamsChannels, chats, files.
  4. 4
    Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
  5. 5
    Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
  6. 6
    Test, then turn it onRun once against a sample, confirm the output, then enable the trigger.

Run this workflow in your colony.

14-day trial. No DevOps. No Sales call. Provisioned in under a minute.