AI가 쓴 설계 기록의 형식과 내용을 regomark로 검사하는 방법(zenn.dev)

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