Check documentation for staleness, missing coverage, and broken references
/plugin marketplace add hhopkins95/ai-systems/plugin install smart-docs@hhopkins-agent-systemAudit the docs folder for issues.
Search docs for file path references and verify they exist:
# Find file path patterns in docs
grep -rE '`[a-zA-Z0-9/_-]+\.(ts|js|tsx|jsx|md)`' docs/
For each referenced path, verify the file exists.
For each folder in docs/:
Check for docs not linked from any index:
Compare documented packages to actual packages:
Search for patterns indicating staleness:
TODO or FIXME in docsComing soon or TBDReport findings grouped by severity:
## Documentation Audit Results
### Errors (Must Fix)
- [ ] Broken reference: docs/packages/foo.md references `src/old-file.ts` (doesn't exist)
- [ ] Missing from index: docs/system/bar.md not in docs/system/index.md
### Warnings (Should Fix)
- [ ] Undocumented package: runtime/server has no doc
- [ ] Orphaned doc: docs/guides/old-guide.md has no incoming links
### Info
- [ ] TODO found: docs/packages/baz.md line 45
- Total docs: X
- Packages documented: Y/Z
After listing findings, suggest specific actions: