🤝 우리 팀을 위한 서브에이전트 제작 프로젝트

🎯

미션 : 내 업무의 문제 하나를 해결하는 서브에이전트 팀 만들기 5교시에는 정해진 자료로 서브에이전트 하나를 만들었습니다. 이번에는 내 실제 업무 파일로 만들고, 내일 출근해서 바로 씁니다.

먼저 「이 에이전트로 내 업무의 어떤 문제를 해결하고 싶은가」를 정합니다

한 번에 잘 되지 않는 것이 정상입니다. 돌려 보고, 막힌 곳을 고쳐 달라고 하면 됩니다

⏰

6~7교시 · 16:00~17:50

Step 1 맡길 일 정하기 15분

Step 2 에이전트 팀 만들기 30분

Step 3 다시 실행하고 맡기기 20분

Step 4 결과 확인 15분

Step 5 소개 · 제출 25분

📘

따라하는 법 · 입력은 번호 붙은 상자 두 종류뿐입니다

💬 채팅창 : 클로드 코드 입력창(> 표시가 있는 곳)에 그대로 복사해 붙여 넣고 Enter

⌨️ 터미널 : 클로드 코드 밖, VS Code 터미널에 입력하고 Enter

빨간 【】는 내 내용으로 바꿔 넣는 자리입니다. 【】 표시까지 지우고 내 내용만 남깁니다. 나머지 글자는 고치지 않습니다. 입력 상자 바로 아래 ✏️ 예시에 채운 모습이 있습니다

예 : 「data 의 【파일 이름】 로」 → 「data 의 부킹대장_10월.xlsx 로」

상자는 입력 1-1 → 1-2 → … 순서대로 입력합니다. 「필요할 때만」이라고 적힌 상자는 그 상황일 때만 씁니다

각 Step 끝의 ✅ 가 보이면 다음 Step 으로 갑니다

다 만들면 이렇게 돕니다 (예 : 수출영업 2팀 · 주간 부킹 보고)

「부킹 보고 돌려줘」 → ① 스킬이 보고서를 만들고 → ② 검토 서브에이전트가 원본과 맞춰 보고 → ③ ⏸ 내가 승인할 때까지 멈추고 → ④ (있으면) 메일 초안 서브에이전트가 초안을 씁니다

순서는 CLAUDE.md 에 적힌 대로 메인 에이전트(내가 대화하는 클로드)가 정합니다

⚠️

시작 전에 : 회사 보안 규정에서 AI 도구에 넣어도 되는 자료인지 확인합니다. 원본은 두고 사본을 쓰고, 개인정보 · 거래처 실명은 가립니다.

Step 1. 맡길 일 정하기

바탕화면에 영문 이름 폴더(예 : my-agent-team)를 만들고 VS Code 로 엽니다. 메뉴 → 터미널 → 새 터미널

⌨️

입력 1-1 · 터미널

claude

💬

입력 1-2 · 채팅창

이 폴더에 data 와 outputs 폴더를 만들어줘

생긴 data 폴더에 내 업무 파일(엑셀 · 문서) 사본을 넣습니다

💬

입력 1-3 · 채팅창

나는 【부서 · 직무】에서 일한다. 에이전트로 내 업무의 문제 하나를 해결하고 싶다.

한 번에 질문 하나씩, 최대 5개까지 물어봐줘. 질문마다 보기를 같이 주고, 내가 직접 써도 되게 해줘.

첫 질문은 「요즘 업무에서 가장 답답한 것」이고, 보기는 시간이 오래 걸린다 · 숫자나 내용이 자주 틀린다 · 밖으로 나가는 게 늦다 · 자료가 흩어져 있다 · 같은 일을 매번 다시 한다.

다 물으면 「해결할 문제」 한 문장, 「해결되면 달라지는 것」, 에이전트에게 맡길 일 하나를 정리해서 이 폴더 맨 위에 업무지도.md 로 저장해줘.

✏️

예시 · 입력 1-3 (바뀐 곳만 굵게, 나머지는 그대로)

나는 물류센터 운영팀에서 일한다. 에이전트로 내 업무의 문제 하나를 해결하고 싶다. 한 번에 질문 하나씩 …

질문이 나오면 채팅창에 하나씩 답합니다. 보기 번호(예 : 2)로 답해도 되고 직접 써도 됩니다. 질문 수와 순서는 사람마다 다릅니다

✏️

예시 · 질문에 답하기 (미리 돌려 본 답)

질문 1 가장 답답한 것 → 2

질문 2 어떤 일에서 → 입출고 내역 엑셀에서 출고 예정일이 지났는데 남아 있는 화물을 찾아 화주에게 안내 메일 쓰는 일. 매주 2번, 1시간 반 걸린다

질문 3 무엇이 나빠지나 → 빠뜨린 화물 때문에 보관료 분쟁이 생긴다

질문 4 해결되면 → 기한 지난 화물이 빠짐없이 뽑히고 안내 메일 초안까지 나오면 좋겠다. 1시간 반 → 15분

💬

입력 1-4 · 채팅창 · 필요할 때만 (내 업무 파일이 없을 때)

업무지도의 맡길 일에 쓰는 파일과 같은 모양의 샘플 파일을 data 에 만들어줘. 30건 이상, 이름은 가상으로

💬

입력 1-5 · 채팅창 · 필요할 때만 (「엑셀을 읽는 도구를 설치할까요?」라고 물을 때)

설치하지 말고 지금 있는 기능으로 읽어줘

✅

업무지도.md 에 해결할 문제 한 문장과 맡길 일 하나가 보이면 다음 Step

Step 2. 에이전트 팀 만들기

먼저 맡길 일을 대화로 한 번 해 보고(입력 2-1), 마음에 들면 팀으로 만듭니다(입력 2-3)

【파일 이름】 에는 Step 1 에서 data 에 넣은 파일 중 이번에 쓸 파일 하나의 이름을 씁니다. VS Code 왼쪽 파일 목록의 data 안에서 보이는 이름 그대로입니다. 파일이 여러 개면 클로드가 아무 파일이나 고를 수 있어서 하나를 정해 줍니다

💬

입력 2-1 · 채팅창

업무지도의 맡길 일을 data 의 【파일 이름】 로 한 번 해서 결과물을 outputs 에 만들어줘. 양식이나 기준을 모르면 일반적인 모양으로 하고, 모르는 값은 「확인 필요」로 표시해줘.

✏️

예시 · 입력 2-1

업무지도의 맡길 일을 data 의 입출고내역_10월1주.xlsx 로 한 번 해서 결과물을 outputs 에 만들어줘. 양식이나 기준을 모르면 일반적인 모양으로 하고, 모르는 값은 「확인 필요」로 표시해줘.

💬

입력 2-2 · 채팅창 · 필요할 때만 (결과물을 다듬고 싶을 때, 여러 번 해도 됨)

【바꿀 곳】을 【이렇게】 바꿔줘

✏️

예시 · 입력 2-2

메일 초안 말투를 조금 더 짧고 공손하게 바꿔줘

기한 지난 화물 표를 화주별로 묶고, 지난 날수가 많은 순서로 바꿔줘

💬

입력 2-3 · 채팅창

방금 한 일을 에이전트 팀으로 만들어줘.

스킬 : 방금 한 순서와 기준을 스킬로 저장

검토 서브에이전트 : 결과물을 data 원본과 맞춰 보고 「통과」 또는 「보완 필요」만 알려 준다. 고치지 않는다. tools 는 Read, Glob, Grep, Bash 로 하고 Bash 는 원본을 읽는 명령만 쓴다

초안 서브에이전트 : 초안만 쓰고 보내지 않는다 ← 메일 · 공지처럼 밖으로 보낼 것이 없으면 이 줄은 지웁니다

CLAUDE.md 맨 아래에 일하는 순서 : 스킬로 결과물 → 검토 (보완 필요면 최대 2번 다시) → 사람 승인에서 멈춤, 승인 없이 넘어가지 않는다 → (있으면) 초안

스킬 · 서브에이전트 이름은 영문 소문자와 하이픈으로 하고, 이 팀을 부르는 말 한 줄을 정해서 마지막에 알려줘.

✏️

예시 · 입력 2-3

화주에게 안내 메일을 보내는 일이라 「초안 서브에이전트」 줄을 남기고, 빨간 안내 문구(← … 지웁니다)만 지우고 붙여 넣었습니다

사내 집계처럼 밖으로 보낼 것이 없는 일이면 「초안 서브에이전트」 줄 전체를 지웁니다

클로드가 마지막에 알려 준 부르는 말 : 「기한 초과 화물 점검 돌려줘」

만들어진 이름 : 스킬 overdue-cargo-report · 검토 overdue-cargo-reviewer · 초안 overdue-cargo-mail-drafter

.claude 폴더에 파일을 만들어도 되는지 묻는 창이 뜨면 허용을 누릅니다

클로드가 마지막에 알려 준 부르는 말을 메모해 둡니다. Step 3 에서 입력합니다

더 붙이고 싶다면 : 결과물이 엑셀 · 워드 · PPT 면 입력 2-1 끝에 「xlsx 스킬로」, 자료가 웹에 있고 3교시에 Playwright 를 연결했다면 「Playwright 로 가져와서」를 더합니다

✅

.claude/skills/ 에 스킬, .claude/agents/ 에 서브에이전트, CLAUDE.md 맨 아래에 일하는 순서가 생기고, 클로드가 부르는 말을 알려 주면 다음 Step

Step 3. 다시 실행하고 맡기기

서브에이전트는 클로드 코드를 다시 실행해야 불립니다

💬

입력 3-1 · 채팅창

/exit

⌨️

입력 3-2 · 터미널

claude

💬

입력 3-3 · 채팅창

【Step 2 에서 받은 부르는 말】 파일은 data 의 【파일 이름】

✏️

예시 · 입력 3-3

기한 초과 화물 점검 돌려줘 파일은 data 의 입출고내역_10월1주.xlsx

클로드가 부르는 말에 기준일 같은 것을 함께 말하라고 했다면 뒤에 이어 씁니다 (예 : 「… 기준일 2026-10-06」)

💬

입력 3-4 · 채팅창 · 클로드가 멈추고 승인을 물을 때마다

승인

승인 뒤에는 「검토하는 중」 같은 말이 먼저 나오고, 결과는 20~30초 뒤에 나옵니다. 결과가 다 나온 뒤에 다음 입력을 합니다

✅

검토 서브에이전트가 불렸다는 표시가 나오고, 클로드가 승인을 묻고 멈추면 다음 Step

Step 4. 결과 확인

결과물을 원본 파일과 직접 맞춰 봅니다. 숫자 2~3개만 골라 세어 봐도 됩니다

승인 전에는 아무것도 밖으로 나가지 않았는지 봅니다

예전 방식과 걸린 시간을 비교합니다. 업무지도에 적은 문제가 줄었나요?

💬

입력 4-1 · 채팅창 · 다른 주 · 다른 달 파일로 한 번 더

【부르는 말】 파일은 data 의 【다른 파일 이름】

✏️

예시 · 입력 4-1

기한 초과 화물 점검 돌려줘 파일은 data 의 입출고내역_10월2주.xlsx

파일을 바꾸면 승인을 처음부터 다시 묻는 것이 정상입니다. 물을 때마다 입력 3-4(승인)

💬

입력 4-2 · 채팅창 · 완성된 구조 정리

완성한 에이전트 구조를 outputs 에 에이전트구조.md 로 정리해줘. 파일을 직접 다시 읽고, 해결할 문제 · 폴더 그림 · 흐름도(어디서 사람에게 멈추는지) · 부품마다 하는 일과 tools 를 넣어줘.

✅

숫자가 원본과 같고, 승인에서 멈추고, 에이전트구조.md 가 생기면 다음 Step. 막힌 곳이 있으면 맨 아래 「막혔을 때」를 봅니다

Step 5. 소개 · 제출

💬

입력 5-1 · 채팅창 · 소개 HTML 만들기

이 폴더의 에이전트 팀을 소개하는 HTML 발표자료를 【영문이름】-agent/index.html 로 만들어줘. 업무지도.md 와 outputs/에이전트구조.md 를 먼저 읽어줘.

슬라이드는 1. 표지 2. 해결하려는 문제 3. 에이전트 구조 4. 일하는 순서 5. 실제로 돌린 결과 6. 고친 것 7. 문제가 얼마나 줄었나 · 다음 계획. 16:9, 방향키로 넘기고, 글자는 크게, 한 장에 6줄 이내, 파일은 index.html 하나.

인터넷에 공개되므로 실제 숫자 · 거래처명 · 사람 이름은 넣지 말고 「○○건」처럼 가려줘. 걸린 시간의 전 · 후는 써도 된다.

✏️

예시 · 입력 5-1 (바뀐 곳만 굵게, 나머지는 그대로)

이 폴더의 에이전트 팀을 소개하는 HTML 발표자료를 kim-minsu-agent/index.html 로 만들어줘. …

영문이름은 내 이름 또는 팀 이름을 영문 소문자와 하이픈으로 씁니다. 버셀 주소가 됩니다 (예 : kim-minsu-agent.vercel.app)

만들어진 index.html 을 브라우저로 열어 슬라이드가 넘어가는지 봅니다

버셀은 1회차에 연동했습니다. VS Code 터미널 오른쪽 위 + 로 터미널을 하나 더 열고 연결만 확인합니다

⌨️

입력 5-2 · 새 터미널

npx vercel whoami

⌨️

입력 5-3 · 새 터미널 · 필요할 때만 (5-2 에서 내 이름 대신 오류가 나올 때)

npx vercel login

💬

입력 5-4 · 채팅창 · 버셀 배포

【영문이름】-agent 폴더를 버셀에 배포해줘. 그 폴더에서 npx vercel deploy --prod --yes 를 실행하고 공개 주소를 알려줘

✏️

예시 · 입력 5-4

kim-minsu-agent 폴더를 버셀에 배포해줘. 그 폴더에서 npx vercel deploy --prod --yes 를 실행하고 공개 주소를 알려줘

5-1 에서 쓴 영문이름과 같게 씁니다

나온 짧은 주소(https://○○.vercel.app)를 브라우저 시크릿 창으로 열어 봅니다

주소를 제출 시트에 이름 · 직무 · 주소 순으로 올립니다

과제 제출 링크 (클릭)

https://docs.google.com/spreadsheets/d/1arXoF53x5h5ogo81FMTC0eU5xZ9hLB-s8C1l54MBbuU/edit?gid=0#gid=0 → 여기 업로드해주세요

✅

시트에 내 줄이 보이면 끝입니다

막혔을 때

아래 문장은 모두 💬 채팅창에 입력합니다.

이럴 때	💬 채팅창에 입력	입력 뒤에
어디까지 했는지 모르겠다	이 폴더의 파일을 보고, 지금 내가 몇 번 Step 에 있는지, 다음에 할 일 하나만 알려줘
클로드의 설명이 어렵다	방금 말을 쉬운 말로 세 줄, 우리 팀 예시로 다시 설명해줘
문제가 너무 크다 (예 : 실적을 올리고 싶다)	【문제】를 이번 주 안에 줄일 수 있는 작은 조각 3개로 쪼개줘 ✏️ 예 : 영업 실적을 올리고 싶다를 이번 주 안에 …
서브에이전트를 찾을 수 없다 (not found)	`/exit`	⌨️ 터미널에 `claude`
부르는 말을 쳤는데 순서대로 안 돈다	`CLAUDE.md` 맨 아래에 일하는 순서가 있는지 보고, 없으면 적어줘	💬 `/clear`
승인 없이 끝까지 가 버린다	`CLAUDE.md` 에 승인 없이 넘어가지 않는다는 줄을 넣어줘	💬 `/clear`
검토가 엑셀을 못 연다	검토 서브에이전트 tools 에 Bash 를 넣고, 읽는 명령만 쓰게 해줘	💬 `/exit` → ⌨️ `claude`
결과물 양식이 매번 다르다	스킬에 결과물 양식과 판단 기준을 적어줘	💬 `/clear`
없는 숫자 · 이름이 들어간다	자료에 없는 값은 지어내지 말고 「확인 필요」로 쓰라고 스킬과 서브에이전트에 적어줘	💬 `/exit` → ⌨️ `claude`
시간이 모자란다	(입력 없음) 입력 2-3 에서 초안 서브에이전트 줄을 지우고 스킬 + 검토 + 승인만으로 끝냅니다. Step 5 제출은 꼭 합니다

같은 Step 에서 10분 넘게 막히면 손을 들어 강사를 부릅니다

이런 일을 맡길 수 있습니다 (예시 10가지)

업무	부르는 말	검토 서브에이전트가 보는 것	승인 뒤 초안
매주 부킹 보고 · 선사영업	「부킹 보고 돌려줘」	상태별 · 루프별 숫자를 원본에서 다시 세기	팀장 보고 메일
견적서 작성 · 물류영업	「이 문의로 견적서 만들어줘」	단가 · 합계, 지어낸 값	거래처 회신 메일
거래처 문의 답변 · 고객지원	「오늘 문의 답변 돌려줘」	날짜 · 부킹번호, 약속하면 안 되는 말	답변 모음
운항 지연 공지 · 운항	「지연 공지 돌려줘」	항차번호 · 시각	화주 안내문
미수금 안내 · 회계	「미수금 안내 돌려줘」	금액, 이미 입금된 건이 섞였는지	거래처별 안내 메일
검사 지적 조치 챙기기 · 선박관리	「지적 조치 점검 돌려줘」	기한 지난 건이 빠졌는지	선박별 조치 요청
수리비 청구 점검 · 컨테이너장비	「수리비 청구 점검 돌려줘」	합계와 중복	청구 안내
오래 두는 화물 안내 · 물류센터	「장기 보관 안내 돌려줘」	수량, 이미 나간 화물이 섞였는지	화주 안내문
회의록 → 할 일 정리 · 누구나	「회의 정리 돌려줘」	메모에 없는 내용을 지어냈는지	참석자 공유 메일
팀 주간보고 모으기 · 누구나	「주간보고 취합 돌려줘」	빠진 사람, 원본에 없는 내용	본부장 보고 메일

🧪

미리 돌려 본 결과 : 물류센터 운영팀 · 샘플 데이터로 처음부터 끝까지 돌렸습니다. 검토 서브에이전트와 초안 서브에이전트가 모두 불렸고, 승인에서 멈췄으며, 기한 지난 화물 숫자(12건 · 11건)가 정답과 같았습니다. 입력 2-3 하나로 스킬 · 검토 서브에이전트 · 초안 서브에이전트 · CLAUDE.md 순서가 한 번에 만들어졌습니다. 클로드가 한 번 답하는 데 걸린 시간은 3~68초였습니다.

🌱

내일부터 쓸 때 : data 의 파일만 새 것으로 바꾸고 💬 채팅창에 부르는 말 한 줄을 입력합니다. 팀원에게 넘길 때는 폴더째 넘깁니다. CLAUDE.md 와 .claude/ 가 함께 가야 같은 결과가 나옵니다.