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 可否)
Installs
46
First Seen
Jul 5, 2026
docs-freshness-audit — nextaltair/altairs-agent-dev-kit