2022년 8월, 화요일 새벽 2시였다. 상하이 오피스 바닥에 앉아 노트북 화면을 응시하고 있었다. GitHub 스타 카운터가 3,200에서 멈춰 있었다 — 3주째.

팀원 중 누군가가 말했다. “이 속도라면 1만 달성하는 데 2년은 걸린다.”

그때는 몰랐다. 18개월 후 우리가 6만 스타를 넘기게 될 줄.

Key Stats: AFFiNE GitHub 성장 지표

지표 수치
총 GitHub 스타 60,000+
Product Hunt #1 달성 30회
GitHub Trending 등장 28회 (5개월)
오픈소스 기여자 300+
月 활성 사용자 100,000+

왜 대부분의 README는 실패하는가

GitHub 스타를 늘리고 싶다면, 가장 먼저 직면해야 할 진실이 있다.

방문자는 당신의 README를 읽지 않는다. 그들은 훑어본다.

3초 안에 “이게 뭔지” 파악하지 못하면 탭을 닫는다. (실제로 우리가 열 분석 도구로 측정해봤더니 평균 체류 시간이 8초였다.)

AFFiNE 초기 README는 기술 스펙으로 가득했다. CRDT 알고리즘, 블록 기반 에디터 아키텍처, Rust 바인딩… 개발자들은 흥미를 보였지만 스타를 누르지 않았다.

전환점은 README를 완전히 재구성했을 때였다 — 기술 설명 대신 “당신의 문제를 이렇게 해결합니다”로 첫 문장을 바꿨다.

전략 1: README를 랜딩 페이지처럼 설계하라

좋은 README의 구조는 다음과 같다:

첫 화면 (fold 위)

  • 한 줄 가치 제안 (15단어 이내)
  • 작동하는 GIF 또는 스크린샷
  • 배지 3개: 스타 수, 라이선스, CI 상태

두 번째 섹션

  • 핵심 기능 (불릿 3-5개, 각 한 줄)
  • “왜 우리를 선택해야 하는가” vs 경쟁자 비교표

세 번째 섹션

  • 5분 이내 시작 가능한 Quick Start
  • 복사-붙여넣기 가능한 실제 코드

AFFiNE에서 이 구조로 바꾼 후 첫 주에 스타 전환율이 2.3배 올랐다.

전략 2: Hacker News Show HN의 타이밍을 공략하라

우리가 처음 Show HN에 올렸을 때, 포인트 2개를 받고 묻혔다. (솔직히 말하면 그 2개 중 하나는 팀원 계정이었다.)

두 번째 시도에서 달랐던 것은 딱 하나였다 — 제목.

“Show HN: AFFiNE — Notion + Miro를 대체하는 오픈소스 도구” 대신 “Show HN: 우리가 Notion을 떠난 이유, 그리고 직접 만든 것”으로 바꿨다.

스토리텔링이 기능 설명을 이긴다. 항상.

최적 투고 시간은 미국 동부 시간 기준 월~화요일 오전 9-11시다. (한국 시간으로 밤 10시~자정.)

전략 3: 스타 속도를 만들어라

GitHub 알고리즘에는 “모멘텀” 요소가 있다. 24시간 내 스타가 집중되면 Trending에 올라간다. Trending에 오르면 더 많은 스타를 받는다 — 복리 효과다.

이를 위해 우리가 한 것:

출시 전 대기자 명단 구축 Discord 서버에 미리 공지를 올렸다. “다음 주 수요일에 큰 업데이트를 공개합니다. 미리 스타를 눌러두세요.” 단순한 말이지만 효과가 있었다.

타이밍 조율 Product Hunt 출시일과 GitHub 대형 업데이트를 동일 날짜에 맞췄다. 두 플랫폼의 트래픽이 시너지를 냈다.

이메일 리스트 활용 뉴스레터 구독자에게 “GitHub에서 지지해달라”는 직접적인 요청을 보냈다. CTA를 명확하게 — “지금 스타 누르기” 버튼 하나.

전략 4: 커뮤니티를 먼저, 제품은 나중에

가장 반직관적인 조언이다.

스타를 늘리고 싶다면, 스타를 요청하기 전에 먼저 가치를 줘야 한다.

AFFiNE 팀은 Notion, Obsidian, Roam Research 관련 Reddit 서브레딧에서 6개월간 활동했다 — 제품 홍보 없이, 그냥 질문에 답하면서. (“AFFiNE 어떠세요?”라는 질문이 나올 때까지 기다렸다.)

신뢰가 쌓인 후에 자연스럽게 언급된 우리 제품에 대한 반응은 광고와 차원이 달랐다.

전략 5: README 번역으로 비영어권 시장을 열어라

GitHub 사용자의 60%는 비영어권이다. 그런데 대부분의 오픈소스 프로젝트는 영어 README 하나만 있다.

AFFiNE은 중국어, 일본어, 한국어 README를 추가했다. 각 언어별로 해당 지역 커뮤니티에서 소개 게시글을 올렸다.

한국어 번역 추가 후 한국 개발자 스타 유입이 3주 만에 400% 증가했다.

전략 6: CONTRIBUTING.md를 실제로 관리하라

“Good First Issue” 태그가 붙은 이슈가 있는 프로젝트는 없는 프로젝트보다 평균 3.4배 더 많은 외부 기여를 받는다 (GitHub 자체 데이터).

기여자가 늘면 그들이 자신의 네트워크에 프로젝트를 공유한다. 유기적 성장의 핵심이다.

우리는 매달 “Hacktoberfest 스타일” 이슈를 만들었다 — 쉽고 명확하고 반응이 보장된 것들.

전략 7: 애널리틱스로 피드백 루프를 만들어라

감으로 하지 마라.

우리는 다음을 매주 추적했다:

  • 어느 채널에서 트래픽이 오는가
  • README의 어느 링크가 클릭되는가
  • 어느 이슈 타입이 가장 많은 참여를 받는가

데이터가 전략을 바꿨다. Hacker News보다 Reddit이 3배 더 효과적이라는 걸 알게 된 후 리소스를 재배분했다.

마무리: 스타는 결과물이다

GitHub 스타는 목표가 아니라 지표다. 진짜 목표는 사람들이 실제로 사용하고 싶은 제품을 만드는 것.

하지만 그 제품을 알리기 위한 전략은 분명히 존재한다. 위의 7가지 전략은 AFFiNE이 3,200에서 60,000+으로 가는 동안 실제로 효과 있었던 것들이다.

지금 당신의 GitHub 프로젝트 README를 열어보라 — 그리고 첫 문장이 기술 설명으로 시작하고 있다면, 오늘이 바꿀 날이다.