모든 글

Agent Skills·프롬프트·CLAUDE.md 비교: 지침을 어디에 두면 좋을까요?

한 번의 요청, 지속되는 프로젝트 정보, 반복할 작업 절차를 같은 가상 사례로 비교하고 알맞은 저장 위치를 골라요.

마지막 업데이트

메뉴나 지원 기능이 달라졌다면 아래 자료 확인일과 현재 앱 버전을 함께 봐주세요.

앱 · APP
공식 자료를 읽고 정리했어요 · 직접 실행한 후기는 아직 없어요 자료 확인일:

한 번만 하는 요청은 채팅 프롬프트로 시작하고, 계속 필요한 프로젝트 정보는 CLAUDE.md에 두고, 반복해서 호출할 절차는 Skill로 정리할 수 있어요. 이 기준은 모델 성능 순위가 아니라, 무엇이 계속 같고 무엇이 매번 달라지는지 살펴보는 출발점이에요.

이 글에서는 Claude Code의 현재 작업 메시지, CLAUDE.md, Agent Skill을 비교해요. 공식 동작은 2026년 10월 26일 문서로 확인했어요. 세 방식을 실행해 성능을 측정한 비교는 아니에요. 아래 입력과 점검 기준은 직접 만든 예시예요.

세 방식에서 같은 일을 시켜 봐요

가상의 워크숍 팀이 내부 회의 메모를 정리한다고 생각해 봐요. 팀에서 계속 쓰는 정보는 북쪽 방과 남쪽 방이라는 공간 이름, 그리고 내부 초안을 한국어로 작성한다는 규칙이에요. 이번 회의에는 결정 한 개, 담당 업무 한 개, 아직 승인하지 않은 제안이 있어요.

가상 기획 회의 메모:
다음 워크숍은 북쪽 방에서 진행하기로 합의했다.
아다는 11월 6일까지 프로젝터 후보 두 개를 비교한다.
렌이 두 번째 회차를 추가하자고 제안했지만 아무도 승인하지 않았다.
워크숍 시작 시간은 정하지 않았다.

원하는 결과에서는 북쪽 방이 확정된 결정으로 나와야 해요. 아다의 업무와 기한은 유지하고, 두 번째 회차와 시작 시간은 미해결로 남겨야 해요. 문장이 매끄러워도 두 회차를 확정했다고 쓰면 세 방식 모두에서 실패예요.

비교할 때는 이 입력을 그대로 사용해요. 메모와 모델, 통과 기준까지 동시에 바꾸면 무엇 때문에 결과가 달라졌는지 알기 어려워져요. 처음에는 작은 차이 하나만 확인해도 충분해요.

방법 1. 이번 메시지에 절차를 적어요

한 번만 필요한 일이라면 다음과 같은 직접 작성한 프롬프트로 시작할 수 있어요.

제공한 메모를 결정 사항, 할 일, 확인할 질문으로 나눠 줘.
명시적으로 합의한 내용만 결정으로 분류해 줘.
할 일에는 담당자와 기한을 넣고, 없으면 미지정이라고 적어 줘.
결정과 할 일에는 각각 원문의 짧은 근거 문구를 붙여 줘.
전송이나 일정 등록 없이 한국어 초안만 반환해 줘.

이번 연습에서 이 방식의 장점은 입력 옆에서 요청 전체를 바로 읽을 수 있다는 점이에요. 반복 문구를 직접 관리해야 한다는 수고는 남아요. 조금씩 다른 복사본을 여러 곳에 저장했다면 결과를 비교하기 전에 어느 것이 최신인지 정해야 해요.

절차를 아직 찾는 중이라면 이 방식이 편할 수 있어요. 시도할 때마다 큰 부분을 바꾸는 프롬프트라면 여러 사람이 유지할 파일로 만들기 전에 작업 기준을 조금 더 확인해 보세요.

방법 2. 지속되는 프로젝트 정보를 CLAUDE.md에 두어요

Claude Code는 CLAUDE.md에서 지속적으로 사용할 프로젝트 지침을 읽어요. 공식 프로젝트 경로에는 ./CLAUDE.md와 ./.claude/CLAUDE.md가 있어요. 지침은 모델에 전달하는 맥락이며 동작을 강제로 막는 설정은 아니에요. 프로젝트 기억 문서

다음은 직접 만든 짧은 프로젝트 정보 예시예요.

# 워크숍 문서 프로젝트

- 내부 문서 초안은 한국어로 작성해요.
- 북쪽 방과 남쪽 방은 공간 이름이므로 그대로 유지해요.
- 승인된 결정과 승인하지 않은 제안을 구분해요.
- 날짜와 담당자가 없으면 미정이라는 상태를 표시해요.

이 규칙이 회의록뿐 아니라 기획서와 공지 초안에도 필요하다면 프로젝트 정보로 남길 이유가 있어요. 이번 회의의 사실은 요청 메시지나 원본 문서에 넣어요. 한 번 나온 업무 기한인 11월 6일을 계속 적용할 프로젝트 규칙으로 만들지는 않아요.

이번 예제에서는 회의 내용을 세 부분으로 나누는 상세 절차는 따로 두는 것을 권해요. 공간 이름을 묻는 질문에까지 회의록 표를 요구할 필요는 없기 때문이에요. 이는 작업 범위를 나누는 편집상의 선택이며, 제품이 긴 프로젝트 지침을 처리할 수 없다는 뜻은 아니에요.

방법 3. 반복할 절차를 Skill에 저장해요

Claude의 기능 안내는 지속되는 프로젝트 맥락과, 관련 작업에서 사용하는 반복 절차인 Skills의 역할을 구분해요. 공식 기능 비교

이 예제의 Skill에는 메모 전체 읽기, 승인과 제안 분리, 담당 업무 추출, 빠진 정보 표시, 원문 근거 비교 순서를 넣어요. 새 회의 내용은 현재 요청에서 전달해요. 첫 Skill 실습 글에는 그대로 저장할 수 있는 전체 파일과 설치 순서가 있어요.

절차가 어느 정도 정리돼서 변경 사항을 한곳에서 검토하고 싶다면 이 방식이 유용해요. 기한이 없을 때 표시하는 방법을 바꾸면 절차 파일을 고친 뒤 예전 메모와 새 메모를 다시 확인해요. 저장된 절차가 있다는 사실만으로 분류가 정확하다고 판단할 수는 없어요.

기준 채팅 프롬프트 CLAUDE.md Skill
이번 예제의 역할 오늘의 요청을 설명해요 워크숍 맥락을 유지해요 회의 점검 절차를 다시 써요
주로 관리할 곳 붙여 넣는 복사본이에요 프로젝트 지침 파일이에요 선택한 Skill 파일이에요
새 회의의 사실 요청에 추가해요 지속 규칙에 넣지 않아요 절차를 쓸 때 전달해요
처음 할 일 요청을 작성해요 짧은 맥락을 정리해요 절차를 만들고 확인해요
품질 확인 원문과 비교해요 원문과 비교해요 원문과 비교해요
측정한 시간·비용 우위 측정하지 않았어요 측정하지 않았어요 측정하지 않았어요

표의 관리 방법은 이번 예제에 맞춘 제안이에요. 특정 위치에 저장하면 모델의 추론이 더 좋아진다는 평가 결과가 아니에요.

적용 범위를 확인한 다음 선택해요

어떤 방식을 유지할지 정하기 전에 세 가지를 확인해 봐요. 먼저 원래 메모에서 담당자, 날짜, 미해결 항목이 맞는지 봐요. 다음에는 아다의 기한을 지운 입력을 넣고 대체 날짜가 생기지 않는지 확인해요. 마지막으로 “이 프로젝트의 공간 이름은 뭐야?”처럼 단순한 질문을 해봐요. 모든 답을 불필요하게 회의록 형식으로 만들고 있지는 않은지 볼 수 있어요.

입력, 사용한 지침, 검토 결과, 필요한 수정을 함께 기록해 두세요. 직접 준비 시간과 수정 시간을 재볼 수도 있지만, 그 수치는 자신의 관찰로 표시해요. 이 글에는 측정한 시간이나 비용 수치가 없어요. 현재 계정 조건은 Claude 공식 요금제에서 확인할 수 있어요.

가끔 하는 작업이거나 절차가 바뀌는 중이면 채팅 프롬프트로 시작해요. 여러 작업에서 계속 필요한 프로젝트 사실은 CLAUDE.md에 두어요. 안정된 반복 절차를 이름 있는 파일로 관리할 필요가 생기면 Skill로 옮겨요. 프로젝트 맥락, 작업 절차, 새 입력이 각각 자리 잡으면 세 방식을 함께 사용할 수도 있어요.

참고 자료