바이브코딩 지도

1단계 · 연장 고르기
어느 목수와 집을 지을까요?

집은 내가 짓습니다. 나는 건축주, AI는 목수입니다. 목수를 보내 주는 회사가 셋 있고, 어느 회사를 골라도 2단계부터는 같은 길을 갑니다.

마을 지도 그림: 건축주와 로봇 목수가 공구함 세 개 앞에 선 작업대, 설계도가 든 금고, 꾸미는 중인 집, 집을 실어 나르는 크레인과 트럭, 문패와 우편함이 있는 완성된 집이 징검돌 길로 이어진다

갈래는 1단계에서만 나뉩니다. 2단계부터는 모두 같은 길입니다.

1어느 회사 목수를 부를까요?

이미 돈을 내고 쓰는 AI가 있다면 그 회사를 고르세요. 아직 없다면 구글로 시작하면 됩니다.

다섯 갈래 한눈에 비교하기

갈래	창	필요한 구독	검은 화면	이런 분께
안티그래비티 2.0	전용 앱(에이전트 관리 화면)	구글 계정	없음	처음 하는 분, 입문 과정
D 클로드 데스크톱 앱	Claude 앱	Claude 유료	없음	클로드는 쓰는데 개발 도구는 처음
B 클로드 · VS Code	VS Code 옆 칸	Claude 유료	가끔	고급 과정, 오래 쓸 분
C 클로드 · 터미널	터미널	Claude 유료	늘	자동화·서버 작업
E 코덱스	코덱스 앱 · VS Code · 터미널	ChatGPT 유료	고르기 나름	ChatGPT를 이미 쓰는 분

목수에게 남기는 쪽지 세 가지

목수를 바꿔도 하던 일이 이어지는 비결은 프로젝트 폴더 안 글 파일 몇 장입니다. 모두 그냥 글(마크다운, .md)이라 메모장으로도 열 수 있습니다.

우리-가게-홈페이지/

AGENTS.md공통 작업 지시서. 세 회사 목수 모두 읽음

CLAUDE.md클로드 목수 쪽지. 첫 줄에 @AGENTS.md 한 줄만

.agents/skills/안티그래비티·코덱스의 매뉴얼 카드 함

사진-줄이기/SKILL.md카드 한 장 = 폴더 하나

.claude/skills/클로드의 매뉴얼 카드 함

사진-줄이기/SKILL.md같은 카드를 한 장 더 넣어 둠

AGENTS.md · 공통 작업 지시서

“이 집은 이렇게 짓는다.” 어느 목수가 와도 출근하자마자 읽습니다.

집 짓기로 보면: 현장 게시판에 붙여 둔 지시서

CLAUDE.md · 클로드 목수 쪽지

클로드만 읽습니다. 이 파일이 있으면 클로드는 AGENTS.md를 건너뜁니다. 그래서 첫 줄에 @AGENTS.md를 적어 게시판을 가리키게 합니다.

집 짓기로 보면: “게시판 먼저 보세요”라고 적은 쪽지

SKILL.md · 작업 매뉴얼 카드

“사진은 이렇게 줄인다”처럼 순서가 있는 일 하나를 적은 카드입니다. 세 회사가 같은 양식을 씁니다. 넣는 함만 다릅니다.

집 짓기로 보면: 연장통 속 “타일 붙이는 법” 카드

지시서는 늘 읽습니다목수가 출근할 때마다 처음부터 끝까지 읽습니다. 그래서 짧을수록 잘 지킵니다.

카드는 필요할 때만 꺼냅니다평소엔 카드 이름과 “언제 쓰는지”만 알고 있다가, 그 일이 생기면 펼쳐 봅니다. 그래서 길어도 괜찮습니다.

파일	안티그래비티	클로드코드 (D·B·C)	코덱스
`AGENTS.md`
`CLAUDE.md`	—		—
`GEMINI.md` (구글 전용 쪽지)		—	—
`.agents/skills/` 카드		—
`.claude/skills/` 카드	—		—

읽음 CLAUDE.md가 없을 때만 읽음. 그래서 CLAUDE.md 첫 줄에 @AGENTS.md

건축주의 세 줄 규칙

늘 지킬 것은 AGENTS.md 한 곳에만 씁니다.
클로드를 쓰면 CLAUDE.md 첫 줄에 @AGENTS.md를 적습니다.
순서가 있는 일은 스킬 카드로 뺍니다. 카드에는 이름과 언제 쓰는지를 꼭 적습니다.

AGENTS.md 예시

# 우리 가게 홈페이지

## 이 집은
- 동네 반찬가게 소개 페이지 한 장
- 보는 사람: 50~70대 단골손님

## 늘 지킬 것
- 글씨는 크게(본문 20px 이상)
- 색은 청록과 주황 두 가지만
- 손님 전화번호·이름은 화면에 쓰지 않기
- 고치기 전에 무엇을 바꿀지 먼저 말해 주기

게시판 지시서는 짧게. 다섯 줄 안팎이 잘 지켜집니다.

SKILL.md 예시

---
name: 사진-줄이기
description: 가게 사진을 홈페이지에 올리기 전에
  크기를 줄인다. 사진을 넣어 달라고 할 때 쓴다.
---

1. 가로 1200px 넘는 사진은 1200px로 줄인다
2. 파일 이름을 영어 소문자로 바꾼다
   (예: 김치찌개.jpg → kimchi-stew.jpg)
3. images/ 폴더에 넣고, 바꾼 목록을 알려 준다

맨 위 두 줄(name, description)만 목수가 늘 기억합니다.

설치 화면을 따라 하는 교재와 차시별 실습은 바이브코딩 과정에서 이어집니다.

그림 사전으로 말 먼저 익히기 바이브코딩 수업 보기

확인 근거(2026-11-05 공식 문서): 클로드코드: CLAUDE.md·AGENTS.md · 클로드코드: 스킬 · 안티그래비티: 규칙 · 안티그래비티: 스킬 · 코덱스: 스킬. 도구 화면과 요금은 자주 바뀌니 설치하는 날 한 번 더 확인하세요.

1단계 · 연장 고르기어느 목수와 집을 지을까요?