프롬프트에 ‘강제장치’를 달았더니 AI가 진짜 일하기 시작했다
1편에서 4번 연속 실패한 이야기를 했다. Claude한테 “만들어줘”라고 했더니 더미 URL만 잔뜩, Step-by-Step으로 나눴더니 중간 스킵, 파일명까지 지정했더니 겨우 절반 성공.
결국 깨달은 건 “AI는 편한 길을 선택한다”는 거였다.
그래서 프롬프트를 완전히 바꿔야 했다. AI가 대충 넘어가지 못하게, 스킵하지 못하게, 강제로 단계를 밟게 만드는 장치가 필요했다. 이번 편에서는 그 해결 과정을 공유한다.
💡 발상의 전환: AI를 “관리”해야 한다
4번 실패하고 나서 생각을 바꿨다. AI를 “도구”로만 보면 안 된다. 차라리 “신입 개발자”라고 생각하는 게 맞다.
신입한테 “재고 시스템 만들어”라고 하면 뭐가 나올까? 아마 뭔가 만들어오긴 할 거다. 근데 내가 원하는 그 결과물은 아닐 확률이 높다. 왜? 구체적인 요구사항을 안 줬으니까. 중간 점검을 안 했으니까. 완료 기준을 안 정했으니까.
AI도 마찬가지다. 시키는 대로 하긴 하는데, “시키는 것”이 명확하지 않으면 자기 맘대로 해석한다. 모르는 건 대충 넘어가고, 복잡한 건 스킵하고, 검증은 알아서 하라고 넘긴다.
그래서 “관리”가 필요하다. 마치 프로젝트 매니저가 신입 개발자를 관리하듯이.
🔧 해결책 1: Phase/Step 계층 구조
첫 번째로 바꾼 건 구조다. 그냥 Step 1, 2, 3으로 나누는 게 아니라 Phase와 Step 두 단계로 계층화했다.
- Step 1: 프로젝트 설정
- Step 2: API 연결
- Step 3: 동기화 로직
- Step 4: 테스트
- ## Phase 1: 환경 설정 (1시간)
– Step 1-1: 프로젝트 초기화 (20분)
– Step 1-2: 패키지 설치 (10분) - ## Phase 2: 이카운트 연동 (2시간)
– Step 2-1: 인증 테스트 (30분)
– Step 2-2: 재고 조회 (30분)
왜 이게 효과가 있냐면, AI한테 “큰 그림”과 “세부 작업”을 동시에 인지시키기 때문이다. Phase는 전체 맥락을 유지하게 하고, Step은 구체적인 액션을 명확하게 한다. 시간까지 적어주면 복잡도와 우선순위도 같이 전달된다.
🚫 해결책 2: 금지 사항 명시
두 번째로 추가한 건 “하지 마”라는 명확한 금지 조항이다. 이게 생각보다 엄청 중요했다.
왜 이게 필요하냐면, AI는 “편한 길”을 선택하기 때문이다. 실제 API 연동이 복잡하면 더미 데이터로 때우고 “나중에 실제 데이터로 교체하세요”라고 한다. 이걸 원천 차단하는 거다.
금지 사항을 명시하면 AI가 그 방향으로 도망가지 못한다. “더미 데이터 쓰면 안 된다고 했으니까 진짜 연동을 해야겠네”라고 인식하는 거다. 실제로 이 금지 조항을 넣고 나서부터 api.example.com 같은 황당한 URL이 사라졌다.
✅ 해결책 3: 검증 포인트 제시
세 번째는 “이게 되면 성공이야”라는 명확한 기준을 주는 거다.
• npm start 실행 시 에러 없이 서버 구동
• 콘솔에 “Server running on port 3000” 출력
• /api/test 접속 시 이카운트 실제 데이터 JSON 응답
• 응답에 ItemCode, Qty 필드 포함
이전에는 그냥 “API 연결해줘”라고 했다. 근데 “연결됐다”의 기준이 뭔가? AI 입장에서는 코드만 작성해도 “연결했다”고 할 수 있다. 실제로 돌아가는지는 별개의 문제니까.
검증 포인트를 명시하면 AI도 “아, 이게 되어야 완료구나”라고 인식한다. 그리고 나도 중간에 확인할 수 있다. “Phase 2 검증 포인트 통과했어?”라고 물으면 AI가 직접 체크해준다.
📋 해결책 4: 강제 응답 패턴
네 번째는 AI가 스킵하지 못하게 “응답을 강제”하는 패턴이다. 이게 제일 효과가 좋았다.
⚠️ 각 단계를 완료할 때마다 [✓] 표시하고 보고하세요.
다음 질문에 YES/NO로 답변 후 작업 시작:
1. 현재 프로젝트 파일을 확인했는가? [ ]
2. 기존 코드 구조를 파악했는가? [ ]
3. API 연동 부분을 식별했는가? [ ]
위 질문에 모두 YES로 답변한 후 Phase 1 시작.
왜 이게 효과가 있냐면, AI가 “아 네 알겠습니다 바로 시작할게요~” 하면서 중요한 단계를 건너뛰는 걸 막기 때문이다.
“YES/NO로 답변해”라고 하면 AI가 정말로 YES/NO로 답한다. 그리고 그 과정에서 실제로 파일을 확인하고, 구조를 파악한다. 그냥 “확인하고 시작해”라고 하면 대충 넘어가는데, 명시적으로 답변을 요구하면 진짜로 한다.
🎯 실전 적용: B2B 주문 시스템 17 Phase
이 모든 걸 종합해서 B2B 거래처 주문 시스템을 만들었다. 거래처가 로그인해서 상품 주문하면 이카운트 ERP에 자동으로 전표가 생성되는 시스템이다. 복잡도가 상당해서 아예 17개 Phase로 쪼갰다.
1. 프로젝트 초기화 (Next.js + Supabase)
2. 데이터베이스 스키마 설계
3. 인증 시스템 구축
## Phase 4-7: 핵심 기능
4. 거래처 로그인/회원가입
5. 상품 목록 페이지
6. 장바구니 기능…
그리고 각 Phase마다 금지 사항, 검증 포인트, 강제 응답 패턴을 전부 넣었다. 실제로 Claude한테 전달한 프롬프트 일부를 공개한다.
## 목표
주문이 생성되면 이카운트 ERP에 판매 전표 자동 생성
## Step 8-1: 이카운트 인증 모듈 (30분)
– /lib/icount/auth.ts 파일 생성
– 세션 키 발급 함수 구현
## 🚫 금지 사항
– Mock 데이터로 테스트 금지
– 더미 URL 사용 금지
## ✅ 검증 방법
– 테스트 주문 생성 시 이카운트 관리자에서 전표 확인
– slipNo가 실제 이카운트 전표번호와 일치
## 📋 완료 보고 형식
“Phase 8 완료 ✓
– Step 8-1: 인증 모듈 완료
– Step 8-2: 전표 생성 API 완료
– 검증: 테스트 전표 [전표번호] 생성 확인
Phase 9 시작하겠습니다.”
📊 결과: Before vs After
이 방식으로 바꾸고 나서 확실히 달라졌다.
| 항목 | Before (기존) | After (개선 후) |
|---|---|---|
| 더미 데이터 | 매번 등장 | 거의 없음 |
| 중간 스킵 | 빈번함 | 거의 없음 |
| 일관성 | 대화 길어지면 붕괴 | 유지됨 |
| 실제 작동률 | 30% 미만 | 85% 이상 |
가장 큰 변화는 “실제로 작동하는 코드”가 나온다는 거다. 이전에는 코드를 받아서 실행하면 90%는 에러였다. 지금은 대부분 바로 돌아간다. B2B 주문 시스템은 17개 Phase를 약 2주에 걸쳐 완성했다. 이전 방식이었으면 아마 한 달이 넘게 걸렸거나, 중간에 포기했을 거다.
1. 명확한 지시 2. 중간 점검 3. 완료 기준
이 세 가지가 있어야 AI가 제대로 일한다.
📢 다음 편 예고
2편에서는 “어떻게 해야 하는지”를 설명했다. 근데 매번 이런 프롬프트를 처음부터 작성하기는 귀찮다. 그래서 3편에서는 복사해서 바로 쓸 수 있는 프롬프트 템플릿을 공유한다.
- 템플릿 A: 신규 프로젝트 셋업용
- 템플릿 B: API 연동 디버깅용
- 템플릿 C: 기존 코드 수정용
- 상황별 커스터마이징 가이드
그냥 복붙해서 프로젝트명이랑 세부사항만 바꾸면 된다. 내가 삽질하면서 만든 템플릿이니까, 이걸 쓰면 최소한 나처럼 4번 실패하는 일은 없을 거다.
📊 2편 요약
| 🔧 AI를 제어하는 4가지 장치 |
|---|
| 1. Phase/Step 계층 구조 → 큰 그림 + 세부 작업 동시 인지 2. 금지 사항 명시 → AI가 편한 길로 도망가는 것 차단 3. 검증 포인트 제시 → “이게 되면 완료” 명확한 기준 4. 강제 응답 패턴 → YES/NO, 체크박스, 보고 형식 강제 |

