AI & RAG

ADR Drafter: turn a Slack decision thread into a Confluence ADR

Triggered on a Slack thread, retrieves related prior ADRs for context, drafts a properly formatted Architecture Decision Record with an LLM.

CategoryAI & RAG
Enginepaperclip
Difficultyadvanced
Triggerevent
Steps5
Setup~25 min

How it runs

The automated pipeline, trigger to output.

  • TriggerMarker emoji reaction added to Slack threadSlack
  • ActionCollect full thread transcript from SlackSlack
  • ActionRetrieve related ADRs from Postgres indexPostgreSQLPostgres
  • ActionDraft structured ADR with OpenAIOpenAI
  • OutputCreate draft ADR page in Confluence and link it backConfluenceConfluence

What it does

Captures decisions made in Slack before they evaporate. When an engineer reacts to a decision thread with a marker emoji, the flow reads the conversation, pulls related existing ADRs for consistency, drafts a structured ADR (context, decision, consequences, alternatives), and files it as a Confluence draft.

When to use it

Use it when real decisions happen in chat but rarely become records, when the ADR template is intimidating enough that people skip it, or when you want a consistent format produced automatically for human approval.

How it works

  1. 1A reaction added to a Slack thread triggers the flow.
  2. 2The bot collects the full thread transcript via Slack.
  3. 3It retrieves semantically related ADRs from the Postgres index so the draft references prior decisions and avoids duplication.
  4. 4OpenAI writes a complete ADR in the team template, marked status "proposed," grounded in the thread and related records.
  5. 5The draft is created as a Confluence page and the link is posted back to the thread for review.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect SlackChannels, DMs, threads, mentions.
  2. 2
    Connect PostgresAny Postgres URL — query, write, migrate.
  3. 3
    Connect OpenAIModels, embeddings, files.
  4. 4
    Connect ConfluenceSpaces, pages, blueprints.
  5. 5
    Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
  6. 6
    Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
  7. 7
    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.