AI 에이전트 활용과 하네스 설계

대화형 AI 와 에이전트의 차이, 생각→도구 호출→관찰→반복 루프, 정해진 순서로 충분한 일은 에이전트 대신 고정 절차로, 사람의 승인 지점, 최대 반복 수와 멈춤 조건, 완성 코드는 가짜 모델과 계산기·메모 도구로 루프를 구현해 단계별 기록을 출력한다

도구 정의(이름·설명·입력 형식·출력), 기능이 겹치지 않게 나누기, 읽기·쓰기·삭제 권한 분리, 위험한 동작은 확인 받기, 도구 오류를 모델이 이해할 수 있게 돌려주기, 완성 코드는 도구 등록부와 권한 검사기를 만들고 허용·거부 사례를 출력한다

목표를 작업 목록으로 쪼개기, 작업마다 완료 확인 방법 붙이기, 진행 상태를 파일에 기록해 중단 후 재시작, 계획을 실행 중 고치는 경우, 완성 코드는 작업 목록 JSON 을 읽어 순서대로 실행하고 중간에 멈췄다가 상태 파일로 이어서 끝내는 과정을 출력한다

맥락은 한정된 예산이라는 관점, 필요한 정보만 고르기, 긴 기록을 요약으로 압축, 맥락 밖 메모 파일에 적고 필요할 때 읽기, 하위 작업을 따로 돌려 요약만 받기(격리), 대표 예시 몇 개가 긴 규칙 목록보다 나은 이유, 완성 코드는 글자 수 예산을 둔 맥락 조립기를 만들고 네 기법을 적용한 전후 크기를 출력한다

명세를 기준 문서로 두고 계획·작업·구현이 거기서 나오게 하기, 모호한 곳을 먼저 질문하는 단계, 산출물끼리 일관성 검사(명세의 요구가 작업 목록에 모두 있나), 프로젝트 원칙 문서, 새 프로젝트와 기존 코드 모두에 적용, 완성 코드는 명세 텍스트에서 요구 목록을 뽑아 작업 목록과 대조해 빠진 요구를 보고한다

완료 기준을 실행 가능한 검사로 바꾸기, 실패하면 되돌리고 다시 시도, 같은 실패 반복 시 멈추고 사람에게 넘기기, 실행 성공과 요구 충족을 따로 확인, 검사를 고쳐서 통과시키는 일 막기, 완성 코드는 가짜 모델이 낸 수정안을 테스트로 검사해 채택·되돌림 기록을 출력한다

도구를 앱마다 따로 붙이지 않고 표준으로 연결하는 이유, 서버·클라이언트·도구·자원·프롬프트 개념, 메시지 주고받기 흐름, 외부 시스템 연결 시 권한 범위와 신뢰, 에이전트끼리 연결하는 표준도 있다는 점(개념만), 완성 코드는 JSON 메시지로 도구 목록 조회·호출을 주고받는 작은 서버·클라이언트를 한 프로세스 안에서 흉내 낸다

늘 지킬 규칙(지침 파일)과 필요할 때만 꺼내는 절차(스킬·명령 파일)의 구분, 절차를 설명·단계·확인으로 쓰기, 필요한 절차만 맥락에 불러오기, 팀 지침·코드 리뷰 기준·생성 코드 표시·운영 승인 절차, 완성 코드는 절차 파일 묶음을 읽어 작업 설명과 맞는 절차만 골라 불러오는 로더를 만든다

역할 분리(작성·검토·조율), 검토자가 작성자와 다른 기준을 갖게 하기, 병렬이 빨라지는 경우와 비용·충돌만 늘어나는 경우, 같은 파일을 동시에 고치지 않게 나누기, 결과 합치기, 완성 코드는 가짜 작성자·검토자 에이전트가 주고받으며 수정안을 확정하고 호출 횟수를 함께 출력한다

외부 문서·웹 페이지 속 지시문, 데이터와 명령의 구분, 최소 권한과 허용 목록, 비밀값 노출 경로, 존재하지 않는 패키지 설치를 막는 확인 절차, 되돌릴 수 없는 동작의 승인, 완성 코드는 지시문이 숨은 문서를 읽는 에이전트에 방어 규칙을 넣기 전후의 행동 차이를 출력한다

평가 세트 만들기(입력·기대 결과·채점 기준), 자동 채점과 사람 평가 섞기, 단계별 실행 기록(추적)으로 실패 원인 찾기, 지침·도구를 바꾼 뒤 회귀 확인, 정해진 일정·이벤트로 돌릴 때의 비용 한도와 실패 알림, 완성 코드는 두 버전의 하네스를 같은 평가 세트로 돌려 점수와 실패 사례를 비교 출력한다

앞 장의 루프·도구 권한·계획·맥락·명세·검증·절차 파일·보안·평가를 묶어 여러 문서를 읽고 요약 보고서를 만드는 하네스를 완성한다. 쓰기 작업 전 사람 승인 관문, 비용 한도, 실행 기록과 평가 결과를 함께 남긴다