mcpField
A
adr-verify

adr-verify

github.com/ruvnetテスト・品質80.0k688 回インストール今日更新
リポジトリ

adr-verify について

adr-verifyは、インポート後の永続化されたADRグラフの整合性を検査するスキルです。参照切れ、置換関係の循環、ステータスの不一致を検出し、厳格モードではCIの失敗条件にできます。

主な機能

  1. 01ADRの参照切れ検出
  2. 02置換関係の循環検出
  3. 03ADRステータスの整合性確認
  4. 04MarkdownまたはJSON出力
  5. 05厳格モードで問題時に失敗

活用シーン

  1. 01adr-index後のグラフ整合性確認
  2. 02CIで問題のある記録を遮断
  3. 03ADR関連リリース前の検証
  4. 04再インデックスが必要な削除記録の特定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/ruvnet/ruflo --skill adr-verify

インストール後、Claude Code で/adr-verifyを入力して読み込まれたか確認します。

詳細

ADR Verify

adr-index の補助ツールです。インポート後に永続化されたグラフを読み取り、整合性の問題を検出します。

  • 参照切れ — エッジが adr-patterns に存在しない ADR ID を参照しています。よくある原因は、参照先の ADR が兄弟リポジトリにあるか、削除されていることです。
  • 置き換えサイクル — ADR-A supersedes ADR-B と ADR-B supersedes ADR-A（またはそれ以上の長さのサイクル）が発生しています。常にデータ破損を示します。
  • ステータスの不一致 — ADR が supersedes エッジの始点になっているのに、その ADR 自身のステータスが Superseded ではありません。通常は、後継 ADR の昇格時にステータスの更新が漏れたことが原因です。

このスキルで検出できないこと： ディスクから削除された ADR の adr-patterns 行があり、その ADR を参照するエッジも、その ADR から出るエッジもない場合、上記のすべてのチェックで検出できません（issue #2666）。報告された ADR 数が実際にディスク上にある数より多く見える場合は、adr-verify を再度実行するのではなく、adr-reindex を実行してください。

使用するタイミング

  • adr-index の直後に、グラフが正常であることを確認する場合
  • CI でフェイルクローズのゲートとして使用する場合（VERIFY_STRICT=1 を設定すると、問題がある場合に終了コード 1 で終了します）
  • ADR 関連のリリースを公開する前

手順

node plugins/ruflo-adr/scripts/verify.mjs

任意の環境変数：

  • VERIFY_FORMAT=json — Markdown の代わりに JSON を出力します
  • VERIFY_STRICT=1 — いずれかの問題がある場合に終了コード 1 で終了します（デフォルトではサイクルがある場合のみ）

終了コード

コード意味
0グラフは正常です（厳格モード以外では、参照切れやステータスの不一致があっても終了コード 0 です）
1置き換えサイクルが検出された、または厳格モードで何らかの問題がある

関連項目

  • adr-index — このスキルが検証するデータを生成します
  • scripts/import.mjs — 独自のドライラン検証機能があります。このスキルは読み戻しを担当します
  • adr-reindex — adr-verify では検出できない削除済み ADR を調整します

コメント

Markdown 対応