AI & RAG

New-Hire Architecture Brief from ADRs

On request via webhook, assembles a grounded onboarding brief for a given subsystem from its accepted ADRs, excludes superseded ones.

CategoryAI & RAG
Enginesim
Difficultybeginner
Triggerwebhook
Steps5
Setup~5 min

How it runs

The automated pipeline, trigger to output.

  • TriggerWebhook fires with subsystem and recipientHTTP webhook
  • ActionRetrieve ADRs tagged to the subsystemConfluenceConfluence
  • LogicDrop superseded and deprecated records
  • ActionWrite cited narrative brief from accepted ADRsOpenAI
  • OutputEmail the onboarding brief to the new hireGmailGmail

What it does

Turns your Architecture Decision Records into an instant onboarding brief. Given a subsystem name, it gathers the accepted ADRs that shaped that area, leaves out anything superseded, and writes a readable summary of how and why the architecture got to where it is — with every point cited back to its ADR so the reader can go deeper.

When to use it

When onboarding engineers to a complex subsystem and you want them reading current decisions, not a graveyard of reversed ones. Useful for team leads who get the same "how does X work and why" questions from each new hire.

How it works

  1. 1A webhook fires with the target subsystem and the new hire's email.
  2. 2ADRs tagged to that subsystem are retrieved from Confluence.
  3. 3A logic step drops superseded and deprecated records, keeping only accepted decisions.
  4. 4OpenAI writes a narrative brief explaining the current architecture with inline ADR citations.
  5. 5The brief is emailed to the new hire as a formatted onboarding document.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect HTTP webhookTrigger any URL on agent actions.
  2. 2
    Connect ConfluenceSpaces, pages, blueprints.
  3. 3
    Connect OpenAIModels, embeddings, files.
  4. 4
    Connect GmailRead, draft, send, label.
  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.