docs-freshness-audit
Installation
SKILL.md
Docs Freshness Audit
docs が実装と乖離していないかを監査し、「更新 / 削除 / ADR 移送」の処遇まで導く手順書。 バナー付きで放置された仕様書・実在しないモジュールを記述し続ける spec・merge 済みなのに 残っている計画ファイルは、残しておくと逆に混乱の元になる。
Step 0: 導入先設定の確認
skill 本体は手順とプロンプトのみを持つ。以下を導入先の CLAUDE.md / rules / ドキュメント保守ポリシーから拾ってから開始する (無ければユーザーに確認):
| 項目 | 例 |
|---|---|
| docs 検証コマンド | make docs-okf, python scripts/validate_docs.py |
| 監査除外 | ADR/デザイン等のバンドル (各自の管理規約に委ねる)、生成物 |
| 計画・設計出力ディレクトリ | docs/plans/, `docs/superpowers/plans |
| 保守履歴の追記先 | docs/documentation-maintenance.md |
| 削除の運用 | docs chore の push 先ルール (直 push 可否) |