바이브 코딩의 정석

용어가 생긴 배경(코드를 읽지 않고 분위기에 맡기는 방식)과 그 뒤 감독형 작업을 따로 부르게 된 흐름, 버려도 되는 실험과 남이 쓸 코드의 차이, 맡기는 정도에 따라 달라지는 사람의 책임, 여전히 필요한 기초, 이 책의 실습 방식(요청→결과→검증→기록), 완성 코드는 할 일 도구의 첫 버전과 스스로 점검하는 간단한 assert 검사

AI 에게 맡기기 좋은 일(반복·초안·변환·탐색)과 사람이 쥘 일(목표·우선순위·최종 판단·위험 결정), 결과를 검증할 방법이 없으면 맡기지 않는다는 원칙, 같은 요청으로 여러 안을 받아 비교하는 방법, 맡긴 뒤 확인할 기준을 먼저 정하기, 완성 코드는 작업 목록을 위험도·검증 가능성 기준으로 분류해 '맡김/함께/직접' 표를 출력하는 도구

막연한 요청이 실패하는 이유, 목적·사용자·기능 목록·제외 범위·입력·출력·완료 기준을 담은 한 장 기획서, 성공 예시와 실패 예시를 먼저 쓰기, 모호한 곳을 AI 가 먼저 질문하게 하는 요청, 완성 코드는 명세의 예시 표를 그대로 검사 데이터로 써서 할 일 추가·완료 기능을 확인한다

파일을 고치기 전에 관련 코드를 살피고 계획만 받는 단계, 계획 검토에서 볼 것(바꿀 파일·기존 관례·빠진 경우), 단계마다 '확인 방법'을 붙인 계획, 승인 후 구현과 검증, 계획이 틀렸을 때 돌아가기, 완성 코드는 마감일 정렬 기능을 계획표대로 단계별로 추가하고 단계마다 확인 결과를 출력한다

한 번에 한 가지 기능, 단계마다 실행 확인, 작업 전후 커밋으로 체크포인트 남기기, 브랜치로 실험하고 망가지면 되돌리기, AI 변경과 내 변경 구분, 대화가 길어지면 새로 시작하기, 완성 코드는 할 일 목록을 JSON 파일에 저장하는 기능을 세 단계로 나눠 넣고 각 단계의 스냅숏 비교 결과를 출력한다

변경 diff 를 읽는 순서(무엇이 바뀌었나→왜→어디에 영향), 이해 못 한 줄을 질문으로 바꾸기, 실행해 보고 예상과 비교, 설명을 자기 말로 다시 쓰기, 그럴듯하지만 틀린 코드의 흔한 모습, 완성 코드는 difflib 로 검색 기능의 두 버전을 비교해 바뀐 줄을 출력하고 숨은 버그를 찾아 고친 버전을 함께 실행한다

unittest 로 기대 동작 고정, 테스트를 먼저 쓰고 구현 요청, 경계값·반례 요청, 테스트를 통과시키려고 테스트를 고치는 일을 막는 규칙, 실행 성공과 요구 충족은 다르다는 점, 완성 코드는 마감 임박 판정 함수와 테스트 묶음을 함께 실행해 결과를 출력한다

오류 메시지와 재현 절차를 그대로 전달하기, 추측 수정의 위험, 가설 하나씩 확인, 실패를 테스트로 먼저 재현하고 고치기, 같은 수정이 반복되면 멈추기, 디버깅을 통째로 맡기면 내 실력이 늘지 않는 이유, 완성 코드는 날짜 파싱 버그를 재현 테스트로 잡고 고친 전후 결과를 출력한다

에이전트를 위한 README 라는 개념, 담을 것(실행·테스트 명령, 코드 관례, 금지 사항, 폴더 경계)과 담지 않을 것(일회성 요구), 짧게 유지하기, 폴더별 지침과 우선순위, 작업 기록과 인계 메모, 완성 코드는 지침 파일 텍스트를 읽어 필수 절이 있는지와 너무 긴지를 점검하는 도구

대화가 길어질수록 앞 내용을 놓치는 현상, 필요한 파일과 줄 위치만 알려 주기, 긴 대화를 요약해 새 세션에 넘기기, 기능마다 새로 시작하기, 병렬 작업이 비용을 줄이지 않는 경우, 완성 코드는 대화 기록(가상 데이터)의 글자 수를 세고 예산을 넘으면 오래된 부분을 요약 문장으로 바꾸는 간단한 압축기

API 키·비밀번호를 코드와 대화에 넣지 않기와 환경 변수, AI 가 만든 코드의 흔한 구멍(SQL 인젝션·경로 조작·검증 없는 입력), AI 가 존재하지 않는 패키지 이름을 지어내는 문제와 설치 전 확인 습관, 모델이 좋아져도 보안은 따로 확인해야 하는 이유, 완성 코드는 sqlite3 로 문자열 이어 붙인 쿼리와 매개변수 쿼리를 비교하고 파일 경로 검증 함수를 테스트한다

앞 장의 위임 판단·명세·계획·작은 단계·테스트·디버깅·지침·맥락·보안을 모두 써서 저장·검색·마감 알림 기능이 있는 도구를 완성하고, 요청·결정·검증을 담은 작업 기록을 남긴다