한 줄 정의
AI 코딩 에이전트가 반복적으로 범하는 실수를 모델 바깥의 제어 환경(규칙, 테스트, 가이드라인)을 수정하여 원천 봉쇄하는 엔지니어링 방법론입니다.
핵심 요지
- 반복은 신호다: AI의 실수를 단순히 수정하는 데 그치지 않고, 그 실수를 발생하게 한 환경적 요인을 찾아 하네스에 반영합니다.
- 울타리 설계: 모델 자체를 재학습시키는 것이 아니라, 모델이 작업을 수행하는 ‘울타리(제약 조건, 지침)‘를 강화합니다.
- 수동 작업에서 시스템 구축으로: 한 번 수정하는 5분 대신, 영구적인 수정으로 수 시간의 중복 작업을 제거합니다.
상세
raw/하네스 엔지니어링. 다음 모델보다 더 중요한 조용한 코딩 스킬.md에서 제시하는 실천 방안은 다음과 같습니다.
- instructions 강화: 반복되는 라이브러리 사용 오류, 이름 규칙 위반 등은 즉시 프로젝트
instructions파일에 반영합니다. - 센서(Sensor) 장착: 테스트 코드, 린터 등 AI 산출물을 자동으로 감시하고 문제를 즉시 표면화하는 검증 루프를 구축합니다.
- 이유 기록: 단순히 “수정함”이 아니라 “왜 수정했는지(추론 과정)“를 기록하여 에이전트가 향후 동일한 설계 고려사항을 파악하게 합니다.
핵심 통찰
가장 강력한 엔지니어링은 복잡한 AI 에이전트 워크플로우를 새로 짜는 것이 아니라, 매주 금요일에 5분간 지난주 에이전트의 실패 패턴 하나를 영구적으로 제거하는 시스템적 개선입니다.