코드가 바뀌면 문서 오류를 잡는 도구
코드 설명 문서가 실제 코드와 계속 맞는지 검사하는 도구가 공개됐다. 사용자는 인증 구조 문서, ADR, 서비스 설명 문서 같은 곳의 특정 주장들을 실제 코드 위치와 연결한다. 예를 들어 토큰을 새로 발급하는 함수나 인증 와 문서 내용을 묶어 둔다.
이후 해당 코드가 바뀌면 도구가 단순한 변경인지, 실제 동작 변경인지 나눠 본다. 주석 추가, 변수 이름 변경, 코드 정리 같은 변화는 통과한다. 비교 연산자가 바뀌거나, 기다림 처리가 추가 또는 제거되는 변화는 실패로 처리해 문서 확인을 요구한다.
이 방식은 모델, 임베딩, , 없이 정해진 규칙만으로 작동한다. 여러 개발자와 에이전트가 같은 에서 일할수록 오래된 문서가 잘못된 공유 문맥이 되는 문제를 줄이려는 목적이다.
핵심 포인트
- 문서의 특정 주장과 실제 코드 위치를 연결해 둔다.
- 코드가 바뀌면 문서가 여전히 맞는지 확인한다.
- 주석, 변수명, 형식 변경은 문제로 보지 않는다.
- 비교 조건 변경이나 기다림 처리 변경처럼 동작이 달라질 수 있는 변화는 실패로 잡는다.
- 모델, 임베딩, , 없이 작동한다.