jpskill.com
💬 コミュニケーション コミュニティ 🟢 非エンジニアでもOK 👤 管理職・人事・カスタマー対応

💬 Adr Index

adr-index

既存のADR（アーキテクチャ意思決定記録）を解析し、依存関係グラフとインデックスを効率的に再構築するSkill。

⚡ ⏱ クレーム返信ドラフト 15分 → 2分

📺 まず動画で見る(YouTube)

▶ 【最新版】Claude(クロード)完全解説!20以上の便利機能をこの動画1本で全て解説 ↗

※ jpskill.com 編集部が参考用に選んだ動画です。動画の内容と Skill の挙動は厳密には一致しないことがあります。

📜 元の英語説明(参考)

Build or rebuild the ADR index + dependency graph by running scripts/import.mjs (handles v3-style and plugin-style ADR formats; one Bash call vs hundreds of MCP round-trips)

🇯🇵 日本人クリエイター向け解説

一言でいうと

既存のADR（アーキテクチャ意思決定記録）を解析し、依存関係グラフとインデックスを効率的に再構築するSkill。

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux 
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o adr-index.zip https://jpskill.com/download/2196.zip && unzip -o adr-index.zip && rm adr-index.zip
🪟 Windows (PowerShell) 
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/2196.zip -OutFile "$d\adr-index.zip"; Expand-Archive "$d\adr-index.zip" -DestinationPath $d -Force; ri "$d\adr-index.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して adr-index.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → adr-index フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動
⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-17
取得日時
2026-05-17
同梱ファイル
1

💬 こう話しかけるだけ — サンプルプロンプト

  • › Adr Index で、お客様への返信文を作って
  • › Adr Index を使って、社内向けアナウンスを書いて
  • › Adr Index で、メールテンプレートを整備して

これをClaude Code に貼るだけで、このSkillが自動発動します。

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

[スキル名] adr-index

ADRインデックス

*/docs/adr/ または */docs/adrs/ 配下のすべてのADRを adr-patterns ネームスペースに、そしてすべての関係（supersedes / amends / related / depends-on）を adr-edges に永続化します。Rufloモノレポで見られる両方のADR形式を処理します。

  • v3-スタイル: # ADR-097: Title 見出し + **Status**: Proposed 行
  • プラグイン・スタイル: YAMLフロントマター (id: ADR-NNNN, status: Proposed)

実装は、ADRごとの多数のMCPツール呼び出しではなく、scripts/import.mjs（1回のBash呼び出し）で行われます。これにより、実質的に同じ動作で、大幅に高速化され、デュアルフォーマットに対応し、イシュー番号の誤検出に強くなっています。

使用するタイミング

  • 他のプロジェクトからADRをインポートした後
  • AgentDBグラフがディスク上のADRファイルと同期していない場合
  • 既存のコードベースでADRトラッキングをブートストラップする場合

手順

  1. インポーターを実行します:

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

    オプションの環境変数:

    • IMPORT_FORMAT=json — Markdownの代わりにJSONを出力します
    • IMPORT_DRY_RUN=1 — 解析と要約を行い、永続化をスキップします
    • ADR_ROOT=/path — 別のルートをスキャンします（デフォルト: 現在の作業ディレクトリ）

  2. 要約を検査します — 総ADR数、保存された数、ステータス別の内訳、エッジ数、ぶら下がり参照、ステータスの不一致。

  3. グラフの整合性を検証します（オプションですが推奨） — 兄弟スキルである adr-verify を使用します。これは scripts/verify.mjs を実行し、サイクルがある場合は終了コード1で終了します。

  4. 投入されたネームスペースに対して mcp__claude-flow__memory_search を介してセマンティック検索を行います:

    memory_search --query "federation budget" --namespace adr-patterns

ストレージの形状

adr-patterns ネームスペース、キー <ADR-id>::<basename>、値（テキスト）:

<title> — <first paragraph of Context>

file: <relative path>
status: <Proposed|Accepted|Superseded|...>
date: <ISO date>
tags: <comma-separated>

adr-edges ネームスペース、キー <relation>:<FROM>-><TO>:<timestamp-rand>、値:

{ "from": "ADR-097", "to": "ADR-086", "relation": "related", "capturedAt": "<ISO>" }

誤検出防止

ADR本文内の #1697 / commit abc123 / PR 1234 参照は、正規表現抽出の前に除去されるため、ADR-1697 などと誤読されることはありません。scripts/import.mjs の extractAdrRefs() を参照してください。

相互参照

  • adr-create — このスキルが消費するADRファイルを生成します
  • adr-review — コンプライアンスチェックのために adr-patterns を実行します
  • adr-verify（兄弟スキル） — グラフ整合性ゲートのために scripts/verify.mjs を実行します
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

ADR Index

Persists every ADR under */docs/adr/ or */docs/adrs/ to the adr-patterns namespace and every relationship (supersedes / amends / related / depends-on) to adr-edges. Handles both ADR formats found in the Ruflo monorepo:

  • v3-style: # ADR-097: Title heading + **Status**: Proposed line
  • plugin-style: YAML frontmatter (id: ADR-NNNN, status: Proposed)

Implementation is in scripts/import.mjs (one Bash call) rather than dozens of per-ADR MCP tool calls — same effective behavior, materially faster, dual-format-aware, and false-positive-resistant for issue numbers.

When to use

  • After importing ADRs from another project
  • When the AgentDB graph is out of sync with the on-disk ADR files
  • Bootstrapping ADR tracking on an existing codebase

Steps

  1. Run the importer:

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

    Optional env:

    • IMPORT_FORMAT=json — emit JSON instead of markdown
    • IMPORT_DRY_RUN=1 — parse + summarize, skip persistence
    • ADR_ROOT=/path — scan a different root (default: cwd)

  2. Inspect the summary — total ADRs, stored count, by-status breakdown, edge counts, dangling refs, status mismatches.

  3. Verify graph integrity (optional but recommended) via the sibling adr-verify skill, which runs scripts/verify.mjs and exits 1 on cycles.

  4. Search semantically via mcp__claude-flow__memory_search against the populated namespace:

    memory_search --query "federation budget" --namespace adr-patterns

Storage shape

adr-patterns namespace, key <ADR-id>::<basename>, value (text):

<title> — <first paragraph of Context>

file: <relative path>
status: <Proposed|Accepted|Superseded|...>
date: <ISO date>
tags: <comma-separated>

adr-edges namespace, key <relation>:<FROM>-><TO>:<timestamp-rand>, value:

{ "from": "ADR-097", "to": "ADR-086", "relation": "related", "capturedAt": "<ISO>" }

False-positive guard

#1697 / commit abc123 / PR 1234 references inside ADR bodies are stripped before regex extraction so they don't get misread as ADR-1697 etc. See extractAdrRefs() in scripts/import.mjs.

Cross-references

  • adr-create — produces the ADR files this skill consumes
  • adr-review — runs over adr-patterns for compliance checks
  • adr-verify (sibling skill) — runs scripts/verify.mjs for graph-integrity gating