ISSUE 83 2026년 11월
AI · 비즈니스·경제 · 건강·생활
AI 실전 활용

프롬프트에 ‘강제장치’를 달아야 AI가 진짜 일한다.

AI 개발 삽질기 2편: 프롬프트에 강제장치 달기
👋 Notice: 이 글은 개인의 주관적인 경험과 생생한 감정을 전달하기 위해 ‘반말(평어)’로 작성되었습니다.

프롬프트에 ‘강제장치’를 달았더니 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: 금지 사항 명시

두 번째로 추가한 건 “하지 마”라는 명확한 금지 조항이다. 이게 생각보다 엄청 중요했다.

🚫 금지 사항 (Do Not)
❌ 더미 데이터 사용 금지
❌ Mock API 사용 금지
❌ “예시입니다” 주석 금지
❌ placeholder URL 금지 (api.example.com)
❌ 실제 연동 없이 UI만 만드는 것 금지

왜 이게 필요하냐면, AI는 “편한 길”을 선택하기 때문이다. 실제 API 연동이 복잡하면 더미 데이터로 때우고 “나중에 실제 데이터로 교체하세요”라고 한다. 이걸 원천 차단하는 거다.

금지 사항을 명시하면 AI가 그 방향으로 도망가지 못한다. “더미 데이터 쓰면 안 된다고 했으니까 진짜 연동을 해야겠네”라고 인식하는 거다. 실제로 이 금지 조항을 넣고 나서부터 api.example.com 같은 황당한 URL이 사라졌다.

✅ 해결책 3: 검증 포인트 제시

세 번째는 “이게 되면 성공이야”라는 명확한 기준을 주는 거다.

✅ 검증 방법 (Definition of Done)
Phase 1 완료 조건:
• npm start 실행 시 에러 없이 서버 구동
• 콘솔에 “Server running on port 3000” 출력
Phase 2 완료 조건:
• /api/test 접속 시 이카운트 실제 데이터 JSON 응답
• 응답에 ItemCode, Qty 필드 포함

이전에는 그냥 “API 연결해줘”라고 했다. 근데 “연결됐다”의 기준이 뭔가? AI 입장에서는 코드만 작성해도 “연결했다”고 할 수 있다. 실제로 돌아가는지는 별개의 문제니까.

검증 포인트를 명시하면 AI도 “아, 이게 되어야 완료구나”라고 인식한다. 그리고 나도 중간에 확인할 수 있다. “Phase 2 검증 포인트 통과했어?”라고 물으면 AI가 직접 체크해준다.

📋 해결책 4: 강제 응답 패턴

네 번째는 AI가 스킵하지 못하게 “응답을 강제”하는 패턴이다. 이게 제일 효과가 좋았다.

📋 필수 작업 체크리스트

⚠️ 각 단계를 완료할 때마다 [✓] 표시하고 보고하세요.

## STEP 0: 사전 확인 [필수 응답]
다음 질문에 YES/NO로 답변 후 작업 시작:

1. 현재 프로젝트 파일을 확인했는가? [ ]
2. 기존 코드 구조를 파악했는가? [ ]
3. API 연동 부분을 식별했는가? [ ]

위 질문에 모두 YES로 답변한 후 Phase 1 시작.

왜 이게 효과가 있냐면, AI가 “아 네 알겠습니다 바로 시작할게요~” 하면서 중요한 단계를 건너뛰는 걸 막기 때문이다.

“YES/NO로 답변해”라고 하면 AI가 정말로 YES/NO로 답한다. 그리고 그 과정에서 실제로 파일을 확인하고, 구조를 파악한다. 그냥 “확인하고 시작해”라고 하면 대충 넘어가는데, 명시적으로 답변을 요구하면 진짜로 한다.

🎯 실전 적용: B2B 주문 시스템 17 Phase

이 모든 걸 종합해서 B2B 거래처 주문 시스템을 만들었다. 거래처가 로그인해서 상품 주문하면 이카운트 ERP에 자동으로 전표가 생성되는 시스템이다. 복잡도가 상당해서 아예 17개 Phase로 쪼갰다.

🏗️ B2B 주문 시스템 프로젝트 구조 ## Phase 1-3: 기반 구축
1. 프로젝트 초기화 (Next.js + Supabase)
2. 데이터베이스 스키마 설계
3. 인증 시스템 구축

## Phase 4-7: 핵심 기능
4. 거래처 로그인/회원가입
5. 상품 목록 페이지
6. 장바구니 기능…

그리고 각 Phase마다 금지 사항, 검증 포인트, 강제 응답 패턴을 전부 넣었다. 실제로 Claude한테 전달한 프롬프트 일부를 공개한다.

💬 실제 사용한 프롬프트 (Phase 8) # Phase 8: 이카운트 API 연동

## 목표
주문이 생성되면 이카운트 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주에 걸쳐 완성했다. 이전 방식이었으면 아마 한 달이 넘게 걸렸거나, 중간에 포기했을 거다.

💡 핵심 원칙
AI를 “사용”하는 게 아니라 “관리”해야 한다.

1. 명확한 지시 2. 중간 점검 3. 완료 기준
이 세 가지가 있어야 AI가 제대로 일한다.

📢 다음 편 예고

2편에서는 “어떻게 해야 하는지”를 설명했다. 근데 매번 이런 프롬프트를 처음부터 작성하기는 귀찮다. 그래서 3편에서는 복사해서 바로 쓸 수 있는 프롬프트 템플릿을 공유한다.

  • 템플릿 A: 신규 프로젝트 셋업용
  • 템플릿 B: API 연동 디버깅용
  • 템플릿 C: 기존 코드 수정용
  • 상황별 커스터마이징 가이드

그냥 복붙해서 프로젝트명이랑 세부사항만 바꾸면 된다. 내가 삽질하면서 만든 템플릿이니까, 이걸 쓰면 최소한 나처럼 4번 실패하는 일은 없을 거다.

📊 2편 요약

🔧 AI를 제어하는 4가지 장치
1. Phase/Step 계층 구조
→ 큰 그림 + 세부 작업 동시 인지

2. 금지 사항 명시
→ AI가 편한 길로 도망가는 것 차단

3. 검증 포인트 제시
→ “이게 되면 완료” 명확한 기준

4. 강제 응답 패턴
→ YES/NO, 체크박스, 보고 형식 강제

더 많은 인사이트가 필요하신가요?

AI와 비즈니스·경제 중심의 다른 콘텐츠도 확인해보세요.

전체 콘텐츠 보기

ESC로 닫기