21장 — 협업 흐름
CHAPTER 21
협업 흐름
외주·코리뷰·팀 확장
📑 이 챕터에서 다룰 내용

새 20장에서 1년 후 본인 자료 검색 흐름을 봤습니다. 이제 "본인이 아닌 사람"이 자료를 펼치는 흐름입니다 — 외주·동료·동업자 협업.

1인 운영자가 영원히 1인 상태는 아닙니다. Phase 2~3 진입 시 외주 (디자인·콘텐츠·번역·QA)가 결합되고, 동업자 (비개발자 또는 개발자)가 합류할 수 있습니다. 이때 5파일이 "AI에게만 입력되는 헌법"에서 "사람 협업의 단일 출처"로 바뀝니다.

📘 사전 지식 체크 + 이 장의 목적

사전 지식: 새 11장 5파일+ 체계 / 새 13장 자동 갱신

이 장의 목적: 외주·동료에게 5파일 공유 흐름 + GitHub·GitLab 활용 + 외주 종류별 권장 + 함정 인지

완료 후 결과물: 외주가 5파일을 펼치고 "무엇을 의무" 답을 5분 안에 찾는 흐름

💡 5파일 = 협업의 "진실의 출처"

외주에게 "이거 만들어주세요"만 보내면 외주는 본인의 짐작으로 작업합니다. 5파일을 보내면 외주는 "SPEC.md 7항목 + PLAN.md DoD + REVIEW.md 12 체크"를 펼치고 "무엇을 의무"를 5분 안에 압니다.

21-1 SPEC.md 공유 — 외주가 가장 먼저 펼침 🔗

외주에게 가장 먼저 보내는 자료가 SPEC.md입니다. "무엇을 만들 것인가" 7항목이 외주에게 "본인 작업 기준"이 됩니다.

외주에게 SPEC.md 공유 의식 4

📘 SPEC.md 공유 4 의식

[1] 외부 노출 부분만 추출
E1 회색지대 결정 = 외주에게 핵심 / DB 스키마 = 개발 외주만 / 수익화 = 비공개 (외주에게 공유 X 또는 익명)

[2] "왜 이 결정" 한 줄 추가
E1 결정에 "이유" 1줄 (변호사 검토 결과 등). 외주가 "왜"를 알면 작업 충돌 X.

[3] 외주 작업 영역 명시
"외주가 작업할 영역: §3 사용자 정의 / §5 성공 기준". 다른 영역 변경 X.

[4] 외주 검토 응답 의무
외주가 SPEC 검토 후 "이해 OK" 또는 "질문 N개" 응답. 작업 시작 전 의무.

Junho 사례 — 줍줍 디자인 외주에게 SPEC.md 공유

💻 Day 17 디자인 외주 SPEC 공유 및 질문 5개
[Day 17 — 디자인 외주에게 SPEC.md 공유]
- 외주: 디자이너 (1인 프리랜서)
- 작업: 두 탭 UI 디자인
- 공유 범위: SPEC.md §3 사용자 정의 + §5 성공 기준 + E1 회색지대

[외주 응답 — 받은 질문 5개]
1. "두 탭의 사용자가 동일 인물 가능?"
   → 답: 가능. UX 의식 의무.
2. "닉네임이 *수원시 카페 운영하는 든든한 줍줍이* 형식?"
   → 답: 그대로. 표현 정제 X.
3. "면책 *정보 제공 목적* 어디 노출?"
   → 답: 두 탭 하단 푸터 + 첫 진입 모달
4. "결제 흐름이 SPEC.md에 X — Phase 1 무수익?"
   → 답: 의도적 무수익. Phase 2 진입.
5. "다크모드 의무?"
   → 답: 선택. Phase 1 X.

[효과]
- 외주가 본인 짐작 없이 작업 시작
- 5질문이 외주의 작업 안전성 보장
21-2 PLAN.md 공유 — 진행 흐름 🔗

PLAN.md는 "어떤 순서로 만드는가"의 흐름. 외주가 "본인 작업이 전체에서 어디" 답을 찾을 수 있습니다.

외주에게 PLAN.md 공유 의식 3

📘 PLAN.md 공유 3 의식

[1] Phase 1 DoD 명시 부분만 공유
외주 작업이 "DoD 어디" 명시. 게이트 (G1·G2 등) 시점 인지 의무.

[2] E2 1인 페이스 부분 공유 X (또는 익명)
외주에게 "1인이 무너질 수 있음" 노출 X. 페이스 부담 외주에게 전가 X.

[3] 외주 마감일 = PLAN.md 게이트 -2~3일
G1이 Day 14면 외주 작업 마감 Day 11~12. 검수·수정 시간 보장.

외주 마감 흐름 표

외주 작업PLAN.md 게이트외주 마감검수 시간
디자인G1 (Day 14)Day 113일
콘텐츠G2 (Day 28)Day 253일
번역G3 (Day 50)Day 473일
QAG5 FINAL-7일7일
21-3 REVIEW.md 공유 — 외주 자체 검토 🔗

외주가 작업 결과를 "본인 검토"후 제출하면 운영자 시간 50% 절감. REVIEW.md 12 체크 중 외주 영역 체크를 외주에게 위임합니다.

외주 자체 검토 흐름

📘 외주 자체 검토 3 단계

[1] 외주에게 REVIEW.md 12 체크 중 외주 영역 5~7 발췌
디자인 외주: 4 체크 (UX 흐름·접근성·반응형·E1 면책 노출)
콘텐츠 외주: 5 체크 (톤·길이·SEO·SSOT 일치·E1 면책)
번역 외주: 6 체크 (의미·톤·문화 차이·SEO·E1 면책·SSOT)

[2] 외주가 작업 후 "체크 결과 O/X" 응답
O면 통과. X면 자체 수정 후 재제출.

[3] 운영자는 외주 X 결과 + 1차 검토 결과만 검토
시간 50% 절감.

Junho 사례 — TSV 영문 번역 외주

💻 Day 200~ Phase 2 영문 진입 시 번역 외주
[Day 200~ Phase 2 영문 진입 시 번역 외주]
- 외주: 영문 번역가 (1인 프리랜서)
- 작업: 페르소나 출력 영문 번역 약 200건

[REVIEW.md 6 체크 중 외주 영역]
1. 의미 일치 (한국어 → 영문, 환각 X)
2. 톤 분리 (STAT vs OBSERVER 영문 톤도 다름)
3. 문화 차이 (한국 xG → 영문 expected goals 자연 변환)
4. SEO 키워드 (영문 expected goals analysis 등)
5. E1 면책 일관 (Position C 영문 면책)
6. SSOT 일치 (lib/match_facts.ts 인터페이스 영문 영역도 동일)

[효과]
- 외주가 본인 검토 후 제출
- 운영자 검토 시간 200건 → 50건 점검 (75% 절감)
21-4 BUILD.md 공유 — 작업 환류 🔗

외주가 작업 종료 후 BUILD.md에 1줄 LogOnTable 트레이스 의무. 6개월 후 "왜 외주가 이 결정" 답이 보존됩니다.

외주 트레이스 양식

💻 외주 BUILD.md 트레이스 양식
## YYYY-MM-DD [외주 이름] — [작업 영역]
- 작업: [무엇을]
- 후보: [몇 개 후보 중]
- 채택: [왜 이걸]
- 검수: [O/X 결과]
- 시간: [N시간]
- 비용: [N만 원]

Junho 사례 — 줍줍 디자인 외주 트레이스

💻 실제 외주 트레이스 예시
## 2026-XX-XX 김디자이너 — 두 탭 UI

- 작업: 소상공인 + 개인 복지 두 탭 UI 디자인
- 후보: A안 (탭 위), B안 (탭 아래), C안 (사이드바)
- 채택: A안 (모바일 우선 + 한국 사용자 친숙)
- 검수: O (4 체크 모두 통과)
- 시간: 12시간 (Day 11~13)
- 비용: 80만 원

이 트레이스가 6개월 후 "왜 두 탭이 위에 있지" 답이 됩니다.

21-5 CLAUDE.md 공유 — AI 협업 흐름 🔗

CLAUDE.md는 "AI에게 매 세션 자동 입력" 자료. 개발 외주에게 핵심 공유 자료입니다.

개발 외주에게 CLAUDE.md 공유 의식

📘 CLAUDE.md 공유 4 의식

[1] 외주가 본인 Claude Code 작업 시 CLAUDE.md 그대로 적용
외주 PC에 CLAUDE.md 동기화. 프로젝트 헌법 외주 PC에서도 작동.

[2] §3 Critical Constraints — 외주에게 핵심
"NativeWind만 사용" / "API 키 비공개" 등. 외주가 위반 시 즉시 차단.

[3] §8 Forbidden Patterns — 외주 위반 0건 의무
정규식 패턴. 외주 commit 검증 자동 (CI).

[4] §10 Current State 외주 영역만 갱신
외주가 본인 작업 후 §10 갱신. 운영자가 종합 점검.

Junho 사례 — TSV 페르소나 추가 외주

💻 Day 250 Phase 2.0 — 5번째 페르소나 추가 외주
[Day 250 Phase 2.0 — 5번째 페르소나 추가 외주]
- 외주: AI/LLM 엔지니어 (1인 프리랜서)
- 작업: COACH 페르소나 추가 (전술 분석 톤)

[CLAUDE.md 공유 영역]
- §3 Critical Constraints (모두)
- §5 Project-Specific Rules — TSV E5 8 규칙 (모두)
- §8 Forbidden Patterns — 페르소나 환각 정규식

[외주 응답]
- §5 8 규칙 모두 인지 후 작업 시작
- 5일 후 COACH 페르소나 + 자동 일관성 테스트 5건 통과
- §10 Current State 갱신 (5 페르소나 가동)

[효과]
- 외주 환각 0건
- 운영자 검토 5분
21-6 GitHub·GitLab 권장 🔗

5파일 공유의 핵심 도구는 GitHub·GitLab입니다. 외주 협업 흐름의 표준입니다.

GitHub Pro·GitLab 권장 흐름

📘 GitHub Pro vs GitLab Free

GitHub Pro $4/월: private repo 무제한 / Issue·Pull Request 협업 / Actions CI 무료 (월 2000분)

GitLab Free: private repo 무제한 / CI/CD 400분/월

권장 — 1인 운영자: GitHub Pro $4/월 (외주 협업 시점). 4 프로젝트 합계 $16/월.

외주 access 흐름

1
private repo에 외주 collaborator 추가
외주 GitHub 계정 → repo settings → collaborator 추가.
2
외주 작업 영역 branch 분리
main (보호) / dev / feature/[외주이름]. 직접 main push는 금지입니다.
3
외주 PR 의무
직접 main push X. PR → 운영자 검토 → merge. 품질 관문입니다.
4
작업 종료 시 collaborator 제거
보안 의식. 외주 작업 완료 후 즉시 제거합니다.
21-7 외주 종류별 권장 🔗

외주 종류 4 — 디자인·콘텐츠·번역·QA

외주Phase시간당5파일 영역
디자인Phase 1·2₩30,000~₩70,000SPEC §3+§5 / PLAN G1·G2 / REVIEW 4 체크
콘텐츠Phase 2·3₩20,000~₩50,000SPEC §3 / CLAUDE §5 SSOT / REVIEW 5 체크
번역Phase 2 후반₩30,000~₩60,000 / 1쪽CLAUDE §5 SSOT / REVIEW 6 체크
QAPhase 1·2·3₩30,000~₩50,000PLAN G5 FINAL / REVIEW 12 체크 모두

4 외주 비용 가설 (1 프로젝트 1년)

💻 1 프로젝트 1년 외주 비용 가설
[1 프로젝트 1년 외주 비용 가설]
- 디자인: 60시간 × ₩50,000 = ₩300만
- 콘텐츠: 40시간 × ₩30,000 = ₩120만
- 번역 (Phase 2): 50쪽 × ₩40,000 = ₩200만
- QA: 80시간 × ₩40,000 = ₩320만
- 합계 약 ₩940만 / 연

[Junho 4 프로젝트 합계]
- 약 ₩3760만/연 (Phase 2 진입 후)
- ★ 수익 흑자 후 흡수
21-8 협업 함정 4개 🔗

함정 1: 외주가 5파일 미의식 → 본인 짐작 작업

외주가 SPEC·CLAUDE.md를 펼치지 않고 "본인 짐작"으로 작업 → 결과물이 SPEC과 충돌 → 재작업.

해결: 외주 작업 시작 전 "5파일 검토 응답" 의무.

함정 2: 외주에게 "어떻게"를 너무 많이 명시

SPEC·PLAN에 "무엇"만 박고 "어떻게"는 외주 자유. "어떻게"까지 박으면 외주 창의성 차단.

해결: SPEC = "무엇", 외주 = "어떻게". 분리 의식.

함정 3: 5파일 공유 후 갱신 X → 외주가 옛 자료 사용

5파일 공유 시점 → 운영자가 SPEC v3 갱신 → 외주는 v2로 작업 → 결과물 충돌.

해결: GitHub PR 흐름. 외주가 항상 main pull. 운영자 갱신 commit 후 외주 알림 의무.

함정 4: E1 회색지대 결정 외주에게 비공개 → 면책 누락

외주가 SPEC §회색지대 결정을 못 봐서 면책 없는 디자인·콘텐츠 → 6개월 후 법적 위험.

해결: E1 결정은 외주 종류 무관 의무 공유.

📌 새 21장 정리
  • 핵심 한 줄: 5파일 = 협업의 "진실의 출처". 외주가 5파일을 펼치고 "무엇을 의무" 5분 안에 답
  • 외주에게 5파일 공유: SPEC.md §3+§5+E1 (수익화 비공개) / PLAN.md Phase 1 DoD + 게이트 (E2 페이스 비공개) / REVIEW.md 외주 영역 5~7 체크 / BUILD.md 외주 트레이스 양식 / CLAUDE.md §3+§5+§8 (개발 외주)
  • 외주 종류 4: 디자인 ₩30,000~₩70,000/시간 / 콘텐츠 ₩20,000~₩50,000/시간 / 번역 ₩30,000~₩60,000/쪽 / QA ₩30,000~₩50,000/시간
  • 1 프로젝트 1년 외주 비용 가설: ₩940만 (Phase 2 진입 시점부터)
  • GitHub·GitLab 권장: GitHub Pro $4/월 / 외주 collaborator 추가 → 작업 → 제거 / PR 흐름 의무 (main 직접 push X)
  • 외주 마감 = PLAN 게이트 -2~3일: 검수·수정 시간 보장
  • REVIEW.md 외주 자체 검토: 운영자 검토 시간 50% 절감
  • BUILD.md 외주 트레이스: 작업·후보·채택·검수·시간·비용
  • 함정 4개: 5파일 미의식 → 짐작 작업 / "어떻게"까지 명시 → 창의성 차단 / 갱신 X → 옛 자료 / E1 비공개 → 면책 누락
  • 다음 장: 새 22장 — 디버깅 흐름 (막힐 때 5파일 활용)
🤖
1탄 학습 도우미
질문하기 OK
안녕하세요! 협업 흐름에 대해 무엇이든 물어보세요. 본문에서 찾아 답변해드릴게요. 👇