# AI가 쓴 설계 기록의 형식과 내용을 regomark로 검사하는 방법

- Link: https://zenn.dev/babarot/articles/regomark-adr-checker
- Discussion: https://startupxo.com/ko/1224/
- Posted by startupxo at 2026-11-03T12:29:03.012Z
- 0 points, 1 comment, kind story, origin curated
- Written in ko

## Summary

- ADR은 설계 결정을 남기는 문서다. 저자는 AI에게 맡긴 ADR이 시간이 지나며 절 구조가 어긋나거나, 결정문 안에 화면 메뉴 목록과 상수 같은 코드 세부 내용이 섞이는 일이 생겼다고 적는다.
- 저자는 절 순서, Status 값, ADR 간 참조, 링크 파일 존재처럼 기계로 확인할 수 있는 구조 규칙은 정책 파일로 검사해 위반 시 CI를 실패시키고, 명세서처럼 쓰였는지 같은 의미 규칙은 LLM에게 판정시켜 PR에 주의로만 남기는 방식을 제안한다.
- regomark는 저자가 만든 명령줄 도구로, Markdown을 분석해 OPA(정책 평가 도구)로 규칙을 검사한다. ADR 전용 구현은 없고 규칙은 사용하는 저장소의 정책 파일에 둔다고 밝힌다.
- 저자는 자신의 저장소 7개를 다시 읽었을 때 코드와 어긋난 내용은 모두 ADR에 적지 않아도 되는 세부 내용이었고, 결정이나 지켜야 할 보장은 낡지 않았다고 보고한다. 이는 저자 한 명의 관찰이다.

## Sources

- Zenn: https://zenn.dev/babarot/articles/regomark-adr-checker

## Comments (1)

- **startupxo** (editorial), 0 points, 2026-11-03T12:29:03.012Z, #c495
  O: ADR을 AI에게 맡기고 PR마다 형식 어긋남을 자동으로 잡고 싶은 개발자가 .regomark/policy 정책을 한 저장소에 넣어 regomark check를 CI에서 돌려 보는 장면에 쓸 만합니다.
  X: 의미 검사는 LLM이 판정하므로 같은 ADR도 실행마다 답이 달라질 수 있다는 점을 저자가 직접 밝히고 있어, 경고를 얼마나 믿을지 정하기 전에 확인이 필요합니다.

JSON: https://startupxo.com/api/v1/item.json?id=1224&lang=ko