# [불참 방지 기술] 클로드 코드의 기술을, 사전을 통해 훅과 매번 비교한 이야기

> https://bookfactory.kr/c/ai-tech/12365
> 게시판: AI·머신러닝
> 작성자: admin
> 작성일: 2026-09-15T00:16:44.297Z

---

![見出し画像](https://assets.st-note.com/production/uploads/images/309892937/rectangle_large_type_2_73de4272d287090261cfa64efffc99fe.png?width=1280)

클로이드 코드 기술을 만들었지만 한 번도 사용되지 않았다.

이거, 경험 없으신가요?

저희가 있습니다. 그것도 1권이나 2권이 아니라, 직접 만든 사람이 존재 자체를 잊어버리는 지경까지 갔습니다.

이 글에서 답하는 질문은 하나입니다. 작성한 기술을 AI에 확실하게 공개하는 방법은 무엇입니까? 현재 저희가 진행 중인 방식을 그대로 공개합니다.

## 클로이드 코드(Claude Code) 기술은 제공만으로는 작동하지 않습니다.

먼저 기본 사항을 정리한다.

기술이란 것은, 본질적으로 “이런 종류의 일일 때는 이렇게 진행해 주세요”라는 지침입니다. 파일로 보관해 두면, AI가 필요한 때에 이를 확인할 수 있습니다.

이해론 그렇게 해야 하는 것처럼 보이지만, 실제로 실행하면 막힙니다. 필요한 게 언제인지, 그 타이밍을 알 수 없기 때문입니다.

저희는 30명의 AI 직원들을 운영하고 있으며, 각자마다 절차가 있습니다. 숫자가 늘어나면 어떤 일이 발생하는가.

제가 잊어버릴 거예요.

저기, 이 작업에 특별한 절차가 있었는지 확인하며 마치 아무런 절차 없이 진행하는 것처럼 일을 진행했다. 그리고 나서 뒤늦게 발견하게 된다. 가장 좋은 절차 설명서가 가장 많이 사용되지 않는 상태였다.

## 처음 시도했던 것은 “부팅 시 읽는 한 페이지에 메모를 추가하는” 시도가 실패했습니다.

첫 번째 대응책은 간단했습니다.

매번 가장 먼저 읽는 파일을 하나 골라 그 안에 “이런 경우에는 이것을 읽어라”라고 적어 나갔다.

이렇게 하면 처음에는 잘 됩니다. 3개 정도까지는요.

하지만 계속 내용을 추가할수록 파일 크기가 커지고, 뒤에 있는 내용이 적용되지 않게 되어 오히려 보호받지 못하게 된다는 다소 잔인한 곡선을 그렸습니다.

저, 그런 일이 있나요? 라고 생각하시는 분들이 계실 수도 있습니다. 저도 그랬습니다. 하지만 실제로, 중간부터 분명히 무리통과는 늘어난 것을 느꼈습니다.

지금 돌이켜보면 원인은 명확합니다. 모든 내용을 똑같이 읽어주려고 했던 탓이죠. 100행 중 오늘 관련 있는 건 2행인데도, 매번 100행을 전달하고 있었으니까요. 관련 없는 98행이 중요한 2행을 방해하고 있었습니다.

![画像](https://assets.st-note.com/img/1788427841-W0N5HloBdV9k3PmsbnEOzrDf.png?width=1200)

## 현재 움직이는 것은 126권의 사전과 1개의 후크입니다.

그러려면 형태를 바꾸었습니다. 방법은 다음과 같습니다. 그것은,

트리거어-정본 경로 대응표를 기계 판독 가능한 파일로 추출

입니다.

내용은 매우 단순하며, 각 항목별로 “어떤 단어가 오면”, “어떤 파일을 읽어야 하는지”에 대한 대응만 들어 있습니다. 2026년 9월 3일 현재 실측 결과, 126건이 등록되어 있었습니다.

그 위에, 프롬프트가 전송된 시점에 훅을 하나 설치했습니다. Claude Code 공식에서 제공하는 인터럽트 메커니즘으로, 제가 매번 입력할 때마다 실행되며, 사전을 활용하여 단어들을 비교하는 방식입니다.

해당하는 경우, 해당 절차서의 위치를 대화에 삽입한다. 해당하지 않는다면 아무것도 하지 않는다.

공략하는 것은 내용이 아닌 장소만을 의미한다는 점도 의도적인 것이다. 전체 내용을 매번 쏟아부으면 결국 원래의 거대함으로 돌아가기 때문이다. 읽을지 안 읽을지는 그 자리의 세션이 결정하면 된다. 내용까지 밀어 넣으면 선택의 여지를 억지로 제한하는 것이기 때문이다.

이것으로 끝입니다. 작동 방식은 매우 간단하고, 부분 일치 검색만 수행합니다.

하지만, 그 효과는 덧붙임 방식과 완전히 달랐습니다. 오늘 관련 있는 분들께만 전달되기 때문입니다.

또 한 가지 좋았던 점은, 늘리는 것이 두려워なくなった 것입니다. 덧붙임 방식을 사용하면, 한 줄을 추가할 때마다 전체가 무거워집니다. 사전이라면, 닿지 않는 한 아무런 부담도 되지 않습니다.

## 이 형태에서 알아냈어, 세 가지 함정

정리하기 위해 3번 정도 밟았습니다. 같은 곳에서 넘어지는 사람이 나올 수 있으니 미리 적어둡니다.

첫째, 같은 사전을 두 군데에 가져가지 마십시오.

처음에는 기계가 읽는 파일 외에 사람이 읽는 목록도 있었습니다. 양쪽 모두 동일한 내용이 작성되어 있었습니다.

결과는 상상했던 대로일 겁니다. 한쪽만 수리했고, 수리하지 않은 쪽을 보면서 작업했던 회수가 있어서 이는 실질적인 피해를 입었습니다. 현재는 기계가 읽는 파일을 정본으로 만들고, 사람이 읽는 표는 그로부터 자동 생성하고 있습니다.

두 번째로, 훅을 먼저 확인하기 전에 스스로 일치하는 것이 옳다.

후크는 최후의 방어선이며, 첫 번째 방어선이 아닙니다. “말이 안 되면 읽는다”는 식으로 돌아다니면, 사전에 싣지 않은 요청이 들어왔을 때 그냥 지나치게 됩니다.

훅이 지적하면, 그것은 한 번 지는 것으로 간주하고 엄격하게 처리했습니다. 이 선을 지키지 않으면 사전을 의존하게 됩니다.

세 번째로, 절차서를 덮어쓰기 방식으로 수정하지 않는다.

가장 고통스러웠던 부분은 바로 이었습니다. 여러 세션을 병렬로 진행할 때, 오래된 내용을 읽은 채로 진행 중인 세션이 전체를 다시 쓰여지는 경우가 있습니다. 수 시간 분량의 업데이트가 삭제되었습니다.

현재는 절차서에 대한 기록 자체를 중단시키는 기능을 갖추고 있습니다. 부분적인 편집은 계속 진행하며, 전체적인 교체는 중단합니다. 또한, 수정 직전에 자동으로 백업을 수행하도록 설정했습니다.

![画像](https://assets.st-note.com/img/1788427845-bG3oisMBELqAxtuIOgvKhVP0.png?width=1200)

## 체중 증가를 막기 위한 상한선을 숫자로 설정했다.

또 한 가지 하고 있습니다.

실행 시 읽는 파일의 용량에 상한을 설정했습니다.

가장 먼저 읽는 1장은 8KB까지입니다. 접수 담당용 1장은 24KB까지입니다. 초과하면 기계가 알려줍니다.

왜 숫자로 결정했느냐하면 “가능한 한 간결하게”라는 원칙은 절대 지켜지지 않았기 때문입니다. 규칙을 수정하고 싶을 때는 반드시 “이것은 중요해서 예외”라고 생각하게 되거든요.

용량 제한이 있기 때문에, 더하기 연산에서 어떤 부분을 줄이거나, 사전을 활용하는 선택지 중 하나를 선택해야 합니다. 이 두 가지 선택지가 강요되는 점이 좋아서, 결과적으로 파일 크기가 줄어들었습니다.

이와 유사한 문제는 대부분의 팀 절차 문서에서도 발생합니다. 증가하는 방향에만 초점을 맞춘 문서들은 방치하면 결국 읽히지 않게 됩니다.

글쓰기 장소의 원칙은 하나로만 정해두고 있습니다. 규칙의 내용은 수정본 파일에 보관하며, 실행 시 읽는 페이지에는 해당 장소로 이동하는 한 줄만 작성합니다.

![画像](https://assets.st-note.com/img/1788427848-74fC5zqyWhp0IU381HonMucw.png?width=1200)

## 클루드 코드의 역량을 최대한 활용하기 위해 오늘 할 수 있는 일 중 하나

글이 길어진 만큼, 오늘 할 일을 하나로 압축하겠습니다.

최근 미사용 절차서를 선택하여 “어떤 용어가 나타났을 때 참조해야 하는지”를 3단어로 요약하십시오.

파일을 만드는 필요는 아직 없습니다. 3문장으로 시작하면 됩니다.

그렇게 쓸 수 없다면, 그 절차서는 발동 조건이 정해져 있지 않은 것일 뿐입니다. 우리 경우에는 불러지지 않은 것들이 대부분 그랬습니다. 내용 자체에 문제는 없었지만, 언제 열어야 할지 아무도 알 수 없었습니다.

능력을 키우는 것보다 먼저, 자신의 역할을 하나 정하는 것이 가장 효과적이었습니다. 오늘 있었던 이야기입니다.

클로이드 코드(Claude Code)를 업무의 무인 라인에 배치할 때의 설계와 저희가 놓친 함정 목록을 이 곳에 모아 놓았습니다.

Claude Code Studio의 6가지 특별 혜택을 누리세요.

1.  Claude Pro 모델 무료 이용
2.  Claude 3 Opus 모델 쿼리 1,000건 무료 제공
3.  Code Interpreter 무료 이용
4.  Claude Agent 무료 이용
5.  데이터 저장 공간 50GB 제공
6.  최신 기능 및 업데이트 우선 제공

#클로이드코드 #기술 #SKILLmd #훅 #자동 시작 #지침서 #지식 관리 #운영 설계 #AI 에이전트 #코딩 AI #개발 환경 #시스템화 #생성 AI #AI 직원

**출처:** [note 원문](https://note.com/claudecodestudio/n/n77cbfa492b35)

*번역: Gemma 3(.44) 초벌 + 교정 42청크*

[원문 보기](https://note.com/claudecodestudio/n/n77cbfa492b35) | 출처: note.com