{"id":1224,"kind":"story","title":"AI가 쓴 설계 기록의 형식과 내용을 regomark로 검사하는 방법","url":"https://zenn.dev/babarot/articles/regomark-adr-checker","host":"zenn.dev","by":"startupxo","score":0,"comments":1,"editorial_comments":1,"time":"2026-11-03T12:29:03.012Z","origin":"curated","language":{"source":"ko","reading":"ko","translated":false},"summary":["ADR은 설계 결정을 남기는 문서다. 저자는 AI에게 맡긴 ADR이 시간이 지나며 절 구조가 어긋나거나, 결정문 안에 화면 메뉴 목록과 상수 같은 코드 세부 내용이 섞이는 일이 생겼다고 적는다.","저자는 절 순서, Status 값, ADR 간 참조, 링크 파일 존재처럼 기계로 확인할 수 있는 구조 규칙은 정책 파일로 검사해 위반 시 CI를 실패시키고, 명세서처럼 쓰였는지 같은 의미 규칙은 LLM에게 판정시켜 PR에 주의로만 남기는 방식을 제안한다.","regomark는 저자가 만든 명령줄 도구로, Markdown을 분석해 OPA(정책 평가 도구)로 규칙을 검사한다. ADR 전용 구현은 없고 규칙은 사용하는 저장소의 정책 파일에 둔다고 밝힌다.","저자는 자신의 저장소 7개를 다시 읽었을 때 코드와 어긋난 내용은 모두 ADR에 적지 않아도 되는 세부 내용이었고, 결정이나 지켜야 할 보장은 낡지 않았다고 보고한다. 이는 저자 한 명의 관찰이다."],"discussion":"https://startupxo.com/ko/1224/","markdown":"https://startupxo.com/ko/1224.md","api":"https://startupxo.com/api/v1/item.json?id=1224&lang=ko","text":null,"edited":null,"sources":[{"site":"rss","name":"Zenn","url":"https://zenn.dev/babarot/articles/regomark-adr-checker","score":null,"comments":null,"observed_at":"2026-11-03T12:28:32Z"}],"thread":[{"id":495,"by":"startupxo","score":0,"time":"2026-11-03T12:29:03.012Z","text":"O: ADR을 AI에게 맡기고 PR마다 형식 어긋남을 자동으로 잡고 싶은 개발자가 .regomark/policy 정책을 한 저장소에 넣어 regomark check를 CI에서 돌려 보는 장면에 쓸 만합니다.\nX: 의미 검사는 LLM이 판정하므로 같은 ADR도 실행마다 답이 달라질 수 있다는 점을 저자가 직접 밝히고 있어, 경고를 얼마나 믿을지 정하기 전에 확인이 필요합니다.","editorial":true,"replies":[]}]}