Files
leo-claude-mktplace/plugins/doc-guardian/commands/doc-stale-docs.md
lmiranda 2d51df7a42 feat(marketplace): command consolidation + 8 new plugins (v8.1.0 → v9.0.0) [BREAKING]
Phase 1b: Rename all ~94 commands across 12 plugins to /<noun> <action>
sub-command pattern. Git-flow consolidated from 8→5 commands (commit
variants absorbed into --push/--merge/--sync flags). Dispatch files,
name: frontmatter, and cross-reference updates for all plugins.

Phase 2: Design documents for 8 new plugins in docs/designs/.

Phase 3: Scaffold 8 new plugins — saas-api-platform, saas-db-migrate,
saas-react-platform, saas-test-pilot, data-seed, ops-release-manager,
ops-deploy-pipeline, debug-mcp. Each with plugin.json, commands, agents,
skills, README, and claude-md-integration. Marketplace grows from 12→20.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-06 14:52:11 -05:00

1.3 KiB

name, description
name description
doc stale-docs Detect documentation files that are stale relative to their associated code

/doc stale-docs

Identify documentation files that may be outdated based on commit history.

Skills to Load

  • skills/staleness-metrics.md
  • skills/drift-detection.md

Visual Output

+------------------------------------------------------------------+
|  DOC-GUARDIAN - Stale Documentation Check                        |
+------------------------------------------------------------------+

Process

  1. Map Documentation to Code Execute skills/staleness-metrics.md - build relationships

  2. Analyze Commit History For each doc file:

    • Find last commit that modified the doc
    • Find last commit that modified related code
    • Count commits to code since doc was updated
  3. Calculate Staleness Use levels from skill (Fresh/Aging/Stale/Critical)

  4. Output Use format from skills/staleness-metrics.md

Options

Flag Description Default
--threshold <n> Commits behind to flag 10
--days Use days instead false
--path <dir> Scan directory Project root
--show-fresh Include fresh docs false

Exit Codes

  • 0: No critical or stale docs
  • 1: Stale docs found
  • 2: Critical docs found