CONTENT CREATION

Flag stale docs on every merged PR and draft the fix

When a PR merges, the agent compares the code diff against your docs and, if it finds documentation that the change made wrong, opens a draft PR with the corrected text…

CategoryContent Creation
Enginepaperclip
Difficultyintermediate
Triggerevent
Steps6
Setup~15 min

How it runs

The automated pipeline, trigger to output.

  • TriggerPull request mergedGitHubGitHub
  • ActionFetch diff and changed filesGitHubGitHub
  • ActionFind docs referencing changed codeGitHubGitHub
  • LogicClassify each doc: stale, maybe, or unaffected
  • ActionRewrite affected doc passages
  • OutputOpen draft doc-fix pull requestGitHubGitHub

What it does

Watches your repository for merged pull requests, reads the actual code diff, and decides whether any documentation in the repo is now inaccurate because of it. When it finds a real mismatch, it drafts the corrected prose and opens a follow-up pull request so a maintainer only has to review and merge.

When to use it

Use it when your README, guides, or in-repo docs drift out of date because code changes ship faster than anyone updates the docs. Best for teams that keep documentation in the same repo as code and want doc fixes to arrive as reviewable PRs rather than nagging reminders.

How it works

  1. 1A merged pull request fires the trigger.
  2. 2The agent pulls the full diff and the list of changed files from GitHub.
  3. 3It locates docs that reference the changed code (function names, flags, endpoints, config keys).
  4. 4A decision step judges whether each doc is now wrong, vaguely affected, or untouched.
  5. 5For genuinely stale docs, it rewrites only the affected passages.
  6. 6It opens a draft pull request with the edits and a summary of what changed and why.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect GitHubRepos, issues, pull requests, actions.
  2. 2
    Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
  3. 3
    Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
  4. 4
    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.