11장. 바이브코딩 전체 지도

지금까지의 실습은 바이브코딩의 최소 동작 루프입니다.

AI와 계획하기
→ 레포 가져오기
→ 파일 고치기
→ 로컬에서 확인하기
→ GitHub에 Push하기
→ Vercel로 배포하기

이 루프만 돌아도 “내 사이트를 만들고 인터넷에 올리는 경험”은 할 수 있습니다. 하지만 이게 바이브코딩 전체는 아닙니다. 진짜로 계속 만들려면 아래 지도가 필요합니다.

바이브코딩에 필요한 큰 축

지금 부족한 것은 무엇인가요

이 코스는 처음 온보딩이라 일부러 깊게 들어가지 않았습니다. 그래서 다음 내용은 “지금 당장 다 해야 할 것”이 아니라 “앞으로 바이브코딩을 계속하려면 만나게 될 것”입니다.

1. 오픈소스 읽는 힘

Fork와 Clone만 할 줄 안다고 오픈소스를 쓸 수 있는 것은 아닙니다. 최소한 아래를 볼 수 있어야 합니다.

• README: 이 레포가 무엇을 하는지
• 설치 방법: 내 컴퓨터에서 어떻게 실행하는지
• 라이선스: 써도 되는지
• 최근 커밋: 아직 관리되는 레포인지
• 이슈: 사람들이 어디서 막히는지
• 폴더 구조: 내가 고칠 파일이 어디인지

AI에게는 이렇게 시키면 됩니다.

이 레포를 초보자 기준으로 분석해줘.
1. 이 레포가 하는 일
2. 실행 방법
3. 내가 고치면 안 되는 위험한 파일
4. 내가 먼저 봐야 할 파일
5. 내 목적에 맞게 바꿀 수 있는 지점
순서로 정리해줘.

2. Git을 안전장치로 쓰는 힘

Git은 개발자 시험 과목이 아니라 AI에게 일을 맡길 때의 안전장치입니다.

최소 요청문:

작업 시작 전에 현재 상태를 확인하고,
되돌릴 수 있게 커밋이 필요한지 판단해줘.
바뀐 파일 목록을 보여준 뒤 진행해줘.

3. 도구를 직접 쓰는 힘

AI가 대신 실행해줘도, 내가 무엇을 시킨 건지는 알아야 합니다.

• npm run dev: 내 컴퓨터에서 미리보기
• npm run build: 배포 전에 깨지는지 확인
• git status: 어떤 파일이 바뀌었는지 확인
• git diff: 무엇이 바뀌었는지 확인
• gh auth status: GitHub 로그인이 되어 있는지 확인

명령어를 외울 필요는 없습니다. 대신 AI에게 “무엇을 확인해야 하는지”를 말할 수 있어야 합니다.

다음에 배울 순서

처음부터 API, MCP, 데이터베이스로 뛰어들면 금방 복잡해집니다. 순서는 이렇게 가는 편이 좋습니다.

1. Git 안전장치 — 커밋, diff, 브랜치, 되돌리기
2. 오픈소스 분석 — README, 설치, 실행, 구조 읽기
3. Claude Code 작업 구조 — AI가 파일과 명령을 어떻게 다루는지
4. 스킬 — 반복되는 작업을 절차로 저장하기
5. MCP — 외부 도구를 AI가 직접 쓰게 하기
6. API — 내 앱이 외부 서비스와 데이터 주고받기
7. 데이터베이스 — 여러 사용자의 데이터를 저장하고 운영하기

이번 코스는 14의 입구를 열고, 57은 “무엇인지 알고 다음 과정으로 넘어갈 수 있게” 만드는 것을 목표로 합니다.