2026 Agent Harness 해부: 모델이 실제 일을 하려면 왜 하네스가 필요한가
대상은 모델에게 저장소 수정, 브라우저 점검, 테스트 실행, 운영 티켓 정리를 맡기려는 플랫폼 팀입니다. 결론은 간단합니다. 모델은 추론 코어이고, Agent Harness는 행동을 실행하는 시스템입니다. 아래에는 매트릭스, 6단계, 임대 경로가 있습니다.
01모델만으로 실제 업무가 멈추는 3가지 이유
채팅 모델은 마이그레이션 계획을 잘 씁니다. 그러나 파일을 열고, 셸을 실행하고, 실패 로그를 보존하고, 승인 뒤 배포하는 일은 별도 실행층이 필요합니다.
🧠 상태 부재
긴 작업은 diff, 로그, 스크린샷, 재시도 기록을 남겨야 다음 실행이 안전합니다.
🔐 권한 경계 부재
파일 수정, 네트워크, 인증서, 결제 동작은 최소 권한과 승인 게이트로 나눠야 합니다.
🖥️ 런타임 부재
Safari, Xcode, iOS Simulator, Keychain은 실제 macOS 호스트 없이는 재현성이 낮습니다.
02Agent Harness 결정 매트릭스
| 계층 | 최소 설계 | 원격 Mac이 필요한 순간 |
|---|---|---|
| 도구 실행 | 파일 편집, 셸, 브라우저, 산출물 업로드 | Safari, Xcode, Keychain, iOS Simulator |
| 상태와 관측성 | 계획, diff, 명령 출력, 테스트 리포트 | 여러 시간 빌드와 WebKit 회귀 분석 |
| 안전 제어 | 읽기, 수정, 실행, 릴리스 4단계 권한 | 서명 키, 고객 데이터, 운영 배포 |
판단 규칙: 글만 쓰면 채팅으로 충분합니다. 코드 변경, 테스트, 브라우저, 서명이 들어가면 하네스와 실제 호스트를 예산에 넣으세요.
036단계: 프롬프트에서 작업 에이전트까지
- 업무 경계 정의: 코드 수정, 테스트, 브라우저 점검, PR 초안 중 허용 범위를 정합니다.
- 위험별 도구 매핑: 검색, 편집, 셸, 브라우저, 네트워크를 단계적으로 엽니다.
- MacWww 노드 선택: Safari·Xcode가 필요하면 요금에서 Mac Mini M4를 고릅니다.
- 증거 저장: 터미널 출력, 스크린샷, 테스트 리포트, 승인 내역을 보존합니다.
- 최종 게이트: 커밋, 배포, 인증서 변경 전 테스트와 사람 승인을 요구합니다.
- 성과 측정: 완료율, 재시도 수, 테스트 통과율, 리뷰 시간을 주간으로 봅니다.
04검토 회의에 바로 쓰는 인용 수치
최소 4단계: 읽기 전용, 수정, 실행, 릴리스. 단계마다 로그와 승인 규칙을 다르게 둡니다.
프로덕션 에이전트는 명령 로그와 산출물을 30일 이상 보관해야 원인 분석이 가능합니다.
Xcode와 브라우저 자동화를 함께 쓰면 24GB 통합 메모리, SSD 25% 여유를 시작 기준으로 잡으세요.
05정리: 하네스가 있어야 AI가 운영이 됩니다
구성 요소는 모델, 도구, 상태, 권한, 런타임, 증거입니다. 하나라도 빠지면 조언에 머물고, 모두 맞으면 에이전트는 저장소를 고치고 Safari를 열고 실패 증거를 남긴 뒤 승인 요청까지 이어갑니다.
macOS 작업 로드맵이 있다면 로컬 장비를 기다리지 마세요. MacWww 홈에서 노드를 확인하고, 콘솔에서 프로비저닝한 뒤, 도움말의 SSH/VNC 절차로 하네스 실험을 시작하세요. 관련 글은 OpenClaw 체크리스트와 iOS 임대 가이드입니다.
에이전트에게 실제 Mac 런타임을 주세요
MacWww Mac Mini M4 노드를 임대해 SSH 도구, VNC 디버그, Safari 검사, Xcode 빌드를 한 하네스 안에서 검증하세요.