Documentation drift detection

Catch documentation drift before your team stops trusting the wiki

Docs go stale the moment code merges without a matching update. Moxie Docs re-checks your repository on every merge, flags drift and open doc gaps, and packages fixes into a single reviewable Cleanup PR each Friday.

  • Continuous checks. Indexing runs on merge - drift is caught while the change is still fresh in everyone's memory.
  • Visible gaps. Missing or stale pages show up in the workspace with severity and suggested paths.
  • Human review. Cleanup PRs are drafts your team merges - no silent doc edits.

What you get

Drift on every merge

The index compares live code paths to the docs that describe them.

Doc gap detection

See what is undocumented before a new engineer or agent discovers it the hard way.

Friday Cleanup PRs

One scoped PR per week with the doc updates Moxie recommends - review and merge when ready.

Search still works

Even when a page is stale, your team can search the index and jump to source citations.

How it works

  1. 01

    Connect GitHub

    Install the app on the repositories you want Moxie to watch.

  2. 02

    Run the first index

    Moxie generates the baseline docs and conventions from source.

  3. 03

    Ship code as usual

    Every merge triggers a re-check. Drift and gaps accumulate in the workspace.

  4. 04

    Review Friday Cleanup

    Approve or edit the weekly docs PR - the only automation that touches your repo.

FAQ

What counts as documentation drift?+

When code changes make an existing doc wrong or incomplete - renamed modules, new flows, removed endpoints, or conventions that no longer match the implementation.

Does Moxie edit docs without asking?+

No. Moxie proposes documentation updates as GitHub pull requests. Your team reviews and merges every change.

Can drift detection run without Friday Cleanup PRs?+

Yes. Drift and gaps are visible in the workspace as soon as they are detected. Friday Cleanup is the optional rhythm that turns findings into a single reviewable PR.