AI & RAG
Auto-Draft an ADR from a Large MR Description
When a large merge request is opened, drafts a candidate architecture decision record grounded in the MR description and related prior ADRs.
How it runs
The automated pipeline, trigger to output.
- TriggerGitLab MR openedGitLab
- LogicContinue only for large or labeled MRs
- ActionFetch MR description and related ADRsConfluence
- ActionDraft structured candidate ADROpenAI
- OutputPost draft to Slack for approvalSlack
What it does
Large MRs usually encode a real architecture decision that never gets written down. When an MR exceeds a configurable size or carries a decision label, this flow reads its description and retrieves related prior ADRs for consistent context and numbering, then drafts a full candidate ADR in your house format (context, decision, consequences, related decisions). It posts the draft to Slack for a human to approve before anything is filed.
When to use it
Use it to capture decisions at the moment they are made, while the author still has the reasoning fresh, instead of reconstructing it months later. The human-approval step keeps quality and authorship under control.
How it works
- 1A GitLab webhook fires when an MR is opened.
- 2A logic step continues only for large or decision-labeled MRs.
- 3The MR description is fetched and related ADRs are retrieved from Confluence for context.
- 4An OpenAI call drafts a structured ADR grounded in those sources.
- 5The draft is posted to Slack with approve and edit actions for review.
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.