AI 코딩 질문 방법을 사용자, 시나리오, 범위, 제외 조건, 완료 기준 5줄로 정리했습니다. 코드를 요청하기 전에 붙여 넣을 템플릿도 제공합니다.
AI 코딩 질문 방법은 원하는 결과뿐 아니라 현재 상태, 제외 조건, 완료 기준을 함께 전달하는 데서 시작합니다.
연재 안내: 27편 전체 순서와 현재 공개된 글은 비개발자 바이브코딩 로드맵에서 확인할 수 있습니다.
개발 용어가 낯설다면 바이브코딩 초보 용어 20개를 옆에 열어두고 읽어보세요.
한 줄 답변
좋은 AI 코딩 질문은 화려한 문장이 아니라 누가 쓰는지, 어떤 순서로 쓰는지, 이번에 만들 범위, 하지 않을 것, 완료를 확인할 기준을 분명하게 적은 작업 지시서입니다.
“멋진 앱을 만들어줘”가 실패하는 이유
AI는 비어 있는 조건을 스스로 채웁니다. 예약 앱을 요청했는데 로그인, 결제, 이메일 알림까지 만들어낼 수 있습니다. 결과가 풍성해 보여도 내가 정하지 않은 기능이 늘어나면 파일과 데이터가 복잡해지고, 작은 오류를 고치기 어려워집니다.
프롬프트를 길게 쓰는 것만으로는 해결되지 않습니다. 중요한 정보가 빠진 긴 문장보다 핵심 조건이 들어간 짧은 목록이 낫습니다. AI가 추측해야 하는 빈칸을 줄이는 것이 질문의 목적입니다.
1. 누가 사용하는지 적는다
“예약 사용자”보다 “휴대전화로 공방 수업을 신청하는 고객”처럼 구체적으로 적습니다. 관리자와 고객이 함께 사용한다면 두 역할을 분리하고, 이번 작업이 어느 역할을 위한 것인지 표시합니다.
사용자가 정해지면 화면 크기, 문구, 필요한 권한이 달라집니다. AI에게 코드부터 요청하기 전에 사용자를 한 유형으로 좁히세요.
2. 행동 순서를 적는다
사용자가 어떤 화면에서 무엇을 누르고 어떤 결과를 보는지 한 줄씩 씁니다.
- 고객이 날짜와 이름을 입력한다.
- 신청 버튼을 누른다.
- 서버가 빈 값과 중복 예약을 검사한다.
- 성공하면 저장하고 완료 메시지를 보여준다.
이 순서가 있으면 AI도 화면, 검증, 저장을 서로 다른 단계로 이해할 수 있습니다.
3. 이번 작업 범위를 정한다
전체 앱이 아니라 지금 완성할 기능만 적습니다. “예약 등록 화면과 저장 기능만 만든다”, “기존 목록 화면은 수정하지 않는다”처럼 변경 범위를 제한합니다. 기존 프로젝트라면 수정 가능한 파일과 건드리면 안 되는 파일도 알려주세요.
범위가 클 때는 AI에게 먼저 구현 계획과 변경 파일 목록만 제시하게 합니다. 계획을 확인한 뒤 한 단계씩 코드를 요청하면 통제하기 쉽습니다.
4. 하지 않을 것을 적는다
AI의 과잉 구현을 막는 가장 강력한 문장은 제외 조건입니다.
- 이번 버전에는 결제를 넣지 않는다.
- 소셜 로그인과 문자 알림을 추가하지 않는다.
- 새 라이브러리를 설치하지 않는다.
- 기존 데이터베이스 표 이름을 바꾸지 않는다.
제외 조건은 아이디어를 포기하는 목록이 아니라 지금 프로젝트를 끝내기 위한 방어선입니다.
5. 완료 기준을 행동으로 적는다
“잘 작동해야 한다”는 확인할 수 없습니다. 정상과 실패 상황을 눈으로 확인할 수 있게 적습니다.
- 올바른 값을 입력하면 목록에 새 예약이 보인다.
- 이름이 비어 있으면 저장하지 않고 안내 문구를 표시한다.
- 같은 날짜와 시간의 중복 예약은 거절한다.
- 새로고침해도 저장된 예약이 남아 있다.
완료 기준이 있으면 코드를 읽지 못해도 결과를 판단할 수 있습니다.
복사해서 쓰는 5줄 템플릿
사용자: 이 기능을 사용하는 사람은 누구인가?
시나리오: 어떤 화면에서 무엇을 하고 어떤 결과를 보는가?
이번 범위: 이번 요청에서 새로 만들거나 수정할 것은 무엇인가?
제외 조건: 이번에는 하지 않을 기능과 건드리지 않을 파일은 무엇인가?
완료 기준: 정상·실패 상황에서 무엇이 보여야 완료인가?
템플릿 아래에는 “코드를 바로 작성하지 말고, 빠진 조건과 위험한 가정을 질문 세 개로 먼저 알려줘”라고 덧붙이세요. AI가 요구사항을 다시 설명하게 하면 서로 다르게 이해한 부분을 구현 전에 찾을 수 있습니다.
수정 요청도 같은 형식을 사용한다
오류를 고칠 때는 현재 정상인 것, 재현 순서, 실제 결과, 기대 결과, 수정 제한을 적습니다. “로그인을 고쳐줘”보다 “올바른 계정은 로그인되지만 잘못된 비밀번호에도 메인 화면으로 이동한다. 인증 파일만 확인하고 화면 디자인은 바꾸지 말라”고 적는 편이 정확합니다.
좋은 질문은 AI를 더 똑똑하게 만드는 주문이 아니라 작업자의 판단을 빠뜨리지 않는 체크리스트입니다.
나쁜 질문을 좋은 질문으로 바꾸는 예시
“로그인 기능을 만들어줘”는 사용자, 저장 방식, 완료 기준이 없습니다. 이를 “관리자 한 명이 이메일과 비밀번호로 로그인해 문의 목록을 보는 기능을 만든다. 회원가입과 소셜 로그인은 제외한다. 잘못된 비밀번호에는 같은 오류 문구를 보여주고, 로그인하지 않은 사용자는 목록 API에 접근하지 못해야 한다”로 바꿔보세요.
여기에 현재 기술과 수정 가능한 파일, 가짜 테스트 계정, 기존 기능 보존 조건을 붙이면 더 좋습니다. 마지막으로 AI에게 코드를 쓰기 전 누락된 보안·실패 조건을 질문하게 하세요. 같은 기능이라도 질문의 기준이 달라지면 결과의 범위와 검증 가능성이 크게 달라집니다.
AI 코딩 질문 방법 최종 점검
AI 코딩 질문 방법을 적용하기 전 사용자, 현재 문제, 원하는 결과, 바꾸지 않을 범위, 검증 방법이 모두 적혔는지 확인하세요. AI 코딩 질문 방법이 구체적이어도 한 번에 여러 기능을 요청하면 변경 범위가 커지므로 가장 작은 결과 하나만 먼저 부탁하는 편이 안전합니다.
답변을 받으면 수정할 파일과 이유, 예상 부작용, 실행할 테스트를 다시 요청하세요. 코드를 적용한 뒤에는 실제 결과와 오류 로그를 원래 요청과 함께 남겨 다음 질문에서 같은 설명을 반복하지 않도록 합니다.
바이브코딩 전체 순서 보기
바이브코딩 뜻, 하는법, 도구 선택, API 연결, 데이터베이스, 배포 흐름은 바이브코딩 가이드에서 이어서 볼 수 있습니다.
