AG북토크 & 핸즈온· AI Agent Guild
0/0

AI Agent Guild 10월 세미나 · 『생존을 위한 최소한의 AI 교양』 조남호 저자와 함께하는

북토크 &
핸즈온 세미나

AI를 이해하는 대화에서, 하네스로 일을 맡기는 경험까지.
북토크에서 AI에 대한 질문을 나눈 뒤, 나머지 실습은 이 페이지 하나로 진행합니다. 먼저 단일 에이전트와 멀티 에이전트가 무엇이 다른지, 왜 하네스가 필요한지, 팀을 짜는 여섯 가지 모양을 실습 키트로 확인합니다. 그다음 내가 고른 책·영화·행사·게임을 소개하는 showreel 하네스를 한 문장으로 만들어 돌립니다. 수업이 끝난 뒤에는 같은 기획으로 실제 영상까지 만들 수 있게 따라 하기 안내를 담았습니다. 코딩은 필요 없습니다. 모든 명령은 복사해서 붙여 넣으면 됩니다.

일시
10월 29일(목)
19:00~22:00
진행
온라인 라이브
총 3시간
준비물
노트북 (Windows · Mac)
Claude Pro 이상 구독
만드는 것
showreel 하네스
HTML 모션 릴
진행 상황은 이 브라우저에 저장됩니다 각 단계의 체크박스를 누르면 상단 진행률이 올라갑니다. 세션 3에서 적는 작품 정보도 이 기기 안에만 저장되고 어디로도 전송되지 않습니다. 처음부터 다시 하려면 맨 아래 진행 기록 지우기를 누르세요.

Agenda

3시간의 흐름

책 이야기로 문제를 꺼내고, 완성된 하네스로 원리를 확인한 뒤, 내 손으로 하나 만들어 돌립니다. 실제 영상 만들기는 수업 뒤에 따라 합니다.

시간프로그램내용
19:00~19:10오프닝인사 · 진행 안내 · Claude Code · 플러그인 점검
19:10~19:50저자 북토크조남호 저자와 책 이야기 · 독자 질문
19:50~20:00휴식다음 실습 준비
20:00~20:50대표 실습단일 vs 멀티 에이전트 · 하네스의 필요성 · 6가지 아키텍처 패턴
20:50~21:00휴식다음 실습 준비
21:00~21:30showreel 하네스작품 고르기 · “하네스 구성해줘” · HTML 릴 만들기
21:30~21:42내 스킬 만들기내 업무의 반복 작업을 스킬로 · 정말 불리는지 시험
21:42~21:50showreel 소개요청 한 줄이 영상이 되는 대형 하네스 · 수업 뒤 따라 하기 안내
21:50~22:00Q&A 및 마무리실습 질문 · 내 업무로 옮기기

Session 0 · 세미나 전에 · 15분

시작 전 준비

당일에 설치하면 그 시간이 실습에서 빠집니다. 전날까지 끝내 주세요. Windows 기준으로 썼고, 탭에서 macOS를 고르면 Mac 명령이 나옵니다.

Claude Code는 Claude Pro 이상 구독 계정으로 로그인합니다. 무료 계정으로는 실습이 되지 않습니다. 아직 없다면 claude.ai에서 가입하고 구독을 켜 두세요.

GPU나 고사양 컴퓨터는 필요 없습니다. 모델은 Claude 쪽에서 돌고, 내 노트북은 파일을 읽고 쓰는 일만 합니다.

사용량을 꽤 씁니다 멀티 에이전트는 담당자 수만큼 사용량이 듭니다. Pro 요금제라면 세미나 당일 낮에는 Claude를 아껴 써 두세요. 한도에 걸리면 그 자리에서 더 진행할 수 없습니다.

Windows에서 Claude Code는 Git과 함께 설치되는 Git Bash로 명령을 실행하므로 꼭 필요합니다. 이미 있다면 확인만 하고 넘어가세요.

PowerShell
winget install --id Git.Git -e --source winget

설치가 끝나면 PowerShell 창을 새로 열고 git --version으로 확인합니다.

한 줄 설치입니다.

PowerShell
irm https://claude.ai/install.ps1 | iex

끝나면 PowerShell 창을 새로 열고 claude --version으로 확인합니다.

“claude 명령을 찾을 수 없습니다”가 나오면

설치 경로가 PATH에 등록되지 않은 경우입니다. 아래를 붙여 넣고 PowerShell 창을 다시 여세요.

PowerShell
$claudePath = "$env:USERPROFILE\.local\bin"
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
if ($userPath -notlike "*$claudePath*") {
    [Environment]::SetEnvironmentVariable("Path", "$userPath;$claudePath", "User")
}
PowerShell · 터미널
claude

처음 실행하면 브라우저가 열립니다. 1단계의 Claude 계정으로 로그인하면 터미널에 입력창이 뜹니다. “안녕”이라고 한 번 걸어 보고 답이 오면 성공입니다. 아직 창을 닫지 마세요. 다음 단계에서 이 입력창을 씁니다.

Claude Code 입력창 안에서 한 줄씩 붙여 넣고 Enter를 누릅니다. 첫 두 줄이 오늘의 주인공인 revfactory/harness, 뒤의 두 줄은 Word·PDF 같은 문서를 읽고 쓰게 해 주는 Anthropic 공식 문서 스킬입니다.

Claude Code 입력창 · 한 줄씩
/plugin marketplace add revfactory/harness
/plugin install harness@harness-marketplace
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills

설치 범위를 묻으면 User를 고르세요. 그래야 어느 폴더에서 띄워도 보입니다. 다 끝나면 /exit로 나갔다가 claude로 다시 들어오고, /plugin을 입력해 harness와 document-skills가 보이면 준비 끝입니다.

Session 1 · 19:10~19:50 · 40분

조남호 저자와 함께하는 북토크

『생존을 위한 최소한의 AI 교양』 — 다가오는 AI 시대의 변화를 뛰어넘기

지식 노동의 스푸트니크 쇼크에서 에이전트 시대의 생존 전략까지. 기술이 도구에서 충격이 되는 순간 무엇이 바뀌는지, 그 변화 앞에서 개인과 조직은 무엇을 준비해야 하는지 저자와 이야기합니다.

“모르면 당한다. 알면 부린다. 이제는 함께 실행한다.” 이 문장의 마지막 부분, 함께 실행한다를 이어지는 핸즈온에서 직접 해 봅니다.

이야기의 흐름

북토크에서 핸즈온으로 — 여섯 가지 능력을 오늘 어디서 연습하나

에이전트 운용 능력오늘 실습에서
문제 분해력 — 큰 일을 실행 가능한 단위로세션 2 · 역할 나누기와 여섯 가지 팀 패턴
맥락 제공력 — 목표·제약·자료를 구조화세션 3 · brief.md, CLAUDE.md, 스킬 의뢰서
병렬 실행력 — 여러 에이전트를 동시에세션 2 · 팬아웃과 서브에이전트
검증·테스트 능력 — 사실·품질 기준으로 점검세션 2·3 · 검증자 분리, 출처 대조, 스킬이 정말 불리는지 시험
사용자 이해력 — 누구에게 어떤 가치인가세션 3 · showreel 의뢰서의 ‘보는 사람’과 끝 화면 문구
책임 있는 결정력 — 최종 승인은 사람이모든 세션 · 승인 창 3초 점검, 검수표를 읽고 고칠지 정하기

미리 생각해 볼 질문

세션 3에서 내가 고른 작품의 15초 소개 영상을 만듭니다. 좋아하는 책, 다시 보고 싶은 영화, 우리 팀 행사, 기다리는 게임 무엇이든 됩니다. 떠오르지 않으면 오늘의 책 『생존을 위한 최소한의 AI 교양』으로 하세요. 예시가 그 책으로 채워져 있습니다.

그리고 머릿속 한쪽에는 내 업무의 반복 작업 하나를 올려 두세요. 마무리에서 같은 방법으로 옮겨 봅니다.

Session 2 · 20:00~20:50 · 50분

대표 실습 — 단일 에이전트 vs 멀티 에이전트, 그리고 하네스

개념을 짧게 본 뒤, 같은 과업을 두 방식으로 처리한 결과를 실습 키트로 뜯어봅니다. 마지막에 팀을 짜는 여섯 가지 모양을 익힙니다.

2-1. 단일 에이전트와 멀티 에이전트

에이전트는 목표를 받으면 스스로 파일을 읽고, 명령을 실행하고, 결과를 보고 다음 행동을 고르는 AI입니다. Claude Code가 그렇습니다. 이 에이전트 한 명에게 일을 통째로 맡길 수도 있고, 여러 명에게 나눠 맡길 수도 있습니다.

단일 에이전트

한 명이 하나의 대화 안에서 처음부터 끝까지

에이전트 1명 · 컨텍스트 하나 조사 — 세 분야를 혼자 훑음 작성 — 앞의 조사를 기억에 의지해 검토 — 자기가 쓴 글을 자기가 작업 기억이 거의 다 참
  • 빠르고 사용량이 적습니다. 문체가 한결같습니다.
  • 범위가 넓으면 깊이가 고르지 않고, 자기 실수를 자기가 못 봅니다.

멀티 에이전트

본체가 일을 나눠 맡기고 결과만 받는다

오케스트레이터 조사 A 조사 B 검증 각자 새 작업 기억 · 결과만 돌려줌
  • 분야마다 깊이가 고르고, 동시에 진행되며, 만든 쪽과 검사하는 쪽이 나뉩니다.
  • 사용량이 담당자 수만큼 늘고, 넘겨줄 양식을 미리 정해야 합니다.

여기서 쓰는 말 세 개만 알아 두세요.

그럼 하네스는 무엇인가 — 일의 세 단계

단계비유방식다음 달에도 같은 품질?
L1 · 혼자유능한 인턴 한 명지시 하나로 처음부터 끝까지 (단일 에이전트)사람이 매번 다시 설명
L2 · 팀그때그때 모은 전문가들나눠 맡기고 취합·검증 (멀티 에이전트)나누는 방법을 매번 다시 지시
L3 · 시스템직무기술서가 있는 팀역할·절차·규칙·검증을 파일로 남긴 멀티 에이전트 = 하네스같은 한 줄이면 됨

L1과 L3의 실행 명령은 둘 다 한 줄입니다. 차이는 명령의 길이가 아니라 그 한 줄이 기대고 있는 파일의 양입니다. 하네스는 이렇게 짜여 있습니다. 바로 다음에 여는 실습 키트가 이 구조입니다.

“제안서를 작성해줘” CLAUDE.md늘 지킬 규칙 · 언제 부르나 오케스트레이터누가 · 언제 · 어떤 순서로 지휘 — 스킬 하나 누가 — .claude/agents/ 어떻게 — .claude/skills/ 요구분석전부 뽑아 번호 도메인 전문가문서 밖 지식 설계 ∥ 관리동시에 작성 검증자대조만 한다 요구 추출 방법 의료 표준 사전 제안서 표준 artifacts/요구사항_인벤토리.md중간 산출물 — 담당자끼리는 파일로 넘긴다
세션 2 실습 키트의 하네스. CLAUDE.md는 규칙과 호출 조건, 오케스트레이터 스킬은 순서, 에이전트는 누가, 스킬은 어떻게를 맡습니다. 담당자는 서로 대화하지 않고 파일로 일을 넘깁니다.

입력은 나라장터에 실제로 올라온 과업지시서 한 건입니다. 병원 진료기록을 연계하는 사업인데, 문서에는 FHIR, KCD-8, 심평원 EDI, 가명화 같은 말이 이름만 나옵니다. 보건의료 데이터를 모르는 사람이 이 문서로 제안서를 써야 합니다. 낯선 부서의 요청이나 처음 보는 규격을 받아 든 날과 같은 조건입니다.

트랙 A · 단일 에이전트트랙 B · 하네스(멀티 에이전트)
지시“과업지시서로 제안서를 작성해줘” 한 번전문가 5명이 순서대로·동시에 나눠 쓰고 검증
결과제안서A_단일패스.docx (3쪽)제안서B_하네스.docx (8쪽)

두 결과물과 트랙 B를 만든 팀이 키트에 이미 들어 있습니다. 트랙 B를 처음부터 돌리면 20~40분이 걸리므로, 오늘은 만들어진 결과를 뜯어보는 데 시간을 씁니다. Claude 입력창이 아니라 PowerShell(Mac은 터미널)에서 실행합니다. Claude가 떠 있다면 /exit로 먼저 나오세요.

PowerShell
mkdir C:\aiguild -Force; cd C:\aiguild
curl.exe -L -o proposal-ab.zip https://namojo.github.io/aiguild/templates/proposal-ab.zip
Expand-Archive proposal-ab.zip -DestinationPath . -Force
cd proposal-ab; claude

PowerShell에서는 curl이 아니라 curl.exe로 써야 합니다.

브라우저로 proposal-ab.zip을 받아 aiguild 폴더에 풀어도 같습니다. 오늘 쓰는 폴더는 이렇게 생겼습니다.

C:\aiguild\          (Mac은 ~/aiguild/)
├── proposal-ab/    ← 세션 2 · 단일 에이전트 vs 하네스
│   ├── 과업지시서_데이터뱅크.hwpx      입력
│   ├── 제안서A_단일패스.docx · 제안서B_하네스.docx
│   ├── artifacts/요구사항_인벤토리.md  트랙 B의 중간 산출물
│   ├── CLAUDE.md · .claude/          트랙 B를 만든 하네스
└── my-reel/        ← 세션 3 · 내가 만들 showreel 하네스

Claude Code는 띄운 폴더를 작업 공간으로 잡습니다. 어느 폴더에서 띄우는지가 곧 Claude가 손댈 수 있는 범위입니다. 홈 폴더나 C:\에서 띄우지 마세요.

승인 창이 뜨면 3초만 읽으세요 Claude가 파일을 만들거나 명령을 실행하기 전에 허락을 구합니다. 무엇을 하려는지(읽기·쓰기·명령), 어느 경로인지, 내가 시킨 일인지만 보고 승인하세요. 모르겠으면 거절하고 “왜 필요한지 설명해줘”라고 물어도 아무것도 망가지지 않습니다.
Claude Code 입력창
제안서A_단일패스.docx 와 제안서B_하네스.docx 를 둘 다 읽고,
아래 네 항목에서 무엇이 다른지 표로 비교해줘. 쪽수 말고 내용으로 비교해줘.
1. 배경지식 (모르는 분야를 어떻게 다뤘나)
2. 요구사항 대응 (빠뜨린 것이 있나)
3. 계약 조건 조항 대응
4. 검증 가능성 (숫자로 확인 가능한 약속이 있나)

대략 이런 표가 나옵니다. 글자가 똑같을 필요는 없습니다. 형태가 비슷하면 됩니다.

비교 지점A · 단일 에이전트B · 하네스
배경지식“표준코드에 맞추어 매핑합니다” — 과업지시서 단어를 되풀이코드체계 6종별 매핑 전략 표
요구사항 대응눈에 띄는 요구 위주. 보안 연계망·가명화 취급이 얕음REQ-01~11 추적 매트릭스
계약 조건사실상 언급 없음CON-01~07 전건 수용 확약표
검증 가능성“약 3주”, “품질을 확보”W1~W9 일정, 미매핑률 ≤1% 같은 확약

A를 일부러 못 쓴 게 아닙니다. 구조도 잡혀 있고 문장도 매끄러운, 단일 에이전트의 괜찮은 평균입니다. 그래서 비교가 공정합니다. 한 줄로 줄이면 A는 과업지시서를 요약한 제안서, B는 과업지시서에 응답한 제안서입니다.

Claude가 만든 표를 그대로 믿지 말고, 두 문서를 직접 열어 한 줄만이라도 확인해 보세요. 그것도 검수 연습입니다.

B가 더 좋은 문장을 써서 이긴 게 아닙니다. 중간에 만든 파일 하나에서 차이가 시작됐습니다.

Claude Code 입력창
artifacts/요구사항_인벤토리.md 를 읽고,
이 파일이 무엇을 정리한 것인지, 항목이 몇 개인지 알려줘.
그리고 이 파일이 없었다면 제안서에서 무엇이 빠졌을지 설명해줘.
REQ-01 ~ REQ-11   기능 요구사항 11건
DOM-01 ~ DOM-13   도메인 지식 항목 13건
CON-01 ~ CON-07   계약 조건 7건
DEL-01 ~ DEL-04   산출물 4건

과업지시서에서 요구사항을 전부 뽑아 번호를 붙이는 지루한 일입니다. 이 목록 하나가 뒤의 모든 것을 만들어 냅니다.

인벤토리가 낳은 것어떻게
추적 매트릭스REQ 번호마다 제안서 어디에서 답했는지 표시
조건 확약표CON 번호를 하나씩 훑으며 수용 여부 명시
검수 기준표DEL 번호마다 인수 조건 정의
“빠진 게 없다”의 근거검증자가 ID를 하나씩 원고에서 대조

사람도 급하면 이 정리를 건너뛰고 바로 본문을 씁니다. 혼자 일하는 에이전트도 그렇습니다. 팀에 그것만 하는 담당이 있으면 건너뛸 수 없습니다.

이 세션의 핵심 문장 하네스란 중간 산출물을 만드는 일을 역할로 강제하는 장치입니다.

트랙 B를 만든 팀이 이 폴더에 그대로 들어 있습니다. 먼저 등록된 에이전트를 봅니다.

Claude Code 입력창
/agents

다섯 명이 보이면 Esc로 닫고, 구성 전체를 설명해 달라고 합니다.

Claude Code 입력창
이 폴더의 CLAUDE.md 와 .claude/agents/, .claude/skills/ 를 훑어보고,
각 파일이 무슨 역할인지 한 줄씩 정리해줘. 코드 용어 말고 조직도를 설명하듯 알려줘.
순서담당맡은 일
1요구분석가 rfp-analyst요구사항 전수 추출 · ID 부여 → 인벤토리
2도메인 전문가 domain-expert문서 밖 지식 주입 (코드 전환표, 관련 법 조항)
3기술 설계 solution-architect
관리 담당 pm-expert
해결 방안 / 일정·리스크·조건 대응 — 두 사람이 동시에 진행
4검증자 compliance-reviewer인벤토리 ID를 원고에서 하나씩 대조, 통과할 때까지 담당자를 지목해 수정 요청. 원고를 직접 고치지 않음

도메인 전문가가 똑똑해서 코드 전환표를 아는 게 아닙니다. medical-data-standards 스킬 파일에 사전이 들어 있어서입니다. 그 사전은 다음 의료 사업에서도 그대로 다시 쓰입니다. 에이전트는 누가, 스킬은 무엇을 어떻게입니다.

단일 에이전트도 충분히 똑똑합니다. 그런데도 B가 이긴 이유는 네 가지 구조입니다. 세션 3에서 내가 만든 팀을 볼 때 이 네 가지를 같은 눈으로 봅니다.

  • 1역할을 나눈다추출 · 지식 · 설계 · 관리 · 검증. 한 명이 다 하면 깊이가 고르지 않습니다.
  • 2지식을 파일로 꺼낸다도메인 사전을 스킬로. 대화에 설명한 지식은 대화가 끝나면 사라지지만, 파일은 다음 사업에서도 쓰입니다.
  • 3중간 산출물을 강제한다요구사항 인벤토리처럼 건너뛰기 쉬운 정리를 담당자의 일로 못 박습니다.
  • 4검증자는 분리한다만든 쪽이 스스로 승인하지 않습니다. 잘 쓰는 것과 빠뜨리지 않는 것은 다른 능력입니다.

그리고 A가 이기는 경우도 있습니다. 내부 검토용 초안이나 참고용 요약이라면 단일 에이전트의 속도가 정답입니다. 하네스의 진짜 비용은 실행이 아니라 처음 설계에 있으니, 반복이 없거나 누락의 대가가 작으면 만들 이유가 없습니다. 내 업무 하나를 넣어 판정해 보세요.

내 업무는 몇 단계짜리 일인가

점수를 고르면 판정이 나옵니다.

(선택 · 집에서) 혼자 vs 팀을 직접 돌려 비교해 보기

세션 3에서 고를 작품을 소재로, 같은 조사를 두 방식으로 시켜 보세요. 빈 폴더에서 claude를 띄운 뒤 아래를 차례로 넣습니다. [ ] 안을 바꾸세요.

① 단일 에이전트
[작품 이름]을 소개하는 1쪽 자료를 report/L1.md 로 써줘.
공식 정보(만든 사람·일정), 반응과 평가, 작품의 배경 세 가지를 다루고
모든 사실에 출처 URL을 붙여줘. 확인 못 한 것은 쓰지 마.
② 대화 비우기
/clear
③ 멀티 에이전트
[작품 이름] 소개 자료를 팀으로 만들어줘.
[1단계] 조사 담당 3명을 동시에 띄워 research/ 에 각자 노트를 쓰게 해줘.
  공식 정보 → research/official.md, 반응과 평가 → research/reception.md, 배경 → research/context.md
[2단계] 집필 담당이 세 노트를 합쳐 report/L2.md 로 써줘.
[3단계] 검증 담당이 report/L2.md 의 사실마다 출처를 열어 대조하고,
  틀리거나 출처 없는 것을 [검증실패] 목록으로 보고한 뒤 집필 담당에게 고치게 해줘.

두 파일을 나란히 놓고 분야별 깊이, 출처 없는 사실의 수, 걸린 시간을 비교해 보세요. 팀이 언제나 이기지는 않습니다. 작품이 작고 자료가 적으면 L1로 충분하다는 것도 결론입니다.

2-2. 팀을 짜는 여섯 가지 모양 — revfactory/harness의 아키텍처 패턴

멀티 에이전트 팀에는 정해진 모양이 있습니다. harness 플러그인은 “하네스 구성해줘”를 받으면 일의 흐름을 분석해 아래 여섯 가지 중에서 고르거나 섞습니다. 외울 필요는 없지만, 만들어진 팀을 보고 “아, 이 모양이구나” 알아보면 점검이 쉬워집니다. 카드 아래에는 광고 실무자를 위한 Harness Ad Academy에서 그 패턴을 한 과정 전체로 풀어 둔 사례를 달았습니다. 가상 브랜드 ‘제로톡’으로 팀 구성, 실행 프롬프트, 완성 산출물까지 볼 수 있습니다.

01

파이프라인

Pipeline
분석 설계 구현 검증 앞 단계의 결과가 다음 단계의 입력
모양
정해진 순서대로 넘긴다
어울림
앞 결과가 있어야 다음이 되는 일 — 소설: 세계관 → 인물 → 줄거리 → 집필 → 편집
주의
한 단계가 늦으면 전체가 늦는다

C8광고 실무 사례 — 콘텐츠·SNS 제작 하네스 · 기획부터 썸네일까지 한 줄로 잇기

02

팬아웃 · 팬인

Fan-out / Fan-in
분배 전문가 A 전문가 B 전문가 C 통합
모양
나눠서 동시에 하고 → 합친다
어울림
같은 대상을 여러 관점에서 — 공식 자료·언론·커뮤니티를 동시에 조사해 보고서 하나로
주의
합치는 방식이 전체 품질을 좌우한다

C3광고 실무 사례 — 리서치·인사이트 하네스 · 하루 걸리던 조사를 동시에 나눠 한 시간에

03

전문가 풀

Expert Pool
분류 보안 전문가 성능 전문가 구조 전문가
모양
상황에 맞는 전문가만 골라 부른다
어울림
입력마다 처리 방식이 다른 일 — 코드 검토에서 해당 영역 전문가만 호출
주의
분류를 틀리면 엉뚱한 전문가가 나선다

C5광고 실무 사례 — 퍼포먼스 마케팅 하네스 · 채널별 전문가를 골라 불러 한 장의 리포트로

04

생성 · 검증

Producer-Reviewer
생성 검증 문제가 있으면 다시 (최대 2~3회)
모양
만들고 → 검사하고 → 걸리면 다시 만든다
어울림
판정 기준을 세울 수 있는 산출물 — 광고 카피를 쓰고 규정 위반을 검사
주의
재시도 횟수를 정해 두지 않으면 끝없이 돈다

C4광고 실무 사례 — 크리에이티브 제작 하네스 · 카피·비주얼을 팀으로 뽑고 검수

05

감독자

Supervisor
감독자 작업자 A 작업자 B 작업자 C
모양
한 명이 진행을 보며 그때그때 배분한다
어울림
일의 양이 실행 중에 바뀌는 일 — 들어오는 대로 남는 사람에게 배정
팬아웃과 차이
팬아웃은 시작 전에 나누고, 감독자는 하면서 다시 나눈다

C7광고 실무 사례 — 미디어·캠페인 플래닝 하네스 · 감독자가 캠페인 전체를 지휘

06

계층적 위임

Hierarchical Delegation
총괄 팀장 A 팀장 B 실무 A1 실무 A2 실무 B1
모양
위에서 아래로 쪼개 내린다
어울림
큰 과제를 상위·하위 작업으로 나눌 수 있는 일 — 행사 총괄 → 홍보팀장·운영팀장 → 실무
주의
세 단계 넘게 깊어지면 느려지고 맥락이 샌다. 두 단계 이내 권장

C6광고 실무 사례 — 브랜드 스케일업·커머스 하네스 · 제품 기획부터 유통·런칭까지 위임

실제 팀은 섞어 씁니다. 예를 들어 “파이프라인인데 그중 한 단계만 팬아웃”, “팬아웃으로 만들고 각각 생성·검증” 같은 식입니다. 플러그인은 모양과 함께 어떻게 돌릴지(실행 모드)도 고릅니다. 팀 크기가 아니라 일의 흐름이 기준입니다.

실행 모드어떻게 도나언제
워크플로 조율순서·병렬·검증 반복을 스크립트로 정해 두고 그대로 실행흐름을 미리 정할 수 있고, 항목이 많고, 결과 형식이 정해진 일
지속형 에이전트 협업이름 붙은 담당자가 대화를 이어 가며 메시지를 주고받음피드백을 주고받으며 다듬는 일, 오래 맥락을 쥐고 있어야 하는 전문가
서브에이전트 위임그때그때 담당자를 불러 한 번 맡기고 결과만 받음결과만 있으면 되는 가벼운 위임 (오늘 실습은 대부분 이것)

여섯 가지 일에 어울리는 모양을 골라 보세요. 답은 하나가 아닐 수 있지만, 가장 잘 맞는 것을 고르면 됩니다.

패턴 퀴즈

  1. 해외 기사 한 편을 번역 → 감수 → 편집 → 게시합니다. 앞 단계가 끝나야 다음 단계를 할 수 있습니다.

    파이프라인. 각 단계가 앞 단계 산출물에 의존합니다. 실습 키트의 제안서 팀도 큰 줄기는 이 모양입니다.

  2. 신제품 반응을 뉴스 · 커뮤니티 · 리뷰 영상에서 동시에 조사해 보고서 한 편으로 합칩니다.

    팬아웃 · 팬인. 세 조사는 서로를 기다릴 필요가 없고, 마지막에 하나로 합칩니다.

  3. 고객 문의가 결제 · 배송 · 기술 중 무엇인지 먼저 가려, 해당 담당자 한 명에게만 넘깁니다.

    전문가 풀. 모두를 부르지 않고 분류 결과에 맞는 전문가만 호출합니다. 분류가 틀리면 전체가 틀립니다.

  4. 건강기능식품 광고 문구를 쓰고, 표시·광고 규정 위반이 있으면 다시 쓰게 합니다.

    생성 · 검증. 판정 기준(규정)이 분명하므로 만든 쪽과 검사하는 쪽을 나누고 재시도 횟수를 정합니다.

  5. 이번 주 버그 신고가 몇 건 들어올지 모릅니다. 들어오는 대로 손이 빈 사람에게 배정하고, 막히면 다른 사람에게 넘깁니다.

    감독자. 일의 양과 배분이 실행 중에 바뀝니다. 미리 나눌 수 있다면 팬아웃으로 충분합니다.

  6. 연말 행사를 준비합니다. 총괄이 홍보팀장 · 운영팀장에게 나누고, 각 팀장이 다시 SNS·보도자료, 장소·등록 담당에게 나눕니다.

    계층적 위임. 큰 과제가 자연스럽게 위아래로 나뉩니다. 단계는 두 층까지만 두는 것이 좋습니다.

이제 실습 키트의 팀이 어떤 모양인지 Claude에게 판정시켜 봅니다.

Claude Code 입력창
이 폴더의 CLAUDE.md 와 .claude/agents/ 를 보고, 이 팀이 아래 여섯 가지 패턴 중
무엇을 어떻게 섞었는지 판정해줘. 근거가 되는 파일과 문장을 하나씩 짚어줘.
파이프라인 / 팬아웃·팬인 / 전문가 풀 / 생성·검증 / 감독자 / 계층적 위임

이런 답이 나오면 맞습니다. 큰 줄기는 파이프라인(요구분석 → 도메인 → 설계·관리 → 통합 → 검증), 그 가운데 설계와 관리를 동시에 하는 작은 팬아웃, 그리고 검증자가 전건 통과까지 수정을 돌리는 생성·검증입니다.

다음 세션으로 넘어가는 질문 이 다섯 명의 정의 파일과 스킬 세 개를 사람이 하나하나 썼다면 반나절은 걸렸을 겁니다. 세션 3에서는 이걸 한 문장으로 만듭니다. 작품 소개 영상을 만드는 팀이라면 어떤 모양이 어울릴지 미리 생각해 두세요.

Session 3 · 21:00~21:50 · 50분

showreel 하네스 만들기 → 실제 영상 만들기

내가 고른 책·영화·행사·게임을 소개하는 15초 showreel을 만듭니다. 30분 동안 내가 만든 하네스로 기획과 HTML 릴을 만들고, 12분 동안 내 업무에 필요한 스킬 하나를 같은 방법으로 만듭니다. 마지막 8분은 영상까지 만드는 showreel 스킬을 소개합니다. 실제 영상은 수업 뒤에 따라 합니다.

오늘 · 내 하네스로 만드는 showreel수업 이후 · showreel 스킬로 만드는 영상
만드는 쪽내가 “하네스 구성해줘”로 만든 4인 팀revfactory/showreel 스킬 (수업 이후 따라 하기에서 설치)
결과out/reel.html — 브라우저에서 재생되는 모션 릴 + 장면표out/<제목>.mp4 — 합성 음악이 들어간 1080p 영상
걸리는 시간팀 생성 5~10분 + 실행 10분 안팎설치 20분 + 15초 영상 기준 30~50분
보는 것팀의 모양 · 중간 산출물 · 검수 분리오디오 먼저 · 비평 반복 · 자동 검수
남의 작품을 다룰 때 포스터·표지·스틸·로고·게임 화면 같은 이미지는 쓰지 않습니다. 오늘 만드는 영상은 글자와 도형만으로 짓고, 개인 학습용으로 둡니다. 밖에 공개하려면 권리자의 허락이 필요할 수 있습니다.

Claude가 떠 있다면 /exit로 나온 뒤, PowerShell(Mac은 터미널)에서 새 실습 폴더를 만들고 Claude를 띄웁니다.

PowerShell
mkdir C:\aiguild\my-reel -Force; cd C:\aiguild\my-reel; claude

아래 칸을 채우면 그 아래 명령이 바로 바뀝니다. 채운 뒤 복사해서 Claude 입력창에 붙여 넣으세요. 하네스가 읽을 의뢰서(brief)가 파일로 생깁니다.

showreel 의뢰서

Claude Code 입력창 — 위 칸을 채우면 바뀝니다
아래 내용 그대로 brief.md 파일을 만들어줘. 내용은 고치지 마.

# brief — showreel 의뢰서

- 유형: 도서
- 제목: 생존을 위한 최소한의 AI 교양
- 만든 이: 조남호 (저자)
- 꼭 넣을 정보: AI Agent Guild 10월 세미나 북토크, 2026년 10월 29일(목) 19:00, 온라인
- 보는 사람: AI를 써 보고 싶지만 어디서 시작할지 모르는 직장인
- 분위기: 미니멀하고 또렷하게
- 길이: 15초
- 끝 화면 문구(CTA): 북토크에서 만나요
- 하지 말 것: 줄거리 반전·결말, 포스터·표지·스틸·로고 같은 저작물 이미지

사실을 모르는 칸은 비워 두세요. 하네스의 조사 담당이 찾고, 못 찾으면 지어내지 않고 빼는지가 오늘 확인할 것 중 하나입니다.

폴더 이름은 영문으로 한글이나 공백이 섞인 경로는 일부 도구에서 인식이 실패합니다. 파일 내용은 얼마든지 한글로 써도 됩니다.

그냥 “하네스 구성해줘”만 써도 동작합니다. 다만 그러면 플러그인이 되묻는 질문이 많아집니다. 도메인 · 입력 · 산출물 · 품질 기준을 미리 적어 주면 질문이 줄고 결과가 좋아집니다. 아래는 그대로 붙여 넣으면 됩니다.

Claude Code 입력창
하네스 구성해줘.
도메인: 도서·영화·행사·게임 같은 작품 하나를 소개하는 15~30초 showreel(모션 그래픽 티저)의 기획과 제작.
입력: brief.md (유형, 제목, 만든 이, 꼭 넣을 정보, 보는 사람, 분위기, 길이, 끝 화면 문구)
산출물:
- _workspace/01_research.md — 영상에 쓸 사실 목록. 항목마다 ID(R1, R2…), 출처 URL, 확실도
- _workspace/02_concept.md — 콘셉트 후보 3개를 같은 기준으로 비교하고 하나를 고른 이유
- out/storyboard.md — 장면표: 시작·끝 초, 화면 문구, 움직임, 쓰인 사실 ID
- out/reel.html — 브라우저에서 바로 재생되는 단일 HTML 모션 릴 (외부 이미지 없이 글자와 도형만)
- _workspace/04_review.md — 검수표
품질 기준:
- 화면에 나오는 사실(날짜·이름·수치·장소)은 모두 01_research.md 의 ID와 출처가 있어야 한다. 출처 없는 사실은 쓰지 않는다.
- 줄거리의 반전·결말은 쓰지 않는다.
- 포스터·표지·스틸·로고 같은 저작물 이미지는 쓰지 않는다.
- 장면 길이의 합이 brief 의 길이와 같고, 장면마다 글자가 읽힐 만큼 짧다.
에이전트는 4명 이내로 하고, 만드는 담당과 검수하는 담당을 반드시 분리해줘. 검수 담당은 고치지 말고 지적만 한다.
오케스트레이터 스킬 이름은 reel-studio 로 하고, 이 폴더에서는 /showreel 이라고 명시하지 않는 한
reel-studio 가 쓰이도록 CLAUDE.md 에 적어줘.

플러그인이 도메인을 분석하고, 팀 모양을 고르고, 파일을 씁니다. 중간에 확인 질문이 오면 짧게 답하고, 파일 쓰기 승인 창이 뜨면 경로가 .claude/나 CLAUDE.md인지 보고 승인하세요. 5~10분 정도 걸립니다.

마지막 두 줄을 넣는 이유 수업 뒤에 설치할 showreel 스킬도 “showreel”, “티저” 같은 말에 반응합니다. 두 도구가 서로 일을 가로채지 않도록, 하네스는 /reel-studio로, 영상 스킬은 /showreel로 이름을 불러 쓰게 정해 두는 것입니다.
10분이 넘도록 끝나지 않으면 — 백업 하네스

강사가 미리 만든 같은 구성의 하네스(에이전트 4명 + 스킬 2개)를 받아 바로 다음 단계로 가세요. 생성 과정은 집에서 다시 해 보면 됩니다. Claude를 /exit로 끈 뒤 my-reel 폴더에서 실행합니다. brief.md는 그대로 남습니다.

PowerShell · my-reel 폴더에서
curl.exe -L -o reel-backup.zip https://namojo.github.io/aiguild/templates/reel-backup.zip
Expand-Archive reel-backup.zip -DestinationPath . -Force
claude

브라우저로 reel-backup.zip을 받아 my-reel에 풀어도 됩니다. 풀면 CLAUDE.md, .claude/, brief.example.md가 생깁니다.

새로 생긴 에이전트와 스킬을 확실히 읽히도록 /exit로 껐다가 claude로 다시 띄웁니다. 그다음 팀을 봅니다.

Claude Code 입력창
/agents
my-reel/
├── brief.md              ← 입력 (1단계에서 만든 의뢰서)
├── CLAUDE.md             ← 언제 reel-studio 를 부르나 · 공통 규칙 · 변경 이력
└── .claude/
    ├── agents/           ← 조사 · 기획 · 제작 · 검수 (이름은 사람마다 다름)
    └── skills/           ← reel-studio(순서) + 릴 만드는 법 같은 도메인 스킬
brief.md 지적 → 해당 담당이 수정 · 최대 2회 조사사실 · 출처 기획콘셉트 · 장면표 제작HTML 릴 검수지적만 한다 01_research.md 02_concept.md storyboard.md reel.html 04_review.md 패턴: 파이프라인(조사 → 기획 → 제작 → 검수) + 끝 구간 생성·검증
백업 하네스(reel-backup.zip)의 팀. 세션 2 키트의 요구사항 인벤토리 자리에 여기서는 조사표·장면표가 있고, 검증자 자리에 검수 담당이 있습니다. 직접 만든 팀도 이름만 다를 뿐 이 모양이면 잘 만들어진 것입니다.

세션 2에서 본 눈으로 점검합니다.

Claude Code 입력창
방금 만든 하네스를 점검해줘. 표로 짧게.
1. 이 팀은 여섯 가지 패턴(파이프라인 / 팬아웃·팬인 / 전문가 풀 / 생성·검증 / 감독자 / 계층적 위임) 중 무엇을 섞었나
2. 검수 담당이 따로 있는가, 그 담당은 결과물을 직접 고치는가
3. 중간 산출물은 무엇이고, 다음 담당이 그것을 어떻게 받는가
4. 각 에이전트와 스킬의 description 에 "언제 쓰는지"가 적혀 있는가
  • 큰 줄기는 파이프라인(조사 → 기획 → 제작 → 검수), 끝에 생성·검증 반복이 붙어 있다. 조사를 여러 관점으로 나눴다면 팬아웃도 섞인 것
  • 검수 담당이 있고, 지적만 한다 (고치는 건 담당자 몫)
  • 단계 사이를 _workspace/의 파일로 넘긴다 — 세션 2의 요구사항 인벤토리와 같은 자리
  • description에 호출 조건이 적혀 있다. Claude는 이 한 줄을 보고 에이전트와 스킬을 고릅니다

이제 길게 설명할 필요가 없습니다. 폴더가 이미 다 알고 있습니다.

Claude Code 입력창
/reel-studio brief.md

조사 → 기획 → 제작 → 검수 담당이 차례로 붙는 것이 화면에 보입니다. 조사 담당이 웹 검색 승인을 물으면 허락하세요. 10분 안팎 걸립니다. 끝나면 결과를 엽니다.

Claude Code 입력창
out/reel.html 을 기본 브라우저로 열어줘.

브라우저에서 릴이 재생됩니다. R 처음부터, Space 일시정지, ← → 1초 이동입니다. (백업 하네스 기준. 직접 만든 하네스는 조작키가 다를 수 있습니다.) 브라우저가 안 열리면 파일 탐색기에서 C:\aiguild\my-reel\out\reel.html(Mac은 Finder에서 ~/aiguild/my-reel/out/reel.html)을 더블클릭하세요. 그다음 파일 세 개를 열어 보세요.

파일볼 것
_workspace/01_research.md사실마다 출처가 있는가. 못 찾은 정보는 확인 안 됨으로 남겼는가
_workspace/02_concept.md후보 세 개가 정말 서로 다른가, 고른 이유가 기준에 맞는가
out/storyboard.md화면의 날짜·이름에 사실 ID가 붙어 있는가, 마지막 장면에 끝 화면 문구가 있는가

화면에 그럴듯한 날짜나 수상 경력이 나왔는데 조사표에 없다면, 그게 바로 검수 담당이 잡아야 할 것입니다.

_workspace/04_review.md를 열어 검수 담당이 무엇을 지적했고, 누구에게 고치게 했고, 몇 회차에 통과했는지 봅니다. 그다음 마음에 들지 않는 장면 하나를 고쳐 달라고 해 보세요.

Claude Code 입력창 — [ ] 안을 바꾸세요
/reel-studio [2]번 장면을 [더 짧은 문구로, 글자가 한 자씩 찍히게] 바꿔줘.

고치는 요청 하나에도 기획 담당이 장면표를 고치고, 제작 담당이 그 장면만 다시 만들고, 검수 담당이 다시 봅니다. 사람이 프롬프트를 다시 쓰지 않아도 절차가 지켜지는 것이 하네스입니다.

3-B. 나에게 필요한 스킬을 하네스로 만들기 · 21:30~21:42

모든 일에 팀이 필요하지는 않습니다. 일 대부분은 한 사람이 매번 같은 방법으로 하는 일입니다. 그 방법을 파일로 꺼내 두면 Claude가 알맞은 때에 알아서 불러 씁니다. 그게 스킬입니다. 방금 쓴 백업 하네스의 reel-html(릴 만드는 법)이 그런 스킬이고, ad-edu의 크리에이티브 과정이 쓰는 quality-review(만들지 않고 판정만 하는 검수 매뉴얼)도 그렇습니다.

weekly-report/ SKILL.md · 머리말name · description SKILL.md · 본문절차 · 규칙 · 예시 · 모르면 멈출 곳 references/긴 자료 · 사전 scripts/계산 · 검사 1 항상 읽힌다이 한 줄을 보고 부를지 정한다 2 불렸을 때 읽힌다요청이 description과 맞으면 3 필요할 때만 꺼낸다본문이 가리킬 때만 연다
스킬은 폴더 하나입니다. Claude는 평소에 description 한 줄만 들고 있다가, 요청이 그 줄과 맞을 때 본문을 읽고, 본문이 가리킬 때만 긴 자료를 엽니다. 그래서 스킬이 많아도 느려지지 않고, description을 어떻게 쓰느냐가 불리느냐 마느냐를 정합니다.
스킬로 만든다에이전트(팀)로 만든다
무엇을 담나일하는 방법 — 절차 · 기준 · 양식 · 용어집그 방법을 쓰는 담당자 — 역할 · 경계 · 금지사항
언제 움직이나요청이 description과 맞으면 알아서오케스트레이터나 사용자가 부를 때
어울리는 일매번 같은 순서·기준으로 혼자 하는 반복 작업깊이 · 동시 진행 · 검증 분리가 필요한 일
예주간보고 양식 맞추기, 보도자료 초안, 사내 용어 통일오늘의 제안서 팀, showreel 팀

세션 1에서 떠올린 내 업무의 반복 작업을 고릅니다. 매번 같은 순서로 하고, 매번 같은 설명을 다시 하고 있다면 좋은 후보입니다. Claude를 /exit로 끄고, 새 폴더에서 띄웁니다.

PowerShell
mkdir C:\aiguild\my-skill -Force; cd C:\aiguild\my-skill; claude

아래 칸을 채우면 그 아래 프롬프트가 바뀝니다. 예시는 ‘흩어진 메모를 팀 주간보고 양식으로’입니다. 내 업무로 바꿔 써 보세요.

스킬 의뢰서

영문 소문자와 하이픈만 — 예: weekly-report, press-release
쉼표로 여러 개. 이 표현들이 description에 들어가 스킬을 부르는 열쇠가 됩니다

Claude Code 입력창 — 위 칸을 채우면 바뀝니다

플러그인이 스킬 하나와 짧은 CLAUDE.md를 만듭니다. 3~5분 걸리고, 되묻는 질문에는 짧게 답하면 됩니다. 마지막 줄의 “예시 입력과 기대 출력”이 중요합니다. 스킬 안에 정답 예시가 하나 있으면 결과가 그 모양으로 고정됩니다.

새 스킬이 확실히 읽히도록 /exit 후 claude로 다시 띄웁니다. 그다음 스킬 이름을 말하지 않고 평소 하던 말로 부탁합니다.

Claude Code 입력창 — 스킬 이름 없이

화면에 내 스킬을 불렀다는 줄(예: Skill(weekly-report))이 보이면 성공입니다. 결과에서 원문에 없는 내용이 ‘확인 필요’로 남았는지도 보세요. 스킬이 불리지 않았다면 십중팔구 description 문제입니다.

불리지 않았을 때

잘 불리면 개인 스킬 폴더로 옮겨 둡니다. 그러면 어느 폴더에서 Claude를 띄워도 이 스킬이 따라옵니다. Claude 입력창이 아니라 새 PowerShell(Mac은 터미널) 창에서 실행하세요.

PowerShell

마지막 줄에 SKILL.md가 보이면 제대로 옮겨진 것입니다. 써 보다가 아쉬운 점이 생기면 프롬프트를 다시 쓰지 말고 스킬을 고칩니다. 그 폴더에서 “하네스 회고해줘. [아쉬웠던 점]”이라고 하면 /harness:evolve가 피드백을 스킬에 반영하고 변경 이력을 남깁니다.

3-C. showreel 소개 — 끝까지 커진 하네스 · 21:42~21:50 · 시연 없음

오늘 만든 네 명짜리 팀이 계속 자라면 어떤 모습이 될까요. revfactory/showreel은 “신제품 티저 30초, 테크 키노트 느낌으로” 같은 요청 한 줄을 받아 MP4 영상 · 포스터 · 자막 · 제작노트까지 납품하는 Claude Code 스킬입니다. 스킬 하나지만 안을 열어 보면 오늘 배운 네 원리가 그대로, 훨씬 크게 들어 있습니다. 이 스킬로 만든 2분짜리 소개 영상은 여기서 받아 볼 수 있습니다(31MB).

0 환경 점검 → 1 요청 읽기(사실만 질문) → 2 콘셉트 후보 비교 → 3 조사 → 4 원고
→ 5 오디오 먼저(음악·효과음 → 타임라인) → 6 이미지 → 7 스타일 프레임 → 8 장면 제작
→ 9 초안 렌더 · 비평 반복 → 10 최종 렌더 · 믹스 → 11 자동 검수 · 납품 보고
원리오늘 만든 하네스showreel 스킬
역할 분리조사 · 기획 · 제작 · 검수 에이전트조사는 서브에이전트에 백그라운드로 맡기고, 본체는 다음 단계를 진행. 구간이 많으면 구간마다 나눠 동시에 제작
지식을 파일로릴 만드는 법을 적은 도메인 스킬references/에 단계별 문서 8개 — 구성, 오디오, 디자인, 한글 타이포그래피, 검수
중간 산출물_workspace/의 조사표 · 콘셉트 · 장면표concept.md · script.json · timeline.json — 장면은 초 단위 숫자 대신 이름 붙은 음악 큐를 읽어서, 소리를 바꿔도 화면을 고칠 필요가 없음
검증자 분리지적만 하는 검수 담당초안마다 비평 질문 여덟 개 + 만든 맥락이 없는 서브에이전트의 판정 + qa_check.py의 기계 측정

마지막 줄이 눈여겨볼 곳입니다. 모델이 판단해야 하는 품질(“템플릿처럼 보이는가”)은 비평 질문으로, 숫자로 잴 수 있는 품질(음량 -14 LUFS, 광과민성 섬광, 멈춘 화면)은 스크립트로 나눠 맡깁니다. 판단은 스킬에, 측정은 도구에입니다. 내 하네스에 무엇을 더하면 좋을지 보이지 않나요?

오늘은 소개만 하는 이유 15초짜리 영상도 30~50분이 걸리고, ffmpeg · Node.js · Python · 브라우저 설정이 더 필요합니다. 수업 시간은 하네스를 만들고 점검하는 데 씁니다. 오늘 만든 my-reel 폴더의 조사표와 장면표를 그대로 넘겨 영상을 만드는 방법은 아래 수업 이후 따라 하기에 순서대로 정리해 두었습니다.
(선택 · 시간이 남으면) 오늘 본 것을 내 하네스에 되먹이기

아쉬운 점이 있으면 프롬프트를 고치는 대신 하네스를 고칩니다. 플러그인의 /harness:evolve가 맡는 일입니다. showreel처럼 검수에 기계 측정을 붙여 보세요.

Claude Code 입력창
하네스 회고해줘. 검수 단계에 기계로 재는 점검을 더하고 싶어.
reel.html 의 장면 시간 합계, 장면별 글자 수, 외부 이미지 사용 여부를
스크립트로 검사해서 검수 담당이 그 결과를 근거로 쓰게 해줘.

어느 에이전트와 스킬이 바뀌었는지, CLAUDE.md 변경 이력에 한 줄이 추가됐는지 보세요.

수업 이후 · 집에서 · 1시간 안팎

showreel로 실제 영상 만들기

세션 3에서 만든 my-reel 폴더를 그대로 씁니다. 하네스가 만든 조사표와 장면표를 showreel 스킬에 넘겨 15초 MP4를 만듭니다. 설치 20분, 제작 30~50분 정도 걸립니다.

시작 전에 알아 두세요 렌더와 비평 반복에 사용량을 꽤 씁니다. Pro 요금제라면 다른 작업이 없는 시간에 하세요. 오늘처럼 나레이션과 AI 이미지 없이 타이포그래피·그래픽·합성 음악으로 만들므로 ElevenLabs 키나 Codex CLI는 필요 없습니다.

revfactory/showreel은 한국어 모션그래픽 영상을 기획부터 납품까지 만드는 Claude Code 스킬입니다. 영상으로 렌더하려면 ffmpeg · Node.js · Python(numpy, Pillow) · Chrome 계열 브라우저가 필요합니다. Claude 입력창이 아니라 PowerShell(Mac은 터미널)에서 실행합니다. 블록마다 다 끝나면 창을 새로 열고 다음 블록으로 갑니다.

① 도구 세 가지 설치

PowerShell ①
winget install --id Gyan.FFmpeg -e
winget install --id OpenJS.NodeJS.LTS -e
winget install --id Python.Python.3.12 -e --override "/quiet InstallAllUsers=0 PrependPath=1 Include_launcher=1"

약관 동의를 물으면 Y를 누릅니다. 이미 설치된 것은 건너뜁니다. 끝나면 PowerShell 창을 새로 엽니다.

② showreel 받기 · python3 이름 만들기 · 렌더 브라우저 지정

PowerShell ② · 통째로 붙여 넣기
# 1) showreel 스킬과 렌더러 의존성
git clone https://github.com/revfactory/showreel.git "$env:USERPROFILE\.claude\skills\showreel"
cd "$env:USERPROFILE\.claude\skills\showreel\scripts"; npm.cmd install
py -3 -m pip install numpy pillow

# 2) showreel 은 스크립트를 python3 로 부릅니다. 같은 Python 을 python3 이름으로도 쓰게 합니다.
$exe = py -3 -c "import sys; print(sys.executable)"
$dir = Split-Path $exe
Copy-Item $exe "$dir\python3.exe" -Force
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
if ($userPath -notlike "*$dir;*") { [Environment]::SetEnvironmentVariable("Path", "$dir;$dir\Scripts;$userPath", "User") }

# 3) 렌더에 쓸 브라우저 — Chrome 이 있으면 Chrome, 없으면 Windows 기본 Edge
$browser = @("$env:ProgramFiles\Google\Chrome\Application\chrome.exe",
             "${env:ProgramFiles(x86)}\Google\Chrome\Application\chrome.exe",
             "$env:LOCALAPPDATA\Google\Chrome\Application\chrome.exe",
             "${env:ProgramFiles(x86)}\Microsoft\Edge\Application\msedge.exe",
             "$env:ProgramFiles\Microsoft\Edge\Application\msedge.exe") | Where-Object { Test-Path $_ } | Select-Object -First 1
[Environment]::SetEnvironmentVariable("REEL_CHROME_PATH", $browser, "User")
"렌더 브라우저: $browser"

마지막 줄에 브라우저 경로가 나오면 성공입니다. 다시 PowerShell 창을 새로 열고 A2단계로 갑니다.

“npm.ps1 파일을 로드할 수 없습니다” · “스크립트를 실행할 수 없습니다”가 나오면
PowerShell의 실행 정책 때문입니다. 위 블록처럼 npm 대신 npm.cmd로 쓰면 정책을 바꾸지 않고 넘어갑니다.
py 명령을 찾을 수 없다고 나오면
①의 Python 설치가 끝나지 않았거나 창을 새로 열지 않은 경우입니다. 새 PowerShell에서 py --version을 확인하고, 안 나오면 ①의 세 번째 줄만 다시 실행하세요.

오늘은 나레이션과 AI 이미지 없이 타이포그래피·그래픽·합성 음악으로 만듭니다. 그래서 ElevenLabs 키나 Codex CLI는 없어도 됩니다.

showreel이 직접 제공하는 점검 스크립트입니다. 새 창에서 실행하세요. Windows에서는 첫 줄로 python3 이름이 제대로 잡혔는지도 함께 확인합니다.

PowerShell
python3 --version
python3 "$env:USERPROFILE\.claude\skills\showreel\scripts\preflight.py"

첫 줄에 Python 3.12.x처럼 버전이 나와야 합니다. 대신 Microsoft Store가 열리거나 “Python was not found”가 나오면 설정 → 앱 → 고급 앱 설정 → 앱 실행 별칭에서 python3.exe(앱 설치 관리자) 두 개를 끔으로 바꾸고 창을 새로 연 뒤 다시 실행하세요.

줄오늘 필요한가
node · ffmpeg · Chrome · playwright-core · python numpy·Pillow모두 ✓여야 합니다 (Windows에서 Edge를 지정했어도 Chrome 줄이 ✓로 나옵니다)
ElevenLabs · codex-image · 누끼(swiftc)✗여도 됩니다 (나레이션·이미지 없이 만듭니다. 누끼는 Mac 전용)

✗인 필수 줄이 있으면 오른쪽에 설치 방법이 나옵니다. Mac 기준 명령(brew)으로 안내되더라도 Windows에서는 A1단계의 해당 줄을 다시 실행하면 됩니다.

세션 3의 my-reel 폴더에서 Claude를 띄웁니다. 새로 설치한 스킬을 읽도록 꼭 새 창에서 띄우세요.

PowerShell
cd C:\aiguild\my-reel; claude

showreel을 이름으로 불러 하네스의 결과를 넘깁니다. 하네스 쪽은 /reel-studio, 영상 쪽은 /showreel로 나눠 두었기 때문에 서로 일을 가로채지 않습니다.

Claude Code 입력창
/showreel brief.md 의 작품을 소개하는 15초 영상을 만들어줘.
- 사실은 _workspace/01_research.md 에 출처가 있는 것만 써. 새로 조사하면 출처를 남겨.
- out/storyboard.md 를 출발점으로 삼되, 더 강한 콘셉트가 있으면 바꿔도 돼.
- 나레이션 없이, AI 이미지 생성 없이, 타이포그래피와 그래픽과 합성 음악으로.
- 포스터·표지·스틸·로고 같은 저작물 이미지는 쓰지 마.
- 이 PC가 Windows 라면 셸 명령은 Git Bash 기준으로 쓰고, 스크립트는 python3 로 실행해.

처음에 사용자만 아는 사실(예: 행사의 정확한 일시)을 한두 개 물을 수 있습니다. 답하고 나면 납품까지 묻지 않고 진행합니다. 승인 창이 뜨면 경로가 my-reel 안이거나 showreel 스킬 폴더(.claude\skills\showreel)의 스크립트인지 보고 승인하세요.

30~50분 동안 PC를 깨워 두세요 전원을 연결하고, 노트북 덮개를 닫지 말고, Claude를 띄운 창을 끄지 마세요. Windows는 잠시 자리를 비우면 절전 모드로 들어갈 수 있습니다. 중간에 끊겼다면 같은 폴더에서 Claude를 다시 띄워 “이어서 해줘”라고 하면 남은 단계부터 이어 갑니다.

작업은 my-reel 아래에 영문 이름의 새 폴더를 만들어 진행합니다. 기다리는 동안 파일이 생기는 순서대로 열어 보세요.

생기는 파일무엇인가내 하네스의 어디와 같은가
concept.md콘셉트 후보를 같은 기준으로 비교하고 고른 기록02_concept.md
research/research.md영상에 넣을 사실과 출처·확실도01_research.md
timeline.json음악의 박자·히트를 이름 붙은 큐로 바꾼 것. 장면은 초 대신 큐를 읽음장면표의 시작·끝 초
qa/critique_01.md초안을 렌더해 질문 여덟 개로 스스로 비평. 구간마다 유지·고침·다시 만듦04_review.md
qa/qa_report.md음량(-14 LUFS)·섬광·멈춘 화면을 스크립트로 잰 검수— (내 하네스에 없는 것)
out/<제목>.mp4완성 영상 · 공유용 경량본 · 포스터out/reel.html

영상이 나오면 직접 소리를 켜고 들어 보세요. Claude는 소리를 듣지 못하고 음량을 숫자로만 확인합니다. 남의 작품으로 만든 영상은 개인 학습용으로 두세요.

Windows에서 막힐 때
  • python3를 찾을 수 없다 · Microsoft Store가 열린다 — A2단계의 앱 실행 별칭 끄기를 하고 창을 새로 연 뒤, Claude를 다시 띄우세요.
  • Chrome · 브라우저를 띄우지 못했다 — A1단계 ②의 3)번(렌더 브라우저 지정)을 다시 실행하고, PowerShell과 Claude를 모두 새로 띄우세요.
  • ffmpeg를 찾을 수 없다 — A1단계 ①의 첫 줄을 다시 실행하고 창을 새로 여세요.
  • 그래도 막히면 Claude에게 오류 메시지를 그대로 보여 주고 “이 PC는 Windows야. 원인을 찾아 고쳐줘”라고 하세요. 설치 경로나 명령 이름 차이는 대부분 그 자리에서 해결합니다.

다음 단계

내 업무로 옮기기

3-B에서 스킬로 만든 일이 혼자 하는 반복 작업이었다면, 깊이나 검증 분리가 필요한 일은 팀으로 만듭니다. 세션 3의 2단계 프롬프트와 같은 모양입니다. 만들기 전에 세션 2의 단계 판정기로 정말 팀이 필요한 일인지 먼저 따져 보세요.

내 업무용 — [ ] 안을 바꾸세요
하네스 구성해줘.
도메인: [무슨 일인가, 얼마나 자주 하는가]
입력: [어떤 파일이 어디에 있는가]
산출물: [무엇이 어디에 어떤 형식으로 나와야 하는가 — 중간 산출물도 적기]
품질 기준: [무엇이 틀리면 안 되는가, 무엇을 지어내면 안 되는가]
에이전트는 3~5명으로 하고, 결과를 원본과 대조해 검증하는 담당을 반드시 포함해줘.

가장 공들일 곳은 산출물과 품질 기준 두 줄입니다. 이 둘이 흐리면 팀이 아무리 많아도 결과가 흔들립니다. 실습은 공개 자료로 하고, 회사의 실제 데이터에 쓰기 전에는 보안 규정을 먼저 확인하세요.

더 배우고 싶다면

자료무엇을 하나
revfactory/harness플러그인 원본. 오늘 본 여섯 가지 패턴, 실행 모드 세 가지, 적대적 검증 같은 품질 패턴과 /harness:evolve의 동작이 문서로 정리돼 있습니다.
Harness Ad Academy광고 실무자를 위한 8개 과정 + 선택 과정. 과정마다 여섯 패턴 중 하나를 가상 브랜드 ‘제로톡’으로 끝까지 풀어, 팀 구성 · 실행 프롬프트 · 완성 산출물을 그대로 보여 줍니다. 광고가 아닌 직무도 패턴 교재로 읽기 좋습니다.
스킬 작성 가이드harness 플러그인이 스킬을 만들 때 따르는 기준. description 쓰는 법, 본문과 references를 나누는 법(필요할 때만 읽히게), 스킬 시험 방법이 정리돼 있습니다.
revfactory/harness-100이미 만들어진 하네스 100개. 내 업무와 비슷한 것을 골라 .claude만 복사해 고쳐 쓰는 것이 처음부터 만드는 것보다 빠릅니다.
revfactory/showreel스킬 하나로 된 대형 하네스의 실제 예. SKILL.md와 references/를 읽는 것만으로도 공부가 됩니다. ElevenLabs 키가 있으면 나레이션도 넣을 수 있습니다.

자주 막히는 곳

/plugin install을 했는데 “하네스 구성해줘”에 반응이 없습니다
/exit로 나갔다가 claude로 다시 들어오세요. 새로 깐 플러그인은 재시작해야 읽힙니다. /plugin에서 harness가 보이는지, 설치 범위가 User인지도 확인하세요. Project로 설치했다면 다른 폴더에서는 보이지 않습니다.
.docx 파일을 못 읽는다고 합니다
Session 0의 5단계에서 document-skills를 깔았는지 확인하세요. 깔았는데도 그렇다면 Claude를 재시작한 뒤 다시 시켜 보세요.
만든 스킬이 불리지 않습니다
세 가지를 보세요. ① 만든 뒤 /exit → claude로 다시 띄웠는가. ② 스킬 폴더가 .claude\skills\이름\SKILL.md 구조인가(한 겹 더 들어가 있거나 파일 이름이 다르면 못 찾습니다). ③ description에 내가 실제로 하는 말이 들어 있는가. 3-B의 7단계 “불리지 않았을 때” 프롬프트로 description을 고치면 대부분 해결됩니다.
/reel-studio 를 찾을 수 없다고 합니다
/exit 후 my-reel 폴더에서 claude를 다시 띄우세요. 그래도 없으면 하네스가 스킬 이름을 다르게 지은 것입니다. .claude/skills/ 아래 폴더 이름을 확인해 그 이름으로 부르거나, 백업 하네스를 받으세요.
/reel-studio 를 불렀는데 showreel 스킬이 대신 움직입니다 (또는 그 반대)
두 도구 모두 “showreel·티저”라는 말에 반응할 수 있습니다. 대화를 /clear로 비우고 이름을 맨 앞에 붙여 다시 부르세요. 직접 만든 하네스라면 “이 폴더에서는 /showreel 이라고 명시하지 않는 한 reel-studio 를 쓰라고 CLAUDE.md 에 적어줘”라고 고치면 됩니다.
플러그인이 질문을 너무 많이 하거나, 에이전트가 6명 넘게 만들어집니다
2단계 프롬프트의 도메인 · 입력 · 산출물 · 품질 기준과 “4명 이내”가 들어갔는지 확인하세요. 사람이 많다고 좋은 팀이 아닙니다. 특히 검수 담당이 제작 담당 안에 흡수돼 있지 않은지 보세요. 그러면 만든 쪽이 스스로 승인하는 구조가 됩니다.
Mac에서 pip 설치가 “externally-managed-environment” 오류를 냅니다
Homebrew로 깐 Python은 pip로 직접 설치하는 것을 막습니다. 수업 이후 A1단계처럼 brew install numpy pillow로 설치하세요. 그다음 preflight.py를 다시 실행해 numpy·Pillow 줄이 ✓인지 봅니다.
영상이 너무 오래 걸립니다
정상입니다. showreel은 시간에 맞추려고 비평 반복을 줄이지 않습니다. 터미널을 열어 둔 채 기다리면 끝까지 갑니다. 중간에 끊겼다면 같은 폴더에서 Claude를 다시 띄워 “이어서 렌더해줘”라고 하면 남은 단계부터 이어 갑니다.
Windows에서 curl 명령이 이상한 오류를 냅니다
Windows PowerShell에서 curl은 다른 명령의 별칭입니다. curl.exe로 쓰세요. 그래도 안 되면 브라우저로 zip 파일을 받아 해당 폴더에 풀면 됩니다.
/clear와 /exit가 헷갈립니다
/clear는 대화만 지우고 Claude는 그대로 떠 있습니다. 앞의 맥락 없이 새 일을 시킬 때 씁니다. /exit는 Claude를 끄는 것입니다. 플러그인을 새로 깔았거나 .claude/ 파일이 새로 생겼을 때는 껐다 켜야 확실히 반영됩니다.
승인 창이 계속 떠서 진행이 더딥니다
/permissions에서 자주 쓰는 동작을 허용 목록에 넣을 수 있습니다. 다만 실습 중에는 기본값을 권합니다. 에이전트가 무엇을 하려는지 보는 것이 오늘 배울 것의 일부이고, 특히 파일을 지우거나 옮기려는 시도는 꼭 눈으로 보세요.