AI 에이전트에게 업무 맡기고 역할 나누기

작성자:

AI 에이전트는 목표를 받고 여러 단계를 스스로 계획하며 도구를 사용하는 실행 주체다. 이 문서에서는 한 에이전트에게 계획, 읽기, 쓰기 순서로 권한을 단계별로 열어 안전하게 업무를 맡기고 결과를 확인하는 법을 먼저 익히고, 이어서 조사·작성·검토를 서로 다른 역할과 파일로 나누어 결과 품질을 높이는 법까지 다룬다. 끝까지 따라 하면 원자료와 일치하는 새 파일과 역할별 산출물이 손에 남고, 반복 절차를 스킬로 묶어 다시 쓰는 경험까지 쌓인다.

[!INFO]
개발 환경과 코드 기초는 별도 교안에서 학습한다. 이 단원에서는 그 내용을 반복하지 않고, AI에게 작업을 안전하게 맡기고 결과를 확인하는 방법에 집중한다.

1 – 에이전트 작업 준비

에이전트는 목표를 받고 여러 단계를 계획하며 도구를 사용한다. 한 번에 모든 권한을 주지 않고 계획, 읽기, 쓰기 순서로 범위를 넓힌다.

1.1 – 연습 폴더 만들기

  1. "ai_prompt" 폴더에 "24_agent" 폴더를 만든다.
  2. 다음 파일을 만든다.
24_agent/
├── request.md
├── source.md
└── progress.md
  1. "source.md"에 다음 내용을 입력한다.
점검일: 2026-07-01
점검 기한: 전날 17:00까지
장소: 2층 실습실
확인 항목: 인터넷 연결, 크롬 실행, 빔프로젝터 연결
  1. "request.md"에 다음 목표를 입력한다.
source.md를 읽고 실습실 사전 점검 요청문 초안을 새 파일로 만든다.

2 – 계획만 받기

2.1 – 작업 범위 제시하기

  1. 파일 작업이 가능한 AI 에이전트를 연다.
  2. "24_agent" 폴더를 작업 폴더로 지정한다.
  3. 다음 요청문을 입력한다.

[!INFO]
일반 웹 AI가 폴더 지정과 파일 생성을 지원하지 않으면 source.md 내용을 대화창에 붙여 넣어 계획과 안내문을 받은 뒤 사람이 직접 새 파일로 저장한다. 파일 작업 기능이 있을 때만 폴더와 권한 단계를 실행한다.

목표:
"source.md"를 읽고 실습실 사전 점검 요청문 초안을 만든다.

허용:
- "24_agent" 폴더 안의 파일 읽기

금지:
- 파일 생성과 수정
- 명령 실행
- 인터넷 접속

지금은 실행하지 않는다.
작업 계획, 사용할 파일, 만들 파일 이름, 확인 방법만 제시한다.
  1. 계획이 다음 순서인지 확인한다.
    1. 자료 읽기
    2. 사실 추출
    3. 점검 요청문 작성
    4. 원자료 대조
    5. 새 파일 저장

3 – 읽기 결과 확인하기

3.1 – 사실만 추출하게 하기

  1. 읽기 권한만 허용한다.
  2. 다음 요청문을 입력한다.
"source.md"에서 점검일, 점검 기한, 장소, 확인 항목만 추출한다.
아직 파일을 만들지 않는다.
자료에 없는 값은 '없음'으로 표시한다.
  1. 네 항목을 원문과 대조한다.
  2. 다른 값이 있으면 쓰기 단계로 넘어가지 않는다.

4 – 새 파일 만들기

4.1 – 쓰기 범위 제한하기

  1. 다음 요청문을 입력한다.
확인한 사실만 사용해 안내문을 작성한다.
"24_agent/draft-notice.md"를 새로 만든다.
기존 파일은 수정하지 않는다.

구조:
# 실습실 사전 점검 요청
점검일
점검 기한
장소
확인 항목

저장 후 원자료와 다른 내용이 없는지 다시 확인한다.
  1. 파일 생성 요청이 표시되면 경로를 확인한다.
  2. "24_agent" 밖이면 승인하지 않는다.
  3. 생성된 파일을 직접 연다.
  4. 점검일, 점검 기한, 장소, 확인 항목을 대조한다.

[!WARNING]

  1. 기존 파일이 변경됐으면 작업을 중단하고 변경 전 사본과 비교한 뒤, 새 파일만 만들라는 규칙을 다시 지정한다. 필요하면 백업에서 복구한다.
  2. 자료에 없는 내용이 추가됐으면 그 문장을 삭제하고 "source.md에 직접 적힌 사실만 사용한다. 근거 줄을 표시할 수 없는 문장은 제거한다."라고 다시 요청한다.

5 – 진행 기록 남기기

5.1 – 작업 상태 작성하기

  1. "progress.md"에 다음 내용을 기록한다.
목표:
사용한 파일:
생성한 파일:
확인한 사실:
승인한 작업:
남은 문제:
  1. 에이전트가 작성한 설명을 그대로 복사하지 않는다.
  2. 실제 파일 상태를 확인한 뒤 기록한다.
  3. 생성한 파일 항목에는 4.1에서 만든 "24_agent/draft-notice.md"를 적는다.

6 – 반복 작업을 스킬로 만들기

에이전트 스킬은 특정 작업을 수행하는 절차, 기준, 예시를 다시 사용할 수 있게 묶은 지침이다. 단순한 프롬프트 한 줄보다 적용 조건과 작업 순서가 분명하고, 필요할 때 불러서 쓸 수 있다는 점이 다르다.

스킬은 Claude Code만의 개념이 아니다. Codex, Hermes Agent, Antigravity 등 여러 에이전트 환경에서 이름과 저장 위치는 달라도 재사용 지침 묶음이라는 원리는 같다.

6.1 – 문서 검수 스킬 만들기

  1. "24_agent"에 다음 폴더와 파일을 만든다.
24_agent/
└── skills/
    └── doc-check/
        └── SKILL.md
  1. "SKILL.md"에 다음 내용을 입력한다.
---
name: doc-check
description: 안내문과 보고서의 누락, 추가 사실, 개인정보를 검사할 때 사용한다.
---

# 문서 검수

1. 요청 조건과 원문을 먼저 읽는다.
2. 필수 항목의 누락을 찾는다.
3. 원문에 없는 날짜, 수치, 연락처를 찾는다.
4. 이름, 전화번호, 이메일, 주소가 있는지 확인한다.
5. 문제 위치, 원인, 수정문을 표로 작성한다.
6. 원문을 직접 고치기 전에 수정안을 제시한다.
  1. 다음 두 요청으로 적용 범위를 비교한다.
요청 1: 이 안내문의 날짜와 장소 누락을 확인한다.
요청 2: 이 사진의 배경색을 바꾼다.
  1. 요청 1에는 doc-check를 사용한다.
  2. 요청 2에는 문서 검수 절차가 맞지 않으므로 사용하지 않는다.

[!WARNING]

  1. 스킬이 맞지 않는 작업에 적용되면 description의 사용 조건이 모호한지 확인하고, 적용할 문서 종류와 제외할 작업을 구체적으로 적는다.
  2. 스킬 없이 처리한 결과와 비교하고, 다른 입력에서도 같은 절차가 필요한지 다시 시험한다.

6.2 – 스킬과 다른 구성요소 구분하기

프롬프트: 현재 작업에 주는 요청
스킬: 반복 작업에 다시 쓰는 전문 절차
도구: 검색, 파일 읽기, 저장처럼 실제 행동을 수행하는 기능
에이전트: 목표를 받고 절차와 도구를 골라 여러 단계를 수행하는 실행 주체
하네스: 지시, 권한, 검증, 기록이 함께 작동하는 작업 환경

[!NOTE]

  1. SKILL.md는 여러 에이전트 제품에서 쓰는 대표적인 파일 형식이다.
  2. 제품마다 폴더 위치, 메타데이터, 자동 선택 방식이 다르므로 설치 전 공식 문서를 확인한다.
  3. 스킬 설명에는 무엇을 하는지와 언제 사용하는지를 함께 적는다.
  4. 스킬이 도구 권한을 대신하지 않는다. 파일 수정과 외부 전송 권한은 별도로 제한한다.

7 – Claude Code를 사용할 때

7.1 – 개발·파일 작업 사례로 적용하기

  1. 프로젝트 폴더에서 Claude Code를 연다.
  2. 처음에는 계획 또는 읽기 전용으로 저장소 구조를 확인한다.
  3. 수정할 파일, 수정 범위, 실행할 검사를 먼저 받는다.
  4. 쓰기와 명령 실행은 계획을 확인한 뒤 승인한다.
  5. 프로젝트 지시 파일과 실제 검사 명령을 함께 제공한다.

[!WARNING]

  1. Claude Code는 이 교안의 필수 도구가 아니다.
  2. 파일과 명령을 다루는 에이전트 사례로 사용한다.
  3. 설치 명령과 권한 모드 이름은 사용 시점의 공식 문서에서 확인한다.

8 – 역할 분리 준비

한 대화에서 조사, 작성, 검토를 모두 하면 처음 만든 내용을 스스로 옹호하는 문제가 생길 수 있다. 역할과 입력 자료를 분리한다.

서브에이전트는 주 에이전트가 맡긴 일부 작업을 독립된 맥락과 도구 범위에서 수행하는 보조 에이전트이다. 단순히 한 대화에서 역할 문구만 바꾸는 것보다 입력, 결과, 권한을 분리하기 쉽다.

8.1 – 작업 폴더 만들기

  1. "ai_prompt" 폴더에 "25_roles" 폴더를 만든다.
  2. 다음 파일을 만든다.
25_roles/
├── request.md
├── research.md
├── draft.md
├── review.md
└── final.md
  1. "request.md"에 다음 내용을 입력한다.
주제: 교육 현장에서 생성형 AI를 안전하게 사용하는 방법
대상: 생성형 AI를 처음 사용하는 성인
결과: 700자 안팎의 안내문
필수: 개인정보, 사실 확인, 사람의 최종 검토
제외: 확인되지 않은 법률 해석과 특정 제품 홍보

9 – 조사 역할 실행하기

9.1 – 근거만 수집하기

  1. 새 대화에서 다음 요청문을 입력한다.
당신의 역할은 조사자이다.
안내문을 작성하지 않는다.

request.md의 주제에 필요한 근거를 수집한다.
공식 출처를 우선한다.

출력:
| 핵심 내용 | 근거 출처 | 게시일·수정일 | 확인한 문장 | 미확인 사항 |

해석과 권고를 추가하지 않는다.
  1. 제시된 링크를 직접 연다.
  2. 확인된 내용만 "research.md"에 저장한다.

[!WARNING]
조사자가 의견을 추가하면 의견 문장을 제거하고, 원문에서 직접 확인한 문장과 출처만 남긴다.

10 – 작성 역할 실행하기

10.1 – 조사 결과만 사용하기

  1. 조사 대화와 다른 새 대화를 시작한다.
  2. "request.md"와 "research.md"를 제공한다.
  3. 다음 요청문을 입력한다.
당신의 역할은 작성자이다.
request.md와 research.md에 있는 내용만 사용한다.

700자 안팎의 안내문을 작성한다.
제목과 세 개의 소제목을 사용한다.
확인되지 않은 내용은 넣지 않는다.
출처는 문서 끝에 정리한다.
  1. 결과를 "draft.md"에 저장한다.

11 – 검토 역할 실행하기

11.1 – 독립 기준으로 확인하기

  1. 세 번째 새 대화를 시작한다.
  2. "request.md", "research.md", "draft.md"를 제공한다.
  3. 다음 요청문을 입력한다.
당신의 역할은 검토자이다.
초안을 다시 작성하지 않는다.

아래 항목만 확인한다.
- request.md의 필수 내용 누락
- research.md에 없는 주장
- 출처와 맞지 않는 설명
- 개인정보를 입력하도록 오해할 표현
- 같은 내용의 반복
- 700자 안팎인지

출력:
| 위치 | 문제 | 근거 | 수정 방향 |

문제가 없으면 '문제 없음'으로 표시한다.
  1. 검토 결과를 "review.md"에 저장한다.
  2. 검토 지적을 원자료와 대조한다.

[!WARNING]
검토자가 새로운 내용을 만들면 조사 자료에 근거가 있는지 확인하고, 근거가 없으면 그 지적을 반영하지 않는다.

12 – 최종본 만들기

12.1 – 확인된 지적만 반영하기

  1. 작성 대화에서 "review.md"를 제공한다.
  2. 다음 요청문을 입력한다.
review.md에서 원자료로 확인된 지적만 반영한다.
request.md의 필수 조건과 research.md의 사실은 유지한다.
수정한 부분을 목록으로 먼저 제시하고 최종본을 작성한다.
  1. 최종본을 "final.md"에 저장한다.
  2. 초안과 최종본의 차이를 확인한다.

13 – 서브에이전트로 역할 실행하기

13.1 – 역할별 입력과 권한 정하기

서브에이전트를 지원하는 도구에서는 조사자, 작성자, 검토자를 별도 에이전트로 만들 수 있다. 지원하지 않는 도구에서는 서로 다른 대화와 파일로 같은 분리 원리를 적용한다.

  1. 다음 역할표를 작성한다.
역할 | 읽을 자료 | 사용할 도구 | 만들 결과 | 금지
조사 | request.md | 웹 검색·읽기 | research.md | 초안 작성
작성 | request.md, research.md | 파일 읽기 | draft.md | 새 사실 추가
검토 | request.md, research.md, draft.md | 파일 읽기 | review.md | 원문 직접 수정
  1. 주 에이전트가 각 결과를 받을 순서를 정한다.
조사 결과 확인
→ 작성자에게 전달
→ 초안 확인
→ 검토자에게 전달
→ 지적 근거 확인
→ 최종본 작성
  1. 세 역할을 동시에 실행할 수 있는지 판단한다.
    1. 서로의 결과가 필요한 조사→작성→검토는 순서대로 실행한다.
    2. 서로 다른 출처를 찾는 조사 역할 여러 개는 동시에 실행할 수 있다.
    3. 같은 파일을 여러 역할이 동시에 수정하지 않는다.

[!WARNING]

  1. 역할 사이에 파일이 섞이면 각 역할이 읽을 파일을 다시 제한한다. 조사자는 초안을 읽지 않고, 작성자는 검토 전에 검토 파일을 읽지 않는다.
  2. 여러 역할이 같은 파일을 수정하면 출력 파일을 다시 분리하고, 최종 파일을 수정할 역할은 하나만 둔다. 나머지 역할은 수정안이나 검토표만 만들고, 충돌한 변경은 원자료와 요청 조건을 기준으로 다시 판단한다.

13.2 – 서브에이전트와 에이전트 팀 구분하기

서브에이전트:
- 주 에이전트가 작업을 나누고 결과를 회수한다.
- 보조 역할끼리 직접 협의하지 않아도 된다.
- 짧고 독립적인 조사, 검사, 분류에 적합하다.

에이전트 팀:
- 여러 에이전트가 각자 역할과 작업 목록을 갖는다.
- 결과와 진행 상태를 서로 공유하거나 조정한다.
- 병렬 작업이 많고 역할 사이 협의가 필요한 업무에 적합하다.

[!WARNING]

  1. 역할을 늘리면 품질이 자동으로 높아지는 것은 아니다.
  2. 같은 자료와 같은 기준을 공유한 역할은 같은 오류를 반복할 수 있다.
  3. 각 역할의 입력, 도구, 출력, 완료 조건을 분리하고 주 에이전트가 결과를 검증한다.
  4. 에이전트 팀은 일부 제품에서 실험 기능일 수 있으므로 현재 지원 범위를 공식 문서에서 확인한다.

14 – 직접 맡기고 역할 나누기

  1. 실제 정보가 없는 연습 자료를 만든다.
  2. 계획만 받고, 읽기 결과를 확인한 뒤, 새 파일 한 개만 만들게 한다.
  3. 원자료와 결과를 대조하고 진행 기록을 남긴다.
  4. 반복할 검수 절차를 SKILL.md로 만들고 다른 안내문에 다시 적용한다.
  5. 실제 업무 주제 한 개를 골라 조사, 작성, 검토를 서로 다른 대화로 실행하고 각 결과를 별도 파일에 저장한다.
  6. 검토 근거를 직접 확인하고 확인된 수정만 최종본에 반영한다.
  7. 지원하는 도구가 있으면 같은 역할을 서브에이전트로 실행해 결과와 권한 분리를 비교한다.

15 – 예상 결과와 맞춰보기

자신의 결과가 제대로 나왔는지 아래와 맞춰 본다.

# 실습실 사전 점검 요청

점검일: 2026-07-01
점검 기한: 전날 17:00까지
장소: 2층 실습실
확인 항목: 인터넷 연결, 크롬 실행, 빔프로젝터 연결

research.md: 공식 출처에서 확인한 사실과 미확인 사항
draft.md: research.md의 사실만 사용한 안내문
review.md: 위치·문제·근거·수정 방향
final.md: 원자료로 확인된 지적만 반영한 문서

[!INFO]
아래 일곱 항목 중 다섯 항목 이상을 만족하면 정상이다.

  1. 실행 전에 계획과 사용할 파일을 확인하고, 읽기 결과를 원자료와 대조했다.
  2. 확인이 끝난 뒤에만 쓰기를 허용해 지정 폴더 밖 파일을 만들거나 수정하지 않았고, 새 파일 한 개만 생성돼 점검일·점검 기한·장소·확인 항목이 source.md와 정확히 일치한다.
  3. 생성 파일과 승인 작업을 진행 기록에 남겼다.
  4. 반복 작업의 적용 조건과 절차를 스킬에 기록했고, 다시 적용했을 때 같은 검수 항목과 출력 형식을 사용한다.
  5. 스킬, 도구, 에이전트, 하네스의 역할과 서브에이전트·에이전트 팀의 차이를 구분할 수 있다.
  6. 조사·작성·검토를 서로 다른 대화로 실행했고, 조사자는 초안을 쓰지 않았으며 작성자는 조사 자료에 없는 내용을 추가하지 않았다.
  7. 검토자가 문제 위치와 근거를 표시했고, 원자료로 확인된 지적만 최종본에 반영했다.

16 – 막히면 AI 코치에게 묻기

이 문서에서 익힌 두 가지, 곧 에이전트에게 계획·읽기·쓰기 순서로 권한을 단계별로 여는 법과 조사·작성·검토를 입력·출력으로 분리하는 법을 내 상황에 적용하다 막히면, 아래를 대화형 AI(ChatGPT·Claude·Gemini)에 붙여 넣어 실습 코치로 삼는다. 답을 한꺼번에 받지 말고 한 단계씩 풀어 간다.

너는 AI 에이전트 위임·역할 분리 실습 코치다. 나는 에이전트에게 계획만 받기·읽기 결과 확인·새 파일 한 개만 만들기 순서로 권한을 단계별로 여는 법과 반복 절차를 SKILL.md로 묶는 법, 그리고 조사·작성·검토를 서로 다른 대화와 파일로 나누어 각 역할의 입력·도구·출력·금지 작업을 분리하는 법을 배웠다. 내 자료로 새 파일 한 개를 안전하게 만들거나 네 개 파일(research·draft·review·final)을 직접 완성하려 한다. 답을 통째로 주지 말고 한 단계씩 물어 내가 직접 하게 한다.

[코칭 방식]
1. 먼저 내가 지금 어떤 권한을 열었거나 어느 역할을 실행 중인지, 어디서 막혔는지 묻는다.
2. 막힌 원인을 한 가지 짚어 준다. 완성된 요청문·안내문·검토표를 통째로 주지 않는다.
3. 다음 한 단계만 제시하고, 내가 해 본 결과를 말하면 확인 질문을 던진다.
4. 마지막에 새 파일 한 개만 생성돼 원자료와 일치하는지, 조사자가 초안을 쓰지 않고 검토자가 새 사실을 만들지 않았으며 원자료로 확인된 지적만 최종본에 반영됐는지 점검 질문을 한다.

[내 상황]
- 지금까지 한 것: {한것}
- 막힌 지점·메시지: {막힌점}
- 내 소재: {소재}

준비됐으면 "지금 에이전트에 연 권한은 어디까지이고, 어느 역할에서 막혔나?"라고만 답한다.
  1. {한것} – 지금까지 진행한 단계, 예: 계획만 받기로 작업 순서를 받았고 읽기 권한만 열었다. 조사 결과는 research.md에 모았다.
  2. {막힌점} – 막힌 부분이나 받은 메시지, 예: 에이전트가 원자료에 없는 날짜를 안내문에 넣었다. 또는 검토자가 초안을 다시 써 버려서 검토표가 안 나온다.
  3. {소재} – 적용할 내 자료·주제, 예: source.md의 실습실 점검 정보로 안내문 만들기. 또는 생성형 AI를 처음 쓰는 성인용 700자 안내문.

위 변수를 실제 값으로 채운 완성 예시는 다음과 같다.

너는 AI 에이전트 위임·역할 분리 실습 코치다. 나는 에이전트에게 계획만 받기·읽기 결과 확인·새 파일 한 개만 만들기 순서로 권한을 단계별로 여는 법과 반복 절차를 SKILL.md로 묶는 법, 그리고 조사·작성·검토를 서로 다른 대화와 파일로 나누어 각 역할의 입력·도구·출력·금지 작업을 분리하는 법을 배웠다. 내 자료로 새 파일 한 개를 안전하게 만들거나 네 개 파일(research·draft·review·final)을 직접 완성하려 한다. 답을 통째로 주지 말고 한 단계씩 물어 내가 직접 하게 한다.

[코칭 방식]
1. 먼저 내가 지금 어떤 권한을 열었거나 어느 역할을 실행 중인지, 어디서 막혔는지 묻는다.
2. 막힌 원인을 한 가지 짚어 준다. 완성된 요청문·안내문·검토표를 통째로 주지 않는다.
3. 다음 한 단계만 제시하고, 내가 해 본 결과를 말하면 확인 질문을 던진다.
4. 마지막에 새 파일 한 개만 생성돼 원자료와 일치하는지, 조사자가 초안을 쓰지 않고 검토자가 새 사실을 만들지 않았으며 원자료로 확인된 지적만 최종본에 반영됐는지 점검 질문을 한다.

[내 상황]
- 지금까지 한 것: 계획만 받기로 작업 순서를 받았고 읽기 권한만 열었다.
- 막힌 지점·메시지: 에이전트가 원자료에 없는 점검 시각을 안내문에 넣었다.
- 내 소재: source.md의 실습실 점검 정보로 안내문 만들기.

준비됐으면 "지금 에이전트에 연 권한은 어디까지이고, 어느 역할에서 막혔나?"라고만 답한다.

[!TIP]

  1. 코치가 답을 통째로 주려 하면 "한 단계씩 물어라"라고 다시 요청한다.
  2. 내 상황을 적을 때 어떤 권한(읽기·쓰기·명령 실행)까지 열어 두었는지와 각 역할이 읽을 파일·만들 출력 파일을 함께 적어 역할 사이에 자료가 섞이지 않게 한다.

댓글 남기기