mcpField
A
adr-create

adr-create

github.com/ruvnet開発80.0k741 回インストール今日更新
リポジトリ

adr-create について

連番の Architecture Decision Record（ADR）を作成し、AgentDB に登録するスキルです。関連する決定を検索し、ADR とグラフの両方で結び付けます。

主な機能

  1. 01次の ADR 番号の割り当て
  2. 02テンプレートによる ADR 作成
  3. 03決定事項の AgentDB 登録
  4. 04関連 ADR の検索
  5. 05関連決定のリンク

活用シーン

  1. 01複数コンポーネントに関わる設計判断の記録
  2. 02技術や API に関する決定の文書化
  3. 03新しい決定と既存 ADR の関連付け

MCP 対応

MCP ツールで ADR データを AgentDB に保存し、関連決定を検索して因果エッジを追加し、後の検索用にパターンを保存します。

インストール

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

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

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

詳細

ADR を作成

次の連番で新しいアーキテクチャ決定記録を作成し、AgentDB グラフに登録して、関連する ADR にリンクします。

使用するタイミング

新しい技術の採用、API 設計の選択、データモデルの変更、インフラストラクチャの決定、複数のコンポーネントに影響する横断的な懸念など、重要なアーキテクチャ上の決定を記録する必要がある場合に使用します。

手順

  1. 次の番号を確認する -- Glob で docs/adr/ADR-*.md を検索し、既存の番号を解析して次の連番 ID（ADR-001、ADR-002 など）を特定します。docs/adr/ が存在しない場合は作成します。

  2. タイトルをスラッグ化する -- タイトルの引数を、小文字でハイフン区切りのスラッグに変換します（例：「永続化に PostgreSQL を使用する」は use-postgresql-for-persistence になります）。

  3. ADR ファイルを作成する -- 標準テンプレートを使用して、docs/adr/ADR-NNN-<slug>.md にファイルを Write します。

    # ADR-NNN: <Title>

- **Status**: proposed
- **Date**: <today's date YYYY-MM-DD>
- **Deciders**: <leave blank for author to fill>
- **Tags**: <leave blank>

## Context



## Decision



## Consequences

### Positive
-

### Negative
-

### Neutral
-

## Links

  4. AgentDB に保存する -- 次を指定して mcp__plugin_ruflo-core_ruflo__agentdb_hierarchical-store を呼び出します。

    • key: mem:ADR-NNN
    • tier: semantic
    • value: JSON 形式でエンコードした文字列：{ "id": "ADR-NNN", "title": "<title>", "status": "proposed", "date": "<today>", "file": "docs/adr/ADR-NNN-<slug>.md" }

  5. 関連する ADR を検索する -- adr-patterns 名前空間で、タイトルをクエリとして mcp__plugin_ruflo-core_ruflo__memory_search を呼び出し、関連する決定を検索します。一致するものが見つかった場合は、それらを Links セクションに追加し、関係ごとに次の内容で mcp__plugin_ruflo-core_ruflo__agentdb_causal-edge を呼び出します。

    • sourceId: mem:ADR-NNN
    • targetId: mem:ADR-RELATED
    • relation: depends-on

  6. パターンを保存する -- adr-patterns 名前空間で、キーを ADR-NNN、値をタイトルとコンテキストとして mcp__plugin_ruflo-core_ruflo__memory_store を呼び出し、今後のセマンティック検索に備えて保存します。

  7. 報告する -- 作成したファイルのパス、ADR 番号、見つかった関連 ADR を出力します。

コメント

Markdown 対応