HAR의 테스트 기록은 어느 버전의 변경을 뒷받침할까?
HAR는 AI가 작성한 코드 변경을 실제로 실행된 저장소 검사와 연결하는 데 유용하다. 도입 전에는 평소처럼 코드 리뷰를 해 보자. 이전 버전이 검사를 통과한 뒤 한 곳을 더 수정했다면, 리뷰어가 그 차이를 한눈에 알아볼 수 있을까?
프런트엔드 팀이 AI가 작성한 코드를 넘겨받을 때마다 “테스트는 모두 통과했습니다”라는 말을 듣지만 마지막 수정 전후 중 언제 돌린 테스트인지 알 수 없다면, 작은 변경 건으로 HAR를 시험해 볼 만하다. 중요한 것은 초록색 상태 표시가 하나 더 생기는 것이 아니라, 통과 기록을 현재 검토하는 버전과 연결할 수 있는지다.
os-factory/har 프로젝트 문서는 두 가지 기능을 구분한다. 코딩 에이전트마다 별도의 Git 워크트리를 할당해 서로 다른 변경이 같은 작업 디렉터리를 공유할 필요가 없게 한다. 또 저장소에 설정된 검사로 워크트리를 검증하고 테스트 로그, 결과물 또는 검증된 트리 해시를 기록한다. 트리 해시로 검사 대상이 된 코드 트리를 확인할 수는 있지만, 테스트가 빠짐없이 이루어졌다는 뜻은 아니다. Git 워크트리를 나눈다고 해서 시크릿, 네트워크 접근 또는 프로세스 권한까지 격리되는 것도 아니다.
가상의 설정 화면 변경을 검수 대상으로 삼아 보자. A 버전은 레이블만 바꾼 뒤 검사를 통과했다. B 버전은 그 뒤 좁은 화면에서의 레이아웃을 추가로 조정했다. 리뷰어는 우선 검사 근거가 A와 B 중 어느 쪽에 해당하는지 확인하고, 기존 테스트에 좁은 화면의 레이아웃도 포함되는지 살핀다. B가 자동 검사까지 통과했더라도 테스트에서 빠진 화면 너비의 분기점은 직접 확인해야 한다. 기록으로 버전을 가를 수 없거나 어떤 검사를 실행했는지 아무도 모른다면, 도구를 한 겹 더 얹어도 인계 단계의 모호함은 남는다.
기존 PR에서 커밋, 필수 CI 검사 기록, 수동 검수가 이미 명확히 연결되어 있다면 우선 그 절차를 유지하자. HAR는 PR을 거치지 않고 코드를 인계하거나, 여러 변경을 병렬로 진행해 검증 근거를 추적하기 어려운 팀에서 시험해 볼 가치가 더 크다. 워크트리는 변경이 서로 간섭하지 않게 하고 검사 기록은 해당 버전을 찾도록 돕는다. 그러나 변경을 머지할 수 있는지까지 도구가 팀 대신 결정하지는 않는다.
콘텐츠 안내:이 글은 공개 자료를 바탕으로 정리한 도구 선택 참고 자료입니다. 제품 기능, 가격 및 관련 정책은 수시로 변경될 수 있으니 최신 공식 정보를 확인해 주세요.
원문 출처:github.com