Files
leo-claude-mktplace/plugins/doc-guardian
lmiranda 6b666bff46 fix: proactive documentation and sprint planning automation
- doc-guardian: Hook now tracks documentation dependencies and outputs
  specific files needing updates (e.g., commands → COMMANDS-CHEATSHEET.md)
- projman: SessionStart hook now suggests /sprint-plan when open issues
  exist without milestone, and warns about unreleased CHANGELOG entries
- projman: Add /suggest-version command for semantic version recommendations
- docs: Update COMMANDS-CHEATSHEET.md with data-platform plugin (was missing)
- docs: Update CLAUDE.md with data-platform and version 4.0.0

Fixes documentation drift and lack of proactive workflow suggestions.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 15:18:30 -05:00
..

doc-guardian

Automatic documentation drift detection and synchronization for Claude Code projects.

Problem Solved

Documentation gets outdated. Functions get renamed, configs change, versions bump—but docs lag behind. This creates:

  • Multiple review cycles finding stale references
  • Unnecessary commits fixing docs piecemeal
  • User confusion from outdated instructions

Solution

doc-guardian monitors your code changes via hooks:

  1. Detects when changes might affect documentation
  2. Alerts you to potential drift (doesn't interrupt your flow)
  3. Provides commands to audit and sync docs when ready

Commands

Command Description
/doc-audit Full project scan - reports all drift without changing anything
/doc-sync Apply all pending documentation updates in one commit

Hooks

  • PostToolUse (Write|Edit): Silently checks if code changes affect docs

What It Detects

  • Broken References: Function/class renamed but docs still use old name
  • Version Drift: Python 3.9 in docs but 3.11 in pyproject.toml
  • Missing Docs: Public functions without docstrings
  • Stale Examples: CLI examples that no longer work

Installation

This plugin is part of the Leo Claude Marketplace.

/plugin marketplace add https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git
/plugin install doc-guardian

Integration

See claude-md-integration.md for CLAUDE.md additions.