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>
53 lines
1.3 KiB
Markdown
53 lines
1.3 KiB
Markdown
---
|
|
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
|
|
|
|
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
|