프롬프트를 잘 쓰는 법보다 맥락을 덜어내는 법
템플릿보다 덜어낸 맥락과 성공 기준이 결과를 바꾼 국내 기록
더블테이크 노아 - 4분 분량 - 처음 쓴 날
AI 업무 프롬프트 맥락부터 덜어낸다
업무용 프롬프트는 길게 쓴다고 좋아지지 않는다. 국내 실무자 기록에서 결과를 바꾼 것은 넘기는 자료를 덜어내고, 절차 대신 성공 기준을 주고, 꼭 지켜야 할 규칙을 AI가 방금 읽는 자리에 다시 두는 일이었다. 템플릿 모음을 모으기 전에 이 세 가지부터 익히는 편이 낫다.
왜 길게 쓸수록 AI가 흘려듣나?
우아한형제들 디자인시스템팀의 Android 개발자 김상국 님은 AI가 프롬프트를 흘려듣는 이유를 어텐션 구조로 풀었다. 요지는 이렇다. 관련 없는 맥락은 도움이 안 되는 정도가 아니라 해롭다. 그러니 덜어내야 한다. 그리고 어떻게 하라는 절차는 덜 지시하고 무엇이 되면 성공인지를 정의하라고 권했다[1].
"혹시 몰라서" 붙인 자료가 오히려 결과를 흐린다는 뜻이다. 프롬프트를 고치기 전에 무엇을 빼야 할지부터 본다.
덜어내면 얼마나 달라지나?
같은 회사 프론트엔드 개발자 이재홍 님 기록에 숫자가 있다. API 명세(Swagger)를 AI에 그대로 넘기지 않고 미리 가공해서 필요한 부분만 넘겼다. API 11개를 다룬 가장 큰 사례에서 넘긴 데이터는 41,944바이트에서 1,763바이트로 줄었고 AI가 도구를 부르는 횟수도 4회에서 1회로 줄었다. 프로젝트 환경 기준 평균 절감률은 96.5%였다. 그는 "AI가 일할 환경과 맥락을 잘 설계해 두고, 넘겨줄 데이터를 최적화하는 것" 이 생산성의 핵심이라고 적었다[2].
규칙은 어디에 둬야 지켜지나?
맨 앞에 한 번 적는 것으로는 부족하다. 토스뱅크 ML Engineer 김경윤 님은 코딩 에이전트가 팀 규칙을 놓치는 이유를 이렇게 적었다. "에이전트는 전반적인 코드 맥락을 보지 않습니다."[3] 고칠 부분만 보고 코드를 쓰다 보니 큰 틀의 규칙을 잘 지키지 못한다는 것이다. 그래서 Stylepack이라는 장치를 만들어 파일을 쓴 직후에 규칙을 최대 2개, 작업을 끝내기 전 변경 내역(git diff)에 규칙을 최대 4개 다시 넣는다[3].
시키기 전에 무엇을 먼저 받나?
LY 프런트엔드 팀은 AI에게 바로 코드를 고치게 하지 않는다. "아직 코드를 수정하지 마세요" 를 계획 모드로 강제하고, AI가 Jira, Figma, Slack 등에 흩어진 맥락을 먼저 모아 계획을 돌려주면 사람이 검토하고 승인한다. 이 팀은 "코딩 속도는 더 이상 가장 큰 병목이 아닙니다." 라고 했다[4].
내 업무에 옮기면 어떻게 되나?
근거는 대부분 개발 직군 기록이다. 원리는 직무와 상관없이 옮겨 쓸 수 있다고 본다. 이건 우리 판단이다.
관련 자료를 전부 붙여 넣는다
- 바꿀 방식
- 이번 일에 필요한 부분만 골라 넘긴다
단계별 절차를 길게 적는다
- 바꿀 방식
- 끝났을 때 어떤 상태여야 하는지 적는다
- 근거
- [1]
규칙을 맨 앞에 한 번 적는다
- 바꿀 방식
- 결과를 받기 직전에 규칙을 다시 대조한다
- 근거
- [3]
바로 결과물을 달라고 한다
- 바꿀 방식
- 계획을 먼저 받고 승인한 뒤 시킨다
- 근거
- [4]
| 하던 방식 | 바꿀 방식 | 근거 |
|---|---|---|
| 관련 자료를 전부 붙여 넣는다 | 이번 일에 필요한 부분만 골라 넘긴다 | [1][2] |
| 단계별 절차를 길게 적는다 | 끝났을 때 어떤 상태여야 하는지 적는다 | [1] |
| 규칙을 맨 앞에 한 번 적는다 | 결과를 받기 직전에 규칙을 다시 대조한다 | [3] |
| 바로 결과물을 달라고 한다 | 계획을 먼저 받고 승인한 뒤 시킨다 | [4] |
예를 들어 주간 리포트를 맡긴다면 지난주 원본 표 전체 대신 이번 주에 볼 지표만 넘기고, "세 문단, 숫자는 표에 있는 값만" 처럼 끝난 모습을 먼저 적는다.
같은 일을 어떻게 시킬지 고르는 감각, 4분 테스트의 지시 문항으로 확인해 보자
4분 테스트 하기자주 묻는 질문
- 프롬프트 템플릿은 쓸모없나?
- 출발점으로는 쓸 만하다. 다만 템플릿이 붙이라는 자료를 다 붙이면 위 기록에서 문제가 된 "관련 없는 맥락" 이 늘어난다. 템플릿을 쓰더라도 이번 일에 필요 없는 칸은 지운다.
- 긴 문서를 꼭 넘겨야 하면 어떻게 하나?
- 이재홍 님처럼 미리 가공한다. 필요한 부분만 뽑아 두거나 요약본을 따로 만들어 넘긴다. 원본을 통째로 넘기는 것은 마지막 수단이다.
- 프롬프트를 고쳐도 같은 실수가 반복되면?
- 말로 고치기를 멈출 때다. 반복되는 실수는 규칙을 검사하는 장치로 막는 팀이 많다. 이 이야기는 에이전트 활용 글에서 따로 다룬다.
출처
- 1AI가 내 프롬프트를 흘려듣는 이유: 원리부터 다시 본 컨텍스트 엔지니어링 우아한형제들 기술블로그, 2026.07.07
- 2하네스 엔지니어링(harness engineering)으로 팀 맞춤형 AI 환경 구축하기 우아한형제들 기술블로그, 2026.04.17
- 3AI가 팀 규칙을 지키도록 하는 방법 토스 기술블로그, 2026.09.08
- 4프롬프팅에서 워크플로로, AI로 프런트엔드 개발 생산성 끌어올리기 LY Tech Blog

