lmiranda
79ee93ea88
Add single-line box headers to 19 agents across all non-projman plugins: - clarity-assist (1): Clarity Coach - claude-config-maintainer (1): Maintainer - code-sentinel (2): Security Reviewer, Refactor Advisor - doc-guardian (1): Doc Analyzer - git-flow (1): Git Assistant - pr-review (5): Coordinator, Security, Maintainability, Performance, Test - data-platform (2): Data Analysis, Data Ingestion - viz-platform (3): Component Check, Layout Builder, Theme Setup - contract-validator (2): Agent Check, Full Validation - cmdb-assistant (1): CMDB Assistant Uses single-line box format (not double-line like projman). Part of #275 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
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:
- Detects when changes might affect documentation
- Alerts you to potential drift (doesn't interrupt your flow)
- 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 |
/changelog-gen |
Generate changelog from conventional commits in Keep-a-Changelog format |
/doc-coverage |
Calculate documentation coverage percentage for functions and classes |
/stale-docs |
Detect documentation files that are stale relative to their associated code |
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
- Low Coverage: Undocumented functions and classes
- Stale Files: Documentation that hasn't been updated alongside code changes
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.