본문 바로가기

하네스를 팀에 옮기기

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는 사람을 위한 안내문입니다.