ENGINEERING

CEO-driven runbook drift triage and remediation drafts

On demand, an agent compares each service's recent GitHub commit history against its Confluence runbook, reasons about which runbook sections are likely outdated.

CategoryEngineering
Enginepaperclip
Difficultyadvanced
Triggermanual
Steps6
Setup~25 min

How it runs

The automated pipeline, trigger to output.

  • TriggerOperator triggers the triage run
  • ActionPull recent commits and changed paths from GitHubGitHubGitHub
  • ActionRead current runbook content from ConfluenceConfluenceConfluence
  • LogicReason about which runbook sections driftedOpenAI
  • ActionPost inline suggested edits as Confluence commentsConfluenceConfluence
  • OutputOpen a Linear drift ticket per service for reviewLinearLinear

What it does

Goes beyond date comparison to judge what content actually drifted. An agent reads recent merged changes for each service, reads the current runbook, and reasons about which steps, commands, or topology notes are now wrong. It writes suggested edits as comments on the Confluence page and files a Linear ticket summarizing the drift for the service owner.

When to use it

Use it when a simple timestamp check is too blunt and you want a human-reviewable starting point for the actual rewrite. Best for a quarterly deep clean across a service catalog, or before an on-call handoff to a new team.

How it works

  1. 1An operator triggers the run, optionally scoping it to a set of services.
  2. 2The agent pulls recent commit messages and changed paths per service from GitHub.
  3. 3It reads the matching runbook content from Confluence.
  4. 4It reasons about which sections the code changes likely invalidated.
  5. 5It posts inline suggested edits as comments on each runbook page.
  6. 6It opens a Linear ticket per service with a drift summary and a link to the suggestions for owner sign-off.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect GitHubRepos, issues, pull requests, actions.
  2. 2
    Connect ConfluenceSpaces, pages, blueprints.
  3. 3
    Connect LinearIssues, projects, cycles, triage.
  4. 4
    Connect OpenAIModels, embeddings, files.
  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.