바이브 코딩 실전 원칙과 과정

1 원칙:  기획과 코딩은 분리해서 작업하고, 반드시 인간이 검토 후 승인한 이후 적용되게 합니다.

이 원칙이 처음이자 마지막 원칙입니다.

이 원칙을 지키지 않으면 AI는 내가 모르는 작업을 진행할 것이며, 이런 작업들이 쌓이면 어느 순간 코드는 무너져 수습 불가능해지며, 작업에 소요되는 토큰(비용)은 치솟게 될 것이기 때문입니다.

이 원칙을 지키면, AI가 의도와 다르게 동작하는 것을 줄이고, 프로젝트의 주도권을 인간이 가지게 되고, 토큰(비용)을 절약하며, 결과물이 향상됩니다.

 

 

바이브 코딩 과정

1. 코드 분석: AI에게 기존 코드를 분석하게 하고 반드시 정리한 내용을 research.md 파일에 작성하도록 시킵니다. 

AI에게 지시 사항:
1. 이 폴더(프로젝트)를 깊게 읽고
2. 어떻게 동작하는지 매우 상세히 이해하고
3. 모든 세부 사항을 파악해라.
4. 파악이 끝나면 research.md 파일에 상세 보고서를 작성해라.

 

AI는 로직 실수나 문법 오류는 거의 저지르지 않고 기능을 구현해 주지만, 주변 시스템을 서서히 망가뜨릴 수 있습니다. 

AI는 기존 시스템을 무시하고 동작하도록 구현할 수 있으며, 기존 관례를 무시하고 마이그레이션을 진행할 수 있으며, API를 중복 구현할 수 있습니다.

이를 막기 위하여 기존 코드 베이스를 리서치 과정을 통해 분석 할 필요가 있으며, 마크 다운 문서(. md)로 남겨 놓아서 AI와 인간 모두 참고할 수 있도록 합니다.

 

 

2. 계획: 별도의 plan.md 마크다운 파일에 상세 구현 계획을 작성하게 합니다.

AI에게 지시 사항:
1. 새 기능을 구현하는 상세 plan.md 파일을 작성 해라.
2. 코드 스니펫도 plan.md 내용에 포함하라.
3. 소스 파일을 읽고 실제 코드 베이스를 기반으로 계획을 세워서 plan.md 파일을 작성해라.
4. 수정되거나 생성할 파일 경로 정보를 plan.md 파일에 포함해야 한다.
5. 고려 사항, trade off, 제한 사항들을 plan.md 파일에 포함해야 한다. 
6. plan.md를 작성할 뿐 아직 실제로 구현하지 마.

 

계획 단계에서는 토큰 낭비가 될 수 있으므로 아직 구현하지 않도록 에이전트에 명시적으로 지시합니다.

 

 

3. 주석 달기

에이전트가 위에서 작성한 plan.md 파일을 에디터로 열어서 검토합니다.

그리고 그 plan.md 파일에 주석이나 메모를 추가하고 필요한 내용을 수정해 줍니다.

주석이나 메모의 내용 예시: 잘못된 가정 수정, 접근 방식 수정, 제약 조건 추가, 도메인 지식 전달

 

변경된 plan.md 파일을 다시 에이전트에게 전송하면서 에이전트에게 메모를 반영해서 문서 내용을 업데이트하도록 지시합니다.

에이전트에 아직 구현을 하지 말라고 명시적으로 지시하고 만족할 때까지 몇 번 더 plan.md를 주고받으면서 에이전트에 업데이트를 시킵니다. 

 

 

4. 구현

계획이 완료되면 구현을 지시하면 되는데, 이 내용 중에 재사용하는 부분을 표준 프롬프트로 따로 보관하여 관리합니다.

전부 구현하라.
작업을 완료하면 plan.md 문서에 완료로 표시해라.
plan.md의 모든 작업이 완료될 때까지 계속 작업해라.
typecheck를 실행해서 문제가 없도록 작업해라.

 

구현 단계에서는 AI의 창의성을 제한해서 계획 대로 작업하도록 하기만 하면 됩니다. 

 

 

5. 피드백

구현이 잘못된 방향으로 가고 있다면, 패치를 해서 계속해서 수정하려 하지 말고, 이전 커밋으로 되돌린 후 잘못된 작업만 따로 떼어내서 분리시켜 새로운 작업을 만들어 시킵니다.

에이전트에게 구현을 맡기지만 무슨 작업을 할지의 대한 결정권을 항상 사람이 갖고 있습니다.

1. 잘된 것은 취하고 잘못된 것은 버린다.
2. 지금 구현하지 않을 것은 버린다.
3. 읽기 쉽도록 정리하기
4. 건드리면 안 되는 부분 정해주기
5. 기술 선택은 사람이 하기, 라이브러리 지정해 주기

 

 

위 단계(리서치 -> 계획 -> 구현)를 하나의 세션에서 작업합니다.

AI 에이전트가 자체 맥락을 파악하기보다 md 파일을 사용해서 에이전트가 충분히 맥락을 파악하게 하는 것입니다.

리서치 단계가 무지한 변경을 막아주고, 충분한 계획 단계가 잘못된 변경을 막아주고, 내 판단이 반영되게 하여 구현 단계에서는 모든 결정이 끝나 작업만 수행하게 해 줍니다.