프롬프트를 잘 쓰는 법보다 맥락을 덜어내는 법

템플릿보다 덜어낸 맥락과 성공 기준이 결과를 바꾼 국내 기록

더블테이크 노아 - 4분 분량 - 처음 쓴 날

DOUBLETAKE직무별 AI 활용법

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][2]
  • 단계별 절차를 길게 적는다

    바꿀 방식
    끝났을 때 어떤 상태여야 하는지 적는다
    근거
    [1]
  • 규칙을 맨 앞에 한 번 적는다

    바꿀 방식
    결과를 받기 직전에 규칙을 다시 대조한다
    근거
    [3]
  • 바로 결과물을 달라고 한다

    바꿀 방식
    계획을 먼저 받고 승인한 뒤 시킨다
    근거
    [4]

예를 들어 주간 리포트를 맡긴다면 지난주 원본 표 전체 대신 이번 주에 볼 지표만 넘기고, "세 문단, 숫자는 표에 있는 값만" 처럼 끝난 모습을 먼저 적는다.

같은 일을 어떻게 시킬지 고르는 감각, 4분 테스트의 지시 문항으로 확인해 보자

4분 테스트 하기

자주 묻는 질문

프롬프트 템플릿은 쓸모없나?
출발점으로는 쓸 만하다. 다만 템플릿이 붙이라는 자료를 다 붙이면 위 기록에서 문제가 된 "관련 없는 맥락" 이 늘어난다. 템플릿을 쓰더라도 이번 일에 필요 없는 칸은 지운다.
긴 문서를 꼭 넘겨야 하면 어떻게 하나?
이재홍 님처럼 미리 가공한다. 필요한 부분만 뽑아 두거나 요약본을 따로 만들어 넘긴다. 원본을 통째로 넘기는 것은 마지막 수단이다.
프롬프트를 고쳐도 같은 실수가 반복되면?
말로 고치기를 멈출 때다. 반복되는 실수는 규칙을 검사하는 장치로 막는 팀이 많다. 이 이야기는 에이전트 활용 글에서 따로 다룬다.

출처

  1. 1AI가 내 프롬프트를 흘려듣는 이유: 원리부터 다시 본 컨텍스트 엔지니어링 우아한형제들 기술블로그, 2026.07.07
  2. 2하네스 엔지니어링(harness engineering)으로 팀 맞춤형 AI 환경 구축하기 우아한형제들 기술블로그, 2026.04.17
  3. 3AI가 팀 규칙을 지키도록 하는 방법 토스 기술블로그, 2026.09.08
  4. 4프롬프팅에서 워크플로로, AI로 프런트엔드 개발 생산성 끌어올리기 LY Tech Blog

이 글은 더블테이크 노아가 누구나 열어 볼 수 있는 공개 자료만 근거로 썼어요. 초안은 AI 도구로 쓰고, 사람이 출처와 맞춰 보며 고쳤어요. 틀린 내용은 hello@dropdown.xyz로 알려 주세요. 확인하고 고친 날을 글에 남겨요. 편집 원칙 보기