DEV Community

Cover image for I built a plugin that checks if your docs are still in sync with your code
F2077
F2077

Posted on

I built a plugin that checks if your docs are still in sync with your code

Hey everyone,

I’ve been using Claude Code for months and kept hitting the same issue: after refactoring code, the README still describes the old API, making onboarding new devs messy.

So I built DocAlign, a free open-source Claude Code plugin (MIT license) that:

Scans your commits to find outdated docs (e.g., README.md missing new features).

Generates a clean report like:

DocAlign Report
─────────────────────────────────────
Docs to update:
  [MED] README.md — missing new recipe
  [LOW] API.md — outdated param count

No update needed:
  [OK] CHANGELOG
─────────────────────────────────────
Enter fullscreen mode Exit fullscreen mode

Then you approve what to fix and it edits just the affected sections.

The key thing: it knows to ignore its own config files. Won't touch CLAUDE.md, .claude/, your skills, etc. Only your actual project docs.

Works with any text format — .md, .rst, .txt, even .adoc.

Install (v0.2.0, early version—feedback welcome!):

claude plugin marketplace add https://github.com/F2077/doc-align  
claude plugin install doc-align  
Enter fullscreen mode Exit fullscreen mode

Top comments (0)