프롬프트 템플릿 만들기: 변수 자리와 팀 공유
프롬프트 템플릿은 매번 같은 지시 부분을 고정해 두고 그때그때 달라지는 자료와 조건만 변수 칸으로 비워 둔 재사용 프롬프트입니다. 고정 부분과 변수 부분을 나누면 결과가 일정해지고 테스트와 공유가 쉬워지며, 원본은 한 곳에만 두고 나머지는 그곳을 참조합니다.
같은 말:프롬프트 템플릿프롬프트 재사용프롬프트 변수프롬프트 라이브러리팀 프롬프트 공유
목차
🤔 잘 됐던 프롬프트를 다시 못 찾을 때
지난주에 광고 리포트 요약이 딱 맞게 나왔던 프롬프트가 있는데 어느 대화였는지 못 찾습니다. 찾아도 그때 자료가 그대로 박혀 있어 이번 자료에 맞게 손으로 고쳐야 하고, 고치다가 조건 하나를 빠뜨립니다. 팀원에게 보내 줬더니 그 사람은 또 자기 식으로 고쳐 씁니다.
한 번 잘 된 프롬프트를 다음에도 같은 결과가 나오게 쓰려면 그 프롬프트에서 매번 같은 부분과 매번 다른 부분을 나눠야 합니다. 그 나눈 형태가 템플릿입니다.
🔑 프롬프트 템플릿의 정의
프롬프트 템플릿은 매번 같은 지시 부분을 고정해 두고 그때그때 달라지는 자료와 조건만 변수 칸으로 비워 둔 재사용 프롬프트입니다. 변수는 프로그램에서 값을 담는 이름표를 뜻하는 말인데, 여기서는 프롬프트 안의 빈칸입니다.
고정과 변수를 나누는 이유는 앤트로픽과 OpenAI 문서에서 공통으로 나옵니다. 지시가 같으니 결과가 일정해지고, 자료만 바꿔 넣으면 되니 빠르며, 고정 부분만 고치면 되니 테스트가 쉽습니다. OpenAI 도움말이 예시마다 {text input here}라는 칸을 두고 실제 자료를 넣는 곳이라고 설명하는 것이 이 변수입니다.
✂️ 고정할 것과 비워 둘 것을 나누는 기준
빈칸이 있는 신청서 양식을 떠올리면 됩니다. 항목 이름과 주의 사항은 인쇄되어 있고 이름과 날짜만 손으로 적습니다. 프롬프트도 같은 질문으로 나눕니다. 다음 요청에서도 이 문장이 그대로 필요한지 봅니다. 필요하면 고정, 이번에만 다르면 변수입니다.
| 고정 부분 | 변수 부분 |
|---|---|
| 역할과 관점 | 이번에 넣을 자료 |
| 결과의 형식과 항목 순서 | 자료의 기간, 대상, 이름 |
| 하지 않는 일과 모를 때의 행동 | 이번에만 추가할 조건 |
| 금지 표현 목록 | 결과를 받을 사람 |
| 예시 | 분량 상한처럼 자주 바뀌는 숫자 |
예시가 고정 부분에 들어가는 점을 눈여겨볼 만합니다. 퓨샷 예시는 형식을 가르치는 장치라 매번 같아야 하고, 그래서 변수 쪽에 두지 않습니다. 반대로 분량 상한은 고정으로 두기 쉬운데 실제로는 자주 바뀌므로 변수로 빼 두는 편이 낫습니다.
🧩 변수를 표기하는 방법
변수 표기는 한 가지로 통일합니다. 앤트로픽 문서의 예시는 {{ANNUAL_REPORT}}처럼 이중 중괄호에 대문자를 쓰고, OpenAI 도움말은 {text}처럼 중괄호 하나를 씁니다. 어느 쪽이든 되지만 본문에 나올 법한 기호는 피하고, 눈에 잘 띄어야 채우지 않은 변수를 놓치지 않습니다.
자료가 들어가는 변수는 태그로 감싸 프롬프트 위에 둡니다. 앤트로픽 문서가 긴 자료를 맨 위에 두라고 권하는 이유 그대로입니다.
템플릿 이름: 주간 광고 리포트 요약
용도: 매주 월요일 광고 플랫폼 CSV를 팀 공유용 세 줄 요약으로
버전: v3 (2026-09-28). 입력 20건 기준 형식 일치 100%, 수치 오류 0건
변수: {{CSV}}, {{기간}}, {{받는_사람}}, {{글자_상한}}
<자료>
{{CSV}}
</자료>
위 자료는 {{기간}}의 광고 성과 CSV이고 열은 캠페인, 노출, 클릭, 비용, 전환 순서입니다.
광고 성과를 정리하는 분석 담당으로서 {{받는_사람}}에게 공유할 요약을 만들어 주세요.
항상 지키는 형식
- 표를 먼저 내고 열 순서는 캠페인 | 클릭 | CTR(%) | 전주 대비입니다.
- 표 아래 해석은 세 줄까지, 전체 {{글자_상한}}자 이내입니다.
- 비율은 소수점 첫째 자리까지 적습니다.
하지 않는 일
- CSV에 없는 기간을 채워 넣지 않습니다.
- 클릭 100회 미만 캠페인에는 전환율 해석을 붙이지 않고 "표본 부족"이라고 적습니다.
모를 때 하는 행동
- 열 이름이 다르면 임의로 맞추지 말고 무엇이 다른지 먼저 물어봅니다.머리에 적은 네 줄이 템플릿을 오래 쓰게 만듭니다. 이름과 용도가 있어야 나중에 찾고, 버전과 마지막으로 잰 결과가 있어야 고친 뒤 나빠졌는지 알 수 있습니다. 잰 결과를 적는 방법은 프롬프트 테스트와 개선 절차의 비교표와 같습니다.
🗂️ 템플릿을 두는 곳 세 가지
템플릿을 어디에 두느냐에 따라 채우는 방식이 달라집니다.
- 문서 한 장: 노션이나 마크다운 파일에 템플릿을 모아 두고 복사해 변수를 채웁니다. 시작하기 가장 쉽고, 어떤 서비스에서든 씁니다. 여러 개가 쌓이면 이름과 용도로 목록을 만듭니다
- 클로드 프로젝트 지침: 고정 부분을 프로젝트 지침에 올려 두면 그 프로젝트의 모든 대화에 자동으로 걸리고, 대화창에는 변수만 적으면 됩니다. 2026년 9월 28일 앤트로픽 도움말 기준으로 무료 계정도 프로젝트를 다섯 개까지 만듭니다. 무엇을 지침에 두는지는 시스템 프롬프트와 사용자 프롬프트 차이에 있습니다
- 스킬: 절차가 여러 단계이고 특정 작업에서만 쓴다면 클로드 스킬로 만듭니다. 매번 걸리는 지침과 달리 부를 때만 읽히므로 긴 절차를 넣어도 평소 대화를 무겁게 하지 않습니다
세 곳의 차이는 적용 범위입니다. 문서는 사람이 복사할 때만, 프로젝트 지침은 그 프로젝트의 매 대화에, 스킬은 부르는 작업에만 적용됩니다. 매번 같은 형식이 필요하면 지침, 특정 작업의 절차라면 스킬, 여러 서비스에서 두루 쓰면 문서가 맞습니다.
👥 팀에 공유할 때 원본을 한 곳에 두기
템플릿을 팀에 보내는 가장 쉬운 방법은 복사해서 나눠 주는 것인데, 이 방법이 몇 주 뒤 가장 큰 문제를 만듭니다. 복사본은 원본을 고쳐도 따라 바뀌지 않아서 사본 수만큼 고칠 곳이 생기고, 한 번만 빠뜨려도 서로 다른 버전이 생깁니다.
같은 문제를 다루는 원칙이 SSOT(Single Source of Truth), 즉 단일 진실 공급원입니다. 하나의 정보를 한곳에서만 고치고 나머지는 전부 그곳을 참조하게 하는 원칙이고, 핵심은 원본을 정하는 것이 아니라 고치는 곳을 하나로 줄이는 것입니다. 이 원칙이 지표 정의서와 규칙 파일에 어떻게 적용되는지는 SSOT 뜻과 AI 시대에 필요한 이유에 있습니다.
템플릿에 적용하면 순서는 네 가지입니다.
- 원본 한 곳을 정합니다. 노션 페이지 하나나 프로젝트 지침 하나입니다. 고정된 주소가 있어야 다른 곳에서 가리킬 수 있습니다.
- 나머지 곳에는 복사 대신 참조를 둡니다. 메신저에는 템플릿 본문 대신 원본 링크를 보냅니다. 노션이면 동기화 블록을 씁니다.
- 고치는 사람과 고친 날짜를 원본 안에 적습니다. 앞의 양식에서 버전 줄이 그 역할입니다.
- 공유 권한을 좁힙니다. 앤트로픽 도움말 기준으로 프로젝트 공유는 Team과 Enterprise 플랜에서 열리고 보기 권한과 편집 권한이 나뉘는데, 편집 권한을 받은 사람이 지침 한 줄을 고치면 그 프로젝트의 모든 대화에 적용되므로 편집은 관리하는 사람에게만 둡니다.
같은 규칙이 클로드 코드의 CLAUDE.md에도 적용됩니다. 공식 문서는 규칙 두 개가 어긋나면 어느 하나를 임의로 고를 수 있다고 밝히고, 다른 도구의 규칙 파일이 있으면 내용을 복사하지 말고 가져오기 한 줄로 참조하라고 안내합니다.
⚠️ 자주 하는 실수
- 자료가 박힌 프롬프트를 그대로 저장합니다: 다음에 손으로 고치다 조건을 빠뜨립니다. 자료 칸을 변수로 비웁니다
- 변수 표기를 섞어 씁니다: 어떤 칸이 채워야 할 곳인지 놓칩니다. 한 가지 표기로 통일합니다
- 이름과 버전 없이 모아 둡니다: 어떤 것이 최신이고 잰 결과가 어땠는지 알 수 없습니다
- 복사본을 팀에 나눠 줍니다: 사본이 제각각 바뀌어 원본을 잃습니다. 링크나 지침으로 참조하게 합니다
- 한 번만 필요한 조건을 고정 부분에 넣습니다: 다음 요청에 그 조건이 따라붙습니다
❓ 자주 묻는 질문
템플릿은 몇 개나 만들어야 하나요?
같은 요청을 두 번 이상 한 작업부터 만듭니다. 같은 말을 두 번 적었다는 것이 템플릿이 필요하다는 신호입니다. 처음부터 목록을 채우려 하기보다 반복이 확인된 것만 하나씩 늘리는 편이 관리하기 쉽습니다.
변수 표기는 무엇을 쓰는 것이 좋나요?
이중 중괄호가 무난합니다. 앤트로픽 문서의 예시가 그 표기이고 본문에 나올 일이 거의 없어 눈에 잘 띕니다. 어느 표기든 한 템플릿 안에서 한 가지로 통일하고, 채우지 않은 변수가 남았는지 보내기 전에 표기를 검색해 확인합니다.
프로젝트 지침에 넣으면 템플릿이 필요 없나요?
고정 부분이 지침으로 옮겨가는 것이라 템플릿의 절반이 지침이 되는 셈입니다. 대화창에는 변수만 적으면 되니 편해지지만, 이번에만 바뀌는 값을 지침에 넣으면 다음 대화에 따라붙습니다. 지침에는 매번 같은 조건만 두고 변수는 대화창에 적는 구분은 그대로 지킵니다.
다른 AI 서비스에서도 같은 템플릿을 쓸 수 있나요?
고정 부분의 문장은 대부분 그대로 씁니다. 다만 태그 표기와 서식 지시가 서비스마다 조금씩 다르게 읽히므로, 옮긴 뒤에는 같은 입력 묶음으로 다시 재 봅니다. 여러 서비스에서 쓰는 템플릿이라면 지침이나 스킬보다 문서 한 장에 원본을 두는 편이 맞습니다.
📋 3줄 요약
-
프롬프트 템플릿은 매번 같은 지시 부분을 고정해 두고 그때그때 달라지는 자료와 조건만 변수 칸으로 비워 둔 재사용 프롬프트이고, 다음 요청에서도 그대로 필요한 문장은 고정 부분에 이번에만 바뀌는 값은 변수에 둡니다.
-
변수는 이중 중괄호나 대괄호처럼 눈에 띄는 한 가지 표기로 통일하고 자료 변수는 태그로 감싸 프롬프트 위에 두며, 템플릿마다 이름과 용도와 버전과 마지막으로 잰 결과를 머리에 적어 둡니다.
-
팀에 공유할 때는 2026년 9월 28일 기준 무료 계정도 다섯 개까지 만드는 클로드 프로젝트의 지침이나 스킬에 고정 부분을 올리고, 복사본을 나눠 갖지 않고 원본 한 곳을 참조하게 해 고치는 곳을 하나로 줄입니다.
📚 참고 자료
- Prompting best practices: Structure prompts with XML tags, Claude Platform Docs
- Best practices for prompt engineering with the OpenAI API, OpenAI Help Center
- What are projects?, Claude Help Center
- How Claude remembers your project, Claude Code Docs
- SSOT 뜻과 AI 시대에 문서를 한곳에서만 고쳐야 하는 이유, 준이아빠블로그
- 클로드 프로젝트 지침 쓰는 법, 준이아빠블로그
2026년 9월 28일 기준으로 공식 문서를 확인했습니다.
제대로 이해했는지 한 문제로 확인해 볼까요?
답을 고르면 바로 풀이가 나와요.
팀원 넷이 같은 보고서 템플릿을 각자 복사해 쓰다가 한 사람이 형식 규칙을 고쳤습니다. 몇 주 뒤 어떤 일이 생기고, 무엇으로 막을 수 있을까요?
