소모임 소개

2월 입문 교육 이후 공통으로 겪은 문제, 이 소모임이 그 답입니다

바이브코딩 소모임 1기는 2월 바이브코딩 입문 교육에 참여하셨던 여러분을 위해 설계된 후속 소모임입니다. 도구를 처음 써보는 설렘은 지났고, 이제는 실제로 써보니 막히는 지점들이 보이기 시작했을 겁니다.

입문 교육 후 공통으로 겪은 문제

여러분이 2월 이후 실제로 부딪혔을 세 가지 벽입니다. 하나라도 고개가 끄덕여진다면, 이 소모임이 여러분을 위한 자리입니다.

소모임 설계 의도

"만들기 전에 생각하기" — 이 소모임의 모든 것은 이 한 문장에서 시작됩니다

바이브코딩 소모임 1기는 단순히 도구 사용법을 더 가르치는 자리가 아닙니다. 여러분이 AI와 협업할 때 진짜 필요한 능력 — 설계하는 힘을 기르는 자리입니다.

이 소모임이 가르치지 않는 것

핵심 설계 철학

3주 커리큘럼 개요

0주차 사전 강의 포함, 총 4시간. 주차마다 딱 하나의 능력을 기릅니다

Kiro로 시작하는 바이브코딩 & Harness Engineering

코딩 없이 앱 만들기, 그리고 AI를 제대로 다루는 방법

바이브코딩이란?

많은 분이 바이브코딩을 "말로 코드를 만드는 것"으로 알고 계십니다. 맞습니다. 하지만 핵심은 다른 곳에 있습니다.

왜 Kiro인가? (+ Claude Code)

이번 소모임에서는 Kiro를 메인 도구로 씁니다. Claude Code를 이미 쓰고 계신 분도 걱정 마세요.

Kiro의 4단계 방식

Kiro가 특별한 이유는 "말 한 마디로 앱 완성"이 아니라, 단계별로 사람과 AI가 함께 확인하며 나아가기 때문입니다.

개발 전에 먼저 탐색하라

마치 집을 지을 때 도면도 없이 바로 벽돌을 쌓는 것과 같습니다. 나중에 방 위치가 잘못됐다고 벽을 허물면 이미 쓴 돈이 아깝죠. AI도 마찬가지입니다. 방향을 먼저 정하고 시작하면 토큰 낭비가 크게 줄어듭니다.

토큰을 아끼는 3단계 탐색법

실습 예제 — GS25 발주 자동화

이 한 문장으로 Kiro가 설계한 시스템은 다음과 같습니다.

Kiro가 이 시스템을 만들기 위해 생성한 태스크 목록은 딱 5개입니다.

Harness Engineering이란?

AI가 강력해질수록, 중요한 것은 AI가 얼마나 뛰어나냐가 아니라 여러분이 AI를 얼마나 잘 제어하느냐입니다. 말의 힘은 강하지만 방향을 잡아주는 마구가 없으면 엉뚱한 곳으로 달립니다.

Common Ground Truth

AI와 나 사이의 "정답 기준"

소모임 도입부에서 살펴본 세 가지 문제(재설명 반복, 엉뚱한 결과, 맥락 끊김)는 모두 하나의 원인에서 비롯됩니다.

해결책은 간단합니다. AI와 내가 공동으로 보는 기준 문서를 만들어두면 됩니다. 이것을 Common Ground Truth라고 합니다.

레이어 구조 — 층마다 AI를 다루는 방식이 달라야 한다

AI를 쓸 때 가장 많이 하는 실수는 모든 것을 같은 방식으로 대하는 것입니다. 집으로 비유하면, 가구 배치는 자주 바꿔도 되지만 기둥을 마음대로 바꾸면 집이 무너집니다.

Human in the Loop

AI가 알아서 다 하는 게 아닙니다. 매 단계마다 사람이 방향을 잡아주는 체크포인트가 필요합니다.

0주차 핵심 정리 3가지

오늘 강의에서 꼭 가져가실 것 딱 세 가지입니다.

구조를 설계하면 재현된다

PRD로 재현 가능한 결과 만들기 — 같은 결과가 다시 나오는 경험

1주차는 이 소모임의 가장 핵심적인 주차입니다. 여러분이 겪었던 "수정할 때마다 처음부터 재설명해야 하는 문제"는 PRD 하나로 해결됩니다.

왜 "재현 가능성"이 중요한가

요리사에게 레시피가 없다면 어떨까요? 오늘 맛있게 만든 음식을 내일 다시 만들 수가 없습니다. AI 작업도 마찬가지입니다.

1주차 실습 — PRD 작성해보기

여러분의 실제 업무 중 AI로 해결하고 싶은 과제 하나를 골라 PRD를 작성합니다.

1주차 실습 목표

• 내 업무 과제를 하나 선정하고 PRD를 작성한다
• 작성한 PRD로 Kiro/Claude에게 요청해서 결과물을 만든다
• 새 대화창을 열고 같은 PRD로 동일한 결과가 나오는지 확인한다
• "재현됐다!" 는 경험을 최소 한 번 한다

검증을 설계에 넣으면 무너지지 않는다

AI 자기검증 구조 경험 — AI가 스스로 점검하게 만들기

1주차에서 PRD로 재현 가능한 결과를 만드는 법을 배웠습니다. 2주차는 그 결과물이 의도대로 작동하는지 확인하는 법을 배웁니다.

AI에게 자기검증을 시키는 이유

AI는 틀린 결과를 자신감 있게 내놓을 수 있습니다. 코드가 실행되더라도 내가 원하는 결과가 아닐 수 있습니다. 검증을 설계에 넣으면 AI가 스스로 "이 결과가 맞는가?"를 확인하게 됩니다.

AI 자기검증 프롬프트 템플릿

복사해서 활용하세요

다음 PRD를 참고해서 현재 만들어진 결과물을 검토해줘.

[PRD 내용 붙여넣기]

검토 항목:
1. PRD의 기능 목록 중 구현되지 않은 것은?
2. 사용자 시나리오대로 실행했을 때 문제가 있는 부분은?
3. 성공 기준을 충족하는가?
4. 놓친 엣지 케이스는?

각 항목별로 구체적으로 답해줘.

2주차 실습 목표

• 1주차에서 만든 결과물에 AI 자기검증을 적용한다
• 검증을 통해 발견된 문제를 수정 지시로 해결한다
• 수정 후 다시 검증해서 문제가 해결됐는지 확인한다
• 검증 프롬프트 자체를 PRD에 추가해서 자산화한다

결과물을 자산으로 남긴다

PRD + 맥락 문서로 자산화 — 팀이 이어받을 수 있는 산출물

3주차는 소모임의 마지막 주차입니다. 1주차에 만든 PRD, 2주차에 추가한 검증 이력을 바탕으로, 팀이 이어받을 수 있는 완성된 문서 자산을 만듭니다.

왜 문서화가 AI 업무에서 특히 중요한가

일반 소프트웨어와 달리, AI로 만든 결과물은 "어떻게 만들었는지"를 기록하지 않으면 재현이 불가능합니다. 6개월 뒤 같은 결과물이 필요할 때, 프롬프트 히스토리를 처음부터 뒤져야 하는 상황을 막아야 합니다.

자산화 문서 구성

3주차 실습 목표

• 1~2주차 산출물을 정리해서 완성된 PRD 패키지를 만든다
• 팀원 1명에게 PRD만 주고 결과물을 재현할 수 있는지 테스트한다
• 3주 회고: "내가 배운 것"과 "아직 어려운 것"을 솔직하게 공유한다
• 소모임 이후 혼자서도 이어갈 수 있는 나만의 루틴을 정한다

운영 방식 & 참석자

소모임을 어떻게 운영하는지, 누가 함께 하는지 안내합니다

운영 방식

참석자

교육 정보

산출물 & 최종 체크리스트

3주가 끝나면 여러분 손에 남아야 할 것들

주차별 산출물

소모임 종료 후 체크리스트

3주가 끝나면 아래 체크리스트를 스스로 확인해보세요.

• PRD가 무엇인지, 왜 필요한지 설명할 수 있다
• 내 업무 과제의 PRD.md를 혼자서 작성할 수 있다
• Kiro의 4단계 방식으로 앱을 만들어본 경험이 있다
• AI에게 자기검증을 시키는 프롬프트를 쓸 수 있다
• Common Ground Truth가 무엇인지 동료에게 설명할 수 있다
• 레이어 구조 (UI / 문서 / API)를 이해하고 있다
• 나만의 프롬프트 패턴이 하나 이상 생겼다
• 팀원이 내 산출물을 이어받아 사용할 수 있다