lmiranda
2d51df7a42
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>
54 lines
1.3 KiB
Markdown
54 lines
1.3 KiB
Markdown
---
|
|
name: doc stale-docs
|
|
description: 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
|