AKC 스킬 · ai-team-8
AI 직원 8명 팀
클로드 코드에 직원 파일 8개를 넣으면 말 한 번에 총괄·기획·조사·디자인·개발·검수·마케팅·고객 응대가 순서대로 일하고 문서 8장과 결과물을 남겨요. 꽃집 예약 페이지로 끝까지 돌린 기록이 있어요.
SKILL.md
혼자 일하는 사람을 위한 AI 직원 8명 스킬 (ai-team-8)
클로드 코드에 직원 설정 파일 8개를 넣으면, 말 한 번에 총괄 → 기획 → 조사 → 디자인 → 개발 → 검수 → 마케팅 → 고객 응대 순서로 일하고 docs/ 아래 문서 8장과 결과물을 남긴다. 넘기는 방법은 파일뿐이라 누가 무엇을 했는지 다 남는다. AI Korea Club이 2026-10-13 꽃집 예약 페이지로 끝까지 돌려 본 팀 파일 그대로다(team/ 폴더).
언제 쓰나
- "혼자 가게 하는데 예약 페이지 하나 만들고 싶어", "기획부터 홍보 글까지 한 번에"
- "클로드 코드 서브에이전트가 서로 파일로 일 넘기게 하고 싶어"
- 이미 팀이 돌아가는데 특정 직원만 다시 돌리고 싶을 때
준비 조건 (먼저 확인)
- 클로드 코드가 설치돼 있고
claude --version이 나온다. 없으면claude-code-korean-start스킬로 9~10단계부터. - Pro 이상 요금제. 한 번 돌리면 20~25분, API 요금으로 약 6달러어치를 쓴다(2026-10-13 Max·Opus 실행 기준). Pro는 중간에 한도에 걸릴 수 있다. 걸리면 기다렸다가 "이어서 진행해 줘".
절차
.claude 와 CLAUDE.md 가 함께 보이면 준비 끝. 맥 Finder에서 .claude 는 ⌘⇧. 로 보인다.
- 일 폴더 만들기 — 이 스킬의
team/안 내용(CLAUDE.md,.claude/agents/,README.md)을 새 폴더에 복사한다. 폴더 이름은 영어·숫자 권장(예:flower-shop).<pre class="sk-code"><button type="button" class="sk-cp" aria-label="복사">복사</button><code>mkdir flower-shop && cp -R <이 스킬 폴더>/team/. flower-shop/ && cd flower-shop && ls -a</code></pre> - 그 폴더에서 클로드 코드 열기 —
claude. 다른 폴더에서 열면 직원이 안 보인다. "이 폴더의 파일을 믿느냐"는 질문엔 Yes. 확인 질문: "이 폴더에서 쓸 수 있는 직원 이름만 알려 줘" → 8명이 나와야 한다. - 한 문장으로 맡기기 — 아래 틀의 [ ] 두 칸을 채워 보낸다. 총괄이 먼저
docs/01_할일표.md를 만들고 진행자가 나머지를 순서대로 부른다.<pre class="sk-code"><button type="button" class="sk-cp" aria-label="복사">복사</button><code>[하는 일, 예: 동네 꽃집을 혼자 하는 사장이에요]. [만들 것, 예: 주말 꽃다발 예약을 받는 휴대폰용 한 장 페이지가 필요해요. 손님이 신청한 내용은 손님 브라우저에만 저장되면 돼요]. 팀 규칙대로 총괄부터 고객 응대까지 진행해 주세요.</code></pre> - 허락 창 — 파일 쓰기·웹 검색은 내용을 읽고 Yes(편집 자동 허용은 Shift+Tab). 설치(npm·pip·brew)·git 커밋·배포 허락 창은 No. 팀 규칙상 사람 허락 전엔 하지 않는 일이다.
- 끝나면 —
app/index.html을 열어 눌러 보고,docs/결정필요.md맨 위 "먼저 정할 3가지"부터 정한다. 가게 이름·가격 같은 [ ] 칸은 개발 직원에게 한 번에 채우게 한다:<pre class="sk-code"><button type="button" class="sk-cp" aria-label="복사">복사</button><code>@agent-developer app/index.html 의 [ ] 빈칸을 아래 값으로 채워 줘. 다른 곳은 고치지 마. 가게 이름: [ ] / 주소: [ ] / 전화번호: [ ] / 영업시간: [ ] / 픽업 가능 시간: [ ] / 상품과 가격: [ ]</code></pre>
직원 한 명만 다시 돌리기
결과가 마음에 안 들 때만. 맨 앞 @agent-이름 이 그 직원을 꼭 부르게 한다.
@agent-planner docs/01_할일표.md 를 읽고 docs/02_기획.md 를 다시 써 줘. 이번엔 [바꿀 점]을 반영해 줘.@agent-researcher [비교할 서비스]를 다시 조사해서 docs/03_조사.md 를 고쳐 줘. 못 연 칸은 [미확인]으로.@agent-designer 시안.html 을 [분위기나 색]으로 다시 만들어 줘.@agent-qa app/index.html 을 다시 검수해서 docs/06_검수표.md 를 고쳐 줘. 못 해 본 건 미실행으로.@agent-marketer docs/07_마케팅.md 의 글 [번호]를 [말투·대상]으로 다시 써 줘. 근거 줄은 그대로.@agent-support docs/08_고객응대.md 에 [새 질문] 답변 초안을 추가해 줘. 모르는 사실은 [ ] 빈칸으로.
자주 막히는 것
- 직원이 안 불리고 클로드가 혼자 다 한다 → 거의 폴더 문제.
ls -a에.claude와CLAUDE.md가 보이는 폴더에서 열었는지 확인. 이미 켜진 상태에서 파일을 넣었다면/exit뒤 다시claude. - 끝났다는데
docs/에 파일이 없다 → 파일 쓰기 허락에서 No 를 눌렀거나 지나친 것. "방금 직원이 낼 파일이 없어. 그 직원을 다시 불러서 그 파일만 내게 해 줘." - 파일이
/tmp같은 폴더 밖에 생겼다 → 팀 규칙 위반. "임시 파일도 이 폴더 안 docs/ 아래에만 만들어" 라고 보낸다. - 결정 필요가 너무 많다 → 진행자가 추린 "먼저 정할 3가지"만 먼저. 나머지는 결과물 공개 전까지.
안에 든 것
team/CLAUDE.md(팀 규칙), team/.claude/agents/{chief-of-staff,planner,researcher,designer,developer,qa,marketer,support}.md, team/README.md(사람용 설명). 실제 실행 기록: aikoreaclub.com/packs/ai-team/made/
실제로 돌려 본 결과
빈 폴더에서 한 문장으로 끝까지 실행(20분 51초·25분 7초), 2026-11-08 SKILL.md 지시로 '직원 이름 확인' 단계 재실행. 고치지 않고 그대로 실었어요.
실행 예시
2026-11-08 — 직원 확인 단계(team/ 폴더에서 클로드 코드 실행)
요청: "이 폴더에서 쓸 수 있는 직원(서브에이전트) 이름만 한 줄에 하나씩 알려 줘."
chief-of-staff
planner
researcher
designer
developer
qa
marketer
support
8명이 모두 잡혔어요. 폴더가 맞으면 이 결과가 나와야 해요.
2026-10-13 — 끝까지 돌린 기록
빈 폴더에서 "동네 꽃집을 혼자 하는 사장이에요. 주말 꽃다발 예약을 받는 휴대폰용 한 장 페이지가 필요해요…" 한 문장을 보내고 20분 51초 뒤 결과가 나왔어요. 총괄·기획·조사·디자인·개발·검수·마케팅·고객 응대가 한 명씩 불려 각자 파일을 냈고, 검수 직원은 크롬을 직접 조종해 17개 조건을 확인했어요. 결과 페이지와 문서 8장은 고치지 않고 그대로: https://aikoreaclub.com/packs/ai-team/made/
안에 든 파일 (13개)
SKILL.mdexamples/01.mdskill.jsonteam/.claude/agents/chief-of-staff.mdteam/.claude/agents/designer.mdteam/.claude/agents/developer.mdteam/.claude/agents/marketer.mdteam/.claude/agents/planner.mdteam/.claude/agents/qa.mdteam/.claude/agents/researcher.mdteam/.claude/agents/support.mdteam/CLAUDE.mdteam/README.md
문제가 있거나 고칠 점을 찾았으면 이 페이지 아래 댓글로 알려 주세요. 다음 판에 반영하고 이름을 남겨요.



