2장 해설
1. 네 역할 대응
- 모델: 다음 행동 후보를 생성하는 추론 엔진
- 에이전트: 관찰·선택·도구·확인을 반복하는 작업자
- 하니스: 작업 봉투, 권한, 예산, 게이트, 이벤트를 제공하는 실행 환경
- 오케스트레이터: 여러 작업의 준비·배치·재시도·통합을 조정하는 제어면
제품 하나가 여러 역할을 구현해도 개념은 분리합니다.
2. 테스트 삭제 삼중 방어
- 입력 계약: 구현 task의
allowedPaths에서 핵심 회귀 테스트/게이트 설정 제외 - 도구 권한: 보호 경로 쓰기 거부
- 게이트: 기준선 대비 테스트 삭제·skip 증가·테스트 0개 검출
독립 리뷰는 테스트가 명세 의미를 약화했는지도 확인합니다.
3. 타임아웃 재시도
같은 ID와 공간을 쓰면 첫 실행의 부작용과 늦은 결과가 섞입니다. 새 runId, 새 임대, 새 공간을 만들고 parentRunId, 입력 해시, 오류 분류를 연결합니다. 일시 오류만 제한적으로 재시도하고 이전 외부 효과를 먼저 조회합니다.
4. 최소 이벤트 필드
eventId, time/sequence, taskId, runId/attempt, type/status, tool/gate, reasonCode, artifact/hash 가운데 최소 여섯 개입니다. 원문보다 원인·대상·판정·증거를 복원할 수 있는지가 기준입니다.