ENGINEERING

Nudge for a runbook update when a service PR merges

When a pull request merges to a service's default branch, checks whether that service's Confluence runbook has been touched recently and, if not, opens a GitHub follow-up issue…

CategoryEngineering
Enginesim
Difficultyintermediate
Triggerevent
Steps5
Setup~15 min

How it runs

The automated pipeline, trigger to output.

  • TriggerPR merged to default branch (GitHub)GitHubGitHub
  • ActionRead service runbook last-edited date from ConfluenceConfluenceConfluence
  • LogicBranch on runbook older than freshness window
  • ActionOpen GitHub follow-up issue linking the PRGitHubGitHub
  • OutputDM the PR author in Slack to refresh the runbookSlack

What it does

Catches runbook drift at the moment it happens. The instant a PR merges into a service's main branch, it inspects when that service's runbook was last edited and, if the runbook is older than a freshness threshold, it files a tracked follow-up issue and reminds the merging author to confirm the runbook still holds.

When to use it

Use it on services where code moves fast and runbooks quietly rot. Tying the reminder to the merge event puts the prompt in front of the person with the most context, instead of weeks later in a batch report.

How it works

  1. 1A GitHub pull-request-merged event triggers the flow.
  2. 2It looks up the service's runbook in Confluence and reads its last-edited date.
  3. 3A branch checks whether the runbook is older than the configured freshness window.
  4. 4If fresh, the flow exits quietly with no noise.
  5. 5If stale, it opens a GitHub issue titled with the service and links the merged PR.
  6. 6It posts a Slack direct message to the PR author asking them to review and refresh the runbook.

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 SlackChannels, DMs, threads, mentions.
  4. 4
    Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
  5. 5
    Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
  6. 6
    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.