Devin.KR

기본 · 전체 목차 공개

바이브 코딩 실습 - 작은 서비스 만들기

공간 예약 서비스 하나를 AI 와 함께 처음부터 만든다. 기획서와 작업 기록, sqlite3 데이터 모델, 예약 충돌 규칙과 테스트, 명령형 첫 버전, http.server 웹 API, HTML 화면, 입력 검증과 오류 처리, 기능 변경과 회귀 테스트, 남의 코드에 기능 넣기, 문서 검색 도움말(RAG 원리), 리팩터링, 배포 전 점검까지 거친다.

이 책을 읽기 전에

《바이브 코딩의 정석》의 명세·테스트·지침 파일 개념

공개 12/12장 · 목차 구성 2026-09-12

CONTENTS

목차

읽음 표시는 직접 선택하며 자동 완료되지 않습니다.

  1. 01
    실습 준비 - 기획서·작업 기록·실행 명령 고정

    서비스 한 장 기획서(누가·무엇을·제외 범위·완료 기준), 화면과 기능 목록, 작업 기록 양식(요청·받은 결과·검증·수정), 실행·테스트 명령을 지침 파일에 고정, 완성 코드는 기획서의 기능 목록을 읽어 작업 단위 표와 진행 상태를 출력하는 도구

  2. 02
    데이터 모델 정하기 - sqlite3 로 표와 관계 만들기

    기획서에서 명사(모임·공간·예약) 뽑기, 표와 열·기본 키·외래 키, AI 가 제안한 스키마를 검토하는 질문(빠진 제약·중복·이름), sqlite3 로 표 만들고 예시 데이터 넣기, 완성 코드는 메모리 DB 에 스키마를 만들고 조인 조회 결과를 표로 출력한다

  3. 03
    핵심 규칙을 함수로 - 예약 충돌을 테스트로 고정

    시간 겹침 판정 같은 핵심 규칙을 화면·DB 와 떼어 함수로, 경계값(끝 시각=시작 시각)과 반례를 테스트로 먼저, AI 가 놓치기 쉬운 경우 찾기, 완성 코드는 충돌 판정 함수와 unittest 묶음을 함께 실행한다

  4. 04
    명령으로 쓰는 첫 버전 - 입력을 받아 저장까지

    가장 작은 동작하는 버전부터, 명령 문자열을 해석해 예약 추가·조회·취소, DB 저장과 규칙 함수 연결, 첫 버전에서 일부러 하지 않을 것 정하기, 완성 코드는 미리 정한 명령 목록을 차례로 실행해 결과를 출력한다

  5. 05
    작은 웹 API - http.server 로 요청과 응답 다루기

    HTTP 요청·응답·상태 코드의 최소 개념, http.server 핸들러 구조, JSON 요청 해석과 응답, 처리 로직을 순수 함수로 분리해 서버 없이 테스트, 완성 코드는 요청 처리 함수를 직접 호출해 여러 요청의 상태 코드와 응답을 출력한다(서버 실행은 인자를 줄 때만)

  6. 06
    화면 만들기 - HTML 을 생성해 파일로 내보내기

    문자열 템플릿으로 예약 현황표와 주간 달력 만들기, html.escape 로 출력 이스케이프, 화면 요구를 AI 에게 설명하는 방법(구성·상태·빈 화면), 생성된 HTML 을 브라우저로 확인하는 법, 완성 코드는 HTML 파일을 만들고 그 앞부분과 줄 수를 출력한다

  7. 07
    잘못된 입력과 오류 - 검증·오류 메시지·로그

    입력 검증 위치와 규칙(형식·범위·권한), 사용자에게 보일 오류 메시지와 개발자용 로그의 구분, 예외를 삼키지 않기, AI 가 만든 코드에서 검증이 빠진 곳 찾기, 완성 코드는 잘못된 요청 묶음을 넣어 각각의 오류 응답과 logging 출력(고정 형식)을 보여 준다

  8. 08
    기능 추가 요청 다루기 - 명세 변경과 회귀 테스트

    새 요구(반복 예약)가 들어왔을 때 명세부터 고치기, 영향 범위 파악, 기존 테스트로 회귀 확인 후 새 테스트 추가, 한 번에 여러 기능을 시키지 않기, 완성 코드는 반복 예약 기능을 넣고 기존·신규 테스트 결과를 함께 출력한다

  9. 09
    남이 짠 코드에 기능 넣기 - 읽기·요약·사실 확인

    낯선 코드의 구조를 AI 에게 요약받고 직접 호출 흐름으로 확인하기, 요약이 틀린 곳 찾기, 기존 관례를 따르는 변경, 문서·주석 생성 후 사실 확인, 완성 코드는 주어진 기존 모듈(장 안에 포함)에 통계 기능을 관례대로 추가하고 결과를 출력한다

  10. 10
    문서 검색 도움말 - 검색 후 답하기(RAG) 원리

    이용 안내 문서를 조각내기, 단어 색인과 점수로 질문과 비슷한 조각 찾기, 근거 조각을 인용해 답하기, 근거가 없으면 모른다고 답하기, 모델 호출은 규칙 기반 가짜 함수로 대신해 흐름만 이해, 완성 코드는 질문 몇 개에 대해 고른 조각과 답을 출력한다

  11. 11
    리팩터링 - 테스트로 지키며 구조 바꾸기

    커진 main.py 에서 코드 냄새 찾기(긴 함수·중복·섞인 책임), 테스트 먼저 고정, 한 번에 한 가지 구조 변경, diff 검토, AI 가 동작까지 바꿔 버리는 경우 알아보기, 완성 코드는 리팩터링 전후 함수가 같은 결과를 내는지 비교 검사를 출력한다

  12. 12
    배포 전 점검과 회고 - 설정 분리·되돌리기 계획·작업 기록

    설정과 비밀값을 코드에서 분리, 실행 방법 문서화, 배포 전 점검표(테스트·오류 처리·로그·백업), 리허설과 되돌리기 계획, 작업 기록으로 회고하기(무엇을 맡겼고 무엇을 판단했나), 완성 코드는 프로젝트 상태(가상 데이터)를 점검표로 검사해 통과·보류 항목을 출력한다

이 책은 Devin.KR 원고를 참조합니다. 원고의 원래 주소와 저작자 표기를 유지하며 같은 글을 다시 등록하지 않습니다. 수정된 원고는 읽기 화면에서 재검수 상태를 확인할 수 있습니다.

이 책·표지의 저작권 및 출처 관련 요청