바이브코딩 구현, 한 기능을 어디까지 확인할까 — Superpowers 활용 3편
주문 마감 기능으로 배우는 테스트와 중간 저장
AI가 작성한 콘텐츠입니다. 실제 AI 기술에 근거하며, 활용 장면·인물·미래 상황에는 허구가 포함될 수 있습니다.

마감 버튼을 누르니 화면에 자물쇠가 떴다. 담당자는 샌드위치 세 개를 주방에 전달했다. 그런데 직원이 마감 전에 열어 둔 휴대전화 화면에서 주문하자 새로고침 뒤 수량이 네 개로 바뀌었다. 버튼은 작동했지만, 확정 수량을 지켜야 한다는 개발 목표는 아직 달성하지 못했다.
이 글은 가상의 점심 주문 앱을 이어서 다룬다. 앞에서 정한 규칙은 단순하다. 담당자가 수동으로 마감하면 그때의 수량이 기록에 남고, 이후 일반 사용자의 주문과 취소는 거절된다. 이번에는 이 규칙을 코드로 옮길 때 작업을 어떻게 나누고, 각 작업이 끝났다는 근거를 어떻게 확보하는지 살펴본다.
첫 변경은 한 문장으로 설명할 수 있어야 한다
AI에게 “계획대로 다 만들어 줘”라고 하면 마감 화면, 데이터 저장, 주문 처리까지 한 번에 바뀔 수 있다. 최종 화면에서 숫자가 틀렸을 때 무엇을 의심해야 할지 좁히기 어렵다. 첫 변경의 범위를 한 문장으로 정해 보자. “담당자가 마감하면 그때의 수량과 마감 상태가 함께 남는다.” 오래 열어 둔 화면의 주문 거절은 다음 작업이다.
첫 작업을 확인할 때는 주문이 있는 상태에서 마감하고, 페이지를 다시 열었을 때도 같은 확정 수량이 보이는지 본다. 저장을 일부러 실패시키는 테스트에서는 성공 안내가 뜨지 않아야 한다. 마감 상태만 바뀌고 수량이 남지 않는 경우도 확인한다. 이 둘이 어긋나면 담당자는 주문을 더 받을 수도, 주방에 줄 수량을 확인할 수도 없다.
변경 단위를 작게 잡는 이유는 파일 수를 줄이기 위해서만은 아니다. 작업 전에는 어떤 결과를 기대하는지 설명할 수 있고, 끝난 뒤에는 무엇이 달라졌는지 따로 확인할 수 있어야 한다. 마감 상태와 수량 기록을 함께 저장하는 데 파일 여러 개가 필요하더라도 두 결과가 함께 성립해야 한다면 같은 작업으로 두는 편이 자연스럽다.
테스트가 먼저 실패하는 것을 보는 이유
두 번째 작업은 마감 이후 주문을 거절하는 것이다. 먼저 다음 장면을 자동으로 확인하는 테스트를 생각해 보자. 샌드위치 세 개로 마감한 뒤 추가 주문을 보낸다. 프로그램은 마감됐다고 응답하고 확정 수량은 세 개로 남아야 한다.
같은 주문을 보내 수정 전후를 비교한다
거절 기능을 넣기 전 테스트를 실행했더니 실제로 주문이 받아들여졌다면, 그 테스트가 고치려는 문제를 포착한 것이다. 반대로 테스트 실행 도구가 설치되지 않아 중단됐다면 환경을 준비한 뒤 다시 실행해야 한다. 실행 오류만으로는 마감 규칙을 확인했다고 할 수 없다. 처음부터 통과했다면 기존 코드가 이미 막고 있는지, 테스트가 실제 주문 경로를 거쳤는지부터 살핀다.
그다음 프로그램이 주문을 최종적으로 받아들이는 곳에서 현재 마감 상태를 확인하도록 구현하고, 같은 테스트를 다시 실행한다. 새 주문을 막았더라도 마감 전 정상 주문까지 거절되면 일상 업무를 깨뜨린다. 새 테스트 결과와 함께 기존 동작을 확인하는 이유다. 코드 정리가 필요하다면 동작을 확인한 뒤 진행하고, 정리 후에는 같은 검증을 다시 실행한다.
Superpowers의 test-driven-development는 이런 순서를 지시한다. 기대한 동작을 테스트에 적고, 원하는 이유로 실패하는지 본 뒤, 필요한 구현을 하고 다시 확인하는 방식이다. 화면의 색이나 내부 함수 이름처럼 쉽게 바뀌는 세부 사항보다 주문이 실제로 거절되는지처럼 업무에 영향을 주는 동작을 확인할 때 가치가 크다. test-driven-development 원문
정상 동작과 지켜야 할 경계를 함께 확인한다
| 확인할 상황 | 통과 기준 | 놓치면 생기는 일 |
|---|---|---|
| 마감 전 주문 | 샌드위치 한 개를 추가하면 현재 집계가 늘어난다 | 정상 주문까지 막힌다 |
| 담당자 마감 | 성공한 마감의 상태와 확정 수량을 다시 열어도 확인할 수 있다 | 주방이 기준으로 삼을 수량을 잃는다 |
| 오래 열린 화면의 추가 주문 | 주문이 거절되고 확정 수량이 유지된다 | 마감 뒤에도 주방 수량이 달라진다 |
| 마감 후 취소 | 취소가 거절되고 기존 주문과 확정 수량이 그대로 남는다 | 주문과 집계가 서로 어긋난다 |
| 저장 실패와 재시도 | 성공으로 안내하지 않으며 재시도해도 확정 기록이 중복되지 않는다 | 담당자가 미확정 수량을 전달하거나 어느 기록이 최종인지 혼동한다 |
표의 수치는 테스트에 넣을 가짜 데이터다. 비슷한 시각에 들어온 두 요청을 어떻게 처리할지는 업무 기준과 연결된다. 이 앱에서는 마감이 먼저 확정된 경우 추가 주문을 거절하고, 주문이 먼저 저장됐으면 그 주문까지 포함해 마감한다고 정할 수 있다. 휴대전화에서 버튼을 누른 시각과 서버가 변경을 확정한 순서는 다를 수 있으므로, 이처럼 어느 시점을 기준으로 삼을지 먼저 합의해야 한다.
자동 테스트는 같은 조건을 다음 변경에서도 반복해서 검사하는 데 좋다. 직접 확인할 때는 담당자 화면과 직원 화면을 나란히 열어 실제로 어떤 안내가 보이는지, 담당자가 주방에 전달할 수량을 헷갈리지 않는지 본다. 계산과 저장이 맞아도 안내가 불명확하면 직원은 주문이 들어간 줄 알 수 있다. 서로 다른 확인이 필요한 이유다.
흔한 실수는 테스트를 통과시키는 데 집중하는 것이다
AI가 “테스트 통과”를 보고했는데 확인한 것은 화면에 자물쇠가 뜨는지뿐이라면, 가장 중요한 늦은 주문 경로는 아직 열려 있을 수 있다. 보고를 받을 때는 테스트 이름보다 그 테스트가 실제로 어떤 행동을 하고 무엇을 비교하는지 읽어 보자. 이 사례라면 화면에 마감 표시가 나타나는 것에 더해, 주문이 거절되고 저장된 수량이 유지되는지까지 확인해야 한다.
또 다른 실수는 새 기능과 무관한 기존 테스트가 실패했는데 작업을 끝낸 것으로 처리하는 것이다. 실패가 원래부터 있었는지 판단하려면 변경 전 결과가 있어야 한다. 실패를 기록하고 원인을 확인한 뒤 다음 작업에 미치는 영향을 판단한다. 원래 계획과 상관없는 코드까지 곧바로 고치면 변경의 경계가 다시 흐려질 수 있다.
Superpowers의 verification-before-completion은 완료를 알리기 전에 해당 검증을 실행하고 결과를 읽도록 요구한다. 주문 앱에서는 “마감 테스트 통과”와 “두 기기에서 실사용 흐름을 확인함”을 별도로 보고하면 판단하기 쉽다. verification-before-completion 원문
확인한 결과를 다음 작업의 출발점으로 남긴다
마감 상태와 수량 기록을 확인했다면 그 변경을 구분해 저장한다. Git에서 커밋은 프로젝트 파일의 변경 이력을 남기는 단위다. “수동 마감과 확정 수량 기록”처럼 어떤 동작이 포함됐는지 제목을 붙이고, 확인한 결과는 작업 메모에 적는다. 다음 작업에서 주문 입력이 망가지면 두 시점 사이에 무엇이 바뀌었는지 비교할 수 있다.
검증을 마친 변경을 다음 작업의 출발점으로 남긴다
작업을 이어받을 때 필요한 메모는 간단하다. 현재 확인한 것, 다음에 확인할 것, 아직 남은 문제가 무엇인지 적는다. 예를 들면 마감 기록의 재조회는 확인했고, 오래 열린 화면의 주문 거절은 다음 작업이며, 여러 요청이 동시에 들어오는 상황은 아직 검증하지 않았다는 식이다. 새 대화에서 다시 시작하더라도 AI가 현재 상태를 추측하는 부담이 줄어든다.
코드 이력과 실제 주문 데이터의 복구는 따로 다뤄야 한다. 이전 코드를 다시 사용하더라도 이미 저장된 주문 기록은 함께 되돌아가지 않는다. 이 예제는 가짜 데이터에서 먼저 실행하고, 실제 데이터를 바꾸는 작업이 필요해지면 영향과 복구 방법을 따로 확인한다.
이번에는 마감 뒤 추가 주문을 거절하는 작업만 진행해 줘. 먼저 마감 후에도 주문이 들어가는 상황을 확인하는 테스트를 만들고, 어떤 이유로 실패했는지 보여 줘. 구현 후에는 추가 주문이 거절되는지, 확정 수량이 유지되는지, 마감 전 정상 주문도 계속 되는지 확인해 줘. 실행하지 못한 항목은 구분해서 알려 줘.
이 요청으로 AI에게 맡기는 것은 구현과 검증이다. 사용자는 늦은 주문을 어떻게 처리할지 결정하고, 결과가 주방의 실제 업무에 맞는지 확인한다. 다음 편에서는 문제가 다시 나타났을 때 어떤 증거부터 모으고 원인을 좁힐지 살펴본다.
더 구체적으로 묻고 답하기
Q1. 첫 작업이 너무 큰지 어떻게 알 수 있나요?
작업이 끝났을 때 무엇이 달라지는지 한 문장으로 말해 보자. “주문 앱 개선”에 로그인과 결제와 마감이 모두 들어 있다면 확인 기준도 여러 개다. “마감 뒤 추가 주문을 거절한다”로 좁히면 필요한 저장 상태와 확인할 행동이 보인다. 함께 성공해야 하는 동작은 한 작업 안에 둘 수 있다.
Q2. 기존 앱에 테스트가 하나도 없으면 어디부터 시작하나요?
이번 변경이 건드리는 중요한 동작부터 잡는다. 마감 기능이라면 기존의 정상 주문이 들어가는지 확인할 기준을 먼저 남기고, 새로 추가할 마감 후 주문 거절을 확인한다. 프로젝트가 자동 테스트를 실행할 준비가 안 됐다면 가짜 데이터로 재현 순서와 결과를 기록하고, 반복 확인이 필요한 핵심부터 자동화할 수 있다.
Q3. AI가 테스트의 기대값을 바꿔 통과시켰다면 어떻게 하나요?
왜 바꿨는지 업무 규칙과 대조해 보자. 확정 수량은 세 개여야 하는데 코드가 네 개를 만들어서 테스트의 기대값을 네 개로 바꿨다면, 실제 문제를 놓친 것이다. 요구사항이 정말로 바뀌었다면 변경한 규칙과 이유를 문서에 남기고 테스트를 수정한다.
Q4. 새 기능은 동작하는데 이전 기능이 깨졌다면 바로 되돌려야 하나요?
먼저 어떤 기능이 언제부터 실패했는지 확인한다. 변경 전 기록에서 정상이고 변경 후에만 실패한다면 이번 수정이 영향을 줬을 가능성이 크다. 작은 수정으로 원인을 해결할 수 있는지 확인하고, 영향이 넓거나 원인이 불명확하면 마지막으로 검증한 코드 상태와 비교한다. 실제 데이터까지 바뀌었다면 코드와 별도로 복구 범위를 확인한다.
Q5. AI에게 어떤 완료 보고를 받으면 다음 작업으로 넘어갈 수 있나요?
무엇을 바꿨는지, 어떤 조건으로 확인했는지, 무엇을 아직 확인하지 못했는지가 있으면 판단하기 쉽다. “마감 뒤 주문 거절과 확정 수량 유지 확인, 실제 운영 계정의 권한은 확인 전”처럼 범위를 드러내야 한다. 이 보고를 작업 계획에 연결해 두면 다음 변경 뒤에도 같은 기준으로 점검할 수 있다.
AI와 함께 작성했습니다. 주문 앱과 테스트 결과는 개발 과정을 설명하기 위한 가상 예시입니다.
AI가 작성한 콘텐츠입니다. 실제 AI 기술에 근거하며, 활용 장면·인물·미래 상황에는 허구가 포함될 수 있습니다.
이미지 3장은 설명용 AI 일러스트이며 실제 촬영 사진이나 실험 기록이 아닙니다.
참고 자료
- test-driven-development (2026.11.05 확인)
- verification-before-completion (2026.11.05 확인)
이 글의 이미지는 AI로 생성했습니다
바이브코딩 디버깅, 어디서부터 틀렸을까 — Superpowers 활용 4편

같은 가지의 다른 글
- AI 소개팅, 전 애인과 나눈 대화까지 넘기시겠습니까?
- [가상 미래] 2029년, 자율주행 택시 동시 정지로 도심 마비
- [가상 미래] 2031년, 배송 드론 연쇄 추락으로 광장 통제
- [가상 미래] 2033년, 수직농장 화재에 인근 주거지 정전
- AI 회의 대리 참석, “그 약속 제가 한 게 아닌데요”
- [가상 미래] 부산행 침대가 대전에서 멈췄다
- 챗GPT·제미나이·클로드, 내 일에 맞는 AI 고르는 법
- AI한테 광고를 맡겨 봤더니… 깃허브 인기 광고 스킬과 실제 사례
- 2023년 2월 이후 생성형 AI가 줄인 직업들, 숫자로 보니
- 구글이 학교에게 던진 최후통첩: AI 거부하면 검색도 끊는다
- 바이브코딩 개발 계획, 어디까지 정해야 할까 — Superpowers 활용 2편
- 바이브코딩으로 만든 앱, 언제부터 써도 될까 — Superpowers 활용 5편
- 대선을 준비하는 AI, 캠프와 선거기관은 어떻게 쓰나
- 신규창업 공약 지키미. AI가 상상하는 살기 좋은 세상 1부
- 신규창업 공약 지키미. AI가 상상하는 살기 좋은 세상 2부
- 신규창업 공약 지키미. AI가 상상하는 살기 좋은 세상 3부
- AI 주식 매매 프로그램 1편|공시로 후보 종목 찾기
- AI 주식 매매 프로그램 2편|공시 후보표 자동화
- AI 주식 매매 프로그램 3편|백테스트의 착시 줄이기
- AI 주식 매매 프로그램 4편|모의주문과 체결 확인
- AI 주식 매매 프로그램 5편|손실을 키우지 않는 주문·중단 기준
- AI 에이전트
- 로봇
- 개인 AI
- 바이브코딩 첫 개발, 무엇부터 정해야 할까 — Superpowers 활용법
이미지: Cloudflare (@cf/black-forest-labs/flux-2-klein-9b)