AI 에이전트 작업 계약: 범위·검증·인계 정하기
AI 에이전트에게 일을 맡길 때 목표와 허용 범위, 검증 방법, 인계 내용을 어떻게 적을지 가이드에서 정리한 기준을 바탕으로 살펴본다.

AI 에이전트에게 “버그를 고쳐줘”라고만 요청하면 수정할 파일, 완료를 확인할 방법, 외부 변경의 승인 지점이 비어 있다. 일을 맡기기 전에는 요청 문장을 늘리기보다 목표와 허용 범위, 검증과 인계 조건을 먼저 적는 편이 판단하기 쉽다.
『Codex로 일하는 법』은 이런 요청을 작업 계약으로 다루며 목표·문맥·제약·완료 조건을 밝히고 필요에 따라 검증과 대상 파일을 덧붙이도록 설명한다. 이 글은 그 가이드를 참고한 노트와 『Claude Code and Cowork Master Guide』의 요약을 바탕으로, 위임할 때 확인할 질문을 재구성했다. 후자의 요약도 프롬프트 표현에 앞서 파일·권한·검증·인계 조건을 살펴보도록 권한다.
왜 프롬프트보다 계약이 먼저인가
“이 버그를 고쳐줘”에는 끝을 판정할 조건이 없다. 반면 허용할 파일을 지정하고, 관련 테스트 결과와 변경 내역을 제출하며, 배포는 승인 전까지 하지 말라고 적으면 작업과 검토의 경계가 드러난다. 이는 요청을 읽기 좋게 꾸미는 문제가 아니라 사람에게 남길 결정과 에이전트에게 맡길 행동을 구분하는 문제다.
이 블로그를 만드는 저장소의 작업 규칙도 위임받은 작업에서 브리프의 목표·제약·소유권을 확인하고 결과·실행 증거·남은 문제를 넘기도록 정한다. 이는 저장소에 적힌 규칙이며, 그 규칙이 모든 작업에서 실행됐다는 뜻은 아니다.
작업 계약에 적을 항목
『Codex로 일하는 법』을 참고해 여러 가이드를 정리한 노트는 목표·문맥·범위·제약·검증·산출·인계를 구분한다. 아래 표는 이 글의 편집상 묶음이다. 결과물과 다음 작업자에게 넘길 내용을 함께 확인하도록 산출과 인계를 한 칸으로 합쳤다. 가이드의 표나 예시를 옮긴 것은 아니다.
| 항목 | 계약에 답할 질문 | 적을 내용 |
|---|---|---|
| 목표 | 완료 뒤 무엇을 확인할 것인가? | 제출할 변경물과 완료 판단 기준 |
| 문맥 | 판단할 때 우선할 자료는 무엇인가? | 현재 지시, 원자료, 코드 또는 오류 기록의 위치 |
| 범위 | 어디를 읽고 어디를 바꿀 수 있는가? | 허용 대상과 제외 대상을 각각 명시 |
| 제약 | 어떤 행동에 별도 승인이 필요한가? | 비밀정보, 외부 변경, 파괴적 작업에 관한 제한 |
| 검증 | 결과를 무엇과 대조할 것인가? | 실행할 검사와 확인할 변경 내역 |
| 산출·인계 | 검토자에게 무엇을 넘길 것인가? | 변경 이유, 실제 검증 결과, 미확인 사항과 재개 지점 |
새 대화를 시작할 때 앞선 대화만을 인계 수단으로 가정해서는 안 된다. Claude Code의 메모리 문서(2026-09-28 조회)에 따르면 CLAUDE.md 파일과 자동 메모리는 대화 시작 시 문맥으로 불러온다. 이 문서는 둘을 강제 설정이 아닌 문맥으로 설명한다. 따라서 지속해서 필요한 프로젝트 정보와 이번 작업의 결과·미확인 사항을 구분해 남기는 것이 계약의 인계 항목이다.
위임 수준부터 정한다
『Codex로 일하는 법』을 참고한 노트는 위임을 질문 답변·로컬 편집·외부 상태 변경·반복 운영으로 나눈다. 이는 어떤 행동을 허용할지 구별하기 위한 분류이며, 뒤의 유형일수록 되돌리는 비용이 크다는 순위는 아니다.
- 질문 답변: 수정 없이 설명을 요청한다. 기준 자료와 불확실한 부분을 답변에서 구분하도록 적는다.
- 로컬 편집: 저장소나 컴퓨터의 파일 변경을 허용한다. 수정 범위와 확인할 테스트·변경 내역을 정한다.
- 외부 상태 변경: 배포·결제·계정 권한·운영 데이터처럼 외부 상태에 영향을 주는 작업이다. 실행 전 사람의 승인 지점과 되돌릴 방법을 정한다.
- 반복 운영: 되풀이할 작업의 조건을 프로젝트 규칙, 절차 문서, 템플릿 또는 점검 체계에 기록한다.
한 요청에 로컬 편집과 배포가 함께 들어 있다면 두 행동의 경계를 따로 적는다. 예를 들어 수정과 검증 결과 제출까지 허용하고 실제 배포는 사람의 승인을 기다리게 할 수 있다.
먼저 닫아야 할 금지선
『Codex로 일하는 법』 등을 참고해 작성된 노트는 아래 영역을 작업 범위와 권한을 정할 때 먼저 확인하도록 분류한다. 이는 사고가 있었다는 기록이 아니라 위임 전에 살필 항목이다.
- 비밀번호·토큰·개인키·로그인된 세션에 대한 접근
- 운영 배포·데이터베이스 변경·결제·도메인과 DNS 설정
- 파일이나 저장소 이력을 되돌리기 어렵게 만드는 명령
- 동작을 확인할 장치 없이 진행하는 넓은 범위의 코드 재구성
- 원문 전체 복사처럼 저작권 경계를 확인해야 하는 작업
금지 항목은 계약에 적되, 기술적으로 막아야 하는 행동은 도구의 권한 설정에도 반영해야 한다. Claude Code 메모리 문서(2026-09-28 조회)는 지시 파일을 강제 설정으로 취급하지 않으며, 모델의 판단과 무관한 차단에는 PreToolUse 훅을 안내한다. Claude Code 권한 문서(2026-09-19 조회)는 거부 규칙이 일치하는 도구 호출을 막는다고 설명한다. 이 설명은 Claude Code의 동작에 관한 것이며 모든 에이전트의 공통 보장을 뜻하지 않는다.
시작 전 체크리스트
아래 질문은 이 글의 작업 전 점검 제안이다. 답을 정할 수 없는 항목은 작업을 시작하기 전에 사람에게 남길 판단인지 확인한다.
- ☐ 제출할 결과와 완료 판단 기준을 적었는가?
- ☐ 우선할 원자료와 최신 지시의 위치를 밝혔는가?
- ☐ 읽기·수정이 허용된 대상과 제외 대상을 구분했는가?
- ☐ 비밀정보와 외부 변경에 관한 제한을 정했는가?
- ☐ 실행할 검사와 제출할 증거를 적었는가?
- ☐ 외부 상태를 바꾼다면 승인 지점과 되돌릴 방법을 정했는가?
- ☐ 다음 작업자에게 넘길 결과와 미확인 사항을 정했는가?
계약에 독립적인 코드 검토를 포함하려면 검토 대상과 확인할 질문도 명시한다. 관련 절차는 한 모델만 믿지 말고 AI 코드 교차 검증하는 법에서 다룬다.
반복되는 일은 계약을 문서로 승격한다
반복할 작업이라면 대화에만 조건을 남기지 말고 프로젝트 규칙이나 절차 문서로 옮길 수 있다. 『Codex로 일하는 법』을 참고한 노트도 반복 작업의 경계와 검증 방법을 지속적인 문서나 템플릿에 담는 방식을 제시한다. 특정 반복 횟수만으로 운영 방식이 자동으로 바뀌는 것은 아니다.
AGENTS.md 형식을 소개하는 사이트(2026-09-28 조회)는 이를 코딩 에이전트에 필요한 지침을 두는 예측 가능한 위치, 곧 에이전트용 README로 설명한다. 어떤 도구가 그 파일을 언제 읽는지는 해당 도구의 설정과 문서에 따라 별도로 확인해야 한다.
필자가 쓰는 노트 저장소의 규칙은 원자료를 원문 창고에 두고 반복해 판단할 결론만 정리 문서로 올리도록 정한다. 이 사례는 문서의 역할을 구분하는 예이며, 작업 속도나 품질의 개선을 측정한 결과는 아니다.
작업 계약을 실행 가능한 문장으로 바꾸기
아래는 특정 작업의 수행 기록이 아닌, 로컬 코드 수정 요청을 위한 가상 문장 예시다. 실제 요청에서는 허용 파일과 재현 방법을 확인한 뒤 빈칸을 채워야 한다.
목표: 보고된 오류를 수정하고 재현 조건에서 결과를 확인한다.
문맥: 현재 이슈 설명, 실패 기록, 저장소 코드를 기준으로 삼는다.
범위: 지정한 파일만 수정하고 제외한 위치는 변경하지 않는다.
제약: 비밀정보를 출력하지 않으며 배포와 권한 변경은 수행하지 않는다.
검증: 재현 검사와 관련 검사를 실행하고 변경 파일을 범위와 대조한다.
산출·인계: 수정 이유, 실제 검사 결과, 확인하지 못한 사항을 남긴다.
실행 전에는 각 문장이 허용 행동을 구분하거나 완료 여부를 확인하는 데 쓰이는지 점검한다. “최소 변경”처럼 해석이 갈리는 표현에는 수정 대상과 제외 대상을 붙이고, “테스트한다”에는 확인할 검사와 결과 보고 방식을 붙인다.
완료 뒤 대조할 것
작업 뒤에는 계약과 실제 변경을 대조한다. 검사가 실패했다면 그 결과와 남은 문제를 인계하고, 허용 범위 밖 변경이 있다면 승인 없이 완료로 처리하지 않는다. 이는 검증을 했다는 주장 대신 검토자가 확인할 수 있는 결과를 남기기 위한 절차다.
자주 묻는 질문
요청을 자세히 쓰면 작업 계약을 따로 적지 않아도 되는가?
형식은 별도 문서일 필요가 없다. 같은 요청 안에서 목표, 기준 자료, 허용 범위, 제약, 검증 방법과 인계 내용을 분명히 구분하면 된다.
로컬 파일을 고치게 할 때 무엇을 먼저 정해야 하는가?
수정해도 되는 파일과 제외할 파일을 정하고, 결과를 확인할 검사와 변경 내역을 함께 요구한다.
배포나 결제를 맡길 때 무엇이 추가되는가?
실제 외부 상태를 바꾸기 전 사람의 승인 지점과 문제가 생겼을 때 되돌릴 방법을 정한다. 승인 전 준비 작업과 승인 후 실행을 구분한다.
반복하는 작업의 계약은 어디에 두는가?
이 글은 반복할 조건을 프로젝트 규칙이나 절차 문서에 기록할 것을 제안한다. 어떤 문서를 쓸지는 도구가 그 문서를 읽는 방식과 팀의 관리 방법을 확인해 정한다.
아직 댓글이 없습니다.