하네스 엔지니어링
AI가 일할 환경과 통제 장치를 설계하는 일
핵심 아이디어
이 글에서 하네스 엔지니어링은 AI 에이전트 하네스 엔지니어링을 뜻합니다. AI 에이전트가 목표에 맞게 작업하도록 지침과 도구를 연결하고, 권한·승인·변경 기록·검증·복구·운영 관찰 절차를 설계하고 개선하는 활동입니다. 아직 업계 전반에서 경계가 고정된 표준 분야명은 아니며 컨텍스트 엔지니어링, 에이전트 오케스트레이션, 플랫폼 엔지니어링, AI 보안과 겹칩니다.
쉽게 말하면
AI에게 “조심해서 만들어 줘”라고 말하는 데서 끝내지 않고 실제 작업 환경에도 안전장치를 두는 일입니다. 읽어야 할 기준 문서, 수정할 수 있는 파일 범위, 실행 전 승인이 필요한 작업, 변경을 확인하고 되돌리는 방법을 준비합니다.
구성 요소
- 지침: 역할, 목표, 금지 사항, 완료 기준을 프로젝트 루트의
AGENTS.md나 도구별 지침 파일에 기록합니다. - 도구: 파일 읽기·수정, 명령 실행, 브라우저 확인처럼 작업에 필요한 기능을 연결합니다.
- 권한과 승인: 삭제, 외부 공개, 결제, 데이터 변경처럼 위험한 행동을 구분합니다.
- 기록과 복구: 별도 작업 공간과 Git 등으로 기록된 상태의 기준점을 남깁니다. 외부 전송, 결제, API 호출, 배포, 데이터베이스 변경이나 비밀정보 노출은 별도 예방책과 보상 절차가 필요하며 되돌릴 수 없을 수도 있습니다.
- 검증과 피드백: 완료 기준에 맞춰 테스트, 정적 분석, 정책 검사, 로그·상태 확인이나 사람 검토를 수행하고, 실패하면 재시도·중단·사람에게 이관합니다.
- 협업과 관찰: 여러 에이전트의 담당과 전달 형식을 정하고, 실행 과정과 비용·오류를 관찰할 수 있게 합니다.
하네스 도구·지침 파일과의 관계
하네스 도구는 실행 환경을 제공하는 제품이나 구성 요소이고, 하네스 엔지니어링은 요구사항에 맞게 지침·도구·권한·검증·복구 체계를 설계하고 운영하는 활동입니다. AGENTS.md 같은 파일도 에이전트나 호스트가 실제로 찾아 읽고 적용할 때만 하네스의 일부가 됩니다. 문서에 “삭제하지 마세요”라고 적는 것만으로는 권한이 제한되지 않으므로 샌드박스, 실행 전 승인, 비밀정보 분리와 실제 결과 검증이 함께 작동해야 합니다.
멀티 에이전트와의 관계
하네스는 하나의 에이전트부터 필요합니다. 멀티 에이전트를 사용할 때는 작업 소유권, 공통 계획, 의존 순서, 결과 통합 기준까지 더해 조율의 기반이 됩니다.
실제 IT 용어와의 연결
관련 용어로 agent harness, sandbox, access control, approval gate, audit log, version control, verification loop, orchestration이 있습니다. 컨텍스트 엔지니어링이 어떤 정보를 제공할지 다룬다면, 하네스 엔지니어링은 정보·도구·권한·피드백이 작동하는 전체 환경을 다룹니다.
이 블로그에서의 역할
이 시리즈의 프로젝트 폴더, AGENTS.md, 설계 문서, OpenCode의 실행 권한, Git 기록, 브라우저와 출력물 확인 절차가 함께 작은 하네스를 이룹니다.