The State of Vibe Coding

바이브 코딩의 역사, 기술, 개념을 총정리하는 살아 있는 책. 서울대학교 데이터사이언스 특강 〈바이브 코딩〉 수업에서 교수와 수강생이 GitHub에서 함께 쓰고, 학기마다 새 판을 낸다.

A living book on the history, art, and concepts of vibe coding, co-written on GitHub by the instructor and students of SNU's Special Topics in Data Science: Vibe Coding, updated every year the course runs.

읽기

	한국어 (원문)	English (AI-translated)
웹	https://oksure.github.io/vibecoding/	https://oksure.github.io/vibecoding/en/
PDF	the-state-of-vibe-coding-ko.pdf	the-state-of-vibe-coding-en.pdf

이 책이 다루는 것

여섯 부, 열여덟 장, 그리고 계속 자라는 개념 사전.

• 제1부 바이브 코딩의 탄생과 역사
• 제2부 바이브 코딩 실전 A to Z
• 제3부 바이브 코딩으로 만든 코드, 어떻게 믿을까
• 제4부 바이브 코딩 시대의 소프트웨어 공학
• 제5부 바이브 코딩 시대, 배우고 일하는 법
• 제6부 바이브 코딩의 미래
• 개념 사전

전체 대, 중, 소주제 목록은 TOPICS.md에 있다.

수업과 책

이 책은 수업의 산출물이면서 동시에 수업 그 자체다.

• 세미나형 운영. 교수 강의는 전체의 3분의 1 이하. 나머지는 학생 조사, 발표, 토론이다.
• 티칭 팀이 목차를 잡고, 학생이 꼭지를 고른다. TOPICS.md의 꼭지를 선착순 self-select 한다. 담당 꼭지에 자기 이름을 적는 PR이 이 수업의 첫 PR이다. 꼭지마다 브리프(다룰 것, 시드 질문, 조사 포인터)가 준비되어 있다.
• 꼭지 하나 = 파일 하나. 담당자는 조사해서 수업에서 발표하고, 토론을 반영해 자기 파일을 쓴다. 다른 사람의 파일은 PR 리뷰로만 관여한다.
• 집필은 GitHub에서. 브랜치, PR, 동료 리뷰. 책을 쓰는 과정 자체가 AI 시대 협업의 실습이다.
• 매년 새 판. 다음 학기가 열리면 그 학기의 수강생이 이전 판을 이어받아 갱신한다. 그래서 제목이 "The State of" Vibe Coding이다.

운영 상세는 SYLLABUS.md, 기여 방법은 CONTRIBUTING.md를 보라.

언어 정책

• 한국어판(ko/)이 1차 원문이고, 영어판(en/)은 AI가 자동 번역한다(tools/translate).
• 영어가 더 편한 저자가 맡은 장은 예외다. 챕터 머리의 authoritative-lang: en을 바꾸고 en/쪽 파일을 직접 쓰면, 한국어판이 번역본이 된다.
• 번역 생성물에는 MACHINE-TRANSLATED 마커가 붙는다. 이 파일은 직접 고치지 않는다. 원문을 고치고 번역을 다시 돌린다.

리포 구조

TOPICS.md        꼭지 목록 + 담당 현황 (self-select 게시판)
ko/              한국어판 (Quarto book, 기본 원문)
  chapters/      중주제: 중주제를 맡은 팀이 담당하여 집필
  sections/      소주제: 소주제를 맡은 팀원이 담당하여 집필
  glossary/      개념사전
en/              영어판 - 동일한 구조로 구성
tools/
  build          웹(HTML) + PDF(Typst) 빌드, _site/ 조립
  translate      ko <-> en AI 번역 (변경된 파일만, -j 병렬)
  new-section    새 꼭지 스캐폴드
  new-chapter    새 챕터 스캐폴드
.github/         CI: push마다 빌드해서 GitHub Pages로 배포

로컬 빌드

Quarto 1.8 이상과 Python(PyYAML)이 필요하다. PDF까지 빌드하려면 Noto Sans CJK 폰트가 있어야 한다.

tools/build html ko    # 한국어 웹판만 (집필 중 확인용, 가장 빠름)
tools/build            # 전체: ko+en HTML/PDF -> _site/
tools/translate        # 변경된 챕터만 AI 번역 (claude CLI 필요)

ko/에서 quarto preview를 실행하면 실시간 미리보기가 뜬다.

라이선스

본문은 CC BY-SA 4.0, tools/의 코드는 MIT. LICENSE.md 참고.