기본 콘텐츠로 건너뛰기

AI 바이브코딩 운영 가이드 (프롬프트 25종 첨부)

 AX컨설팅 동료용 실무 가이드

AI 바이브코딩
80% 벽을 넘는 운영 가이드

AI로 웹사이트, 업무 자동화, 데이터 분석, 제안서 보조 도구, 내부 업무 시스템을 만들어보려는 컨설턴트를 위한 문서입니다.

바이브코딩은 “AI에게 코딩을 맡기는 일”이 아니라,
AI 개발팀을 운영하는 일입니다.
빠르게 되는 구간◀ 80% 벽운영으로 넘는 구간 95%

80%까지는 AI가 데려다줍니다. 나머지 15%는 코딩 실력이 아니라 운영 방식으로 넘습니다.

01 · 진단

처음엔 날아가는데,
왜 80%에서 멈출까

요즘 AI로 개발을 해보면 처음에는 정말 빠릅니다. 로그인 화면이 금방 만들어지고, 버튼도 생기고, 데이터 입력 폼도 나오고, 간단한 대시보드도 몇 분 만에 완성됩니다.

“이제 코딩은 AI가 다 해주는구나.”

그런데 실제 프로젝트에서는 이상한 일이 생깁니다. 처음 70~80%까지는 빠르게 가는데, 그 다음부터 갑자기 진도가 안 나갑니다.

증상

80% 지점에서 벌어지는 일

  • 버튼 하나 고쳤더니 다른 버튼이 망가집니다.
  • 오류를 고쳐달라고 했더니 디자인이 깨집니다.
  • AI는 “수정 완료했습니다”라고 하는데 실행해보면 그대로입니다.
  • 이전에 정한 요구사항을 잊어버립니다.
  • 새 기능을 붙일수록 코드가 점점 복잡해집니다.
  • 결국 처음부터 다시 만드는 것이 더 빠른 상황이 됩니다.

한 줄 결론

80% 벽은 AI의 코딩 실력만의 문제가 아닙니다.
대부분은 검증 없는 지시, 오염된 컨텍스트, 롤백 없는 작업 방식, 모호한 완료 기준 때문에 생깁니다.

AI에게 코딩을 맡긴다는 것은 개발자를 없애는 일이 아닙니다. 오히려 우리의 역할이 바뀝니다.

기존 방식AI 바이브코딩 방식
내가 직접 코드를 작성한다AI에게 작업을 나누어 맡긴다
개발자가 기능을 구현한다사람이 목표와 검증 기준을 정한다
오류는 개발자가 직접 찾는다AI에게 찾게 하되, 실행 결과로 확인한다
프로젝트 관리는 별도 영역이다프로젝트 관리가 곧 개발 품질이 된다

왜 처음에는 잘 되는가

처음 만드는 기능은 대부분 AI가 이미 많이 학습한 패턴이기 때문입니다. 아래와 같은 요청은 인터넷에 예제가 넘칩니다.

AI가 아주 잘하는 요청
간단한 로그인 페이지를 만들어줘.
고객 정보를 입력하는 폼을 만들어줘.
CSV 파일을 업로드하면 표로 보여주는 웹페이지를 만들어줘.
할 일 목록을 추가, 삭제, 완료 처리할 수 있는 앱을 만들어줘.

왜 80%에서 막히는가

문제는 프로젝트가 조금씩 우리 요구에 맞게 변형되기 시작할 때 생깁니다. 처음에는 흔한 로그인 페이지였지만, 점점 이런 요구가 붙습니다.

  • 우리 회사 로고를 넣어야 한다.
  • 관리자와 일반 사용자를 구분해야 한다.
  • 고객사별로 보이는 메뉴가 달라야 한다.
  • 특정 사용자는 다운로드만 가능해야 한다.
  • 입력값은 DB에 저장되어야 한다.
  • 모바일에서도 깨지면 안 된다.
  • 기존 엑셀 양식과 맞아야 한다.
  • 나중에 다른 프로젝트에도 재사용 가능해야 한다.

이때부터 AI가 “많이 본 예제”를 그대로 쓰기 어려워집니다. 즉, AI 입장에서는 정답 예제가 사라지는 순간입니다. 그러면 AI는 검증된 코드가 아니라 그럴듯해 보이는 코드를 만듭니다. 이것이 할루시네이션의 시작입니다.

02 · 증상과 처방

80% 벽에서 자주 나오는
네 가지 증상

거의 모든 프로젝트에서 반복됩니다. 나쁜 지시문을 좋은 지시문으로 바꾸는 것만으로 대부분 해결됩니다.

증상 1

“수정 완료했습니다”라고 했지만 실제로는 안 됨

상황

고객관리 화면에서 검색 버튼이 작동하지 않아 AI에게 고쳐달라고 했습니다. AI는 “검색 기능을 수정했습니다”라고 답했습니다. 그런데 실제 브라우저에서 실행해보니 여전히 검색이 되지 않습니다.

AI가 거짓말을 하려는 것이 아닙니다. 코드를 보고 “이론상 고쳤다”고 판단했을 수 있습니다. 하지만 실제 실행은 하지 않았을 수 있습니다.

나쁜 지시문
검색 기능 고쳐줘.
좋은 지시문
검색 기능을 고쳐줘.
단, 수정 후에는 반드시 앱을 실행하고 아래 조건을 확인해줘.

1. 검색창에 "홍길동"을 입력한다.
2. 검색 버튼을 누른다.
3. 결과 목록에 홍길동 데이터만 표시되는지 확인한다.
4. 실행 결과 로그와 확인 내용을 보고해줘.

실제로 실행하지 않았다면 "완료"라고 말하지 마.
증상 2

하나를 고쳤더니 다른 기능이 망가짐

상황

파일 업로드 오류를 고쳤더니, 기존에 잘 되던 다운로드 기능이 깨졌습니다.

AI는 특정 문제만 보고 수정하다가 전체 흐름을 놓칠 수 있습니다.

나쁜 지시문
업로드 오류 고쳐줘.
좋은 지시문
업로드 오류를 수정해줘.
다만 기존 다운로드 기능은 절대 깨지면 안 돼.
수정 후 아래 회귀 테스트를 같이 확인해줘.

- 파일 업로드가 되는가?
- 업로드된 파일명이 목록에 표시되는가?
- 기존 파일 다운로드가 되는가?
- 빈 파일을 올렸을 때 오류 메시지가 나오는가?

변경한 파일 목록과 테스트 결과를 표로 정리해줘.
증상 3

AI가 이전의 잘못된 가정을 계속 믿음

상황

AI가 처음에 users.json 파일이 있다고 착각했습니다. 실제로는 없는데, 이후 모든 답변에서 계속 그 파일을 기준으로 설명합니다.

이런 경우 같은 대화방에서 계속 고치려고 하면 오히려 더 꼬입니다. 순서는 이렇습니다.

  1. 현재 사실을 다시 확인시킨다.
  2. 파일 구조를 직접 읽게 한다.
  3. 잘못된 가정을 명시적으로 폐기시킨다.
  4. 그래도 반복되면 새 세션으로 옮긴다.
가정 폐기 지시문
방금 네가 말한 users.json 파일은 실제 프로젝트에 없어.
추정하지 말고 현재 폴더 구조와 파일 내용을 직접 확인한 뒤 다시 판단해줘.

이번 답변에서는 다음을 구분해서 보고해줘.

1. 실제로 존재하는 파일
2. 네가 이전에 잘못 가정한 파일
3. 앞으로 기준으로 삼아야 할 실제 데이터 저장 방식
증상 4

대화가 길어질수록 AI가 멍청해지는 느낌

상황

처음에는 잘 알아듣던 AI가 어느 순간부터 엉뚱한 파일을 고치고, 이전 요구사항을 반복해서 잊습니다.

대화가 길어지면 과거의 내용과 현재의 요청이 섞이면서 판단력이 떨어지는 것처럼 보입니다. 이것을 컨텍스트 오염이라고 볼 수 있습니다.

  • 주제가 바뀌면 새 대화방을 사용합니다.
  • 긴 작업 후에는 중간 요약을 만듭니다.
  • 잘못된 방향으로 간 대화는 과감히 정리합니다.
  • 새 세션에 넘길 “인수인계 메모”를 만듭니다.
새 세션 인수인계 지시문
지금까지 작업 내용을 새 세션에 넘길 수 있도록 정리해줘.

다음 형식으로 작성해줘.

# 프로젝트 현재 상태
- 목적:
- 기술 스택:
- 실행 방법:
- 주요 파일:

# 완료된 작업
- 

# 아직 해결되지 않은 문제
- 

# 절대 바꾸면 안 되는 것
- 

# 다음 작업자가 먼저 확인해야 할 것
- 

# 검증 명령 또는 확인 방법
- 
03 · 기본 규칙

AI에게 반드시
박아두어야 할 원칙

바이브코딩에서 가장 위험한 말은 이것입니다.

“수정 완료했습니다.”

이 말 자체는 아무 의미가 없습니다. 진짜 완료는 말이 아니라 증거로 판단해야 합니다.

기본형
앞으로 이 프로젝트에서는 "완료"라고 말하기 전에 반드시 실행 또는 검증 결과를 제시해줘.
테스트를 실행하지 않았거나 브라우저에서 확인하지 않았다면 완료라고 말하지 마.
확인하지 못한 부분은 "미확인"이라고 표시해줘.
강화형
이 프로젝트의 완료 기준은 코드 수정이 아니라 검증 통과야.

너는 다음 조건을 지켜야 해.

1. 코드를 고친 뒤 실제 실행 또는 테스트를 한다.
2. 실행하지 못한 경우 그 이유를 말한다.
3. 추측으로 성공했다고 말하지 않는다.
4. 변경 파일, 변경 이유, 검증 결과를 함께 보고한다.
5. 테스트 실패 시 실패 로그를 숨기지 말고 그대로 보여준다.
“완료했습니다”가 아니라,
“실행해봤더니 이렇게 됐습니다”라고 말하게 만들어야 합니다.

좋은 지시문과 나쁜 지시문

상황나쁜 지시문좋은 지시문
오류 수정이거 고쳐줘오류 원인을 먼저 설명하고, 수정 전후 차이와 실행 결과를 보고해줘
기능 추가관리자 기능 넣어줘관리자 권한으로만 접근 가능한 화면을 만들고, 일반 사용자가 접근하면 차단되는지 확인해줘
디자인 수정예쁘게 해줘모바일 390px 기준에서 카드가 한 줄로 보이고, 버튼은 하단 고정으로 보이게 수정해줘
성능 개선빠르게 해줘목록 1,000건 기준으로 로딩 시간을 줄이고, 개선 전후 측정값을 비교해줘
문서 작성사용법 써줘비개발자 사용자가 따라 할 수 있도록 로그인→업로드→결과 확인 순서로 작성해줘
배포배포해줘배포 전 빌드 성공, 환경변수 확인, 배포 URL 접속 확인까지 진행해줘

AI가 거짓말하는 것처럼 보일 때

상황실제 원인대응
실행했다고 했는데 안 함코드를 보고 추정했을 가능성실행 로그 요구
파일을 고쳤다는데 변화 없음다른 파일을 고쳤을 가능성변경 파일 목록 요구
테스트 통과라는데 실패테스트를 실제로 안 돌렸을 가능성명령어와 결과 요구
오류 원인이 계속 바뀜원인 분석 없이 수정 반복수정 전 원인 분석 요구
같은 실수 반복컨텍스트 오염인수인계 후 새 세션

감정적으로 “왜 거짓말했냐”고 하기보다, 작업 규칙을 다시 세우는 것이 좋습니다.

규칙 재설정 지시문
방금 답변은 실제 실행 결과가 아니라 추정으로 보인다.
앞으로는 추정과 확인을 구분해줘.

다음 형식으로만 보고해줘.

- 실제 확인한 것:
- 아직 확인하지 못한 것:
- 추정하는 것:
- 다음 확인 방법:
04 · 상황별 실전 프롬프트

여덟 가지 상황,
여덟 개의 지시문

프로젝트 진행 순서대로 배치했습니다. 필요한 순간에 그대로 가져다 쓰세요.

8-1 · 새 프로젝트를 시작할 때
이 프로젝트를 바로 코딩하지 말고 먼저 작업 계획을 세워줘.

목표:
- 소상공인 상담 기록을 입력하고 요약 리포트를 만드는 내부 웹앱

사용자:
- 컨설턴트
- 관리자

필수 기능:
1. 상담 기록 입력
2. 고객명/상담일/상담내용 저장
3. AI 요약 생성
4. 관리자용 목록 조회
5. CSV 다운로드

먼저 다음을 작성해줘.

1. 화면 구성
2. 데이터 구조
3. 필요한 파일 목록
4. 구현 순서
5. 각 단계별 검증 방법

아직 코드는 작성하지 마.
8-2 · 기능을 작게 나누어 맡길 때
이번에는 전체 앱을 만들지 말고, 상담 기록 입력 화면만 구현해줘.

범위:
- 고객명 입력
- 상담일 입력
- 상담내용 입력
- 저장 버튼

범위 밖:
- AI 요약 기능은 아직 만들지 마
- 관리자 화면도 아직 만들지 마
- 로그인도 아직 만들지 마

완료 기준:
1. 입력 화면이 브라우저에서 열린다.
2. 저장 버튼을 누르면 콘솔에 입력값이 출력된다.
3. 빈 고객명으로 저장하면 오류 메시지가 나온다.

작업 후 실행 결과를 보고해줘.
8-3 · 오류 원인을 먼저 찾게 할 때
지금 오류를 바로 고치지 말고 원인 분석부터 해줘.

요청사항:
1. 오류 메시지를 그대로 읽어줘.
2. 관련 파일을 찾아줘.
3. 가능한 원인을 3개 이하로 정리해줘.
4. 가장 가능성 높은 원인 하나를 선택해줘.
5. 수정 전에 어떤 파일을 바꿀지 먼저 말해줘.

내가 확인하기 전에는 코드를 수정하지 마.
8-4 · AI가 자꾸 엉뚱한 파일을 고칠 때
지금부터는 추측으로 파일을 만들거나 수정하지 마.

먼저 실제 파일 구조를 확인하고, 이번 문제와 관련 있는 파일만 골라줘.
그 다음 아래 형식으로 보고해줘.

| 파일 | 관련 이유 | 수정 필요 여부 |
|---|---|---|

수정이 필요한 파일만 고치고, 새 파일을 만들 경우 왜 필요한지 먼저 설명해줘.
8-5 · 테스트를 강제할 때
수정 후 반드시 테스트를 실행해줘.

보고 형식:

## 변경 내용
- 

## 실행한 테스트
- 명령어:
- 결과:

## 직접 확인한 기능
- 

## 아직 확인하지 못한 것
- 

테스트를 실행하지 못했다면 완료라고 말하지 말고, 실행하지 못한 이유를 말해줘.
8-6 · 브라우저 확인이 필요할 때
이 작업은 코드 수정만으로 끝내면 안 돼.
브라우저에서 실제 사용자 흐름을 확인해줘.

확인 시나리오:
1. 홈페이지 접속
2. 로그인 버튼 클릭
3. 테스트 계정 입력
4. 대시보드 진입
5. 새 상담 기록 추가
6. 목록에 추가된 기록 표시 확인

각 단계에서 성공/실패를 표시하고, 실패한 단계가 있으면 화면 상태와 원인을 설명해줘.
8-7 · 디자인을 요청할 때
디자인을 "예쁘게"가 아니라 아래 기준에 맞게 수정해줘.

대상 사용자:
- 50~60대 컨설턴트
- 개발자가 아닌 일반 사용자

디자인 기준:
1. 글씨는 작지 않게
2. 주요 버튼은 한눈에 보이게
3. 입력 순서는 위에서 아래로 자연스럽게
4. 모바일에서도 깨지지 않게
5. 색상은 과하지 않게, 업무용 느낌으로

수정 후 PC 화면과 모바일 화면에서 레이아웃이 어떻게 보이는지 설명해줘.
8-8 · 배포 전 점검할 때
배포하기 전에 아래 항목을 점검해줘.

1. 로컬 실행 성공 여부
2. 빌드 성공 여부
3. 환경변수 누락 여부
4. 테스트 계정 로그인 가능 여부
5. 주요 기능 3개 작동 여부
6. 배포 후 접속 URL 확인

각 항목을 표로 정리하고, 하나라도 실패하면 배포 완료라고 말하지 마.
05 · 운영 원칙

컨설턴트가 기억해야 할
네 가지 운영 원칙

원칙 1

작게 시켜라

AI에게 한 번에 너무 많은 일을 맡기면 실패 확률이 올라갑니다.

나쁜 예
고객관리 CRM 만들어줘.
좋은 예
먼저 고객 목록 화면만 만들어줘.
필드는 고객명, 연락처, 담당자, 최근 상담일까지만 넣어줘.
저장 기능은 아직 만들지 말고 화면만 먼저 확인하자.
  • 오류가 어디서 생겼는지 찾기 쉽습니다.
  • 결과를 사람이 검토하기 쉽습니다.
  • 실패해도 되돌리기 쉽습니다.
  • AI가 요구사항을 덜 놓칩니다.
원칙 2

완료 기준을 먼저 정하라

“해줘”라고만 하면 AI는 자기 기준으로 완료를 판단합니다. 사람이 원하는 완료와 AI가 생각하는 완료는 다릅니다.

AI가 생각하는 완료사람이 원하는 완료
코드를 수정했다실제로 작동한다
오류가 없어 보인다테스트를 통과했다
화면이 만들어졌다사용자가 쓸 수 있다
설명상 가능하다브라우저에서 확인했다
완료 기준 전달 예시
완료 기준은 다음과 같아.

1. 사용자가 고객명을 입력할 수 있다.
2. 저장 버튼을 누르면 목록에 추가된다.
3. 새로고침해도 데이터가 유지된다.
4. 빈 값이면 안내 메시지가 나온다.
5. 이 과정을 실제로 실행해 확인한다.
원칙 3

자주 저장하고 쉽게 되돌려라

AI 코딩에서 가장 중요한 안전장치는 커밋입니다. 개발자만 쓰는 전문 기능이 아니라, AI가 작업을 망쳤을 때 되돌아가기 위한 보험입니다.

권장 습관

  • 새 기능 시작 전 커밋
  • 기능 하나 완성 후 커밋
  • 디자인 크게 바꾸기 전 커밋
  • AI에게 대규모 수정 맡기기 전 커밋
  • 테스트 통과 후 커밋
작업 전
작업 전에 현재 상태를 커밋해줘.
커밋 메시지는 "before adding customer search"로 해줘.
그 다음 검색 기능을 추가해줘.
작업 후
수정이 끝났다면 테스트를 실행하고, 통과하면 커밋해줘.
커밋 메시지는 "add customer search feature"로 해줘.
원칙 4

컨텍스트를 정리하라

새 대화방으로 옮겨야 할 신호

  • 같은 오류를 두 번 이상 잘못 고쳤을 때
  • AI가 존재하지 않는 파일을 계속 언급할 때
  • 이전 요구사항과 현재 요구사항을 섞을 때
  • 기능 개발에서 배포 점검으로 주제가 바뀔 때
  • 대화가 너무 길어져 답변 품질이 떨어질 때

단, 그냥 새 대화방으로 가면 안 됩니다. 반드시 인수인계 메모를 만들어야 합니다.

인수인계 요청
새 대화방으로 옮길 예정이야.
현재 프로젝트 상황을 인수인계 문서로 정리해줘.

포함할 내용:
- 프로젝트 목표
- 현재까지 완료된 기능
- 아직 안 되는 기능
- 중요한 결정사항
- 실행 방법
- 테스트 방법
- 다음에 해야 할 일
- 절대 건드리면 안 되는 부분

“메모”는 AI 개발의 작업 기억이다

메모는 길 필요가 없습니다. 다만 정확해야 합니다. 프로젝트 폴더에 PROJECT_MEMO.md로 저장해두세요.

PROJECT_MEMO.md 예시
# 프로젝트 메모

## 목적
소상공인 상담 내용을 입력하면 AI가 요약 리포트를 만들어주는 내부 도구

## 사용자
- 컨설턴트: 상담 기록 입력, 요약 생성
- 관리자: 전체 기록 조회, CSV 다운로드

## 기술 스택
- Next.js
- Supabase
- Tailwind CSS

## 현재 완료된 기능
- 상담 입력 화면
- 상담 목록 화면
- Supabase 저장

## 아직 미완성
- AI 요약 생성
- 관리자 권한 구분
- CSV 다운로드

## 중요한 결정
- 50~60대 사용자도 쉽게 쓸 수 있게 글씨를 크게 유지
- 모바일보다 PC 사용을 우선
- 복잡한 대시보드보다 상담 입력 속도를 우선

## 검증 방법
- npm run dev
- 상담 기록 입력
- 새로고침 후 데이터 유지 확인
작업 시작 시 한 마디
작업을 시작하기 전에 PROJECT_MEMO.md를 먼저 읽고, 현재 프로젝트 기준을 이해한 뒤 진행해줘.
06 · 컨설팅 현장

고객 요청을
작업 지시로 바꾸는 법

고객의 말은 늘 한 문장입니다. 그 한 문장을 그대로 AI에게 넘기면 범위가 터집니다.

시나리오 1

“간단한 예약 시스템”을 원할 때

고객의 말

“상담 예약을 온라인으로 받는 간단한 시스템이 있으면 좋겠어요.”

1단계 · 범위 정리
상담 예약 시스템을 만들기 전에 MVP 범위를 정리해줘.

고객 요구:
- 온라인으로 상담 예약을 받고 싶다.
- 관리자는 예약 목록을 확인하고 싶다.
- 처음에는 결제 기능은 필요 없다.

정리할 내용:
1. 꼭 필요한 기능
2. 나중에 추가할 기능
3. 첫 번째 버전에서 제외할 기능
4. 화면 구성
5. 데이터 항목
6. 구현 순서
2단계 · 더 작게 지시
첫 번째 버전에서는 예약 입력 폼만 만들어줘.
필드는 이름, 연락처, 희망일, 상담 주제만 사용해.
저장 기능은 임시로 브라우저 메모리에 저장해도 돼.
먼저 화면과 입력 흐름이 자연스러운지 확인하자.
시나리오 2

엑셀 업무를 웹앱으로 바꿀 때

고객의 말

“지금 엑셀로 관리하는 지원사업 신청자 목록을 웹으로 보고 싶어요.”

중요한 것은 엑셀의 모든 기능을 한 번에 옮기지 않는 것입니다.

1단계 · 업무 흐름 분석
엑셀 업무를 웹앱으로 전환하려고 해.
먼저 엑셀의 모든 기능을 구현하지 말고, 업무 흐름을 분석해줘.

현재 엑셀에서 하는 일:
- 신청자 정보 입력
- 상태값 변경
- 담당자 배정
- 선정 여부 표시
- 월별 통계 확인

먼저 다음을 구분해줘.

1. 웹앱 1차 버전에 꼭 필요한 기능
2. 엑셀로 계속 해도 되는 기능
3. 관리자만 필요한 기능
4. 자동화하면 효과가 큰 기능
5. 구현 난이도가 높은 기능
2단계 · 1차 버전 범위
1차 버전에서는 신청자 목록 조회와 상태 변경만 구현해줘.
통계와 자동 알림은 아직 만들지 마.
목록에서 상태를 변경하면 화면에 바로 반영되는 것까지만 확인하자.
시나리오 3

제안서 자동화 도구를 만들 때

고객의 말

“제안서 초안을 자동으로 만들어주는 도구가 있으면 좋겠어요.”

처음에는 “완전 자동 제안서”가 아니라 “초안 보조 도구”로 접근하세요.

1단계 · 1차 버전 설계
제안서 자동 작성 도구의 1차 버전을 설계해줘.
완전 자동 작성이 아니라 컨설턴트가 입력한 정보를 바탕으로 초안을 만들어주는 보조 도구로 제한해줘.

입력값:
- 고객사명
- 업종
- 현재 문제
- 원하는 목표
- 제안 서비스
- 예상 일정

출력값:
- 제안 배경
- 고객 문제 요약
- 해결 방향
- 추진 일정 초안
- 기대 효과

먼저 화면 구성과 입력 항목을 설계해줘.
2단계 · 이번 단계 범위
이번 단계에서는 AI 생성 기능을 붙이지 말고, 입력 폼과 미리보기 화면만 만들어줘.
사용자가 입력한 내용이 제안서 형식으로 정리되어 보이는지 확인하는 것이 목표야.

AI에게 맡길 일과 사람이 잡아야 하는 일

구분AI에게 맡기기 좋음사람이 잡아야 함
화면 초안가능사용자에게 맞는 흐름 판단
코드 작성가능기능 우선순위 결정
오류 수정가능완료 기준 결정
문서 초안가능고객 맥락 반영
테스트 작성가능어떤 테스트가 중요한지 판단
배포 보조가능실제 운영 책임 판단

AI는 “그럴듯한 평균 답”을 잘 만듭니다. 하지만 컨설턴트는 고객의 상황, 예산, 사람, 조직 문화, 실제 사용 능력을 봐야 합니다. 그래서 컨설턴트의 역할은 더 중요해집니다.

AI는 속도가 매우 빠른 신입 개발자입니다.
손은 빠르지만, 업무 맥락을 자주 잊고, 확인하지 않은 것도 했다고 말할 수 있습니다.
AI는 24시간 일하는 외주 개발팀입니다.
하지만 요구사항 정의서, 검수 기준, 중간 보고, 납품 테스트가 없으면 결과물이 흔들립니다.
07 · 현장 체크리스트

AI로 만들기 전,
18개만 확인하세요

눌러서 표시할 수 있습니다. 시작 전에 한 번, 작업 중에 한 번, 마치고 한 번 훑어보세요.

시작 전

작업 중

작업 후

08 · 프롬프트 라이브러리

바로 복사해서 쓰는
프롬프트 모음

앞의 내용을 짧게 압축한 일곱 개입니다. 이 부분만 저장해두어도 충분합니다.

프로젝트 시작
너는 지금부터 이 프로젝트의 개발자가 아니라, 신중한 개발 파트너로 일해야 해.
바로 코딩하지 말고 먼저 목표, 범위, 구현 순서, 검증 방법을 정리해줘.
내가 승인하기 전에는 코드를 작성하지 마.
완료 기준 설정
이 작업의 완료 기준을 먼저 정의해줘.
완료 기준은 사용자가 실제로 확인할 수 있는 행동 기준이어야 해.
예: 버튼이 보인다, 저장된다, 목록에 표시된다, 오류 메시지가 나온다, 새로고침 후 유지된다.
작업 범위 제한
이번 작업에서는 아래 범위만 수정해줘.

포함할 것:
- 

제외할 것:
- 

제외한 기능은 절대 건드리지 말고, 필요하다고 생각되면 먼저 나에게 제안만 해줘.
검증 보고
작업 후 아래 형식으로만 보고해줘.

1. 변경한 파일
2. 변경 이유
3. 실행한 명령어
4. 테스트 결과
5. 직접 확인한 기능
6. 아직 확인하지 못한 부분
7. 다음 추천 작업
오류 분석
오류를 바로 고치지 말고 먼저 분석해줘.

- 오류 메시지 원문
- 오류가 발생한 위치
- 관련 파일
- 가능한 원인
- 가장 유력한 원인
- 수정 계획

수정은 내가 승인한 뒤 진행해줘.
컨텍스트 정리
대화가 길어졌으니 현재 상태를 정리해줘.
새 대화방에 그대로 붙여넣을 수 있게 작성해줘.

포함할 내용:
- 프로젝트 목적
- 현재 파일 구조
- 완료된 작업
- 실패했던 시도
- 중요한 결정사항
- 남은 문제
- 다음 작업 순서
- 검증 방법
롤백 판단
방금 수정 이후 문제가 더 커진 것 같아.
계속 고칠지, 이전 커밋으로 롤백할지 판단해줘.

다음 기준으로 비교해줘.

| 선택지 | 장점 | 위험 | 추천 여부 |
|---|---|---|---|

추측하지 말고 현재 변경 파일과 오류 내용을 기준으로 판단해줘.

고객에게는 이렇게 설명하세요

“AI로 개발하면 빠르게 만들 수 있습니다. 하지만 빠르게 만든다는 것과 안전하게 완성한다는 것은 다릅니다. 그래서 저희는 AI에게 그냥 코딩을 시키는 것이 아니라, 작업 범위, 검증 기준, 롤백 구조를 정해놓고 운영합니다.”

AI를 과장해서 파는 것이 아니라, 실제로 성공시키는 방법을 알고 있다는 인상을 줄 수 있습니다.

09 · 최종 정리

95%까지 가는
네 가지

바이브코딩은 재미있고 강력합니다. 하지만 그냥 감으로 밀어붙이면 80%에서 멈춥니다.

ONE작게 시키기한 번에 전체를 만들지 말고 기능을 잘게 나눈다.
TWO완료 기준 정하기“수정 완료”가 아니라 실제 작동 기준을 정한다.
THREE검증 요구하기실행 결과, 테스트 결과, 화면 확인으로 증명하게 한다.
FOUR컨텍스트와 롤백 관리메모, 커밋, 새 세션 인수인계로 작업을 통제한다.

바이브코딩은 프롬프트 기술이 아니라,
AI 개발팀을 운영하는 PM 기술입니다.

댓글

이 블로그의 인기 게시물

구글 드라이브에서 내 파일이 갑자기 사라졌어요 [알아두면 쓸모 있는 구글 드라이브 팁]

  구글 드라이브에서 고아가 된(정리 되지 않은)  파일들에 대한 현상 및 복원 방법 및 공유 드라이브 활용 목차  배경 내 파일이나 폴더가 사라지고 (삭제된 것은 아님) 찾을 수 없는 현상 고아가 된 파일 (정리가 안된 파일) 을 찾아 내고 복원하는  방법 고아가 된 과정을 추적하는 방법 배경   구글 드라이브의 내 드라이브에서 협업을 위한 협업 폴더를 생성한 후 다른 팀원간들간에 공유하여 작업하는 동안 예기치 못하게 내가 생성한 파일들 또는 폴더가 갑자기 사라지는 현상이 발생 할 수 있습니다. 또한 이를 경험한 사용자들이 많이 있습니다.  내가 파일이나 폴더를 삭제하지 않았는데 불구하고 휴지통에도 없고, 내가 삭제한 기억도 없고, 이러한 현상이 발생할 경우에는 본 벡서서에서 설명하는 해당 폴더나 파일들이 ‘고아 (Orphaned)’ 가 된 상태가 되어있는게 분명합니다.  한글 도움말에는 ‘정리가 되지 않은 파일 (또는 분리가 된 파일)' 이라고 설명되어 있기도 합니다. 고아가 된 파일들은 어떠한 폴더에도 속하여 있지 않고, 내 휴지통에도 존재하지 않는 현상입니다. 그러나, 구글 드라이브에서는 용량을 계속 차지 않고 있는 상태입니다. 간혹 왜? 내가 삭제한 적이 없는데 파일이 없어졌거나 폴더가 보이질 않는 경우 당황하지 않고 이문서를 자세히 참조하면 해답을 찾을 수 있습니다.   내 파일이나 폴더가 사라지고 (삭제된 것은 아님) 찾을 수 없는 현상      1. 내 드라이브에서 Folder A를 생성하고 Folder A 안에 File A 를 생성 합니다. 나중에 File A를 삭제 하고, 그 이후에 Folder A 까지 삭제를 할 수 있습니다. 그후 휴지통에서 File A만 복원을 할 경우 삭제된 File A 를 복원하려고 하는데 File A가 존재하였던 상위 폴더 ‘Folder A’는 이미 삭제된 상태입니다. 이럴때 File A는 ...

Claude Code 공식 모범 사례 쉽게 이해하기

  학습용 가이드 · Anthropic 공식 문서 기반 Claude Code 공식 모범 사례 쉽게 이해하기 이 문서는 Anthropic의 공식 문서 Claude Code 모범 사례 를 바탕으로, 내용을 더 쉽게 이해할 수 있도록 설명과 예시를 추가해 재구성한 학습용 가이드입니다. 공식 문서: code.claude.com/docs/ko/best-practices 목차 한 줄 요약 챗봇이 아니라 "자율 코딩 작업자"다 완료 기준을 먼저 줘라 검증 기준의 종류 Before/After: 검증 기준 제공 탐색 → 계획 → 코딩 순서 Plan Mode가 필요한 경우 탐색 → 계획 → 구현 예시 구체적인 맥락을 넣어라 Before/After: 맥락 제공 풍부한 콘텐츠를 제공하라 CLAUDE.md는 짧은 운영 카드다 좋은 CLAUDE.md 예시 권한은 자동화의 브레이크다 CLI 도구를 적극 활용하라 MCP 서버로 외부 시스템 연결 Hooks: 반드시 실행되는 규칙 Skills: 반복 업무 저장 Subagents로 context 절약 Claude에게 질문도 잘 시켜라 세션 관리는 품질 관리다 체크포인트와 rewind 활용 비대화형 모드로 자동화하기 여러 세션 병렬 실행 대량 작업은 fan-out으로 적대적 리뷰 단계 추가 흔한 실패 패턴과 해결책 실무 시나리오별 완성 프롬프트 AI 개발팀 운영 모델 작업 전 체크리스트 바로 쓰는 기본 템플릿 최종 정리 0 한 줄 요약 Claude Code를 잘 쓰는 핵심은 AI에게 코딩을 맡기는 것 이 아니라, AI가 검증 가능한 방식으로 일하게 만드는 것 입니다. 좋은 AI 코딩 운영 = 목표 + 맥락 + 검증 기준 + 권한 제한 + 리뷰 구조 1 Claude Code는 챗봇이 아니라 "자율 코딩 작업자"다 일반 챗봇은 질문에 답하고 멈춥니다. 하지만 Claude Code는 다음 일을 할 수 있습니다. 파일 읽기 코드 수정 터미널 명령 실행 테스트 실행 빌드 확인 에러 로그 분석 여러 파일에 걸친 리팩터링...

[알아두면 쓸모 있는 구글 문서 팁] 문서 공유시- 사용자 이름 대신에 익명의 동물이 표시 되는 이유와 동물 종류

구글 드라이브에는 다른 유사 서비스에서는 제공하지 않는 구글 만의 유니크한 기능들이 있다 구글 문서를  불특정 다수에게 전체 공개로 공유할 수 있습니다. 불특정인이 구글 문서에 접속한 경우 익명의 동물로 표시됩니다.  ' 웹에 공개' 또는 '링크가 있는 사용자' 공유 설정을 선택하면 인식할 수 없는 이름이나 익명의 동물이 표시될 수 있습니다. 파일에서 인식할 수 없는 이름을 볼 수 있는 몇 가지 이유는 다음과 같습니다. 메일링 리스트와 파일을 공유합니다. Google 계정이 없는 사용자와 파일을 공유하며, 그 사용자가 다른 사용자에게 공유 초대를 전달했습니다. 내 파일을 수정할 수 있는 누군가가 파일을 다른 사용자와 공유했습니다. 다른 사용자가 자신의 Google 계정 이름을 변경했습니다. 공유 설정 페이지에서 해당 사용자 이름 위로 마우스를 이동하여 이메일 주소를 확인하세요. 익명의 동물 다른 사용자에게 개별적으로 보기 또는 수정 권한을 부여하거나 메일링 리스트에 속해 있는 경우에만 사용자 이름이 표시됩니다. 파일 권한을 '링크가 있는 사용자'로 설정하면 파일을 보고 있는 사용자의 이름이 표시되지 않습니다. 대신 다른 사용자가 익명으로 라벨이 지정되어 표시되고 각 익명 사용자는 다양한 익명의 동물로 나열됩니다. 파일 권한을 '링크가 있는 사용자'로 설정했지만 특정 사용자와 파일을 공유하는 경우 파일을 공유한 사용자의 이름이 표시됩니다. 그 외 다른 사용자가 파일을 볼 때는 익명으로 나타납니다. 비공개 파일의 익명 동물 파일 권한을 '링크가 있는 사용자'로 설정한 다음 이를 '특정 사용자'로 변경하면 다음과 같은 경우 여러 익명의 동물이 표시될 수 있습니다. 누군가 파일을 여러 번 여는 경우에는 익명의 동물 목록에서 오래되고 연결이 끊긴 세션을 강제 종료하는 데 조금 시간이 걸릴 수 있습니다. 누군가 온...

[팁] Google Slide 프리젠테이션시 모든 한글폰트가 '굴림체' 로 바뀌는 현상을 해결한 크롬 확장 프로그램 소개

구글 문서도구인 구글 슬라이드를 이용하여 프리젠테이션을 많이 하는 분들을 위한 희소식 현재 구글 슬라이드에서는 슬라이드 편집시 사용한 고유 한글 폰트들은 프리젠테이션 모드로 전환할 경우는 모두 '굴림체' 로 바뀌어 표시가 되는 불편함이 있었습니다. 예). 슬라이드 편집에서 사용한 '궁서체' 한글 폰트는, 프리젠테이션 모드에서는 '굴림체'로 바뀌어 디스플레이됨 예). 슬라이드 편집 모드 - '궁서체' 폰트 사용 프리젠테이션 모드에서 '굴림체' 로 변경됨    따라서, 이러한 현상을 해결하는 크롬 확장 프로그램이 개발 되었습니다.  크롬 확장 프로그램 명 - ShowAsis 입니다. 크 롬 웹스토어 링크 -  https://goo.gl/PVPkZz 이 확장 프로그램을 사용하여 슬라이드 프리젠테이션을 하면, 편집 모드의 폰트 그대로 프리젠테이션시에도 그대로 한글 폰트로 디스플레이 됩니다. 단, 단점은 슬라이드가 애니메이션 슬라이드가 있는 경우는 애니메이션이 동작하지 않습니다. ----------------------- G Suite/Google Apps 전문 블로그 -  charlychoi.blogspot.kr 도서 '기업과 학교를 위한 구글크롬북'