🧑🏻💻 Ep.07 | AI에게 잘 시키는 기술, 프롬프트가 전부가 아니다
슬랙에 이런 메시지가 올라옵니다.
"이 프롬프트 공유해줘. 나도 똑같이 해볼게."
공유받아서 그대로 사용합니다. 그런데 결과가 다릅니다. 같은 프롬프트인데 왜 다른 결과가 나올까요?
프롬프트는 같아도 시키는 맥락이 다르기 때문입니다.
1. 프롬프트가 결과를 바꾼다는 것은 맞다. 하지만..
프롬프트를 어떻게 쓰느냐에 따라 AI의 결과물이 달라지는 건 사실입니다. 같은 질문을 두루뭉술하게 하느냐 구체적으로 하느냐에 따라 답이 완전히 바뀌니까요. 하지만 프롬프트보다 더 큰 차이를 만드는 게 있습니다. 무엇을 시킬지 정의하는 것입니다.
"API 만들어줘"와 "기존 인증 체계를 유지하면서, 페이징 처리가 포함된 상품 목록 API를 만들어줘"는 같은 프롬프트가 아닙니다.
두 번째 문장이 더 긴 것이 아니라 문제를 더 잘 정의한 것입니다. 프롬프트 기법을 공부하는 것보다 문제를 정확히 파악하는 게 먼저입니다.
2. "좋은 프롬프트"보다 중요한 것
좋은 프롬프트에는 공통점이 있습니다. 프롬프트 자체가 아니라 그 앞 단계가 잘 되어 있다는 점입니다.
세 가지가 명확해야 합니다.
- 문제 정의: 정확히 무엇을 해결하려는가
- 제약 조건: 기존 시스템에서 바꾸면 안 되는 것은 무엇인가
- 완료 기준: 어떤 상태가 되면 끝인가
이 세 가지가 머릿속에서 정리되지 않은 채로 프롬프트를 쓰면 AI는 방향을 잡지 못합니다. 반대로 이 세 가지가 명확하면 프롬프트는 자연스럽게 구체적이 됩니다.
3. 실전에서 통하는 프롬프트 구성 방식
프롬프트를 구성할 때 네 가지 요소를 포함하면 결과가 안정됩니다.
예를 들어 "Spring Boot 프로젝트에서 기존 `ErrorCode` enum 체계를 따라 새 API의 예외 처리를 작성해줘. 기존 패턴은 이렇다." 이런 식입니다.
네 가지 요소를 매번 의식적으로 넣을 필요는 없습니다. 하지만 결과가 이상하게 나왔을 때 어떤 요소가 빠져 있었는지 돌아보면 원인을 빠르게 찾을 수 있습니다.
4. 범위 정의: AI에게 줄 수 있는 맥락의 단위
같은 작업이라도 어떤 단위로 시키느냐에 따라 결과 품질이 크게 달라집니다.
단위별 기대치가 다릅니다.
- 함수 단위: 가장 정확합니다. 입력과 출력이 명확하면 거의 틀리지 않습니다.
- 파일 단위: 꽤 괜찮습니다. 기존 파일의 패턴을 읽고 맞춰줍니다.
- 기능 단위: 여러 파일에 걸칩니다. 맥락을 충분히 줘야 합니다.
- 서비스 단위: 위험합니다. 전체 아키텍처를 이해해야 하는데 그게 어렵습니다.
앞선 글에서 이야기했듯이, 에이전트를 잘 쓰는 방법은 크게 시키는 것이 아니라 잘게 나누어 시키는 것에 가깝습니다. 프롬프트도 마찬가지입니다.
5. 실패 프롬프트에서 배우는 법
프롬프트가 실패하는 경우는 생각보다 많습니다. 의도와 다른 코드가 나오거나, 기존 패턴을 무시하거나, 엉뚱한 방향으로 가거나.
이때 보통 두 가지 반응이 나옵니다. 프롬프트를 다시 쓰거나, 직접 코드를 짜거나.
하지만 한 가지 더 할 수 있는 게 있습니다. 왜 실패했는지 기록하는 것입니다.
- 어떤 맥락이 빠져서 실패했는가
- 어떤 제약을 추가했더니 해결됐는가
- 어떤 단위로 쪼갰더니 성공했는가
이 기록이 쌓이면 팀의 자산이 됩니다. 다음에 비슷한 작업을 시킬 때 같은 실수를 반복하지 않게 됩니다.
6. 프롬프트를 팀 자산으로 관리하는 방식
좋은 프롬프트가 개인 노트에만 있으면 그 사람이 휴가를 가면 끝입니다.
프롬프트도 버전 관리가 가능한 형태로 남겨두세요.
앞선 글에서 `CLAUDE.md` 같은 규칙 파일을 이야기했습니다. 프롬프트 패턴도 같은 방식으로 관리할 수 있습니다.
이걸 팀 저장소에 넣어두면 새로운 팀원이 합류해도 바로 활용할 수 있습니다. 프롬프트를 잘 쓰는 능력이 개인 스킬이 아니라 팀의 인프라가 되는 겁니다.
7. 결국 좋은 지시는 좋은 사고에서 나온다
프롬프트 테크닉을 공부하는 것도 나쁘지 않습니다.
하지만 아무리 형식을 갖춰도 시킬 일이 정리되지 않으면 결과도 정리되지 않습니다.
문제를 정확히 파악하고, 제약을 명확히 하고, 완료 조건을 정의하는 것. 이건 AI 시대에 새로 생긴 능력이 아닙니다. 좋은 엔지니어가 원래 하던 일입니다.
좋은 지시를 내리려면 좋은 사고가 먼저입니다.
🌱 좋은 사고를 함께 훈련하는 곳, 루퍼스
좋은 지시를 내리려면 좋은 사고가 먼저입니다. 혼자 고민하기보다 함께 부딪히며 생각을 다듬는 환경이 성장을 만듭니다.
AI 시대에도 결국 중요한 건 생각하는 힘과 성장하는 환경이라고 믿습니다.
루퍼스에는 성장에 진심인 650+명의 크루가 함께하고 있습니다. 현업에서 부딪히는 고민과 경험을 나누며 함께 성장하는 크루들의 이야기. 전액 기부 강의 그리고 다양한 오프라인 네트워킹까지! 루퍼스는 개발자를 위한 지속 가능한 성장을 만들어 갑니다.
📢 LOOPERS의 소식이 궁금하다면?
Share article