review-docslisted

# Review Docs Skill `docs/` 以下のドキュメント全体を走査し、リンク切れと整合性問題を検出してレポートを出力する。 ## アーキテクチャ このスキルは処理を2つのサブエージェントに分担させることでメインのコンテキストを節約する。 ``` /review-docs（メインエージェント） ├── Explore エージェント A: リンク切れチェック（並列起動） ├── Explore エージェント B: 整合性チェック（並列起動） └── メインエージェント: 両結果を受け取りレポート生成 ``` ## 手順 ### 1. サブエージェントを並列起動する 以下の2つの Explore エージェントを **同時に（1メッセージで）** 起動する。 --- #### サブエージェント A — リンク切れチェック **プロンプト（要旨）**: > `docs/**/*.md` および `CLAUDE.md` 全件を読み込み、各ファイルに含まれる Markdown リンク `[text](path)` と画像参照 `` を抽出せよ。 > > チェック対象: > - 相対パス参照 → リポジトリルートから解決して実ファイルの存在確認 > - アンカー付きリンク `[text](file.md#anchor)` → 対象ファイルに該当見出し（`# ...`, `## ...` 等）���存在するか確認 > - `/` 始まりの絶対パス → リポジトリルートから存在確認 > > チェック対象外: > - `http://`, `https://` で始まる外部リンク > > 結果は以下の形式で返せ: > > ``` > BROKEN_LINK|ファイルパス|行番号|リンク記述|理由 > BROKEN_LINK|docs/requirements.md|125|[コアコンセプト](design/concepts.md)|ファイルが存在しない > OK_LINK_COUNT|32 > TOTAL_FILES|18 > ``` --- #### サブエージェント B — 整合性チェック **プロンプト（要旨）**: > `docs/` 以下のすべての Markdown ファイルを読み込み、以下の観点で整合性を確認せよ。 > 各観点は対応するディレクトリ・ドキュメントが存在する場合のみ実行し、無ければスキップする。 > > **1. CLAUDE.md ドキュメント表** > `CLAUDE.md` 内に「ドキュメント」表（または同等のパス一覧）が存在する場合、記載されたファイルパスが実在するか確認する。 > > **2. ADR ↔ Design Doc の対応**（`docs/adr/` がある場合のみ） > - ADR に「関連」として記載された Design Doc のパスが実在するか > - Design Doc のステータスが「ADR化」の場合、対応する ADR ファイルが存在するか > > **3. Design Doc のステータスと実装状態の乖離**（`docs/design/` がある場合のみ） > - ステータスが「完了」の Design Doc に対応する ADR が存在しないもの（警告） > - ステータスが「ドラフト」「検討中」のまま実装されていそうなもの（git history は見なくてよい、判断で��る範囲で） > > **4. Design Doc ↔ A