AI & RAG
Alert Reviewers When a Diff Contradicts an ADR
Scans newly pushed merge requests, and when the change appears to violate a recorded architecture decision, sends the assigned reviewers a Slack alert quoting the conflicting ADR.
How it runs
The automated pipeline, trigger to output.
- TriggerGitLab MR push eventGitLab
- ActionPull diff and changed filesGitLab
- ActionRetrieve governing ADRsConfluence
- ActionJudge diff against ADR rationaleOpenAI
- LogicExit if no conflict detected
- OutputDM reviewers with violated ADR clauseSlack
What it does
This is a guardrail, not a summarizer. On each new or updated MR it retrieves the ADRs touching the changed areas and asks whether the diff contradicts any accepted decision (for example, introducing a banned dependency or bypassing an agreed boundary). Only when a likely conflict is found does it notify the MR's assigned reviewers in Slack, with the exact ADR clause and the offending file.
When to use it
Use it when silent architecture drift is your real risk and you do not want yet another always-on bot comment. It stays quiet on compliant MRs and speaks only when a decision looks violated.
How it works
- 1A GitLab webhook fires on merge_request push.
- 2The flow gathers the diff and changed file paths.
- 3Relevant ADRs are retrieved from Confluence.
- 4An OpenAI call judges conflict vs. no-conflict and extracts the violated clause.
- 5A logic branch exits silently when no conflict is found.
- 6On conflict, a Slack DM goes to the MR reviewers with the citation and a jump link.
Set it up
What you configure once, before turning it on.
- 1Connect GitLabRepos, MRs, pipelines, registry.
- 2Connect ConfluenceSpaces, pages, blueprints.
- 3Connect OpenAIModels, embeddings, files.
- 4Connect SlackChannels, DMs, threads, mentions.
- 5Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
- 6Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
- 7Test, then turn it onRun once against a sample, confirm the output, then enable the trigger.
More AI & RAG workflows
Publish a Grounded API FAQ Page to Confluence Weekly
Each week, clusters the top unanswered or repeated API questions, generates spec-grounded answers with citations.
Detect Breaking API Changes from Spec Diffs and Alert Owners
Compares the new OpenAPI spec against the previous version on each GitLab merge, uses retrieval over the changelog to classify whether changes are breaking.
Pre-meeting prep brief grounded in Coda and CRM
Before each booked sales meeting, builds a one-page prep brief by combining the account's HubSpot context with grounded talking points and objection responses pulled from your…
Coda-grounded sales answer bot with citations in Slack
Reps ask product, pricing, or competitive questions in Slack and get an answer drawn only from your Coda knowledge hub, with links to the exact docs and rows it pulled from.
Weekly knowledge-gap digest from unanswered rep questions
Each week, scans rep questions the answer bot couldn't ground in Coda, clusters the recurring gaps.
RFP and security questionnaire drafter grounded in Coda
Drafts answers to inbound RFP and security questionnaire questions by retrieving approved language from your Coda hub, then files the cited draft for review before a rep sends it.
Run it inside a business
This workflow drops into a full company template. Import the org, and this is one of the playbooks its agents run.
Run this workflow in your colony.
14-day trial. No DevOps. No Sales call. Provisioned in under a minute.