기획자를 위한 깃허브 첫걸음

“깃허브, 개발자만의 공간일까요?” 사실 깃허브는 이제 더 이상 개발자만의 도구가 아닙니다. 요즘은 기획자, 디자이너, 연구자, 대학생까지도 깃허브를 ‘나의 작업실’처럼 사용합니다. 그 이유는 간단합니다. 프로젝트의 변화 과정을 기록하고, 협업을 효율적으로 관리할 수 있기 때문입니다.

이 글에서는 기획자의 시선에서 깃허브를 이해하고, 실제로 어떻게 사용할 수 있는지 구체적으로 설명드리겠습니다.

---

깃허브 잘알려졌지만 의외로 잘 모르…

깃허브(GitHub)는 ‘Git’이라는 버전 관리 시스템을 기반으로 한 협업 플랫폼입니다. 즉, 파일의 변경 내역을 자동으로 저장하고, 언제든 과거 버전으로 되돌릴 수 있는 기능을 제공합니다.

기획자의 입장에서 보자면, 깃허브는 문서의 진화를 기록하는 타임머신과도 같습니다. 누가, 언제, 무엇을 수정했는지 명확히 남기기 때문에 협업 시 책임과 이력이 투명하게 관리됩니다.

---

기획자에게도 깃허브가 상당히 도움이 됩니다.

기획자는 하루에도 여러 번 정책 문서를 수정하고, 플로우나 UI 시안을 업데이트하며, 개발자와 지속적으로 조율합니다. 이 과정에서 버전이 섞이거나, “최신 파일이 무엇인지” 혼란스러울 때가 많습니다.

깃허브를 사용하면 이런 문제를 깔끔하게 해결할 수 있습니다.

• 수정 이력 관리 : 언제, 누가, 어떤 내용을 변경했는지 자동 기록됩니다.
• 버전 구분 : 문서 파일명이나 버전 태그로 v1.0, v1.1처럼 쉽게 관리할 수 있습니다.
• 협업 효율화 : 개발자와 동일한 플랫폼에서 이슈(issue)나 변경 요청을 관리할 수 있습니다.
• 지식 아카이브 : 프로젝트의 모든 기획, 정책, 회의 기록이 한눈에 정리됩니다.

이런 이유로 요즘 기획자들은 깃허브를 단순한 ‘코드 저장소’가 아닌, ‘업무의 흐름을 기록하고 공유하는 플랫폼’으로 활용하고 있습니다.

---

깃허브에서 사용하는 문서 형식: .md (Markdown)

깃허브의 대표 문서 형식은 .md, 즉 Markdown(마크다운) 입니다. 이 형식은 복잡한 서식을 넣지 않아도 텍스트만으로 구조화된 문서를 만들 수 있어, 기획자가 작성하기에도 매우 효율적입니다.

아래는 실제 기획 문서 예시입니다.

# 회원가입 프로세스 정책 (v1.2)
- 작성일: 2025.10.31
- 담당: 기획팀 김춘식

## 1. 목적
사용자가 회원가입을 완료하기 위한 최소 단계를 정의한다.

## 2. 플로우
1. 약관동의
2. 본인인증
3. 개인정보 입력
4. 가입완료

## 3. 정책 상세
- 본인인증은 PASS / KB인증서 사용
- 이메일은 선택 입력
- 추천인 코드 입력 필드는 선택사항

## 4. 변경이력
| 버전 | 일자 | 수정내용 | 작성자 |
|------|------|-----------|--------|
| v1.0 | 25.09.15 | 최초작성 | 춘식 |
| v1.1 | 25.10.01 | 이메일 항목 추가 | 춘식 |
| v1.2 | 25.10.31 | 추천인코드 추가 | 춘식 |

이 문서를 깃허브에 업로드하면, 자동으로 서식이 적용되어 웹페이지처럼 깔끔한 정책 문서 형태로 보이게 됩니다.

---

기획자가 깃허브를 활용하는 구체적인 방법

1. 정책 문서와 기획서 관리

프로젝트에서 정책이나 기획 문서는 지속적으로 수정됩니다. 이때, 깃허브에 .md 파일로 업로드하면 모든 변경 이력이 자동으로 기록됩니다. 수정 전후의 내용을 비교할 수 있어, 누가 언제 어떤 이유로 바꿨는지 명확히 남습니다.

2. 화면 플로우 및 UI 구조 정의

Figma 등에서 설계한 화면 흐름을 텍스트로 정리하면 개발자와 같은 언어로 소통하기 쉬워집니다. 예를 들어, “회원가입 화면 ID: join_01 → join_02 → complete” 이런 형태로 각 단계와 조건을 .md 파일로 문서화해두면 정책 변경 시에도 혼란 없이 대응할 수 있습니다.

3. API 요구사항 및 데이터 정의

기획자는 API의 동작 방식이나 요청/응답 형식을 간단한 표 형태로 정리해둘 수 있습니다. 이렇게 하면 개발자와의 커뮤니케이션이 빨라지고, 문서가 최신 상태로 유지됩니다.

# [API] 로그인 요청
- URL: /api/user/login
- Method: POST

## Request
| Key | Type | Description |
|-----|------|-------------|
| id | string | 사용자 ID |
| pw | string | 비밀번호 |

## Response
| Key | Type | Description |
|-----|------|-------------|
| result | string | 성공/실패 여부 |
| message | string | 안내 메시지 |

4. 회의록 및 의사결정 기록

회의 중 나온 논의 내용과 결정을 문서로 남기면, 나중에 “이 정책은 왜 이렇게 됐지?”라는 질문에 바로 답할 수 있습니다. 회의 날짜별로 meeting_YYYYMMDD.md 형태로 정리하면 깔끔합니다.

5. 이슈(issue) 기능 활용

깃허브의 “이슈(Issues)” 기능은 기획자가 개발자에게 요청사항이나 수정사항을 카드처럼 등록할 수 있는 기능입니다. 예를 들어 [기획요청] 포인트 잔액 표시 단위 변경 이런 식으로 올리면, 개발자는 댓글로 진행 상황을 남길 수 있습니다. 모든 대화와 결과가 한 화면에서 관리되기 때문에 협업이 훨씬 투명해집니다.

---

VS Code에서 .md 문서 작성하기

기획자가 깃허브를 쓸 때 가장 기본적인 도구는 VS Code입니다. 무료이며, 텍스트 기반 작업에 매우 적합한 에디터죠.

1. VS Code 공식 사이트에서 설치
2. 새 파일을 만들어 이름을 document.md로 저장
3. 제목(#), 리스트(-), 표(|) 기호로 구조 작성
4. Ctrl + Shift + V를 누르면 작성 중인 마크다운 문서를 미리보기로 볼 수 있습니다.
5. 완성된 문서를 깃허브에 업로드하면 자동으로 포맷이 적용됩니다.

워드처럼 복잡한 서식을 만들 필요가 없고, 텍스트 중심이라 훨씬 가볍습니다.

---

📁 깃허브 폴더 구성 예시 (기획자용)

📦 smartT-project
 ┣ 📂 01_Policy
 ┃ ┣ membership_policy.md
 ┃ ┗ refund_policy.md
 ┣ 📂 02_UIFlow
 ┃ ┣ login_flow.md
 ┃ ┗ payment_flow_v2.md
 ┣ 📂 03_API
 ┃ ┗ api_user_login.md
 ┣ 📂 04_Meeting
 ┃ ┗ meeting_20251031.md
 ┗ README.md  ← 프로젝트 개요 및 링크 모음

이렇게 정리하면, 기획자도 프로젝트를 ‘시스템적으로 관리하는 사람’이 됩니다. 문서가 파일 단위로 깔끔하게 정리되고, 개발자와의 협업 시 혼동이 줄어듭니다.

---

깃허브는 기획자의 생각과 과정이 쌓이는 기록소로도 활용될 수 있습니다.

마크다운 문서를 통해 정책과 흐름을 관리하고, VS Code를 활용해 문서화 습관을 들이면 시간이 지나도 지식이 낭비되지 않습니다.

기획자가 깃허브를 쓴다는 건, “내 아이디어의 역사를 기록한다”는 의미입니다. 처음에는 낯설지만, 익숙해지면 깃허브는 가장 든든한 업무 파트너가 됩니다.