하네스 엔지니어링

습관은 당신이 기억해서 해야 하는 일이다. 작업 공간을 갖추는 다음 단계는 그 점검들을 AI가 건너뛸 수 없게 만드는 것이다. 그게 하네스다.

하네스를 에이전트와 실제 세계 사이에 놓인 보안 검색대라고 생각하라. 위험한 단계마다 셋 중 하나를 한다: 무슨 일이 있었는지 기록하거나, 경고하거나, 그 행동을 아예 차단한다. 명령이 실행되기 전, 파일이 쓰이기 전, 프롬프트가 제출될 때, 커밋할 때, 푸시할 때 — 게이트가 있다. 새벽 2시에 테스트 돌리는 걸 깜빡할 수 있는 당신과 달리, 에이전트는 그것을 우회할 수 없다.

왜 필수일까? 바이브 코딩의 핵심 베팅은 "AI는 질주하게 두고, 당신은 조종하라"는 것이다. 그건 당신이 눈 깜빡하는 사이에 AI가 절벽으로 달려가지 못할 때에만 통한다. 하네스는 안전을 경계심(모든 디프를 읽고, 모든 규칙을 기억하는 것)에서 코드(자동으로 강제되는 규칙)로 옮긴다. 진짜 사용자 앞에 내놓을 무언가라면, 그건 선택적 마감이 아니다 — 자율성을 안전하게 만드는 바로 그것이다.

좋은 하네스는 알아둘 만한 몇 가지 원칙을 따른다:

• 성공은 조용히, 실패는 시끄럽게 — 괜찮을 때는 아무 말도 안 하므로, 경고에 의미가 남는다.
• 절대 자동 수정하지 않는다 — 제안하거나, 차단하거나, 경고한다; 에이전트를 몰래 "고쳐서" 문제를 숨기지 않는다.
• 새 규칙을 더하기 전에 잠든 규칙을 폐기한다 — 군더더기 없이 신뢰받는 상태를 유지하고, 낡은 점검의 더미가 되지 않게 한다.
• 설정 주도 — 엔진은 하나, 프로젝트별 설정으로, 어느 저장소에든 끼워 넣을 수 있다.
• 추가 전용(append-only) 로그 — 에이전트가 실제로 한 일의 변조-방지 기록.

이걸 처음부터 만들 필요는 없다. 기성품으로 끼워 넣을 수 있는 하네스가 있다 — dancinlab/harness는 코딩 에이전트의 도구 수명 주기에 연결할 수 있는 프로젝트 비종속 엔진 하나다. 솔직히 말하자면: 하네스가 AI를 옳게 만들어주지는 않는다. AI의 실수를 값싸게 잡아내게 해줄 뿐이다 — 빠르게 움직일 때 그것이 싸움의 대부분이다.