자료실
가이드웹앱 만들기

비개발자용 오류 해결 카드와 질문 템플릿

고른 이유오류가 나면 비개발자는 "안 돼요, 고쳐줘"만 보내기 쉬워요. 상황을 나눠 설명하는 틀 하나만 있어도 AI가 엉뚱한 곳을 고치는 일이 줄어서 골랐어요.

한 줄로 말하면

AI로 만든 앱이 갑자기 안 될 때, 당황해서 이것저것 고치지 말고 6단계 루틴과 질문 템플릿 하나로 AI에게 정확히 설명하세요.

이런 분께

  • AI와 대화하며 웹사이트나 앱을 만들어 보는 비개발자
  • 오류 메시지를 봐도 무슨 뜻인지 몰라 AI에게 어떻게 물어야 할지 막막한 분

오류가 나면 이 순서대로

  • 멈추기: 오류가 나자마자 이것저것 더 요청하면 문제가 겹쳐요. 일단 손을 멈춰요.
  • 화면 저장하기: 오류가 난 화면과 오류 메시지를 그대로 남겨 둬요. 나중에 AI에게 보여 줄 증거예요.
  • 마지막 작업 확인하기: 오류 직전에 AI에게 무엇을 요청했는지 떠올려요. 원인은 대개 가장 최근 변경 근처에 있어요.
  • 문제 설명하기: 아래 질문 템플릿을 채워서 AI에게 보내요.
  • 한 가지씩 수정하기: 여러 곳을 한꺼번에 고치면 무엇이 효과가 있었는지 알 수 없어요. 한 번에 하나만 고쳐요.
  • 다시 테스트하기: 고친 부분만이 아니라, 원래 잘 되던 기능도 여전히 되는지 확인해요.

AI에게 오류를 설명하는 법

"안 돼요, 고쳐줘"만 보내면 AI는 어디가 문제인지 추측부터 해야 해요. 추측이 빗나가면 멀쩡한 부분까지 바꿔 버릴 수 있어요. 그래서 질문을 여섯 칸으로 나눠 채워요.

  • 원래 원한 결과와 실제로 나타난 결과를 나란히 적으면 차이가 드러나요.
  • 마지막으로 요청한 내용은 원인을 좁히는 가장 큰 단서예요.
  • 오류 메시지는 뜻을 몰라도 그대로 복사해 붙여 넣어요.
  • 작동하는 부분과 작동하지 않는 부분을 함께 적으면, AI가 잘 되는 기능을 건드리지 않게 돼요.

마지막에 "쉬운 말로, 한 번에 한 단계씩, 기존 기능은 유지"를 요청해 두면 비개발자도 따라갈 수 있는 답이 와요.

✏️ 바꿔 쓰는 프롬프트

나는 비개발자…

프롬프트 전체 보기와 복사는 회원에게 열려 있어요

확인 중…
✅ 체크리스트

오류가 난 화면과 오…

체크리스트 전체는 회원에게 열려 있어요

확인 중…

오류 앞에서 만나는 용어

AI의 답이나 오류 메시지에 자주 나오는 말만 골랐어요.

용어쉬운 설명
버그의도와 다르게 작동하는 문제
테스트기능이 정상적으로 작동하는지 확인하는 과정
페이지서비스 안의 한 화면
프런트엔드사용자가 직접 보고 누르는 화면
데이터서비스에서 사용하는 각각의 정보
데이터베이스데이터를 일정한 규칙으로 저장하는 공간
필드제목, 설명, 날짜처럼 데이터의 항목
배포다른 사람이 접속할 수 있도록 공개하는 과정
URL서비스에 접속하는 인터넷 주소
API서로 다른 서비스가 기능이나 데이터를 주고받는 방법
API 키외부 기능 사용 권한을 확인하는 비밀값
반응형컴퓨터와 휴대폰 화면 크기에 맞게 화면이 바뀌는 구조

용어를 알면 "어디가 문제인지"를 더 짧게 말할 수 있어요. 예를 들어 "화면은 나오는데 저장한 내용이 사라져요"라면 프런트엔드보다 데이터베이스 쪽 문제일 가능성을 AI와 함께 확인해 볼 수 있어요.

참고할 점

  • 오류 메시지를 붙여 넣기 전에 API 키 같은 비밀값이 섞여 있지 않은지 확인하세요.
  • AI가 고친 뒤에도 같은 오류가 반복되면, 다시 처음 루틴으로 돌아가 마지막 변경부터 짚어 보세요.
  • 이 템플릿은 원인을 좁히는 도구예요. 앱 구조 자체가 복잡해졌다면 한 번에 해결되지 않을 수 있어요.

저작권·출처 문의 newrun.cs@gmail.com

자료를 넘어 나만의 도구를 직접 만들고 싶다면 —

교육 프로그램 보기 →

함께 보면 좋은 자료

자료실 전체 →