에이전트 하네스 설계: 오래 실행되는 AI 개발 작업 관리하기

장기 작업에는 모델 바깥의 구조가 필요합니다

Anthropic은 2026년 3월 장기 애플리케이션 개발 실험에서 작업 분할, 세션 사이의 정보 전달과 평가 역할을 설명했습니다. 하네스는 이런 실행 과정을 감싸는 구조를 뜻합니다. 업무를 받아 모델을 호출하고, 도구 결과와 진행 상태를 보관하며, 다음 행동과 종료 여부를 관리합니다.

대시보드 전체를 만드는 작업을 생각해 보세요. 화면은 생성했지만 인증이 연결되지 않았거나, 새 세션에서 이미 만든 기능을 다시 구현할 수 있습니다. 이런 문제는 요청 문장 하나를 다듬는 것만으로 해결하기 어렵습니다. 완료한 작업과 검증 근거를 다음 실행에서도 확인할 수 있어야 합니다.

완료 표시에는 결과물과 검증을 연결합니다

구현·평가·수정의 반복을 제한합니다

평가 단계에서는 사용자가 기대한 흐름을 실행해 보고 결과를 남깁니다. 모델이 작성한 설명만 평가하는 경우와 실제 브라우저에서 저장·조회·오류 처리를 확인하는 경우는 다릅니다. 요구사항에 맞는 검증을 선택하고, 수정 뒤에는 영향을 받은 기존 기능도 다시 확인하세요.

반복 횟수나 예산을 정하지 않으면 같은 오류를 고치며 비용을 계속 쓸 수 있습니다. 같은 실패가 반복되거나 새로운 근거 없이 접근만 바꾸는 경우에는 작업을 멈추고 원인과 필요한 결정을 기록하게 하세요. 정해진 횟수에 도달했다는 이유로 미완성 결과를 완료로 표시해서는 안 됩니다.

재개 시에는 저장된 상태와 실제 환경을 대조합니다

작업 기록에 테스트 통과라고 적혀 있어도 이후 커밋에서 코드가 바뀌었을 수 있습니다. 재개 시 기준 커밋, 설치 버전과 파일 변경을 확인하세요. 검증 결과가 어떤 상태에서 나온 것인지 연결하면 오래된 성공 기록을 현재 결과로 오해하는 일을 줄일 수 있습니다.

작게 검증하려면 한 화면의 조회·수정 기능을 맡긴 뒤 구현 중간에 실행을 중단해 보세요. 새 실행이 기존 산출물을 확인하고 남은 검수부터 이어 가는지 살펴봅니다. 파일이 존재한다는 이유만으로 완료 처리하거나 같은 기능을 다른 위치에 다시 만들면 재개 절차를 보완해야 합니다.

하네스 검토 체크리스트

• 세션이 끝나도 목표와 미완료 항목을 복원할 수 있는가
• 검증 결과가 특정 코드 상태와 연결되어 있는가
• 작업 실패와 도구·환경 장애를 구분하는가
• 재시도와 실행 비용에 상한이 있는가
• 사람이 중단하고 산출물을 인수할 수 있는가