바이브 코딩 · 운영·넘기기 · 10 / 10

혼자 한계에 왔을 때,
전문가에게 넘기는 법

바이브 코딩으로 여기까지 왔다면 이미 큰 일을 해냈습니다. 그런데 어느 순간 같은 오류가 반복되고, 사용자가 늘고, 결제나 개인정보가 붙기 시작합니다. 그때가 멈출 때가 아니라 넘길 때입니다. 잘 넘기면 지금까지 만든 것은 버려지지 않고 가장 정확한 설계도가 됩니다.

HandsMate 바이브 코딩 가이드 · 예상 읽기 7분
결론 먼저같은 문제가 반복되거나, 사용자·돈·개인정보가 커지기 시작하면 넘길 때입니다. 넘기기 전에 요구사항 한 장, 데이터 표 설계, 계정 대장, 실행·배포 방법, 알려진 문제 목록 다섯 가지를 정리하세요. 이 다섯 가지가 있으면 이어받는 쪽이 재사용 여부를 빠르고 정확하게 판단할 수 있습니다.

1. 이런 신호가 보이면 넘길 때입니다.

신호 1같은 문제가 반복된다

고친 버그가 다른 모양으로 계속 돌아옵니다.

신호 2코드를 설명할 수 없다

AI가 만든 부분을 내가 이해하지 못하는 비율이 커졌습니다.

신호 3사용자가 늘었다

내가 아닌 사람이 매일 의존하기 시작했습니다.

신호 4책임이 커졌다

결제, 개인정보, 외부 시스템 연동이 필요해졌습니다.

이 신호는 실패가 아니라 시제품이 제 역할을 다했다는 증거입니다. 1편의 ‘직접 → 함께 → 맡김’ 중 다음 길로 넘어갈 때가 된 것입니다.

2. 넘기기 전에 다섯 가지를 정리하세요.

자료담을 내용이 연재의 어디서
① 요구사항 한 장누가, 왜, 무엇을, 만들지 않을 것, 완료 기준3편
② 데이터 표 설계표·항목·관계, 상태·이력 규칙4편
③ 계정 대장도메인·서버·저장소·외부 서비스 소유와 비용9편
④ 실행·배포 방법어떻게 실행하고 어디에 어떻게 올리는지5편 저장 기록, 9편
⑤ 알려진 문제 목록아직 안 되는 것, 가끔 틀리는 것, 걱정되는 것7편 점검 결과

완벽하지 않아도 됩니다. 솔직한 알려진 문제 목록이 있으면 이어받는 쪽의 판단이 훨씬 빨라지고, 견적도 정확해집니다.

3. 이어받는 쪽은 이것부터 봅니다.

실행

다른 컴퓨터에서 돌아가는가

④ 실행 방법대로 처음부터 실행해 봅니다. 여기서 막히면 그 자체가 첫 번째 작업이 됩니다.

데이터

구조가 버틸 수 있는가

② 설계와 실제 표를 비교해 앞으로의 기능을 받칠 수 있는지 봅니다. 재사용 판단의 핵심입니다.

보안·권한

지금 위험한 곳은 없는가

비밀값, 서버 쪽 권한 확인, 개인정보 저장 상태를 먼저 확인합니다(6·8편).

반대로 화면 디자인이나 코드 스타일은 이 단계에서 크게 중요하지 않습니다. 데이터와 권한이 튼튼하면 화면은 얼마든지 다듬을 수 있습니다.

4. 재사용할까, 새로 만들까

이어서 쓰기 좋은 경우

다른 컴퓨터에서 실행된다 · 데이터 표가 업무를 잘 반영한다 · 권한을 서버에서 확인한다 · 저장 기록이 단계별로 남아 있다.

→
새로 만드는 편이 나은 경우

실행 방법을 아무도 모른다 · 한 표에 모든 정보가 섞여 있다 · 비밀값이 코드 곳곳에 있다 · 수정할 때마다 다른 곳이 깨진다.

새로 만들게 되더라도 시제품은 낭비가 아닙니다. 화면 흐름, 데이터 항목, 완료 기준이 이미 검증되어 있어 처음부터 말로 설명하는 것보다 기간과 비용이 크게 줄어듭니다.

5. 넘기는 방식은 하나가 아닙니다.

방식내가 하는 일전문가가 하는 일어울리는 경우
점검만 받기계속 직접 만든다데이터·권한·보안 설계 검토와 조언사내 도구, 사용자 소수
일부 맡기기화면·업무 흐름을 만든다로그인·결제·연동·배포 등 어려운 부분작은 서비스의 운영 전환
전체 맡기기요구사항과 검수에 집중한다설계부터 운영까지사용자·책임이 큰 서비스

처음부터 전체를 맡길 필요는 없습니다. 지금 가장 위험한 부분부터 작게 맡기는 것도 좋은 출발입니다.

6. 넘길 때는 ‘확인서’로 마무리하세요.

자료를 보냈다고 끝이 아닙니다. 이어받는 쪽이 실제로 실행하고, 배포하고, 계정에 접근할 수 있는지 확인하고 서로 서명하듯 체크해야 인계가 끝납니다.

핸즈메이트 프로젝트 표준문서의 ‘인수인계 확인서’를 그대로 써도 되고, 외주 인수인계를 다룬 MVP 가이드 26편도 같은 기준으로 참고할 수 있습니다.

7. 넘기기 전 체크리스트

요구사항 한 장을 최신으로 고쳤다.
데이터 표 설계와 실제 표가 일치하는지 확인했다.
계정 대장에 모든 계정과 비용, 만료일이 있다.
실행·배포 방법을 다른 사람이 따라 할 수 있게 적었다.
알려진 문제를 숨김없이 목록으로 적었다.
점검만 · 일부 · 전체 중 원하는 방식을 정했다.
한 줄 원칙

직접 만든 것은 버리는 것이 아니라, 넘겨서 키우는 것입니다.

이 연재의 열 편은 결국 한 가지를 위해 쓰였습니다. 내가 만든 것을 내가 설명할 수 있고, 다른 사람이 이어받을 수 있게 하는 것입니다. 직접 만든 시제품이 있다면 그대로 들고 오세요. 핸즈메이트가 이어서 함께 완성하겠습니다.