Standalone documentation sync: find outdated refs, update CHANGELOG, flag stale examples based on code changes
npx claudepluginhub agent-sh/sync-docsSync documentation with code changes. Find outdated refs, update CHANGELOG, flag stale examples.
No description available.
Production-ready workflow orchestration with 79 focused plugins, 184 specialized agents, and 150 skills - optimized for granular installation and minimal token usage
Curated collection of 141 specialized Claude Code subagents organized into 10 focused categories
Detect outdated documentation by comparing docs against actual code state - broken references, version mismatches, stale examples, and missing CHANGELOG entries.
Documentation drifts from code silently. A function gets renamed, an import path changes, a version bumps - but the README and CHANGELOG still reference the old state. sync-docs compares documentation files against the current codebase and finds the gaps. Safe fixes like version updates and CHANGELOG entries are auto-applied. Ambiguous cases - removed exports referenced in docs, code examples needing context - are flagged for manual review.
Use cases:
agentsys install sync-docs
# Check for outdated docs (no changes made)
/sync-docs
# Apply safe fixes (version updates, CHANGELOG entries)
/sync-docs apply
# Check docs related to a specific path
/sync-docs report src/
# Scan entire codebase, not just recent changes
/sync-docs --scope=all
sync-docs runs a multi-phase analysis pipeline:
Phase 1 - Project detection. Identifies the project type (JavaScript, Python, Rust, Go) and locates documentation files (README.md, CHANGELOG.md, docs/*.md).
Phase 2 - Change discovery. Gets changed files based on scope (recent commits, full branch, or entire codebase) and finds documentation files that reference those changed files by filename, import path, function name, or class name.
Phase 3 - Issue analysis. Reads each related doc and checks for:
Phase 4 - CHANGELOG check. Compares recent conventional commits against CHANGELOG entries. Flags commits with no corresponding entry.
Phase 5 - Doc-drift detection (optional). When repo-intel data is available, identifies docs with zero code coupling - files that never co-change with code and are likely stale.
/sync-docs
/sync-docs report src/auth/
/sync-docs report --scope=all
Outputs a structured report of documentation issues sorted by severity. No files are modified.
/sync-docs apply
/sync-docs apply --scope=before-pr
Applies safe fixes (version updates, CHANGELOG entries) and reports remaining issues for manual review. Changes are committed with the message docs: sync documentation with code changes.
recent (default) - files changed since last commit to mainall - scan all docs against all codebefore-pr - files in current branch, optimized for pre-PR workflows<path> - specific file or directory/sync-docs --include-undocumented # Find exports with no doc coverage (uses repo-map)
MIT