하네스를 팀에 옮기기
6장에서 만든 랜딩 하네스는 한 사람이 자기 폴더에서 쓰는 자리였습니다. 위니브에는 마케팅, 디자인, 콘텐츠 담당자가 여러 명 있고, 그들 모두가 랜딩 페이지를 만들어야 합니다. 한 사람의 폴더를 어떻게 팀의 자산으로 옮길지가 여기서 다룰 주제입니다.
1. 옮길 때 흔들리는 자리
한 사람이 쓰던 폴더를 팀에 그대로 풀어놓으면 흔히 다음 세 가지가 흔들립니다.
버전 흔들림
마케터 A의 폴더와 디자이너 B의 폴더가 따로 진화하기 시작합니다. A는 brand.md에 자기 부서용 톤을 추가하고, B는 style/tokens.css에 자기 프로젝트용 색을 추가합니다. 한 달 뒤에는 두 폴더가 서로 다른 디자인 시스템이 되어 있습니다.
자산 흔들림
회사 폰트 파일, 로고 SVG, 이미지 같은 무거운 자산이 폴더마다 복사됩니다. 디자인팀이 폰트를 업데이트해도 누구 폴더에는 새 파일이 깔리고 누구 폴더에는 옛 파일이 깔립니다.
규칙 흔들림
처음 만든 사람의 머릿속에만 있던 규칙들이 다음 사람에게 전달되지 않습니다. "왜 컨테이너가 1190px인가", "왜 자뻑 표현이 금지인가" 같은 맥락이 잊혀집니다.
이 세 가지를 막는 자리가 곧 "팀 자산"의 모양입니다.
2. 한 자리에 두는 가장 단순한 방법, Git
가장 단순하고 흔한 답은 Git 저장소 하나입니다.
weniv-landing-harness/ ← 사내 Git 저장소
├── CLAUDE.md
├── components.md
├── brand.md
├── style/
├── .claude/skills/landing/
├── output/ ← .gitignore에 등록 (각자 로컬에서만)
└── README.md ← 사용 안내
팀 멤버들은 이 저장소를 git clone해서 본인 컴퓨터에 둡니다. 자기 브리프로 만든 페이지(output/)는 본인 로컬에서만 보고, 디자인 시스템·컴포넌트·카피 규칙은 모두가 같은 버전을 봅니다. style/tokens.css에 새 색이 필요하면 풀 리퀘스트로 올리고, 디자인팀이 한 번 검토하고 머지합니다.
핵심은 "각자 만드는 것(랜딩 페이지)"과 "모두가 같이 쓰는 것(디자인 시스템·규칙)"을 한 저장소 안에서 분리해 두는 것입니다. output/은 .gitignore로 빼고, 나머지는 모두 추적합니다.
3. 누가 어디를 고칠 수 있는가
저장소에 모든 사람이 어디든 손댈 수 있게 두면 곧 흔들립니다. 다음 정도의 권한 분리를 명시해 두면 깔끔합니다.
| 자리 | 누가 고칠 수 있는가 | 누가 검토하는가 |
|---|---|---|
style/tokens.css (색·폰트) | 디자인팀 | 디자인 리드 |
style/components.css (컴포넌트 CSS) | 디자인·개발팀 | 디자인 리드 + 프론트엔드 리드 |
components.md (섹션 시퀀스) | 콘텐츠팀·마케팅팀 | 디자인 리드 |
brand.md (카피 톤) | 마케팅팀·콘텐츠팀 | 마케팅 리드 |
.claude/skills/landing/SKILL.md (작업 흐름) | 누구나 풀 리퀘스트 | 처음 만든 사람 |
output/ (만들어진 페이지) | 본인만 | 없음 (로컬) |
CODEOWNERS 파일 같은 깃허브 기능을 쓰면 이 권한 분리가 풀 리퀘스트 단계에서 자동으로 작동합니다. 디자인 토큰을 누가 바꾸면 디자인 리드가 자동으로 리뷰어로 들어옵니다.
4. 새 멤버가 합류할 때
신규 멤버가 합류하면 이 저장소를 클론하는 일이 첫날 일과가 됩니다. README에 다음 정도를 박아두면 첫날에 첫 페이지가 나옵니다.
# 위니브 랜딩 하네스
## 처음 사용하시는 분
1. 이 저장소를 클론합니다.
git clone https://github.com/weniv/landing-harness
2. 폴더로 들어가서 Claude Code를 엽니다.
cd landing-harness
claude
3. 채팅창에 "랜딩 만들어줘"라고 한 줄 던집니다.
브리프 형식은 `output/sample-briefs.md`를 참고하세요.
4. 생성된 `output/{slug}.html`을 브라우저로 열어 확인합니다.
## 무엇을 어디서 고치나요
- 색 바꾸고 싶음 → style/tokens.css
- 섹션 시퀀스 추가 → components.md
- 카피 톤 조정 → brand.md
- 작업 흐름 조정 → .claude/skills/landing/SKILL.md
규칙 변경은 풀 리퀘스트로 올려주세요. 자동으로 해당 리드가 리뷰어로 들어옵니다.
이 README가 곧 신규 멤버를 위한 작은 온보딩 문서입니다. 한 페이지를 넘지 않습니다. "어디에 무엇이 있고, 어떻게 시작하고, 어디를 고치면 되는지"만 짚어주면 됩니다.
4장에서 본 CLAUDE.md의 역할이 사람용으로 한 단계 확장됐습니다. CLAUDE.md는 모델을 위한 안내문, README는 사람을 위한 안내문입니다.