바이브코딩 방법론
팀에 안착시키는 세 톱니

Session 9 · 커밋 · 테스트 · 규약

개인 도구에서 팀 방법론으로 · 실패 사례 6선 · 팀 규약 초안 · 도입 로드맵 3단계

강사 박수현 · 🚀 젠아이랩스(GenAI Labs)

🎨 이미지 프롬프트: "Editorial illustration on dark navy #0f1722 background split in two. Left side shows a single lone developer silhouette at a laptop. Right side shows a team meeting room silhouette with five to seven people around a table. Between the two sides, three interlocking gears are labeled in English: 'Commit', 'Test', 'Convention'. One gear is slightly detached, tilting the right room toward collapse to suggest that a missing gear breaks the team. Clean editorial illustration style, teal #00b894 and purple #6c5ce7 accents with a hint of warm orange, 16:9. CRITICAL: All visible text MUST be in English ONLY (no Korean characters). Each label appears EXACTLY ONCE — no duplicates. No mirrored or reversed text."

Session 9 · 커밋 · 테스트 · 규약

PART 1

왜 방법론이 필요한가

개인 워크플로가 팀으로 확장될 때 균열이 나는 지점 5개 · 도입 문맥 3가지 · 검증된 실패 사례 6선 (2025 초기 4 + 2026 하반기 신규 2).

개인 도구에서 팀 도입으로 — 함정 5개

"내가 잘 쓰니 팀도 잘 쓰겠지" 는 성립하지 않는다. 개인 워크플로가 팀 워크플로로 확장될 때 다섯 지점에서 반드시 균열이 생긴다.

세 도입 문맥 — 스타트업 · 대기업 · 사내망

같은 도구라도 조직 성격에 따라 도입 방식이 달라진다. 이 강의는 세 문맥을 나눈다.

🎨 이미지 프롬프트: "Editorial illustration on dark navy #0f1722 background showing three vertical stacked cards arranged left to right. Each card has a distinct icon at the top and three short English lines below it labeled 'Priority', 'Blocker', 'First Action'. Card 1 icon is a rocket labeled 'Startup'. Card 2 icon is a corporate building labeled 'Enterprise'. Card 3 icon is a closed padlock labeled 'Regulated Internal'. Cards share a subtle inner glow; card backgrounds are slightly darker than the base. Clean editorial illustration style, teal #00b894 and purple #6c5ce7 accents, 16:9. CRITICAL: All visible text MUST be in English ONLY (no Korean characters). Each label appears EXACTLY ONCE — no duplicates. No mirrored or reversed text."

세 도입 문맥 — 스타트업 · 대기업 · 사내망

실패 회고 6선 — 검증된 사례만

"바이브코딩이 위험하다" 는 경고는 많지만, 실제 사고로 이어진 사례를 검증된 것만 골라 여섯 건을 소개한다. 초기 4선 (2025) + 2026 하반기 신규 2건. 이 사례들은 뒤 파트에서 대응책의 근거로 반복 인용한다.

🎨 이미지 프롬프트: "Editorial illustration on dark navy #0f1722 background showing four warning cards arranged in a 2x2 grid. Each card carries a single stylized icon and a short English label: an unlocked padlock labeled 'Replit DB wipe', a broken shield labeled 'Moltbook 1.5M tokens', a red triangle labeled 'Lovable CVE', a keyring labeled 'EnrichLead key leak'. Card backgrounds are darker than the base, with a thin red border on each. Clean editorial illustration style, teal #00b894 and purple #6c5ce7 accents with a hint of warm red, 16:9. CRITICAL: All visible text MUST be in English ONLY (no Korean characters). Each label appears EXACTLY ONCE — no duplicates. No mirrored or reversed text."

사례 1 · 2 — Replit · Moltbook

사례 3 · 4 — Lovable · EnrichLead

사례 5 · 6 — Agentjacking · RedAccess (2026 하반기 신규)

PART 2

커밋 단위

AI 페어링에서 커밋이 감당해야 하는 세 기능 · 기능당 3~10 커밋 원칙 · 나쁜 vs 좋은 시퀀스 대비 · 메시지 규약.

왜 AI 페어링에서 커밋 단위가 결정적인가

사람이 혼자 짤 때 커밋 단위는 "자기 기억 회복용" 이다. 잘못 잘라도 자기가 감당하면 된다. AI 페어링에서는 다르다. 커밋 단위가 세 기능을 동시에 수행해야 한다.

기능당 3~10 커밋 원칙

한 기능(feature) 을 완성하는 데 커밋 3~10개 사이가 실무에서 안정적으로 관찰된다. 3개 미만이면 리뷰 단위가 너무 크고, 10개 초과면 히스토리가 노이즈로 덮인다.

📦 표준 시퀀스 예 — "사용자 검색 API 추가"

1. feat(api): search endpoint skeleton (route + empty handler)
2. feat(api): search query param validation
3. feat(api): search DB query (with index)
4. test(api): search endpoint happy path + edge cases
5. docs(api): search endpoint OpenAPI spec
6. chore: search endpoint rate limit (100/min)

나쁜 vs 좋은 커밋 시퀀스 — 같은 기능, 두 결과

기능: "PR 자동 리뷰어에 슬랙 알림 추가" — 두 방식으로 커밋한 예.

9a3f1e2 add slack notification
        (2340 additions, 187 deletions)

1. c4d2a91 feat(notify): SlackClient wrapper
2. 8b7f302 test(notify): SlackClient unit tests
3. 3f19a4c feat(review): review completion hook
4. 6e2b105 feat(notify): wire hook → SlackClient
5. e91c204 test(notify): end-to-end flow test
6. 2a48d1f docs(notify): config guide
7. 5f31c9e chore(notify): env var validation

🎨 이미지 프롬프트: "Editorial split-screen illustration on dark navy #0f1722 background. Left panel has a red-tinted glow and shows a single terminal-style commit log line labeled 'Bad (2300 lines)' with a bloated block underneath and a small crossed-out rollback arrow. Right panel has a green-tinted glow and shows six neatly stacked commit rows labeled 'Good (6 focused)' with tiny diff-size badges next to each. A vertical divider separates the two panels. Clean editorial illustration style, teal #00b894 and purple #6c5ce7 accents with red and green highlights, 16:9. CRITICAL: All visible text MUST be in English ONLY (no Korean characters). Each label appears EXACTLY ONCE — no duplicates. No mirrored or reversed text."

커밋 메시지 규약 — 두 축

커밋 메시지 자체에 팀 규약을 얹는다. 두 축이 표준안이다.

🎨 이미지 프롬프트: "Editorial illustration on dark navy #0f1722 background showing three stacked commit-message UI mockups resembling a GitHub commit detail card. Card 1 shows a title line and a footer line reading 'Co-Authored-By: Claude' labeled 'Trailer' with a green check mark to its right. Card 2 shows a title with an inline suffix reading 'feat(api): search endpoint [AI]' labeled 'Suffix'. Card 3 shows a plain title only, labeled 'No Marking' in muted gray. Each card is a subtle window with a top status bar. Clean editorial illustration style, teal #00b894 and purple #6c5ce7 accents, 16:9. CRITICAL: All visible text MUST be in English ONLY (no Korean characters). Each label appears EXACTLY ONCE — no duplicates. No mirrored or reversed text."

PART 3

테스트 우선

테스트를 스펙으로 다루는 이유 · pytest·vitest 프롬프트 · CI 3게이트 · 반복 사용할 프롬프트 카드 3장.

AI 가 만든 코드에 테스트를 어떻게 붙이나

AI 페어링에서 테스트는 부속물이 아니라 스펙 그 자체 로 다뤄야 한다.

테스트 생성 프롬프트 — 5요소

AI 에 테스트를 생성시키는 프롬프트는 다음 5개 요소를 포함해야 한다.

표준 프롬프트 — pytest · vitest

routes/search.py 의 search_users() 에
pytest 테스트를 붙여줘.

요구:
- pytest + pytest-asyncio
- 픽스처: fake_db, fake_current_user
- 케이스:
  a) 정상: 검색어 매칭 3건 반환
  b) 경계: 빈 문자열 → 400
  c) 경계: 100자 초과 → 400
  d) 부정: 인증 안 됨 → 401
  e) 부정: 다른 조직 사용자 → 403
  f) 예외: DB 타임아웃 → 503 + 로그
- 커버리지: 라인 100%, 브랜치 90%+
- 파일: tests/routes/test_search.py

한 번에 하나 케이스씩,
pytest 실행 결과 붙여줘.

src/components/SearchBar.tsx 에
vitest 테스트를 붙여줘.

요구:
- vitest + @testing-library/react
- 케이스:
  a) 입력 시 debounce 300ms 후
     onSearch 호출
  b) 빈 입력 시 onSearch 호출 안 함
  c) API 실패 시 에러 배너 렌더
  d) 로딩 상태에서 스피너 표시
- 모킹: onSearch = vi.fn(),
  API 는 msw 로 인터셉트
- 파일: __tests__/SearchBar.test.tsx

각 케이스 만든 뒤 pnpm test 결과 붙여줘.

🎨 이미지 프롬프트: "Editorial illustration on dark navy #0f1722 background showing two side-by-side prompt cards resembling terminal windows. Left card is tinted teal and labeled 'pytest'. Right card is tinted purple and labeled 'vitest'. Both cards show a short bulleted list with prefixes indicating case types, with the last two bullets highlighted by a small red tag reading 'Negative Path'. Above the two cards a single banner reads 'Must specify negative paths and exceptions'. Clean editorial illustration style, teal #00b894 and purple #6c5ce7 accents, 16:9. CRITICAL: All visible text MUST be in English ONLY (no Korean characters). Each label appears EXACTLY ONCE — no duplicates. No mirrored or reversed text."

회귀 감지 — CI 3게이트

테스트를 만들었다고 끝이 아니다. CI 에 물려 있고, 실패 시 병합이 차단돼야 방법론이 완성된다.

🎨 이미지 프롬프트: "Editorial horizontal pipeline illustration on dark navy #0f1722 background showing three gates connected by a bright progress bar flowing left to right. Gate 1 icon is a wrench labeled 'Pre-commit · Local'. Gate 2 icon is a robot cog labeled 'CI · Actions'. Gate 3 icon is two person silhouettes labeled 'Human Review'. The progress bar is filled solid teal up to Gate 3 and shows a small red X badge above one alternate branch to indicate blocked merges on failure. Clean editorial illustration style, teal #00b894 and purple #6c5ce7 accents with red highlight, 16:9. CRITICAL: All visible text MUST be in English ONLY (no Korean characters). Each label appears EXACTLY ONCE — no duplicates. No mirrored or reversed text."

회귀 감지 — CI 3게이트

회귀 방지 프롬프트 카드 3장

반복 사용할 프롬프트를 카드로 저장. 팀 리포 prompts/regression/ 에 그대로 넣을 표준안이다.

이 PR 이 기존 pytest 를
깨는지 확인해줘.
1. 브랜치 로컬 체크아웃
2. pytest -q 실행 결과
3. 실패 시:
   - 원인 파일 · 라인 특정
   - 수정 방향 3개 제안
     (diff 크기 · 위험도)
   - 승인 없이 파일 수정 금지

다음 스펙을 pytest 테스트
목록으로 먼저 만들어줘.
- 스펙: [붙여넣기]
- 형식: 함수명 · 케이스
  · 예상 assert
- 코드는 아직 만들지 마
- 목록 승인 후
  다음 턴에 실제 테스트

pytest --cov=src 결과가
다음과 같아. [붙여넣기]
- 커버리지 70% 미만
  파일 3개
- 각 파일 커버 안 된
  브랜치 · 라인 표로
- 필요한 테스트 케이스
- 우선순위 (H/M/L) · 이유

PART 4

역할별 활용 패턴

같은 도구라도 주니어·시니어·팀 리드가 쓰는 방식이 완전히 다르다. 세 층위의 표준 워크플로.

왜 역할별로 워크플로가 갈리는가

같은 도구라도 주니어 · 시니어 · 팀 리드가 쓰는 방식이 완전히 다르다. 이걸 인식하지 않고 "AI 를 잘 쓰자" 는 슬로건만 던지면 도입이 실패한다.

주니어 개발자 — 학습 · 이해 · 자기 PR 리뷰

주니어에게 AI 를 "코드 생성기" 로 쓰게 하면 성장이 멈춘다. "설명자 · 리뷰어 · 학습 파트너" 로 쓰게 해야 한다.

이 함수가 뭘 하는지
라인 단위로 설명해줘.
- 각 라인의 목적
- 왜 이 자료구조인지
  (다른 선택지도)
- 실패할 수 있는
  5가지 상황

방금 쓴 PR 을 리뷰해줘.
- 놓쳤을 예외 5개
- 스타일이 CLAUDE.md
  컨벤션에 맞는지
- 성능 · 보안 우려
- 리뷰어 관점 질문 3개

"이벤추얼 컨시스턴시"
실무 예시로 설명해줘.
- 개념 정의
- 코드 예 (Python+Redis)
- 반대 개념 대비
- 우리 리포에서
  등장할 위치

🎨 이미지 프롬프트: "Editorial illustration on dark navy #0f1722 background. On the left, a stylized silhouette wearing a hard hat labeled 'Junior' stands with a book under one arm. To the right, three vertical prompt cards float in a row, each with a small icon and a short English caption at the top: card one 'Explain Code', card two 'Self PR Review', card three 'Learn Concept'. Below the cards, two red tag badges read 'No AI-first PR' and 'No untested commit'. Clean editorial illustration style, teal #00b894 and purple #6c5ce7 accents with red warning tags, 16:9. CRITICAL: All visible text MUST be in English ONLY (no Korean characters). Each label appears EXACTLY ONCE — no duplicates. No mirrored or reversed text."

시니어 개발자 — 자동화 · 문서 · 리서치

시니어는 이미 코드를 짤 줄 안다. 손에 익은 코드는 프롬프트 왕복 · 응답 대기 · 리뷰 반복을 합쳐도 직접 치는 편이 더 빠르다 — 타이핑 대체로는 이득이 없다. 시니어 워크플로를 가르는 질문은 하나. 어디에 시간을 쏟느냐 — 결정과 검수는 사람이 맡고, 나머지는 위임한다.

이 로그 파일 100개에서
세 지표를 CSV 로 저장.
- 지표: [명세]
- Python 3.11 + pandas
- cli 로 디렉토리 인자
- 실패 파일·라인 로그
- 결과 CSV 컬럼·샘플 3줄

논의를 아키텍처 결정
문서(ADR) 로 정리해줘.
- 논의: [붙여넣기]
- 배경·결정·근거·대안
  ·결과·미해결 이슈
- 3페이지 이내
- 미해결 이슈 3개+ 명시

"메시지 큐 - RabbitMQ vs
Redis Streams vs Kafka"
우리 문맥에서 비교.
- 문맥: [사용량·지연·팀]
- 셋업·운영·5년 유지보수
  ·실패 모드
- 문맥 맞는 것 하나 추천
- 반대 의견 대응 논거 2개

🎨 이미지 프롬프트: "Editorial illustration on dark navy #0f1722 background. On the left, a stylized silhouette with a short beard holding a coffee mug labeled 'Senior' stands in a slightly darker warmer tone than the junior figure. To the right, three vertical prompt cards float in a row with icons and short English captions at the top: card one 'Automation Script', card two 'ADR Draft', card three 'Option Comparison'. Below the cards, a single red tag reads 'No unreviewed deploy'. Clean editorial illustration style, teal #00b894 and purple #6c5ce7 accents with a warm amber highlight, 16:9. CRITICAL: All visible text MUST be in English ONLY (no Korean characters). Each label appears EXACTLY ONCE — no duplicates. No mirrored or reversed text."

팀 리드 — 규약 · 로드맵 · 지표

팀 리드는 대개 코드를 직접 짜지 않는다. 대신 팀이 AI 를 어떻게 쓸지 를 설계하는 데 AI 를 쓴다.

우리 팀에 Claude Code
도입 규약 초안 만들어줘.

포함:
1. 승인 정책
   (Plan · Default
   · Auto · Bypass)
2. 리뷰 정책
   (AI 트레일러 → 2인)
3. 비용 관리
4. 보안
5. 데이터 프라이버시
6. 감사 · 사고 대응

톤: 실행 가능한
구체 규칙, 슬로건 금지

30명 SaaS 스타트업에
Codex 도입 로드맵.

- 파일럿 (2~4주)
  참여자 · 성공 지표
  · 종료 조건
- 확산 (분기)
  대상 팀 · 지원 · 예산
- 표준화 (연)
  규약 · 온보딩 · 감사
- 단계별 리스크 3
- 조기 종료 신호 3
- 3년 TCO

AI 도구 효과 추적 지표.

- 생산성: 리드타임
  · 롤백 · 리뷰 왕복
- 품질: 회귀 버그
  · 프로덕션 사고
- 비용: 인당 월 토큰
  · 예산 대비 소진율
- 만족도: 서베이(분기)
  · 이탈 위험
- 지표별: 측정법
  · 임계선 · 대응

🎨 이미지 프롬프트: "Editorial illustration on dark navy #0f1722 background. On the left, a stylized silhouette standing in front of a whiteboard with a marker in hand, labeled 'Team Lead'. To the right, three vertical prompt cards float in a row with icons and short English captions at the top: card one 'Team Convention', card two 'Rollout Roadmap', card three 'Metrics Dashboard'. Faint sketchy diagrams appear on the whiteboard behind the silhouette. Clean editorial illustration style, teal #00b894 and purple #6c5ce7 accents, 16:9. CRITICAL: All visible text MUST be in English ONLY (no Korean characters). Each label appears EXACTLY ONCE — no duplicates. No mirrored or reversed text."

세 층위 — 한 페이지 요약

🎨 이미지 프롬프트: "Editorial illustration on dark navy #0f1722 background showing three tall side-by-side column cards, each with its own distinct background tint and header icon. Column 1 header is a graduation cap labeled 'Junior' on a teal-tinted card. Column 2 header is a coffee mug labeled 'Senior' on an amber-tinted card. Column 3 header is a clipboard labeled 'Team Lead' on a purple-tinted card. Under each header a small three-line stack shows 'Use', 'Prompt', 'Workflow' as short English tags. The three columns feel like a single visual anchor. Clean editorial illustration style, teal #00b894 and purple #6c5ce7 accents, 16:9. CRITICAL: All visible text MUST be in English ONLY (no Korean characters). Each label appears EXACTLY ONCE — no duplicates. No mirrored or reversed text."

PART 5

팀 규약 초안

규약 6섹션 · Anthropic·OpenAI 데이터 정책 · 한 페이지 예시 · 규약 유무 대비.

규약 문서 — 6개 섹션 표준

팀 규약 문서는 여섯 섹션이 표준. 이 여섯이 없으면 도입 후 반드시 어딘가에서 사고가 난다.

🎨 이미지 프롬프트: "Editorial illustration on dark navy #0f1722 background showing six hexagon tiles arranged in a honeycomb cluster (two rows of three, offset). Each hexagon carries one icon and one short English label: 'Acceptance' with a check mark, 'Review' with two person silhouettes, 'Cost' with a coin stack, 'Security' with a shield, 'Privacy' with a masked user, 'Audit' with a magnifying glass over a document. Hexagons share subtle interior gradients and are lightly connected by thin lines. Clean editorial illustration style, teal #00b894 and purple #6c5ce7 accents, 16:9. CRITICAL: All visible text MUST be in English ONLY (no Korean characters). Each label appears EXACTLY ONCE — no duplicates. No mirrored or reversed text."

Anthropic 데이터 처리 정책 (2026 상반기)

"우리 코드를 외부 LLM 에 보내도 되나" 는 팀 규약 문서에서 가장 자주 나오는 질문이다.

OpenAI 데이터 처리 정책 (2026 상반기)

규약 예시 — 한 페이지 요약 · 6 섹션 헤더

아래는 실무에서 그대로 채택할 수 있는 한 페이지 규약의 섹션 헤더. 전문은 워크시트에 인쇄된 상태로 배부.

🎨 이미지 프롬프트: "Editorial illustration on dark navy #0f1722 background showing a single large upright document icon centered on the slide. The document has a subtle drop shadow and a folded top-right corner. Its front reads a header 'AI Coding Convention v1.0' followed by six numbered section headers listed vertically as short English labels: '1 Acceptance', '2 Review', '3 Cost', '4 Security', '5 Privacy', '6 Audit'. Each section header has a small check mark to the left. The document glows softly along its edges. Clean editorial illustration style, teal #00b894 and purple #6c5ce7 accents, 16:9. CRITICAL: All visible text MUST be in English ONLY (no Korean characters). Each label appears EXACTLY ONCE — no duplicates. No mirrored or reversed text."

규약 없이 도입한 팀 vs 규약과 함께 도입한 팀

같은 도구를 같은 규모의 팀이 도입해도 결과가 크게 갈린다. 실패 사례 6선 (Part 1) 은 공통적으로 규약 부재였다 — 초기 4선은 개별 실수, 2026 신규 2건은 플랫폼·프로토콜 구조 실패.

PART 6

도입 로드맵 · 정리

파일럿 → 확산 → 표준화 3단계 · 성공 지표 3+3 · 실패 신호 4 · 한 문장 결론.

도입 로드맵 — 3단계 표준

방법론을 조직에 이식하는 데는 3단계가 표준. 이 순서를 건너뛰면 반드시 어딘가에서 무너진다.

🎨 이미지 프롬프트: "Editorial horizontal timeline illustration on dark navy #0f1722 background showing three stages arranged left to right, connected by a thin luminous arrow. Stage 1 icon is a beaker labeled 'Pilot · 2 to 4 weeks · 5 to 10 people'. Stage 2 icon is a wave with radiating dots labeled 'Rollout · 3 to 6 months · whole org'. Stage 3 icon is a Greek temple labeled 'Standardize · yearly · policy v1'. Each stage sits on a subtle pedestal with a small English tag showing the deliverable below. Clean editorial illustration style, teal #00b894 and purple #6c5ce7 accents, 16:9. CRITICAL: All visible text MUST be in English ONLY (no Korean characters). Each label appears EXACTLY ONCE — no duplicates. No mirrored or reversed text."

도입 로드맵 — 3단계 표준

성공 지표 · 실패 신호 — 3+3+4

도입이 되고 있는지 · 실패로 가고 있는지를 지표로 감별. 정량·정성 섞어서 3+3 이 실무 하한.

마무리 — 한 문장으로

바이브코딩은 개인 도구로는 이미 성숙했다. 실패 사례들이 보여준 건 도구의 한계가 아니라 규약 없이 도입한 팀의 한계다. 이 세션에서 다룬 커밋 · 테스트 · 팀 규약 · 로드맵 은 그 실패를 피하는 최소 세트다.

🎨 이미지 프롬프트: "Editorial illustration on dark navy #0f1722 background. Left side shows a single developer silhouette at a laptop; right side shows a team meeting room silhouette with people around a table. Between them, three interlocking gears labeled in English as 'Commit', 'Test', 'Convention' are now fully meshed and turning, indicated by soft curved motion arrows around each gear. The composition mirrors the cover but this time the gears are aligned and the room is upright. Clean editorial illustration style, teal #00b894 and purple #6c5ce7 accents with a hint of warm orange and green, 16:9. CRITICAL: All visible text MUST be in English ONLY (no Korean characters). Each label appears EXACTLY ONCE — no duplicates. No mirrored or reversed text."

"AI 는 도구를 쥐어주지만, 팀은 규약을 쥐어야 무너지지 않는다."