最終更新: 2026/06/22 18:56
commonid: adr-skill-migration-mappingtype: opsstatus: active

Migration Mapping (簡略版)

位置付け: 既存 ADR-0001〜0018 を adr-kit の canonical-seven-section テンプレに migrate しない ことを明示するメモ。将来 canonical 化を再検討する場合の対応マッピングを参考メモとして残す。

本リポの方針 (ADR-0019): 既存 _template.md / ADR-0001〜0018 は不変更。canonical 移行は採用しない。

現在の方針 (ADR-0019 で確定)

  • 既存 ADR-0001〜0018 は _template.md 形式のまま維持
  • adr-kit の canonical-seven-section テンプレには 変換しない
  • LangGraph N7 (本文生成 LLM) も _template.md を system prompt に注入する

理由:

  1. 既存 ADR は導入時に手動で品質確認済 (Status: 採用済み / Accepted)。再フォーマットは差分ノイズが大きい。
  2. canonical 化のメリット (4 ゲート lint pass) は新規 ADR で享受できれば十分。
  3. CLAUDE.md L102「既存テストの skip / 削除 (リファクタ理由でも禁止)」と同じ原則を ADR にも適用: 「動作している既存資産を再構成するためだけに変更しない」。

将来 canonical 化を再検討する場合のマッピング (参考)

もし将来 (例: 2027 年に ADR が 50 本を超え、フォーマット統一の ROI が逆転する場合) canonical 移行を検討するなら、以下の対応を参考にする:

_template.md セクションadr-kit canonical-seven-section 相当備考
# ADR-NNNN: タイトル要旨# ADR-NNNN: Titleそのまま
メタ情報 (Status / Mode / 起案者 / 起案日 / 承認日)YAML frontmatter に変換adr-kit はメタを frontmatter で扱う
## コンテキスト## Contextそのまま日 → 英で OK
## 決定## Decisionそのまま
## 検討した代替案## Alternatives Consideredadr-kit の Mode = Standard で必須セクション
## 影響## Consequencesadr-kit は positive / negative / risk を明示分離する慣習
## 撤退条件## Rollback Plan (新規セクション)adr-kit の標準には含まれない、本リポ独自セクションを Notes for Successor 直前に配置
## 参照## Referencesそのまま
(なし)## Notes for Successoradr-kit 推奨セクション、新規追加可

Mode → Notes for Successor 対応

adr-kit には Mode (Light / Standard / Critical) という概念がある。本リポも _template.md に Mode フィールドが既存。

本リポ Modeadr-kit 相当必須セクション
Lightliteコンテキスト / 決定 / 影響 のみ。代替案・撤退条件は省略可
Standardstandard全セクション必須
Criticalcritical全セクション + Notes for Successor 必須、レビュアー 2 名以上要件

ADR-0019 は Mode: Standard で起案。

migrate を しない 場合の運用

  • 新規 ADR (ADR-0019 以降) は _template.md で起案、LangGraph N7 が生成
  • 既存 ADR-0001〜0018 は そのまま参照、必要時のみ手動更新
  • /adr-kit:lint docs/adr/ で 4 ゲート pass 率を測定 → ベースラインとして lint_baseline.md (main session で作成) に記録
  • pass 率が低い ADR は 個別に手動修正 で品質改善 (一括 migrate はしない)

撤退条件再掲 (ADR-0019 より)

  • adr-kit lint pass 率 50% 未満 → adr-kit 撤去、LangGraph に lint node 追加
  • 上記が発動したら本マッピングメモも保留 (LangGraph 側で lint 規則を別途定義)

参照

  • ADR-0019 (docs/adr/0019-drp-migration.md)
  • ADR-0010 (モジュラーモノリストと 3 桁番号体系)
  • docs/adr/_template.md (本リポの ADR テンプレ SSoT)
  • bizlink-domain.md (docs/_internal/adr_skill_setup/bizlink-domain.md)
  • langgraph-adrkit-boundary.md (docs/_internal/adr_skill_setup/langgraph-adrkit-boundary.md)