클로드 코드에 '너는 전문가다' 대신 도구를 줘야 하는 이유 (요즘 쓰는 프롬프트 패턴)
핵심 요약
- 에이전트도 도구로 일한다. 클로드 코드는 명령을 처리할 때 Bash, 일정을 걸 때 Cron, 검색할 때 WebSearch, 내려받을 때 WebFetch 를 쓴다. Bash 도구 안에는 명령을 다룰 때 지킬 규칙까지 들어 있다.
- LLM 이 똑똑해도 도구를 주는 건 정확도 때문이다. 도구 없이도 될 때가 있지만 안 될 때도 생긴다. 실패할 확률을 줄이려고 도구를 미리 만들어 건넨다.
- 하네스 밖에도 도구가 필요하다. 디자인이라면 피그마, 펜슬, 스티치. LLM 이 못 만들어서 쓰는 게 아니라, 이미 검증된 작업 방식을 따라가야 가장 빠르고 안정적이라서 쓴다.
- "너는 전문가다"는 마인드셋과 용어를 맞추는 정도다. 진짜 전문성은 도구에서 나온다. 실력 있는 디자이너도 피그마를 뺏기고 원시적인 도구만 남으면 능력을 다 꺼내지 못한다.
- 그래서 프롬프트에 도구를 먼저 묻는다. 이 분야 전문가가 쓰는 도구를 찾고, 유료면 무료 대안을, 맞는 게 없으면 직접 만들 수 있는지 검토하게 한다.
- 도구를 제대로 고르고 있는지는 모델에게 검증받는다. 적합한 도구를 쓰고 있는지, 없으면 만들어서라도 쓰고 있는지를 Fable 이나 Opus 에게 따져 보게 한다.
| 방식 | 에이전트에게 주는 것 | 결과 |
|---|---|---|
| 페르소나 | "너는 전문 디자이너다" 한 줄 | 말투와 용어가 그 분야처럼 바뀐다 |
| 도구 | 그 분야 전문가가 실제로 쓰는 도구, 없으면 직접 만든 도구 | 검증된 작업 방식을 따라 정확하고 빠르게 일한다 |
역할을 주지 말라는 이야기는 아니다. 역할만으로는 모자라다는 이야기다. 일을 잘하게 만드는 건 역할이 아니라 그 일에 맞는 도구다.
바로 쓸 프롬프트만 필요하면 복사해 쓰는 프롬프트로, 이야기 흐름이 궁금하면 영상 줄거리로.
복사해 쓰는 프롬프트
1. 작업을 시작할 때 넣는 패턴
영상에서 말한 패턴을 프롬프트 한 덩어리로 정리했다. 실제로 친 원문이 아니라 영상 내용을 요약한 것이다. <작업> 자리만 바꿔 쓰면 된다.
<작업>을 시작하기 전에, 이 분야의 전문가들이 실제로 어떤 도구를 쓰는지 먼저 찾아봐.
그 도구가 유료라면 대신 쓸 수 있는 무료 도구를 찾아 줘.
적합한 도구가 없다면 직접 만들 수 있는지도 같이 검토해 줘.
직접 만든다면 기존에 잘 만들어진 도구를 레퍼런스로 삼아서 핵심 기능만 가져와.
2. 정리 데스크 화면을 만들 때 (2026-10-23)
할 일과 일정을 정리하는 전용 화면을 만들 때 넣은 프롬프트다. 영상 화면에는 실제로 친 말을 다듬어 띄웠고, 그 문장을 그대로 옮겼다.
이 분야의 전문가들이 실제로 어떤 도구를 쓰는지 참고해서, 그 핵심 기능과 유사하게 작업 및 일정 정리만을 위한 전용 워크스페이스 페이지를 만들면 좋겠어.
3. 디자인 시트 도구를 고를 때 (2026-10-22)
피그마를 쓰지 않기로 하고, 에이전트와 같이 쓸 디자인 도구를 고를 때 넣은 프롬프트다. 이것도 영상 화면에 띄운 문장이다.
그래서 도구를 선택해야 될 것 같은데: 페이지라는 도구도 있었던 것 같고, 일단 피그마는 이제 사용하지 않을 것 같고, 에이전트랑 같이 돌리기 좋은 도구를 하나 찾거나, 직접 만드는 게 낫다면 직접 만들어도 되고. 한번 그 부분 체크해 줘.
4. 도구 선택 점검
작업이 끝나 갈 때 모델에게 따져 보게 하는 두 가지다. 영상 속 체크리스트를 그대로 옮겼다.
- 이 작업에 적합한 도구를 쓰고 있나
- 없으면 만들어서라도 쓰고 있나
영상 줄거리, 짧게
못에는 망치, 명령에는 Bash
못을 박을 때는 망치, 스크류에는 드라이버, 종이를 자를 때는 가위를 쓴다. 가위가 없으면 손으로 찢어야 한다. 일에는 마땅한 도구가 있을 때도 있고, 아예 없을 때도 있다.
에이전트도 똑같다. 클로드 코드는 명령을 처리할 때 Bash 도구를 쓰고, 그 안에는 명령을 다룰 때 지켜야 할 규칙이 들어 있다. 일정은 Cron, 검색은 WebSearch, 리소스를 내려받을 때는 WebFetch 다. 필요할 때 꺼내 쓸 수 있게 미리 정의돼 있다.
똑똑한데 왜 도구를 쥐여 줄까
요즘 LLM 은 충분히 똑똑하다. 그래도 도구를 주는 건 일을 정확하게 하기 위해서다. 도구 없이 처리하면 잘 될 때도 있지만 안 될 때도 생긴다. 실패할 확률을 줄이고 더 효율적으로 일하라고 도구를 건넨다.
클로드 코드처럼 모델을 감싸서 도구를 실행해 주는 환경을 하네스라고 부른다. 기본 도구는 하네스 안에 다 갖춰져 있다. 문제는 일을 하다 보면 하네스 안에 없는 도구가 필요해진다는 점이다.
하네스 밖의 도구
디자인 작업이라면 피그마, 펜슬, 스티치 같은 도구를 쓸 수 있다. LLM 이 그 도구를 못 만들어서 쓰는 게 아니다. 일에는 이미 어느 정도 정해진 작업 방식이 있고, 그 방식을 따라가려면 검증된 도구를 쓰는 편이 가장 빠르고 안정적이다.
맞는 도구가 아예 없을 수도 있고, 비쌀 수도 있다. 필요한 기능이 모자라거나 안 쓰는 기능이 너무 많아 직접 손봐야 할 때도 있다. 그래도 도구가 필요하다는 사실은 변하지 않는다.
"너는 전문 디자이너다"
예전에는 프롬프트에 페르소나를 넣으려고 했다. 에이전트에게 특정 전문가의 역할을 주는 방식이다. "너는 전문 디자이너다, 디자이너처럼 행동하고 디자이너처럼 진행해라." 역할을 주면 그 분야 사람처럼 일을 잘할 거라고 생각했다.
지금은 역할 부여가 그 분야의 마인드셋과 용어를 맞춰 주는 수준이라고 본다. 에이전트가 진짜 전문성을 발휘하게 하려면 결국 도구를 줘야 한다.
피그마를 뺏긴 디자이너
실력 있는 디자이너를 한 명 뽑았다고 해 보자. 디자인 감각도 뛰어나고 아는 것도 많다. 그런데 회사가 피그마도 안 주고, 펜슬 같은 무료 도구도 막는다. 돌도끼 같은 원시적인 도구만 남기고 다 뺏는다.
천재라면 어떻게든 해낼 수는 있다. 하지만 갈수록 효율이 떨어지고 실수가 늘어서 자기 능력을 100% 꺼내지 못한다.
그래서 지금 묻는 것
그래서 요즘은 이 작업에 맞는 도구를 쓰고 있는지를 가장 먼저 본다. 맞는 도구가 없으면 직접 만들어서라도 쓰고 있는지 따져 보고, 이 점검을 Fable 이나 Opus 에게 맡긴다.
도구를 새로 만들 때는 잘 만들어진 기존 도구를 레퍼런스로 삼게 하는지도 계속 보게 됐다. 요즘은 내 워크플로에 맞는 데스크톱 앱을 직접 만들어 쓰고 있어서, 도구 이야기를 에이전트에게 할 일이 특히 많다.
기록
영상 챕터다.
| 시각 | 내용 |
|---|---|
| 0:00 | Intro, 도구란 |
| 0:34 | 클로드 코드의 도구 |
| 1:13 | LLM 은 왜 도구를 쓰나 |
| 1:42 | 하네스 밖의 도구 |
| 2:42 | 요즘 쓰는 프롬프트 패턴 |
| 3:42 | 페르소나 대신 도구 |
| 4:28 | 도구 없는 디자이너 |
| 5:07 | Fable, Opus 에게 검증 |
| 5:27 | 마무리, 내 데스크톱 앱 |
글은 영상 대본에서 옮겼고, 그림은 영상에 들어간 손그림 모션그래픽에서 뽑았다. 모션그래픽은 Claude Code 로 Remotion 코드를 짜서 만들었다.
영상에 나온 도구: Claude Code 도구 목록, Figma, Pencil, Stitch
같이 보면 좋은 글: Claude Code 작업 환경을 네 번 바꾼 이유 (직접 만든 데스크톱 앱 Muster), 하네스 with 클로드 코드
하네스 엔지니어링을 다룬 책: 요즘 바이브 코딩 하네스 with 클로드 코드 (골든래빗), 예스24, 교보문고
댓글
아직 댓글이 없습니다. 첫 댓글을 남겨보세요!