Files
leo-claude-mktplace/plugins/doc-guardian
lmiranda 32bbca73ba feat: enhance debug commands with sprint awareness and lessons learned
Debug Report (/debug-report):
- Add Step 1.5: Sprint context detection based on branch and milestone
- Add Step 5: Smart labeling via suggest_labels MCP tool
- Update issue creation to support milestone association

Debug Review (/debug-review):
- Add Step 9.5: Search lessons learned before proposing fixes
- Add Step 15: Verify, close issue, and optionally capture lesson

Hooks:
- Simplify doc-guardian hook to be truly non-blocking (15 words max)
- Update code-sentinel to skip docs/config files entirely

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-22 18:02:09 -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.