한 줄로 말하면
AI로 만든 앱이 갑자기 안 될 때, 당황해서 이것저것 고치지 말고 6단계 루틴과 질문 템플릿 하나로 AI에게 정확히 설명하세요.
이런 분께
- AI와 대화하며 웹사이트나 앱을 만들어 보는 비개발자
- 오류 메시지를 봐도 무슨 뜻인지 몰라 AI에게 어떻게 물어야 할지 막막한 분
오류가 나면 이 순서대로
- 1멈추기
- 2화면 저장하기
- 3마지막 작업 확인하기
- 4문제 설명하기
- 5한 가지씩 수정하기
- 6다시 테스트하기
- 멈추기: 오류가 나자마자 이것저것 더 요청하면 문제가 겹쳐요. 일단 손을 멈춰요.
- 화면 저장하기: 오류가 난 화면과 오류 메시지를 그대로 남겨 둬요. 나중에 AI에게 보여 줄 증거예요.
- 마지막 작업 확인하기: 오류 직전에 AI에게 무엇을 요청했는지 떠올려요. 원인은 대개 가장 최근 변경 근처에 있어요.
- 문제 설명하기: 아래 질문 템플릿을 채워서 AI에게 보내요.
- 한 가지씩 수정하기: 여러 곳을 한꺼번에 고치면 무엇이 효과가 있었는지 알 수 없어요. 한 번에 하나만 고쳐요.
- 다시 테스트하기: 고친 부분만이 아니라, 원래 잘 되던 기능도 여전히 되는지 확인해요.
AI에게 오류를 설명하는 법
"안 돼요, 고쳐줘"만 보내면 AI는 어디가 문제인지 추측부터 해야 해요. 추측이 빗나가면 멀쩡한 부분까지 바꿔 버릴 수 있어요. 그래서 질문을 여섯 칸으로 나눠 채워요.
- 원래 원한 결과와 실제로 나타난 결과를 나란히 적으면 차이가 드러나요.
- 마지막으로 요청한 내용은 원인을 좁히는 가장 큰 단서예요.
- 오류 메시지는 뜻을 몰라도 그대로 복사해 붙여 넣어요.
- 작동하는 부분과 작동하지 않는 부분을 함께 적으면, AI가 잘 되는 기능을 건드리지 않게 돼요.
마지막에 "쉬운 말로, 한 번에 한 단계씩, 기존 기능은 유지"를 요청해 두면 비개발자도 따라갈 수 있는 답이 와요.
✏️ 바꿔 쓰는 프롬프트
나는 비개발자…
프롬프트 전체 보기와 복사는 회원에게 열려 있어요
확인 중…✅ 체크리스트
오류가 난 화면과 오…
체크리스트 전체는 회원에게 열려 있어요
확인 중…오류 앞에서 만나는 용어
AI의 답이나 오류 메시지에 자주 나오는 말만 골랐어요.
| 용어 | 쉬운 설명 |
|---|---|
| 버그 | 의도와 다르게 작동하는 문제 |
| 테스트 | 기능이 정상적으로 작동하는지 확인하는 과정 |
| 페이지 | 서비스 안의 한 화면 |
| 프런트엔드 | 사용자가 직접 보고 누르는 화면 |
| 데이터 | 서비스에서 사용하는 각각의 정보 |
| 데이터베이스 | 데이터를 일정한 규칙으로 저장하는 공간 |
| 필드 | 제목, 설명, 날짜처럼 데이터의 항목 |
| 배포 | 다른 사람이 접속할 수 있도록 공개하는 과정 |
| URL | 서비스에 접속하는 인터넷 주소 |
| API | 서로 다른 서비스가 기능이나 데이터를 주고받는 방법 |
| API 키 | 외부 기능 사용 권한을 확인하는 비밀값 |
| 반응형 | 컴퓨터와 휴대폰 화면 크기에 맞게 화면이 바뀌는 구조 |
용어를 알면 "어디가 문제인지"를 더 짧게 말할 수 있어요. 예를 들어 "화면은 나오는데 저장한 내용이 사라져요"라면 프런트엔드보다 데이터베이스 쪽 문제일 가능성을 AI와 함께 확인해 볼 수 있어요.
참고할 점
- 오류 메시지를 붙여 넣기 전에 API 키 같은 비밀값이 섞여 있지 않은지 확인하세요.
- AI가 고친 뒤에도 같은 오류가 반복되면, 다시 처음 루틴으로 돌아가 마지막 변경부터 짚어 보세요.
- 이 템플릿은 원인을 좁히는 도구예요. 앱 구조 자체가 복잡해졌다면 한 번에 해결되지 않을 수 있어요.


