Arrow keys / Space to navigate
NEXT SECURITIES / 2026

Git & GitHub
완전 정복

비개발자를 위한 친절한 안내서

Content Team Product Team

오늘 배울 내용

01
Git & GitHub이 뭔가요?
버전 관리의 기본 개념을 쉬운 비유로 알아봅니다
02
핵심 개념 알아보기
Repository, Branch, Commit 등 꼭 알아야 할 용어를 정리합니다
03
AI로 더 쉽게 사용하기
NPC Orchestrator로 Git 명령어 없이 작업하는 방법을 배웁니다
PART 01

Git이란?

파일의 모든 변경 이력을 기억하는 타임머신입니다.
문서를 수정할 때마다 자동으로 스냅샷을 찍어두고,
언제든 과거 버전으로 돌아갈 수 있어요.

기존 방식
보고서_최종.docx
보고서_최종_진짜최종.docx
보고서_최종_진짜최종_v2.docx
보고서_최종_진짜최종_v2_수정.docx
// 어떤 게 진짜 최종이지...?
Git 사용 시
보고서.docx 하나만!
v3 ─ 결론 수정 (오늘)
v2 ─ 이미지 추가 (어제)
v1 ─ 초안 작성 (그저께)
// 모든 버전이 자동 기록!
PART 01

GitHub이란?

Git으로 관리하는 프로젝트를 온라인에서 함께 작업하는 공간

Git
내 컴퓨터의 버전 관리 도구
= Word 문서 편집
혼자 작업 가능
내 PC에 저장
변경 이력 추적
GitHub
클라우드 협업 플랫폼
= Google Docs
여러 명이 동시 작업
클라우드에 백업
리뷰 & 승인 프로세스
핵심: Git은 도구, GitHub은 서비스입니다. Git으로 기록하고, GitHub에서 공유합니다.
PART 02

핵심 용어 한눈에 보기

📁
Repository
저장소
프로젝트의 모든 파일과 변경 이력이 담긴 폴더
🌿
Branch
가지
원본을 건드리지 않고 별도로 작업하는 공간
💾
Commit
저장
변경 사항을 기록하는 스냅샷 (세이브 포인트)
🤝
Pull Request
합류 요청
내 변경사항을 원본에 반영해달라는 요청
PART 02

Branch = 복사본에서 안전하게 작업하기

원본은 그대로 두고, 복사본에서 마음껏 수정합니다

main (원본)
feature-branch (내 작업 공간)
Merge!
비유: 회의 자료 수정하기
1.원본 파일(main)은 그대로 두고, 복사본(branch)을 만듭니다 2.복사본에서 마음껏 수정합니다 (실수해도 원본은 안전!) 3.수정이 완료되면 원본에 반영(merge)을 요청합니다 4.검토 후 승인되면 원본이 업데이트됩니다
PART 02

Commit = 게임 세이브 포인트

변경 사항을 의미 있는 단위로 기록하는 행위입니다

3/10 09:00
프로젝트 시작
3/10 14:00
첫 번째 글 작성
3/11 10:00
이미지 추가
3/11 15:00
오타 수정
3/12 11:00
최종 리뷰 반영
좋은 Commit 메시지란?
✓ "블로그 제목 오타 수정"
✗ "수정함"
✓ "3월 리포트 이미지 추가"
✗ "업데이트"
✓ "FAQ 섹션 새로 작성"
✗ "작업 완료"
Tip: 무엇을 왜 변경했는지 한 줄로 적으세요!
PART 02

협업의 전체 흐름

Branch 생성부터 Merge까지, 한 사이클을 따라가 봅시다

1
Branch 생성
작업 공간 만들기
→
2
작업 & Commit
내용 수정 + 저장
→
3
Push
GitHub에 올리기
→
4
Pull Request
리뷰 요청하기
→
5
Code Review
팀원이 검토
→
6
Merge
원본에 반영!
이 과정이 반복됩니다!
새로운 작업이 생길 때마다 Branch를 만들고, 작업 후 PR을 통해 리뷰받은 뒤 Merge합니다. 이렇게 하면 여러 사람이 동시에 작업해도 서로의 작업을 덮어쓸 걱정이 없습니다.
PART 02

Pull Request = 변경사항 합의 요청

"이 변경사항을 원본에 반영해도 될까요?"

PR #42: 3월 투자 분석 블로그 추가 Open
나
작성자 (나)
3월 AI 반도체 시장 분석 블로그를 작성했습니다.
변경 파일: blog-posts/ai-semiconductor-202603.md
팀
리뷰어 (팀장)
전반적으로 좋습니다! 결론 부분에 리스크 요인도 추가해주시면 더 좋을 것 같아요.
나
작성자 (나)
리스크 요인 추가했습니다. 확인 부탁드립니다!
팀
리뷰어 (팀장)
LGTM! (Looks Good To Me) 승인합니다. ✓
PART 02

자주 쓰는 Git 명령어

터미널에서 입력하는 기본 명령어들입니다 (참고용)

명령어의미비유
git clone프로젝트 복제하기공유 폴더를 내 PC에 다운로드
git pull최신 변경사항 받기구글 드라이브 동기화
git branch새 작업 공간 만들기문서 복사본 만들기
git add변경 파일 선택하기보낼 파일을 봉투에 넣기
git commit변경 사항 저장하기세이브 포인트 만들기
git pushGitHub에 올리기이메일 보내기 버튼
걱정 마세요! 다음 장에서 이 명령어들을 외우지 않아도 되는 방법을 알려드립니다.

이거...
다 외워야 하나요?

아닙니다!

AI가 대신 해드립니다

PART 03

NPC Orchestrator 소개

Next Product Content - 비개발자를 위한 통합 AI 도우미

한국어로 말하면, Git이 알아서 동작합니다
NPC는 여러분의 자연어 명령을 Git 명령어로 자동 변환합니다.
Branch 생성, 파일 작업, Commit, Push, PR 생성까지 전부 자동!
Git 명령어를 하나도 모르셔도 됩니다.
NPC 사용법은 배포 후 별도 세션에서 상세히 안내할 예정입니다. 오늘은 Git/GitHub의 기본 개념과 NPC가 무엇을 해주는지 이해하는 것이 목표입니다.
content-create
콘텐츠 생성
+ 자동 PR
skill-manage
크리에이터/포맷
추가 & 관리
pr-review
PR 자동 리뷰
+ 품질 점수
pr-merge
안전한
PR 머지
PART 03

한마디로 끝내는 콘텐츠 작업

BEFORE (기존 방식)
git checkout -b npc/blog-ai-semi
# 파일 작성...
git add blog-posts/ai-semi.md
git commit -m "feat: add blog"
git push origin npc/blog-ai-semi
gh pr create --title "..."
# PR 리뷰 요청...
# CI 확인 후 머지...
8단계 + Git 지식 필요
AFTER (NPC 사용)
"AI 반도체 투자 분석
블로그 써줘"
✓ Branch 자동 생성
✓ 시장 데이터 자동 수집
✓ 콘텐츠 AI 생성
✓ Commit + Push 자동
✓ PR 자동 생성
1마디 + Git 지식 불필요!
PART 03

PR 리뷰 & 머지도 간편하게

PR 리뷰
"PR #42 리뷰해줘"
•PR의 변경사항을 자동 분석
•구조화된 리뷰 코멘트 작성
•100점 만점 품질 점수 부여
•개선 제안까지 포함
PR 머지
"이 PR 머지해줘"
•CI/CD 상태 자동 확인
•테스트 통과 여부 검증
•Squash merge + 브랜치 정리
•실패 시 자동 수정 or 이슈 생성
안전장치 내장: 모든 작업은 격리된 공간(worktree)에서 진행 | 머지 전 반드시 사용자 확인 | NPC 생성 PR은 별도 라벨 관리
PART 03

팀별 활용 가능한 Skills

Content 팀과 Product 팀이 활용할 수 있는 AI 도구 모음

Content Team

content-create
블로그, 카드뉴스, 숏폼 스크립트 자동 생성
content-studio
크리에이터 페르소나 + 포맷 기반 콘텐츠
remotion
AI 투자 영상 자동 제작 (15-60초)
pr-review
작성한 콘텐츠 자동 품질 검토
pr-merge
검토 완료된 콘텐츠 안전하게 반영

Product Team

skill-manage
크리에이터/포맷 추가, 수정, 관리
rfc
기술 제안서 작성 (팀 합의용)
adr
의사결정 기록 (왜 이렇게 했는가)
thinking-partner
AI와 함께 아이디어 검증
devils-advocate
결정 전 반대 의견으로 리스크 확인
FAQ

자주 묻는 질문 (1/3)

Q. 실수로 잘못된 파일을 올렸어요!
A. 걱정 마세요! Git은 모든 변경 이력을 기록하기 때문에 언제든 되돌릴 수 있습니다. NPC를 사용하면 "방금 올린 거 취소해줘" 한마디로 해결됩니다.
Q. Conflict(충돌)가 발생했다는데 어떻게 하나요?
A. 두 사람이 같은 파일의 같은 부분을 동시에 수정하면 발생합니다. NPC를 사용하면 격리된 Branch + Worktree에서 작업하므로 충돌 발생 가능성이 크게 줄어듭니다. 만약 발생하더라도 NPC가 충돌을 감지하고 알려주므로, 개발팀과 함께 어떤 내용을 살릴지 결정하면 됩니다.
Q. main 브랜치에 직접 작업해버렸어요...
A. main은 "원본 보관함"이라 직접 수정하면 안 됩니다. 하지만 실수해도 복구할 수 있으니 당황하지 마세요. NPC는 항상 별도 Branch를 자동 생성하기 때문에 이런 실수가 원천 차단됩니다.
FAQ

자주 묻는 질문 (2/3)

Q. PR에서 수정 요청을 받았는데 어떻게 하나요?
A. PR은 대화의 공간입니다. 리뷰어의 피드백을 확인하고, 해당 내용을 수정한 뒤 다시 Commit하면 PR에 자동으로 반영됩니다. 새 PR을 만들 필요 없어요!
Q. 비밀번호나 API 키를 실수로 올리면 어떻게 되나요?
A. 매우 위험합니다! Git은 모든 이력을 기록하기 때문에, 파일을 삭제해도 과거 기록에 남아있습니다.
한번 올라간 비밀번호는 유출된 것으로 간주하고 즉시 변경해야 합니다.
예방법: .env 파일, 비밀번호, 토큰 등은 절대 Git에 올리지 마세요. .gitignore가 이를 보호하지만, 확신이 없으면 개발팀에 확인하세요.
Q. .gitignore 파일은 뭔가요?
A. Git에게 "이 파일은 무시해"라고 알려주는 설정 파일입니다. 예를 들어 비밀번호, API 키, 임시 파일 등을 실수로 올리지 않도록 보호합니다. 보통 개발팀이 미리 설정해두니 직접 수정할 일은 거의 없습니다.
FAQ

자주 묻는 질문 (3/3)

Q. git stash가 뭔가요?
A. 작업 중인 내용을 임시 서랍에 잠깐 넣어두는 기능입니다.
예를 들어, 블로그를 쓰다가 급하게 다른 작업을 해야 할 때:
git stash = 작업물을 서랍에 저장
git stash pop = 서랍에서 다시 꺼내기
비유: "책 읽다가 책갈피 꽂아두고 다른 책 읽기"
Q. git worktree는 뭔가요?
A. 하나의 프로젝트를 여러 폴더에서 동시에 작업할 수 있게 해주는 기능입니다.
보통은 Branch를 바꾸면 기존 작업을 stash하거나 commit해야 하지만, worktree를 쓰면 폴더 자체가 분리되어 독립적으로 작업할 수 있어요.
비유: "같은 문서를 탭 1개로만 열 수 있던 것을 여러 창으로 동시에 여는 것" NPC가 콘텐츠를 생성할 때 바로 이 worktree를 활용하여 안전한 격리 작업을 합니다!
Tip: stash와 worktree 모두 NPC가 자동으로 처리하므로 직접 사용할 일은 거의 없습니다. 개념만 이해해두면 개발팀과의 소통이 훨씬 수월해집니다!

오늘의 핵심 정리

1
Git은 파일 변경 이력을 추적하는 타임머신,
GitHub은 이를 온라인으로 공유하는 협업 공간입니다.
2
Branch로 안전하게 작업하고,
Pull Request로 리뷰받은 뒤 Merge합니다.
3
NPC Orchestrator를 사용하면 Git 명령어 없이
한국어 한 마디로 모든 작업을 완료할 수 있습니다.

Q & A

궁금한 점이 있으시면 질문해주세요!