바이브 코딩 입문자라면 꼭 알아야 할 개발 6단계와 "산출물" — AI에게 "알아서 만들어줘"가 잘 안 통하는 이유
코드를 몰라도 AI와 대화하며 프로그램을 만드는 바이브 코딩(Vibe Coding)이 유행입니다. 그런데 "알아서 멋있게 만들어줘"라고 하면 엉뚱한 결과가 나오거나, 고치다가 다른 곳이 망가지는 일이 자주 생깁니다. 이유는 대부분 개발 단계를 건너뛰었기 때문입니다. 코드는 AI가 써 줘도, 무엇을 만들지 정하고 제대로 됐는지 확인하는 일은 여전히 사람의 몫입니다.
실제 개발에서 코딩은 전체 과정 중 한 단계일 뿐이고, 각 단계가 끝날 때마다 산출물(Deliverable)이 남습니다. 개발을 잘 모르는 분과 바이브 코딩 입문자를 위해 단계별 산출물을 정리하고, 바이브 코딩에서 이를 어떻게 활용하는지 소개합니다.
📖 먼저 알아 둘 용어 5개
· 산출물: 각 단계가 끝나면 남는 결과물(문서, 그림, 코드, 테스트 기록 등)
· 프론트엔드 / 백엔드: 눈에 보이는 화면 쪽 / 화면 뒤에서 데이터를 가져오고 계산하는 서버 쪽
· API: 화면과 서버(또는 다른 서비스)가 데이터를 주고받는 "주문 창구"
· 커밋: 코드를 특정 시점 그대로 저장해 두는 것. 게임의 "세이브 포인트"와 비슷합니다
· 배포: 내 컴퓨터에서 만든 것을 인터넷에 올려 다른 사람도 쓸 수 있게 하는 것
산출물이 왜 중요할까
- 약속의 증거: "이렇게 만들기로 했다"를 고객과 팀이 함께 확인한 기록입니다.
- 다음 단계의 재료: 요구사항이 있어야 설계를 하고, 설계가 있어야 테스트 기준을 세웁니다.
- 사람이 바뀌어도 이어지게: 담당자가 바뀌어도 "왜 이렇게 만들었는지" 알 수 있습니다.
- 검수의 기준: 외주·SI 프로젝트에서는 산출물을 내야 단계 완료로 인정받는 경우가 많습니다.
1. 단계별 산출물 지도
STEP 1. 기획 — "왜 만들고, 무엇을 얻나?"
- 프로젝트 계획서: 목표, 범위, 일정, 예산, 인력을 정리한 문서
- WBS(작업 분해 구조)·일정표: 큰 일을 잘게 쪼개 누가 언제까지 할지 정리
- 위험 관리 계획: "외부 데이터가 끊기면?" 같은 위험과 대응책
- 타당성 검토서: 만들 가치와 기술적 가능성 검토 (주로 큰 프로젝트)
STEP 2. 요구사항 분석 — "정확히 무엇이 필요한가?"
- 요구사항 정의서: 기능마다 번호(REQ-01…)를 붙여 "사용자는 ○○를 할 수 있다"로 정리. 이 단계의 핵심
- 유스케이스·유저 스토리: "투자자로서 나는 ○○를 보고 싶다, 왜냐하면…"처럼 사용자 입장의 시나리오
- 요구사항 추적표(RTM): 요구사항이 어떤 설계·코드·테스트로 이어지는지 연결한 표
- 현행 분석서: 기존 시스템을 고치는 경우 지금의 동작 정리
STEP 3. 설계 — "어떻게 만들 것인가?"
- 화면 설계서(스토리보드·와이어프레임): 버튼 위치, 화면 이동, 문구까지 그린 문서
- 아키텍처 설계서: 서버·데이터베이스·외부 API의 연결 구조
- ERD·테이블 정의서: 데이터를 어떤 표(테이블)와 칸(컬럼)에 저장할지
- API 명세서: 화면과 서버가 어떤 주소로 어떤 형식의 데이터를 주고받을지 정한 약속
STEP 4. 구현 — "설계대로 동작하게 만들기"
- 소스 코드 + 커밋 이력: 가장 대표적인 산출물. "언제, 누가, 왜 고쳤는지"가 함께 남습니다
- 단위 테스트 코드·결과: 함수·모듈 하나가 제대로 동작하는지 자동으로 확인
- 코드 리뷰 기록, 빌드 결과물
STEP 5. 테스트 — "요구한 대로 잘 동작하나?"
- 테스트 계획서: 무엇을, 어떤 환경에서, 어떤 기준으로 판단할지
- 테스트 케이스: "이렇게 하면 → 이렇게 나와야 한다" 목록. 요구사항 번호와 연결
- 결함 관리 대장: 버그, 심각도, 담당자, 수정 여부 기록
- 테스트 결과서: 통과·실패 건수와 남은 문제 정리
STEP 6. 배포·운영 — "안전하게 내보내고 계속 잘 도나?"
- 배포(이행) 계획서: 언제, 어떤 순서로 올리고 문제 시 어떻게 되돌릴지
- 릴리스 노트: 이번 버전에서 무엇이 생기고 고쳐졌는지 알리는 글
- 사용자·운영 매뉴얼
- 장애 보고서·변경 요청서: 운영 중 문제와 개선 요청. 이것이 다음 버전의 요구사항이 됩니다
2. 실제 예시 — 기능 하나에 남은 산출물
퀀트 마켓 레이더에 추가한 "외국인 지분율 차트에 필라델피아 반도체 지수 겹쳐 보기" 기능을 예로 듭니다. 혼자 만드는 서비스라 두꺼운 문서를 따로 만들지는 않았지만, 개발하며 정한 내용을 산출물 양식에 맞춰 정리하면 다음과 같습니다.
- 요구사항: 겹쳐 그리기(REQ-01), ON/OFF 버튼(REQ-02), "한국 날짜엔 전날 밤 미국 종가"(REQ-03)
- 설계: 화면은 "삼성전자 버튼 옆, 보라색 선과 오른쪽 눈금", 서버는 /api/sox-daily 주소로 날짜·종가·등락률 제공
- 구현: 지수를 받아오는 서버 파일 1개를 새로 만들고 서버 주소 등록과 차트 화면 파일을 수정, 커밋 하나로 기록
- 테스트: 실제로 버그가 하나 나왔습니다. 1월 2일부터 비교해야 하는데 미국 12월 31일 종가를 받아 오지 않아 비교가 1월 5일부터 시작됐습니다. 받아오는 시작일을 12월 15일로 당겨 고치고 재테스트해 통과했습니다. 이런 내용을 적는 곳이 결함 관리 대장입니다.
- 배포: 커밋을 올려 서버에 배포하고 업데이트 노트(릴리스 노트)를 작성
💡 "한국 날짜엔 전날 밤 미국 종가"라는 요구사항이 처음부터 있었기 때문에, 테스트할 때 "1월 2일 비교가 맞나?"를 확인할 기준이 생겼습니다. 요구사항이 없었다면 1월 5일부터 시작하는 그래프를 그냥 넘겼을지도 모릅니다.
3. 산출물은 서로 이어져 있다 — V 모델
- 요구사항 정의서 ↔ 인수 테스트: 고객이 주문한 대로 만들어졌는가
- 시스템 설계 ↔ 시스템 테스트: 전체 기능과 성능이 설계대로인가
- 아키텍처 설계 ↔ 통합 테스트: 화면·서버·데이터가 잘 연결되는가
- 상세 설계 ↔ 단위 테스트: 함수·모듈 하나하나가 맞는가
설계 문서가 부실하면 테스트 기준도 부실해집니다. "테스트는 잘했는데 고객이 원한 게 아니었다"는 일이 생기는 이유입니다.
4. 폭포수 vs 애자일
단계를 하나씩 끝내고 넘어가는 방식이 폭포수(Waterfall)입니다. 계약과 검수가 중요한 공공·금융 SI 프로젝트에서 많이 씁니다. 애자일(Agile)은 1~4주 스프린트마다 기획→개발→테스트→시연을 작게 반복하며, 산출물도 제품 백로그, 유저 스토리, 스프린트 백로그·번다운 차트, 동작하는 소프트웨어(증분), 회고 기록으로 달라집니다. 애자일은 문서를 안 만드는 것이 아니라 필요한 문서를 가볍게, 자주 만드는 쪽에 가깝습니다.
5. 바이브 코딩에서는 산출물 = "AI에게 주는 설명서"
바이브 코딩이야말로 산출물이 가장 중요합니다. AI는 말해 준 만큼만 정확하게 만들고, 말하지 않은 부분은 그럴듯하게 추측해서 채우기 때문입니다.
AI는 손이 아주 빠른 개발자, 나는 기획자 겸 테스터라고 생각하면 쉽습니다. 개발자에게 기획서를 주듯 AI에게도 단계별 산출물을 말로 정리해 줍니다.
단계별로 AI에게 이렇게
- 기획 — 3줄 요약부터: "무엇을 / 누구를 위해 / 왜"를 3줄로 적어 대화 처음에 붙입니다. 대화가 길어져도 방향을 잃지 않습니다.
- 요구사항 — 번호 붙인 목록: 기능을 ①②③으로 나누고 "이번에 할 것"과 "나중에 할 것"을 구분합니다. 한꺼번에 10개를 시키면 반은 어설프게 나옵니다.
- 설계 — 그림 한 장, 데이터 출처 한 줄: 손그림이나 비슷한 앱 캡처를 보여 주고 "버튼은 어디, 누르면 무엇"을 알려 줍니다. 데이터가 필요하면 "실제 데이터만 써 줘, 가짜 예시 값은 넣지 마"라고 꼭 말합니다.
- 구현 — 작게 시키고, 되면 바로 커밋: 기능 하나가 잘 되면 바로 저장해 두면 다음 수정에서 망가져도 되돌릴 수 있습니다. "다른 부분은 건드리지 마"로 범위를 정하는 것도 좋습니다.
- 테스트 — 직접 눌러 보기: AI가 "완료했습니다"라고 해도 직접 확인하기 전까지는 완료가 아닙니다. 버그는 "○○ 화면에서 △△를 누르면 □□가 나온다"처럼 재현 방법을, 오류 메시지는 통째로 전달합니다.
- 배포·운영 — 한 줄 기록, 비밀번호 조심: 바뀐 점을 한 줄씩 남기면 릴리스 노트가 됩니다. 비밀번호·API 키는 코드에 직접 넣지 말고 따로 보관하도록 요청합니다.
⚠️ 입문자가 자주 겪는 실수 4가지
1. "알아서 다 만들어줘" → 결과가 매번 달라지고, 원하는 것이 무엇이었는지 스스로도 헷갈려집니다.
2. 저장(커밋) 없이 계속 고치기 → 어느 순간 다 망가졌는데 되돌아갈 곳이 없습니다.
3. 확인 없이 다음 기능으로 → 버그가 쌓여 어디서 틀렸는지 찾기 어려워집니다.
4. AI가 만든 숫자를 그대로 믿기 → 그럴듯한 예시 값이 진짜처럼 들어가 있을 수 있습니다. 데이터는 출처를 확인하세요.
복사해서 쓰는 부탁 양식
[목표] ○○하는 사람을 위해, ○○를 할 수 있게 하고 싶어.
[이번에 할 것] ① ○○ ② ○○ ③ ○○
[화면] ○○ 화면의 ○○ 옆에 ○○ 버튼. 누르면 ○○가 보이게.
[데이터] ○○에서 가져온 실제 데이터만 사용. 가짜 예시 값은 넣지 마.
[범위] 다른 기능은 건드리지 마.
[확인] 내 컴퓨터에서 확인하는 방법도 알려 줘. 다 되면 ①②③을 어떻게 확인하면 되는지 체크리스트로 정리해 줘.
정리
- 개발은 기획 → 요구사항 분석 → 설계 → 구현 → 테스트 → 배포·운영 6단계로 볼 수 있습니다.
- 대표 산출물은 프로젝트 계획서 → 요구사항 정의서 → 화면 설계서·API 명세서 → 소스 코드 → 테스트 케이스·결과서 → 릴리스 노트·매뉴얼입니다.
- 산출물은 번호로 서로 이어져 앞 단계 문서가 뒤 단계의 기준이 됩니다.
- 바이브 코딩에서 산출물은 곧 AI에게 주는 설명서입니다. 코드는 AI가 써도 정하고 확인하는 것은 나입니다.
처음부터 완벽한 문서를 만들 필요는 없습니다. 다음에 AI에게 무언가를 부탁할 때 목표 3줄 + 번호 붙인 요구사항 + 확인 방법만 먼저 적어 보세요.
이 글의 예시 기능(외국인 지분율 차트 + 필라델피아 반도체 지수)은 퀀트 마켓 레이더에서 직접 써 볼 수 있습니다.
퀀트 마켓 레이더 열기 →
※ 단계와 산출물 이름은 일반적인 소프트웨어 개발 생명주기(SDLC)를 기준으로 정리했으며, 회사·기관·방법론에 따라 이름과 구성이 다를 수 있습니다. 예시의 요구사항·테스트 케이스는 실제 개발 과정의 내용을 산출물 양식에 맞춰 다시 정리한 것입니다.