lmiranda
7c8a20c804
Refactored commands to extract reusable skills following the Commands → Skills separation pattern. Each command is now <50 lines and references skill files for detailed knowledge. Plugins refactored: - claude-config-maintainer: 5 commands → 7 skills - code-sentinel: 3 commands → 2 skills - contract-validator: 5 commands → 6 skills - data-platform: 10 commands → 6 skills - doc-guardian: 5 commands → 6 skills (replaced nested dir) - git-flow: 8 commands → 7 skills Skills contain: workflows, validation rules, conventions, reference data, tool documentation Commands now contain: YAML frontmatter, agent assignment, skills list, brief workflow steps, parameters Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1.3 KiB
1.3 KiB
description
| description |
|---|
| Detect documentation files that are stale relative to their associated code |
Stale Documentation Detection
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
-
Map Documentation to Code Execute
skills/staleness-metrics.md- build relationships -
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
-
Calculate Staleness Use levels from skill (Fresh/Aging/Stale/Critical)
-
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