Scraps 最終更新 2026/11/10 10:33

原文著者: @にしこりさぶろ〜 | TOKIUM /

AIが書く「読みづらいADR」に発狂しかけたので、ADRのガイドラインを作った

AIで作成し、掲載基準に基づいて自動選定した要約です。

  • AIが書いたADRが読みづらい問題を解決するためにADRのガイドラインを作成した
  • ADRに書くべきこと・書くべきでないことを32件の規約で整理し、移行計画や実装の詳細を書かないこと、参照先を明確にすることを必須とした
  • ADRに移行計画やタスク表を書くと長期的に読み返しづらいため、ガイドラインで禁止し、参照先をReferences節にまとめるよう求めた
AIが書く「読みづらいADR」に発狂しかけたので、ADRのガイドラインを作った

Zenn / 原文を読む