regomarkでAIが書いた設計記録の形式と内容を検査する方法(zenn.dev)

- ADRは設計上の決定を残す文書です。著者は、AIに任せたADRが時間の経過とともに節の構成がずれたり、決定文の中に画面のメニュー一覧や定数などのコードの詳細が混ざったりするようになったと書いています。 - 著者は、節の順序、Statusの値、ADR同士の参照、リンク先ファイルの存在のように機械で確認できる構造のルールは、ポリシーファイルで検査し、違反があればCIを失敗させる方法を提案しています。仕様書のように書かれているかどうかといった意味のルールは、LLMに判定させ、PRに注意としてだけ残す方法です。 - regomarkは著者が作ったコマンドラインツールで、Markdownを解析し、OPA（ポリシー評価ツール）でルールを検査します。ADR専用の実装はなく、ルールは利用するリポジトリのポリシーファイルに置くと著者は述べています。 - 著者は自分のリポジトリ7個を読み直したところ、コードと食い違っていた内容はすべてADRに書く必要のない詳細であり、決定や守るべき保証は古くなっていなかったと報告しています。これは著者一人の観察です。