AI에게 코딩을 맡길 때 '신입에게 설명하듯' 지시하는 법

문제: '이렇게 해줘'만 하면 왜 엉뚱한 결과가 나올까

AI에게 코딩을 맡길 때 흔히 저지르는 실수가 있습니다. 실제 개발 과정에서도 처음에는 AI에게 그냥 "이렇게 해줘", "이렇게 만들어줘"라고만 지시했습니다. 그 결과 생각했던 방향과 다르게 작업되는 경우가 많았습니다.
짧은 지시에는 내 머릿속에만 있는 전제가 잘 담기지 않습니다. 일반적으로 설명이 부족할수록 결과가 의도와 어긋날 가능성이 있는데, 실제로도 짧게 지시했을 때 원하던 방향과 다른 작업물이 나오는 일이 잦았습니다.

---

왜 이 문제를 살펴야 하는가

이 개발은 코딩을 직접 하지 않고 AI로만 만들겠다는 규칙 아래 진행했습니다. 그래서 AI에게 어떻게 지시하느냐가 결과물에 직접 영향을 주는 작업 방식이었습니다.

• 직접 코드를 작성하지 않고 AI 지시 중심으로 진행하는 방식이었기 때문에, 의도를 글로 전달하는 것이 작업의 핵심이었습니다.
• 짧게 지시했을 때는 생각했던 방향과 다르게 작업되는 경우가 많았습니다.

그래서 지시 단계에서 의도를 최대한 명확히 전달하는 것이 중요하다고 판단했습니다.

---

해결의 핵심: 신입에게 설명하듯 지시하기

실제 개발에서 방식을 바꾼 지점이 바로 여기였습니다. AI에게 신입 직원에게 설명하듯 자세하고 친절하게 지시하기 시작했습니다. 이것이 AI로만 개발을 진행하면서 얻은 첫 번째 요령이었습니다.
참고로, 신입에게 일을 시킨다고 생각하면 아래와 같은 항목이 자연스럽게 채워질 수 있습니다. 다음은 원문 경험 자체가 아니라, 그 요령을 바탕으로 지시문을 구조화할 때 넣어볼 만한 일반 예시입니다.

• 배경: 무엇을 위해 만드는지, 어디에 쓰이는지
• 목표: 완성했을 때 어떤 모습이어야 하는지
• 제약: 사용할 언어·라이브러리, 하지 말아야 할 것(일반 권장 항목)
• 예시: 입력과 기대하는 출력의 구체적인 예(일반 권장 항목)

---

실전 체크리스트

아래 항목들은 원문에 기록된 체크리스트가 아니라, '신입에게 설명하듯 자세히 지시했다'는 요령에서 확장해 덧붙인 일반적 점검 예시입니다.

• (일반 점검) 이 작업의 목적과 배경을 한 문장이라도 적었는가?
• (일반 점검) 기대하는 결과의 형태를 최대한 구체적으로 적었는가?
• (일반 점검) 내 머릿속에만 있는 전제를 글로 꺼내 두었는가?
• (일반 점검) 신입에게 설명하듯 친절하게 풀어 썼는가?

아래도 원문 경험에는 없지만, 일반적으로 함께 권장되는 추가 항목입니다.

• (일반 권고) 사용할 기술과 금지 사항을 지정했는가?
• (일반 권고) 결과를 직접 실행해 확인할 계획이 있는가?
• (일반 권고) 작은 테스트로 결과를 검증할 수 있는가?

---

적용 예시: 짧은 지시 vs 자세한 지시

짧은 지시(권장하지 않음)
"로그인 기능 만들어줘"
자세한 지시(권장)
"사용자 이메일과 비밀번호로 로그인하는 기능이 필요합니다. 목적은 회원 전용 페이지 접근 제어입니다. 입력은 이메일·비밀번호, 성공 시 세션을 생성하고 실패 시 오류 메시지를 반환합니다. 비밀번호가 틀렸을 때와 계정이 없을 때의 메시지를 구분해 주세요. 사용하는 프레임워크는 (프로젝트에 맞게 지정)이며, 우선 로직만 작성하고 화면은 다음 단계로 미룹니다."
두 지시의 차이는 '내 머릿속 전제를 얼마나 글로 꺼냈는가'입니다. 위 예시는 원문 경험이 아니라 방식을 설명하기 위한 일반 예시입니다.

---

한계와 주의사항

이 글의 핵심 경험은 '짧게 지시했더니 의도와 다른 결과가 많아, 신입에게 설명하듯 자세히 지시하는 방식으로 바꿨고 이를 첫 번째 요령으로 삼았다'는 것입니다. 다음 사항을 함께 기억하세요.

• 원문은 방식을 바꾼 계기와 요령까지를 기록한 것이며, 방식을 바꾼 뒤의 구체적 효과나 개선 결과를 단정하지는 않습니다.
• 자세한 지시가 모든 상황에서 동일한 효과를 보장하지는 않습니다.
• 이 글에 포함된 언어·라이브러리 지정, 테스트, 실행 확인, 각 체크리스트 항목 등은 원문 경험이 아니라 일반적인 권고이므로, 각자 상황에 맞게 판단하세요.

이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다.