KKflow

GUIDE · 바이브 코딩

바이브 코딩을 시작할 때 알아 두면 좋은 일곱 가지

AI에게 설명하며 함께 코드를 만드는 바이브 코딩. 요청을 작게 나누고, 계획을 먼저 묻고, 자주 저장하고, 실행해서 확인하는 것까지, 결과를 크게 바꾸는 습관 일곱 가지를 정리했습니다.

· KKflow

바이브 코딩은 AI에게 원하는 것을 말로 설명하고, AI가 만든 코드를 함께 다듬어 가는 작업 방식입니다. 코드를 한 줄도 모르는 사람도 결과물을 만들 수 있게 됐지만, 같은 도구를 써도 결과의 질은 사람마다 크게 다릅니다. 차이를 만드는 건 대부분 프롬프트 문장력보다 작업 습관입니다. 처음 시작할 때 알아 두면 좋은 일곱 가지를 정리했습니다.

1. 기능이 아니라 결과를 설명하기

"로그인 기능 만들어 줘"보다 "처음 온 사람이 이메일 없이 닉네임만 정하고 바로 랭킹에 오를 수 있으면 좋겠어"가 훨씬 좋은 요청입니다. 무엇을 만들지보다 사용자가 무엇을 겪어야 하는지를 설명하면, AI가 더 알맞은 방법을 고르고 내가 미처 생각하지 못한 선택지를 제안하기도 합니다. 누가 쓰는지, 어떤 기기에서 쓰는지, 꼭 지켜야 할 조건(예: 개인정보를 서버에 저장하지 않기)을 함께 적어 주세요.

2. 한 번에 하나씩, 작게 나누기

"쇼핑몰 전체를 만들어 줘" 같은 요청은 그럴듯한 껍데기를 만들어 주지만, 어디서 무엇이 잘못됐는지 알기 어렵게 만듭니다. 화면 하나, 기능 하나 단위로 나눠서 요청하고, 하나가 제대로 동작하는 걸 확인한 뒤 다음으로 넘어가세요. 단계가 작을수록 문제가 생겼을 때 원인이 바로 앞 단계에 있다는 걸 알 수 있습니다.

3. 코드보다 계획을 먼저 묻기

조금 큰 작업이라면 바로 코드를 받기 전에 "어떻게 만들 건지 먼저 설명해 줘"라고 요청하세요. 어떤 파일을 고치고 어떤 구조로 만들지 계획을 먼저 보면, 방향이 틀렸을 때 코드가 쌓이기 전에 바로잡을 수 있습니다. 계획 단계에서 "더 단순한 방법은 없어?"라고 한 번 더 묻는 것도 좋은 습관입니다.

4. 자주 저장하기 (버전 관리)

AI는 한 번에 여러 파일을 고칩니다. 잘 되던 것이 다음 요청에서 망가지는 일도 흔합니다. 그래서 잘 동작하는 상태마다 저장 지점을 만들어 두는 게 중요합니다. Git을 쓴다면 기능 하나가 동작할 때마다 커밋하세요. 문제가 생기면 마지막으로 잘 되던 지점으로 돌아가 다시 시도하면 됩니다. Git이 낯설다면 "지금 상태를 커밋해 줘"라고 AI에게 부탁해도 됩니다.

5. 반드시 실행해서 확인하기

AI가 "완성했습니다"라고 말해도 직접 실행해 보기 전까지는 완성이 아닙니다. 화면을 열어 실제로 눌러 보고, 휴대폰 크기에서도 확인하세요. 계산이 중요한 기능이라면 정답을 아는 예시로 검증하는 테스트를 만들어 달라고 요청하세요. 사주 플로우의 만세력 엔진도 결과를 교차 대조하는 검증 테스트 수백 건으로 지키고 있습니다. 테스트가 있으면 나중에 다른 걸 고치다가 계산이 틀어져도 바로 알 수 있습니다.

6. 오류는 통째로 붙여 넣기

"안 돼"라고만 하면 AI도 추측할 수밖에 없습니다. 오류 메시지 전문, 무엇을 했을 때 생겼는지, 원래 기대한 결과가 무엇인지를 함께 알려 주세요. 같은 문제를 몇 번 고쳐도 해결되지 않는다면 대화가 너무 길어져 맥락이 엉킨 경우가 많습니다. 지금까지의 상황을 짧게 정리해서 새 대화로 다시 시작하면 의외로 쉽게 풀립니다.

7. 비밀값은 코드에 넣지 않기

API 키, 데이터베이스 비밀번호 같은 값을 코드에 직접 적으면 저장소를 공개하는 순간 그대로 노출됩니다. 비밀값은 환경 변수로 분리하고, 그 파일이 저장소에 올라가지 않게 제외 설정을 해 두세요. AI에게 "비밀값은 환경 변수로 빼 줘"라고 처음부터 요청하는 것이 가장 쉽습니다. 혹시 키가 노출됐다면 지우는 것만으로는 부족하고, 발급처에서 키를 새로 발급받아야 합니다.

정리: 일곱 가지 습관

  1. 기능이 아니라 사용자가 겪을 결과를 설명한다.
  2. 작게 나눠 하나씩 요청한다.
  3. 큰 작업은 계획부터 확인한다.
  4. 잘 될 때마다 저장 지점을 만든다.
  5. 직접 실행하고, 중요한 계산은 테스트로 지킨다.
  6. 오류는 전문과 상황을 함께 전달한다.
  7. 비밀값은 처음부터 코드 밖에 둔다.

바이브 코딩은 "AI가 대신 만들어 주는 것"보다 "AI와 함께 빠르게 만들고 확인하는 것"에 가깝습니다. 확인하는 습관만 갖추면, 혼자서도 꽤 큰 것을 만들 수 있습니다.