파이프라인
Pipeline- 모양
- 정해진 순서대로 넘긴다
- 어울림
- 앞 결과가 있어야 다음이 되는 일 — 소설: 세계관 → 인물 → 줄거리 → 집필 → 편집
- 주의
- 한 단계가 늦으면 전체가 늦는다
C8광고 실무 사례 — 콘텐츠·SNS 제작 하네스 · 기획부터 썸네일까지 한 줄로 잇기
AI Agent Guild 10월 세미나 · 『생존을 위한 최소한의 AI 교양』 조남호 저자와 함께하는
AI를 이해하는 대화에서, 하네스로 일을 맡기는 경험까지.
북토크에서 AI에 대한 질문을 나눈 뒤, 나머지 실습은 이 페이지 하나로 진행합니다.
먼저 단일 에이전트와 멀티 에이전트가 무엇이 다른지, 왜 하네스가 필요한지, 팀을 짜는 여섯 가지 모양을 실습 키트로 확인합니다.
그다음 내가 고른 책·영화·행사·게임을 소개하는 showreel 하네스를 한 문장으로 만들어 돌립니다. 수업이 끝난 뒤에는 같은 기획으로 실제 영상까지 만들 수 있게 따라 하기 안내를 담았습니다.
코딩은 필요 없습니다. 모든 명령은 복사해서 붙여 넣으면 됩니다.
Agenda
| 시간 | 프로그램 | 내용 |
|---|---|---|
| 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:30 | showreel 하네스 | 작품 고르기 · “하네스 구성해줘” · HTML 릴 만들기 |
| 21:30~21:42 | 내 스킬 만들기 | 내 업무의 반복 작업을 스킬로 · 정말 불리는지 시험 |
| 21:42~21:50 | showreel 소개 | 요청 한 줄이 영상이 되는 대형 하네스 · 수업 뒤 따라 하기 안내 |
| 21:50~22:00 | Q&A 및 마무리 | 실습 질문 · 내 업무로 옮기기 |
Session 0 · 세미나 전에 · 15분
Claude Code는 Claude Pro 이상 구독 계정으로 로그인합니다. 무료 계정으로는 실습이 되지 않습니다. 아직 없다면 claude.ai에서 가입하고 구독을 켜 두세요.
GPU나 고사양 컴퓨터는 필요 없습니다. 모델은 Claude 쪽에서 돌고, 내 노트북은 파일을 읽고 쓰는 일만 합니다.
Windows에서 Claude Code는 Git과 함께 설치되는 Git Bash로 명령을 실행하므로 꼭 필요합니다. 이미 있다면 확인만 하고 넘어가세요.
winget install --id Git.Git -e --source winget
설치가 끝나면 PowerShell 창을 새로 열고 git --version으로 확인합니다.
git --version
버전이 나오면 끝입니다. 처음 실행하는 Mac이라면 개발자 도구 설치 창이 뜨는데, 설치를 누르고 기다리면 됩니다.
한 줄 설치입니다.
irm https://claude.ai/install.ps1 | iex
끝나면 PowerShell 창을 새로 열고 claude --version으로 확인합니다.
설치 경로가 PATH에 등록되지 않은 경우입니다. 아래를 붙여 넣고 PowerShell 창을 다시 여세요.
$claudePath = "$env:USERPROFILE\.local\bin"
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
if ($userPath -notlike "*$claudePath*") {
[Environment]::SetEnvironmentVariable("Path", "$userPath;$claudePath", "User")
}
curl -fsSL https://claude.ai/install.sh | bash
끝나면 터미널 창을 새로 열고 claude --version으로 확인합니다.
claude
처음 실행하면 브라우저가 열립니다. 1단계의 Claude 계정으로 로그인하면 터미널에 입력창이 뜹니다. “안녕”이라고 한 번 걸어 보고 답이 오면 성공입니다. 아직 창을 닫지 마세요. 다음 단계에서 이 입력창을 씁니다.
Claude Code 입력창 안에서 한 줄씩 붙여 넣고 Enter를 누릅니다. 첫 두 줄이 오늘의 주인공인 revfactory/harness, 뒤의 두 줄은 Word·PDF 같은 문서를 읽고 쓰게 해 주는 Anthropic 공식 문서 스킬입니다.
/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분
지식 노동의 스푸트니크 쇼크에서 에이전트 시대의 생존 전략까지. 기술이 도구에서 충격이 되는 순간 무엇이 바뀌는지, 그 변화 앞에서 개인과 조직은 무엇을 준비해야 하는지 저자와 이야기합니다.
| 에이전트 운용 능력 | 오늘 실습에서 |
|---|---|
| 문제 분해력 — 큰 일을 실행 가능한 단위로 | 세션 2 · 역할 나누기와 여섯 가지 팀 패턴 |
| 맥락 제공력 — 목표·제약·자료를 구조화 | 세션 3 · brief.md, CLAUDE.md, 스킬 의뢰서 |
| 병렬 실행력 — 여러 에이전트를 동시에 | 세션 2 · 팬아웃과 서브에이전트 |
| 검증·테스트 능력 — 사실·품질 기준으로 점검 | 세션 2·3 · 검증자 분리, 출처 대조, 스킬이 정말 불리는지 시험 |
| 사용자 이해력 — 누구에게 어떤 가치인가 | 세션 3 · showreel 의뢰서의 ‘보는 사람’과 끝 화면 문구 |
| 책임 있는 결정력 — 최종 승인은 사람이 | 모든 세션 · 승인 창 3초 점검, 검수표를 읽고 고칠지 정하기 |
세션 3에서 내가 고른 작품의 15초 소개 영상을 만듭니다. 좋아하는 책, 다시 보고 싶은 영화, 우리 팀 행사, 기다리는 게임 무엇이든 됩니다. 떠오르지 않으면 오늘의 책 『생존을 위한 최소한의 AI 교양』으로 하세요. 예시가 그 책으로 채워져 있습니다.
그리고 머릿속 한쪽에는 내 업무의 반복 작업 하나를 올려 두세요. 마무리에서 같은 방법으로 옮겨 봅니다.
Session 2 · 20:00~20:50 · 50분
에이전트는 목표를 받으면 스스로 파일을 읽고, 명령을 실행하고, 결과를 보고 다음 행동을 고르는 AI입니다. Claude Code가 그렇습니다. 이 에이전트 한 명에게 일을 통째로 맡길 수도 있고, 여러 명에게 나눠 맡길 수도 있습니다.
한 명이 하나의 대화 안에서 처음부터 끝까지
본체가 일을 나눠 맡기고 결과만 받는다
여기서 쓰는 말 세 개만 알아 두세요.
| 단계 | 비유 | 방식 | 다음 달에도 같은 품질? |
|---|---|---|---|
| L1 · 혼자 | 유능한 인턴 한 명 | 지시 하나로 처음부터 끝까지 (단일 에이전트) | 사람이 매번 다시 설명 |
| L2 · 팀 | 그때그때 모은 전문가들 | 나눠 맡기고 취합·검증 (멀티 에이전트) | 나누는 방법을 매번 다시 지시 |
| L3 · 시스템 | 직무기술서가 있는 팀 | 역할·절차·규칙·검증을 파일로 남긴 멀티 에이전트 = 하네스 | 같은 한 줄이면 됨 |
L1과 L3의 실행 명령은 둘 다 한 줄입니다. 차이는 명령의 길이가 아니라 그 한 줄이 기대고 있는 파일의 양입니다. 하네스는 이렇게 짜여 있습니다. 바로 다음에 여는 실습 키트가 이 구조입니다.
입력은 나라장터에 실제로 올라온 과업지시서 한 건입니다. 병원 진료기록을 연계하는 사업인데, 문서에는 FHIR, KCD-8, 심평원 EDI, 가명화 같은 말이 이름만 나옵니다. 보건의료 데이터를 모르는 사람이 이 문서로 제안서를 써야 합니다. 낯선 부서의 요청이나 처음 보는 규격을 받아 든 날과 같은 조건입니다.
| 트랙 A · 단일 에이전트 | 트랙 B · 하네스(멀티 에이전트) | |
|---|---|---|
| 지시 | “과업지시서로 제안서를 작성해줘” 한 번 | 전문가 5명이 순서대로·동시에 나눠 쓰고 검증 |
| 결과 | 제안서A_단일패스.docx (3쪽) | 제안서B_하네스.docx (8쪽) |
두 결과물과 트랙 B를 만든 팀이 키트에 이미 들어 있습니다. 트랙 B를 처음부터 돌리면 20~40분이 걸리므로, 오늘은 만들어진 결과를 뜯어보는 데 시간을 씁니다.
Claude 입력창이 아니라 PowerShell(Mac은 터미널)에서 실행합니다. Claude가 떠 있다면 /exit로 먼저 나오세요.
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로 써야 합니다.
mkdir -p ~/aiguild && cd ~/aiguild
curl -L -o proposal-ab.zip https://namojo.github.io/aiguild/templates/proposal-ab.zip
unzip -o proposal-ab.zip
cd proposal-ab && claude
브라우저로 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:\에서 띄우지 마세요.
제안서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가 더 좋은 문장을 써서 이긴 게 아닙니다. 중간에 만든 파일 하나에서 차이가 시작됐습니다.
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를 만든 팀이 이 폴더에 그대로 들어 있습니다. 먼저 등록된 에이전트를 봅니다.
/agents
다섯 명이 보이면 Esc로 닫고, 구성 전체를 설명해 달라고 합니다.
이 폴더의 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에서 내가 만든 팀을 볼 때 이 네 가지를 같은 눈으로 봅니다.
그리고 A가 이기는 경우도 있습니다. 내부 검토용 초안이나 참고용 요약이라면 단일 에이전트의 속도가 정답입니다. 하네스의 진짜 비용은 실행이 아니라 처음 설계에 있으니, 반복이 없거나 누락의 대가가 작으면 만들 이유가 없습니다. 내 업무 하나를 넣어 판정해 보세요.
내 업무는 몇 단계짜리 일인가
점수를 고르면 판정이 나옵니다.
세션 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로 충분하다는 것도 결론입니다.
멀티 에이전트 팀에는 정해진 모양이 있습니다. harness 플러그인은 “하네스 구성해줘”를 받으면 일의 흐름을 분석해 아래 여섯 가지 중에서 고르거나 섞습니다. 외울 필요는 없지만, 만들어진 팀을 보고 “아, 이 모양이구나” 알아보면 점검이 쉬워집니다. 카드 아래에는 광고 실무자를 위한 Harness Ad Academy에서 그 패턴을 한 과정 전체로 풀어 둔 사례를 달았습니다. 가상 브랜드 ‘제로톡’으로 팀 구성, 실행 프롬프트, 완성 산출물까지 볼 수 있습니다.
C8광고 실무 사례 — 콘텐츠·SNS 제작 하네스 · 기획부터 썸네일까지 한 줄로 잇기
C3광고 실무 사례 — 리서치·인사이트 하네스 · 하루 걸리던 조사를 동시에 나눠 한 시간에
C5광고 실무 사례 — 퍼포먼스 마케팅 하네스 · 채널별 전문가를 골라 불러 한 장의 리포트로
C4광고 실무 사례 — 크리에이티브 제작 하네스 · 카피·비주얼을 팀으로 뽑고 검수
C7광고 실무 사례 — 미디어·캠페인 플래닝 하네스 · 감독자가 캠페인 전체를 지휘
C6광고 실무 사례 — 브랜드 스케일업·커머스 하네스 · 제품 기획부터 유통·런칭까지 위임
실제 팀은 섞어 씁니다. 예를 들어 “파이프라인인데 그중 한 단계만 팬아웃”, “팬아웃으로 만들고 각각 생성·검증” 같은 식입니다. 플러그인은 모양과 함께 어떻게 돌릴지(실행 모드)도 고릅니다. 팀 크기가 아니라 일의 흐름이 기준입니다.
| 실행 모드 | 어떻게 도나 | 언제 |
|---|---|---|
| 워크플로 조율 | 순서·병렬·검증 반복을 스크립트로 정해 두고 그대로 실행 | 흐름을 미리 정할 수 있고, 항목이 많고, 결과 형식이 정해진 일 |
| 지속형 에이전트 협업 | 이름 붙은 담당자가 대화를 이어 가며 메시지를 주고받음 | 피드백을 주고받으며 다듬는 일, 오래 맥락을 쥐고 있어야 하는 전문가 |
| 서브에이전트 위임 | 그때그때 담당자를 불러 한 번 맡기고 결과만 받음 | 결과만 있으면 되는 가벼운 위임 (오늘 실습은 대부분 이것) |
여섯 가지 일에 어울리는 모양을 골라 보세요. 답은 하나가 아닐 수 있지만, 가장 잘 맞는 것을 고르면 됩니다.
패턴 퀴즈
해외 기사 한 편을 번역 → 감수 → 편집 → 게시합니다. 앞 단계가 끝나야 다음 단계를 할 수 있습니다.
파이프라인. 각 단계가 앞 단계 산출물에 의존합니다. 실습 키트의 제안서 팀도 큰 줄기는 이 모양입니다.
신제품 반응을 뉴스 · 커뮤니티 · 리뷰 영상에서 동시에 조사해 보고서 한 편으로 합칩니다.
팬아웃 · 팬인. 세 조사는 서로를 기다릴 필요가 없고, 마지막에 하나로 합칩니다.
고객 문의가 결제 · 배송 · 기술 중 무엇인지 먼저 가려, 해당 담당자 한 명에게만 넘깁니다.
전문가 풀. 모두를 부르지 않고 분류 결과에 맞는 전문가만 호출합니다. 분류가 틀리면 전체가 틀립니다.
건강기능식품 광고 문구를 쓰고, 표시·광고 규정 위반이 있으면 다시 쓰게 합니다.
생성 · 검증. 판정 기준(규정)이 분명하므로 만든 쪽과 검사하는 쪽을 나누고 재시도 횟수를 정합니다.
이번 주 버그 신고가 몇 건 들어올지 모릅니다. 들어오는 대로 손이 빈 사람에게 배정하고, 막히면 다른 사람에게 넘깁니다.
감독자. 일의 양과 배분이 실행 중에 바뀝니다. 미리 나눌 수 있다면 팬아웃으로 충분합니다.
연말 행사를 준비합니다. 총괄이 홍보팀장 · 운영팀장에게 나누고, 각 팀장이 다시 SNS·보도자료, 장소·등록 담당에게 나눕니다.
계층적 위임. 큰 과제가 자연스럽게 위아래로 나뉩니다. 단계는 두 층까지만 두는 것이 좋습니다.
이제 실습 키트의 팀이 어떤 모양인지 Claude에게 판정시켜 봅니다.
이 폴더의 CLAUDE.md 와 .claude/agents/ 를 보고, 이 팀이 아래 여섯 가지 패턴 중
무엇을 어떻게 섞었는지 판정해줘. 근거가 되는 파일과 문장을 하나씩 짚어줘.
파이프라인 / 팬아웃·팬인 / 전문가 풀 / 생성·검증 / 감독자 / 계층적 위임
이런 답이 나오면 맞습니다. 큰 줄기는 파이프라인(요구분석 → 도메인 → 설계·관리 → 통합 → 검증), 그 가운데 설계와 관리를 동시에 하는 작은 팬아웃, 그리고 검증자가 전건 통과까지 수정을 돌리는 생성·검증입니다.
Session 3 · 21:00~21:50 · 50분
| 오늘 · 내 하네스로 만드는 showreel | 수업 이후 · showreel 스킬로 만드는 영상 | |
|---|---|---|
| 만드는 쪽 | 내가 “하네스 구성해줘”로 만든 4인 팀 | revfactory/showreel 스킬 (수업 이후 따라 하기에서 설치) |
| 결과 | out/reel.html — 브라우저에서 재생되는 모션 릴 + 장면표 | out/<제목>.mp4 — 합성 음악이 들어간 1080p 영상 |
| 걸리는 시간 | 팀 생성 5~10분 + 실행 10분 안팎 | 설치 20분 + 15초 영상 기준 30~50분 |
| 보는 것 | 팀의 모양 · 중간 산출물 · 검수 분리 | 오디오 먼저 · 비평 반복 · 자동 검수 |
Claude가 떠 있다면 /exit로 나온 뒤, PowerShell(Mac은 터미널)에서 새 실습 폴더를 만들고 Claude를 띄웁니다.
mkdir C:\aiguild\my-reel -Force; cd C:\aiguild\my-reel; claude
mkdir -p ~/aiguild/my-reel && cd ~/aiguild/my-reel && claude
아래 칸을 채우면 그 아래 명령이 바로 바뀝니다. 채운 뒤 복사해서 Claude 입력창에 붙여 넣으세요. 하네스가 읽을 의뢰서(brief)가 파일로 생깁니다.
showreel 의뢰서
아래 내용 그대로 brief.md 파일을 만들어줘. 내용은 고치지 마.
# brief — showreel 의뢰서
- 유형: 도서
- 제목: 생존을 위한 최소한의 AI 교양
- 만든 이: 조남호 (저자)
- 꼭 넣을 정보: AI Agent Guild 10월 세미나 북토크, 2026년 10월 29일(목) 19:00, 온라인
- 보는 사람: AI를 써 보고 싶지만 어디서 시작할지 모르는 직장인
- 분위기: 미니멀하고 또렷하게
- 길이: 15초
- 끝 화면 문구(CTA): 북토크에서 만나요
- 하지 말 것: 줄거리 반전·결말, 포스터·표지·스틸·로고 같은 저작물 이미지
사실을 모르는 칸은 비워 두세요. 하네스의 조사 담당이 찾고, 못 찾으면 지어내지 않고 빼는지가 오늘 확인할 것 중 하나입니다.
그냥 “하네스 구성해줘”만 써도 동작합니다. 다만 그러면 플러그인이 되묻는 질문이 많아집니다. 도메인 · 입력 · 산출물 · 품질 기준을 미리 적어 주면 질문이 줄고 결과가 좋아집니다. 아래는 그대로 붙여 넣으면 됩니다.
하네스 구성해줘.
도메인: 도서·영화·행사·게임 같은 작품 하나를 소개하는 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분 정도 걸립니다.
/reel-studio로, 영상 스킬은 /showreel로 이름을 불러 쓰게 정해 두는 것입니다.
강사가 미리 만든 같은 구성의 하네스(에이전트 4명 + 스킬 2개)를 받아 바로 다음 단계로 가세요. 생성 과정은 집에서 다시 해 보면 됩니다.
Claude를 /exit로 끈 뒤 my-reel 폴더에서 실행합니다. brief.md는 그대로 남습니다.
curl.exe -L -o reel-backup.zip https://namojo.github.io/aiguild/templates/reel-backup.zip
Expand-Archive reel-backup.zip -DestinationPath . -Force
claude
curl -L -o reel-backup.zip https://namojo.github.io/aiguild/templates/reel-backup.zip
unzip -o reel-backup.zip
claude
브라우저로 reel-backup.zip을 받아 my-reel에 풀어도 됩니다. 풀면 CLAUDE.md, .claude/, brief.example.md가 생깁니다.
새로 생긴 에이전트와 스킬을 확실히 읽히도록 /exit로 껐다가 claude로 다시 띄웁니다. 그다음 팀을 봅니다.
/agents
my-reel/
├── brief.md ← 입력 (1단계에서 만든 의뢰서)
├── CLAUDE.md ← 언제 reel-studio 를 부르나 · 공통 규칙 · 변경 이력
└── .claude/
├── agents/ ← 조사 · 기획 · 제작 · 검수 (이름은 사람마다 다름)
└── skills/ ← reel-studio(순서) + 릴 만드는 법 같은 도메인 스킬
reel-backup.zip)의 팀. 세션 2 키트의 요구사항 인벤토리 자리에 여기서는 조사표·장면표가 있고, 검증자 자리에 검수 담당이 있습니다. 직접 만든 팀도 이름만 다를 뿐 이 모양이면 잘 만들어진 것입니다.세션 2에서 본 눈으로 점검합니다.
방금 만든 하네스를 점검해줘. 표로 짧게.
1. 이 팀은 여섯 가지 패턴(파이프라인 / 팬아웃·팬인 / 전문가 풀 / 생성·검증 / 감독자 / 계층적 위임) 중 무엇을 섞었나
2. 검수 담당이 따로 있는가, 그 담당은 결과물을 직접 고치는가
3. 중간 산출물은 무엇이고, 다음 담당이 그것을 어떻게 받는가
4. 각 에이전트와 스킬의 description 에 "언제 쓰는지"가 적혀 있는가
_workspace/의 파일로 넘긴다 — 세션 2의 요구사항 인벤토리와 같은 자리description에 호출 조건이 적혀 있다. Claude는 이 한 줄을 보고 에이전트와 스킬을 고릅니다이제 길게 설명할 필요가 없습니다. 폴더가 이미 다 알고 있습니다.
/reel-studio brief.md
조사 → 기획 → 제작 → 검수 담당이 차례로 붙는 것이 화면에 보입니다. 조사 담당이 웹 검색 승인을 물으면 허락하세요. 10분 안팎 걸립니다. 끝나면 결과를 엽니다.
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를 열어 검수 담당이 무엇을 지적했고, 누구에게 고치게 했고, 몇 회차에 통과했는지 봅니다.
그다음 마음에 들지 않는 장면 하나를 고쳐 달라고 해 보세요.
/reel-studio [2]번 장면을 [더 짧은 문구로, 글자가 한 자씩 찍히게] 바꿔줘.
고치는 요청 하나에도 기획 담당이 장면표를 고치고, 제작 담당이 그 장면만 다시 만들고, 검수 담당이 다시 봅니다. 사람이 프롬프트를 다시 쓰지 않아도 절차가 지켜지는 것이 하네스입니다.
모든 일에 팀이 필요하지는 않습니다. 일 대부분은 한 사람이 매번 같은 방법으로 하는 일입니다. 그 방법을 파일로 꺼내 두면 Claude가 알맞은 때에 알아서 불러 씁니다. 그게 스킬입니다.
방금 쓴 백업 하네스의 reel-html(릴 만드는 법)이 그런 스킬이고, ad-edu의 크리에이티브 과정이 쓰는
quality-review(만들지 않고 판정만 하는 검수 매뉴얼)도 그렇습니다.
| 스킬로 만든다 | 에이전트(팀)로 만든다 | |
|---|---|---|
| 무엇을 담나 | 일하는 방법 — 절차 · 기준 · 양식 · 용어집 | 그 방법을 쓰는 담당자 — 역할 · 경계 · 금지사항 |
| 언제 움직이나 | 요청이 description과 맞으면 알아서 | 오케스트레이터나 사용자가 부를 때 |
| 어울리는 일 | 매번 같은 순서·기준으로 혼자 하는 반복 작업 | 깊이 · 동시 진행 · 검증 분리가 필요한 일 |
| 예 | 주간보고 양식 맞추기, 보도자료 초안, 사내 용어 통일 | 오늘의 제안서 팀, showreel 팀 |
세션 1에서 떠올린 내 업무의 반복 작업을 고릅니다. 매번 같은 순서로 하고, 매번 같은 설명을 다시 하고 있다면 좋은 후보입니다.
Claude를 /exit로 끄고, 새 폴더에서 띄웁니다.
mkdir C:\aiguild\my-skill -Force; cd C:\aiguild\my-skill; claude
mkdir -p ~/aiguild/my-skill && cd ~/aiguild/my-skill && claude
아래 칸을 채우면 그 아래 프롬프트가 바뀝니다. 예시는 ‘흩어진 메모를 팀 주간보고 양식으로’입니다. 내 업무로 바꿔 써 보세요.
스킬 의뢰서
플러그인이 스킬 하나와 짧은 CLAUDE.md를 만듭니다. 3~5분 걸리고, 되묻는 질문에는 짧게 답하면 됩니다.
마지막 줄의 “예시 입력과 기대 출력”이 중요합니다. 스킬 안에 정답 예시가 하나 있으면 결과가 그 모양으로 고정됩니다.
새 스킬이 확실히 읽히도록 /exit 후 claude로 다시 띄웁니다. 그다음 스킬 이름을 말하지 않고 평소 하던 말로 부탁합니다.
화면에 내 스킬을 불렀다는 줄(예: Skill(weekly-report))이 보이면 성공입니다. 결과에서 원문에 없는 내용이 ‘확인 필요’로 남았는지도 보세요.
스킬이 불리지 않았다면 십중팔구 description 문제입니다.
잘 불리면 개인 스킬 폴더로 옮겨 둡니다. 그러면 어느 폴더에서 Claude를 띄워도 이 스킬이 따라옵니다. Claude 입력창이 아니라 새 PowerShell(Mac은 터미널) 창에서 실행하세요.
마지막 줄에 SKILL.md가 보이면 제대로 옮겨진 것입니다. 써 보다가 아쉬운 점이 생기면 프롬프트를 다시 쓰지 말고 스킬을 고칩니다. 그 폴더에서 “하네스 회고해줘. [아쉬웠던 점]”이라고 하면 /harness:evolve가 피드백을 스킬에 반영하고 변경 이력을 남깁니다.
오늘 만든 네 명짜리 팀이 계속 자라면 어떤 모습이 될까요. 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, 광과민성 섬광, 멈춘 화면)은 스크립트로 나눠 맡깁니다. 판단은 스킬에, 측정은 도구에입니다. 내 하네스에 무엇을 더하면 좋을지 보이지 않나요?
my-reel 폴더의 조사표와 장면표를 그대로 넘겨 영상을 만드는 방법은 아래 수업 이후 따라 하기에 순서대로 정리해 두었습니다.
아쉬운 점이 있으면 프롬프트를 고치는 대신 하네스를 고칩니다. 플러그인의 /harness:evolve가 맡는 일입니다.
showreel처럼 검수에 기계 측정을 붙여 보세요.
하네스 회고해줘. 검수 단계에 기계로 재는 점검을 더하고 싶어.
reel.html 의 장면 시간 합계, 장면별 글자 수, 외부 이미지 사용 여부를
스크립트로 검사해서 검수 담당이 그 결과를 근거로 쓰게 해줘.
어느 에이전트와 스킬이 바뀌었는지, CLAUDE.md 변경 이력에 한 줄이 추가됐는지 보세요.
수업 이후 · 집에서 · 1시간 안팎
revfactory/showreel은 한국어 모션그래픽 영상을 기획부터 납품까지 만드는 Claude Code 스킬입니다. 영상으로 렌더하려면 ffmpeg · Node.js · Python(numpy, Pillow) · Chrome 계열 브라우저가 필요합니다. Claude 입력창이 아니라 PowerShell(Mac은 터미널)에서 실행합니다. 블록마다 다 끝나면 창을 새로 열고 다음 블록으로 갑니다.
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 창을 새로 엽니다.
# 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 대신 npm.cmd로 쓰면 정책을 바꾸지 않고 넘어갑니다.py --version을 확인하고,
안 나오면 ①의 세 번째 줄만 다시 실행하세요.brew install ffmpeg node python numpy pillow
git clone https://github.com/revfactory/showreel.git ~/.claude/skills/showreel
cd ~/.claude/skills/showreel/scripts && npm install
Google Chrome이 /Applications에 있어야 합니다. 없다면 google.com/chrome에서 설치하세요.
Homebrew(맥용 설치 도구)부터 설치합니다. 끝나면 화면에 나오는 Next steps의 두 줄을 그대로 실행하고 터미널을 새로 연 뒤, 위 명령을 다시 붙여 넣습니다.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
오늘은 나레이션과 AI 이미지 없이 타이포그래피·그래픽·합성 음악으로 만듭니다. 그래서 ElevenLabs 키나 Codex CLI는 없어도 됩니다.
showreel이 직접 제공하는 점검 스크립트입니다. 새 창에서 실행하세요. Windows에서는 첫 줄로 python3 이름이 제대로 잡혔는지도 함께 확인합니다.
python3 --version
python3 "$env:USERPROFILE\.claude\skills\showreel\scripts\preflight.py"
첫 줄에 Python 3.12.x처럼 버전이 나와야 합니다. 대신 Microsoft Store가 열리거나 “Python was not found”가 나오면
설정 → 앱 → 고급 앱 설정 → 앱 실행 별칭에서 python3.exe(앱 설치 관리자) 두 개를 끔으로 바꾸고 창을 새로 연 뒤 다시 실행하세요.
python3 ~/.claude/skills/showreel/scripts/preflight.py
| 줄 | 오늘 필요한가 |
|---|---|
| node · ffmpeg · Chrome · playwright-core · python numpy·Pillow | 모두 ✓여야 합니다 (Windows에서 Edge를 지정했어도 Chrome 줄이 ✓로 나옵니다) |
| ElevenLabs · codex-image · 누끼(swiftc) | ✗여도 됩니다 (나레이션·이미지 없이 만듭니다. 누끼는 Mac 전용) |
✗인 필수 줄이 있으면 오른쪽에 설치 방법이 나옵니다. Mac 기준 명령(brew)으로 안내되더라도 Windows에서는 A1단계의 해당 줄을 다시 실행하면 됩니다.
세션 3의 my-reel 폴더에서 Claude를 띄웁니다. 새로 설치한 스킬을 읽도록 꼭 새 창에서 띄우세요.
cd C:\aiguild\my-reel; claude
cd ~/aiguild/my-reel && claude
showreel을 이름으로 불러 하네스의 결과를 넘깁니다. 하네스 쪽은 /reel-studio, 영상 쪽은 /showreel로 나눠 두었기 때문에 서로 일을 가로채지 않습니다.
/showreel brief.md 의 작품을 소개하는 15초 영상을 만들어줘.
- 사실은 _workspace/01_research.md 에 출처가 있는 것만 써. 새로 조사하면 출처를 남겨.
- out/storyboard.md 를 출발점으로 삼되, 더 강한 콘셉트가 있으면 바꿔도 돼.
- 나레이션 없이, AI 이미지 생성 없이, 타이포그래피와 그래픽과 합성 음악으로.
- 포스터·표지·스틸·로고 같은 저작물 이미지는 쓰지 마.
- 이 PC가 Windows 라면 셸 명령은 Git Bash 기준으로 쓰고, 스크립트는 python3 로 실행해.
처음에 사용자만 아는 사실(예: 행사의 정확한 일시)을 한두 개 물을 수 있습니다. 답하고 나면 납품까지 묻지 않고 진행합니다.
승인 창이 뜨면 경로가 my-reel 안이거나 showreel 스킬 폴더(.claude\skills\showreel)의 스크립트인지 보고 승인하세요.
작업은 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는 소리를 듣지 못하고 음량을 숫자로만 확인합니다. 남의 작품으로 만든 영상은 개인 학습용으로 두세요.
다음 단계
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 키가 있으면 나레이션도 넣을 수 있습니다. |
/exit로 나갔다가 claude로 다시 들어오세요. 새로 깐 플러그인은 재시작해야 읽힙니다.
/plugin에서 harness가 보이는지, 설치 범위가 User인지도 확인하세요. Project로 설치했다면 다른 폴더에서는 보이지 않습니다./exit → claude로 다시 띄웠는가. ② 스킬 폴더가 .claude\skills\이름\SKILL.md 구조인가(한 겹 더 들어가 있거나 파일 이름이 다르면 못 찾습니다).
③ description에 내가 실제로 하는 말이 들어 있는가. 3-B의 7단계 “불리지 않았을 때” 프롬프트로 description을 고치면 대부분 해결됩니다./exit 후 my-reel 폴더에서 claude를 다시 띄우세요. 그래도 없으면 하네스가 스킬 이름을 다르게 지은 것입니다.
.claude/skills/ 아래 폴더 이름을 확인해 그 이름으로 부르거나, 백업 하네스를 받으세요./clear로 비우고 이름을 맨 앞에 붙여 다시 부르세요.
직접 만든 하네스라면 “이 폴더에서는 /showreel 이라고 명시하지 않는 한 reel-studio 를 쓰라고 CLAUDE.md 에 적어줘”라고 고치면 됩니다.brew install numpy pillow로 설치하세요.
그다음 preflight.py를 다시 실행해 numpy·Pillow 줄이 ✓인지 봅니다.curl은 다른 명령의 별칭입니다. curl.exe로 쓰세요.
그래도 안 되면 브라우저로 zip 파일을 받아 해당 폴더에 풀면 됩니다./clear는 대화만 지우고 Claude는 그대로 떠 있습니다. 앞의 맥락 없이 새 일을 시킬 때 씁니다.
/exit는 Claude를 끄는 것입니다. 플러그인을 새로 깔았거나 .claude/ 파일이 새로 생겼을 때는 껐다 켜야 확실히 반영됩니다./permissions에서 자주 쓰는 동작을 허용 목록에 넣을 수 있습니다. 다만 실습 중에는 기본값을 권합니다.
에이전트가 무엇을 하려는지 보는 것이 오늘 배울 것의 일부이고, 특히 파일을 지우거나 옮기려는 시도는 꼭 눈으로 보세요.