최근에 Claude Code를 많이 사용하는 사람들과 이야기할 때마다 "레포지토리가 점점 지저분해지는 느낌이 드나요? 처리 속도가 좀 느려진 것 같나요?"라고 물어보곤 합니다. 거의 모든 사람들이 "네..."라고 대답하더군요.
- 어느새 스킬이 엄청나게 늘어나 있습니다.
- 6개월 전의 사실들이 context/ 폴더에 남아 있습니다.
- CLAUDE.md가 너무 비대해져서 제가 전체를 파악하기 어려울 지경입니다.
- 처리 속도가 왠지 엄청 느려졌습니다.
최근에 깨달은 것은, 이것이 "키우는 방법"의 문제가 아니라는 점입니다.
바로 "신진대사"의 문제입니다.
인간의 몸이 영양분만으로는 살아갈 수 없는 것과 같습니다. 대사하고, 배출하고, 처음부터 더러워지기 어려운 체질을 만들어야 합니다. 레포지토리도 완전히 똑같습니다.
이 글에서는 Claude Code를 "스스로 성장하는" 상태로 만드는 네 가지 메커니즘에 대해 설명하겠습니다. Claude Code를 꽤 사용하면서 관리 비용이 부담스러워지고 있다고 느끼는 분들에게 정말 와닿을 내용입니다.
■ 키우기만 해서는 한계가 있다
예전에 저는 "Claude Code는 육성 게임이다"라는 내용의 글을 많이 썼습니다.
https://x.com/0xfene/status/2042047157767926056?s=20
스킬을 만들고, context/에 사실을 축적하고, CLAUDE.md를 다듬는... 이 모든 것이 "추가"하는 작업이었습니다.
처음 몇 달 동안은 이것이 엄청나게 잘 먹혔습니다.
더 많이 할수록 Claude Code가 더 똑똑해지는 느낌이 들어서 정말 재미있었습니다.
하지만 약 6개월이 지나면 시각이 바뀝니다.
무엇이 있는지조차 모를 정도로 스킬이 너무 많아지고, context/의 사실들은 현실과 동떨어지기 시작합니다. CLAUDE.md조차 너무 비대해져서 Claude가 중요한 지침을 간과하기 시작합니다.
즉, "키울수록 막힌다"는 현상이 발생하는 것입니다.
그때 깨달았습니다.
그냥 집어넣기만 해서는 안 된다는 것을.
섭취, 대사, 배출, 그리고 "깨끗한 체질"이라는 네 가지 기둥을 순환시켜야 합니다. 그렇지 않으면 레포지토리는 죽습니다.
이 네 가지를 순서대로 소개하겠습니다.
■ ① 섭취: X 게시물을 즉시 가져올 수 있게 만들기
최신 Claude Code 노하우는 거의 모두 X에서 흘러나오고 있습니다.
- "이 프롬프트로 결과가 급상승했어요"
- "이 스킬 조합은 미쳤어요"
- "훅을 이렇게 쓸 줄은 몰랐네요"
매일 정말 좋은 인사이트가 흘러들어오고 있습니다.
하지만 문제는 대부분의 사람들이 그냥 흘려보낸다는 점입니다.
솔직히 말하면, 저도 마찬가지였습니다.
"나중에 해봐야지" 하면서 스크린샷을 찍어두고, 한 달 후에 카메라 롤을 보며 "이게 뭐였더라?" 하고 생각하곤 했습니다.
아니면 URL을 북마크해두고 다시는 열어보지 않았습니다.
죽은 X 게시물들이 제 휴대폰과 브라우저에 쌓여만 갔습니다.
그래서 X 게시물을 위한 "섭취 파이프라인"을 만들었습니다.
구체적으로, X 게시물 URL을 제공하면 Claude Code가 자동으로 다음 작업을 수행합니다:
- 주요 내용 요약
- 태그로 분류
- 기존 스킬에 반영할 수 있으면 추가 제안
- 새 스킬이 필요해 보이면 초안 작성
- 참고 정보일 경우 context/에 메모
이것을 거의 자동으로 해주는 메커니즘입니다.
이것만 추가했을 뿐인데, X를 볼 때 제 행동이 완전히 바뀌었습니다.
예전에는 스크린샷에 만족했지만, 이제는 X에서 관심 있는 게시물을 보면 바로 그 자리에서 Claude Code에 URL을 건네줍니다. 부드럽게 처리되고, 3분 후면 스킬이 업데이트됩니다.
"좋은 정보를 찾는 것"과 "그것을 내 Claude Code에 녹여내는 것"이 하나의 행동 세트가 됩니다.
이것은 엄청나게 큽니다.
정말 엄청나게 큽니다.
커뮤니티에서 흘러나오는 최신 노하우가 여러분의 레포지토리에 지속적으로 주입되기 때문입니다.
이것의 유무는 6개월 후에 엄청난 차이를 만듭니다...!!!
구체적으로, X에는 CLI가 있으므로 X Developer Console에서 Claude Code와 연결하면 됩니다.
자세한 방법은 Claude Code가 아마 알아서 구현해 줄 테니 생략하겠지만, 관심 있으시면 연락 주세요!
■ ② 대사: 인간의 피드백을 통해 스킬이 스스로 성장하다
이 부분을 가장 추천합니다.
Gotcha라는 메커니즘에 관한 것인데, 정말 미친 수준입니다.
그것은 각 스킬 정의 파일의 끝에 "과거 실수 모음" 섹션을 배치하는 것입니다.
예를 들어, 이렇게요:
1## Gotchas (과거 실수 모음)21. 과거 글의 숫자를 재사용하지 마세요32. DAIJOBU 주식회사는 접미사 표기법을 사용합니다. "DAIJOBU Corporation"은 틀렸습니다43. 과장된 숫자를 조심하세요
그게 다입니다.
그게 전부예요.
하지만 이것은 스킬을 "경험자"로 성장시키는 메커니즘으로서 엄청나게 강력합니다.
구체적으로, 흐름은 이렇게 작동합니다:
- 사용자가 피드백을 제공합니다 ("이 글은 과거 글과 숫자가 같아요")
- 그 피드백이 해당 스킬의 Gotchas에 추가됩니다
- 다음에 그 스킬이 호출되면 Gotchas가 자동으로 프롬프트에 포함됩니다
- Claude Code가 "아, 이건 예전에 내가 실수했던 거구나"라고 인식하고 회피합니다
즉, 한 번의 인간 피드백으로 그 스킬이 영구적으로 더 똑똑해집니다.
이것은 정말 충격적입니다.
예를 들어, 제 글 리뷰 스킬은 이제 "과거 글과 같은 숫자를 사용하지 마세요"와 "DAIJOBU 주식회사는 접미사 표기법입니다"를 완벽하게 기억합니다.
1on1 준비 스킬은 "QA 엔지니어의 커리어 경로 5가지를 나열하세요"를 기억합니다.
면접 스킬은 "묻기 전에 항상 읽으세요; 건너뛰면 신뢰를 잃습니다"를 기억합니다.
매번 이렇게 말하는 것이 아닙니다.
한 번 피드백을 주고 Gotchas에 추가했을 뿐입니다.
"키우는" 느낌보다는 "경험을 쌓게 하는" 느낌에 가깝습니다.
신입사원에게 피드백을 주는 것처럼, 스킬 자체가 꾸준히 똑똑해집니다.
이것 외에 또 다른 보완 메커니즘으로 제가 Dreams라고 부르는 것이 있습니다.
이것은 개별 스킬이 잡을 수 없는 레포지토리 전체의 교차 패턴을 주 단위로 추출하는 스킬입니다.
최근 작업 로그에서 반복되는 패턴을 찾아 자동으로 context/dreams.md에 기록합니다. "최근에 이 판단을 세 번 했네" 또는 "이 실수가 반복되고 있어" 같은 것들입니다.
요컨대, 오늘의 내가 어제의 나의 행동을 관찰하는 메커니즘입니다.
이것으로 미처 인지하지 못했던 행동 패턴이 언어화되어 지식으로 승격됩니다.
Gotcha와 Dreams가 순환하기 시작하면, 레포지토리는 "경험을 쌓고 스스로 똑똑해지는" 상태에 들어갑니다.
이것은 정말 효과가 있습니다...!!!
■ ③ 배출: Claude Code에게 정기적으로 "질문"하기
여기부터는 "출력" 측면입니다.
솔직히, 청소를 잘하는 사람은 많지 않죠?
저도 형편없었습니다.
"아마 더 이상 안 쓰겠지..."라고 생각하면서도, 버리는 결정을 내리기가 두려워서 계속 가지고 있었습니다.
어느새 스킬이 엄청나게 많아졌고, 그 중 절반은 사용되지 않고 있었습니다.
처음에는 "자동 청소 로봇" 같은 메커니즘으로 해결하려고 했지만, 잘 되지 않았습니다.
판단이 너무 어려웠고, 결국 사람이 확인해야 했습니다.
그래서 정책을 바꿨습니다.
메커니즘이 청소하게 하는 대신, 사람이 정기적으로 "질문"을 던지는 운영 방식으로 변경했습니다.
구체적으로, 한 달에 한 번씩 Claude Code에게 항상 이 세 가지를 묻습니다:
- 사용되지 않는 스킬이나 에이전트가 있나요? (지난 한 달간 호출되지 않은 것들을 나열해 주세요)
- 오래된 context가 남아 있나요? (6개월 이상 업데이트되지 않은 파일들을 나열해 주세요)
- Claude Code의 처리 속도를 높이고 싶은데, 무엇이 느리게 만드는 원인인가요?
그냥 묻기만 하면 됩니다.
특별한 메커니즘은 없습니다.
하지만 한 달에 한 번 이렇게 하기로 결정하는 것만으로도 레포지토리 청소가 순환하기 시작합니다.
"버릴지 말지"를 결정하는 대신 "현재 상황을 시각화"하기 때문입니다.
목록이 나오면 "아, 이건 더 이상 안 쓰네" 또는 "이 context는 현실과 다르네" 하고 한눈에 알 수 있습니다. 판단 자체는 5초면 끝납니다.
청소를 "자동화"에서 "질문의 정례화"로 바꾸세요.
마음이 한결 가벼워질 것입니다.
한 달에 한 번씩 일정에 넣어보세요.
정말 좋습니다!
■ ④ 처음부터 더러워지기 어려운 체질 만들기
이번에 전달하고 싶은 가장 중요한 내용일지도 모르겠습니다.
청소를 열심히 하는 것도 중요하지만, 처음부터 더러워지지 않는 구조를 만드는 것이 훨씬 비용 효율적입니다.
더러워지기 어려운 체질의 핵심은 두 가지입니다.
첫 번째는 SSoT (단일 진실 공급원)를 정의하는 것입니다.
SSoT는 "이 정보의 올바른 버전은 오직 여기에만 존재한다"는 장소를 하나로 결정하는 것을 의미합니다.
예를 들어, 최신 고객 상태를 생각해 보세요.
이것을 "Notion 고객 DB", "context/clients/", "Slack 메모", "여러분의 머릿속" 이렇게 네 군데에 흩어 놓으면 반드시 불일치가 발생합니다.
6개월 후에는 "어느 것이 맞는 거지?"라고 알 수 없게 되어 레포지토리가 늪으로 변합니다.
대신, "최신 고객 상태의 SSoT는 context/clients/{name}.md이다"라고 결정합니다.
거기에 쓰여 있는 것이 현실의 최신 상태이고, Notion은 기본적으로 그것의 복사본이며, Slack은 엄격하게 흐름(지나가는 정보)으로 취급합니다.
(실제로는 고객 정보를 기본적으로 Notion에 집중시키는 방식으로 운영하고 있습니다.)
처음에 이것을 확실히 정해두기만 해도 정보가 흩어지는 것을 막을 수 있습니다.
두 번째는 흐름 정보와 축적 정보를 분리하는 것입니다.
이것은 엄청나게 효과적입니다.
- 흐름 정보 = 회의록, 1on1 로그, 업무 회의 메모, 일일 보고서, 연구 결과 (시간순으로 추가되며, 썩지 않음)
- 축적 정보 = 현재 시점에서 올바른 사실, 상태 (덮어쓰여지며, 오래된 것은 해로움)
이 둘을 분리하지 않으면 흐름 정보가 점점 축적 쪽에 섞여 들어가고, 레포지토리는 늪이 됩니다.
제 레포지토리에서는 흐름 정보를 물리적으로 work/ 아래에, 축적 정보를 context/ 아래에 분리해 두었습니다.
"회의록을 읽고 새로운 사실만 축적으로 승격시킨다"는 규칙을 엄격히 지키는 것만으로 context/ 쪽은 영원히 깨끗하게 유지할 수 있습니다.
work/ 쪽은 시간순으로 쌓이겠지만, "지나가는 정보"이므로 오래되어도 해롭지 않습니다.
요컨대, 들어오는 곳과 쌓이는 곳을 물리적으로 분리하는 것입니다.
이렇게 하면 청소 자체가 엄청나게 가벼워집니다.
축적 쪽은 구조적으로 더러워지기 어렵고, 흐름 쪽은 오래되어도 해롭지 않습니다.
먼저 체질을 설계하면, 이후의 운영이 180도 달라집니다.
■ 키우기에서 스스로 성장하기로
지금까지 네 가지를 소개했습니다:
- ① 섭취: X 게시물 즉시 가져오기
- ② 대사: 인간의 피드백을 통해 스킬이 스스로 성장 (Gotcha + Dreams)
- ③ 배출: "질문"을 던져 정기적으로 청소
- ④ 더러워지기 어려운 체질: SSoT와 흐름/축적 분리
이 네 가지가 순환하기 시작하면 어떤 일이 일어날까요?
레포지토리는 "스스로 성장하는" 상태에 들어갑니다.
처음에 저는 Claude Code가 "육성 게임"이라고 생각했습니다.
스킬을 만들고, context를 작성하고, CLAUDE.md를 정리하고... 모든 것을 손수 다듬고 있었습니다.
하지만 이 네 가지를 설정하면, 어느 순간 시야가 바뀝니다.
레포지토리가 제가 손대지 않아도 스스로 똑똑해집니다.
X에서 새로운 인사이트가 계속 들어오고, 스킬은 경험을 쌓아 스스로 더 똑똑해집니다. 오래된 것은 정기적으로 정리되고, 처음부터 더러워지기 어렵기 때문에 유지 관리 자체가 엄청나게 가볍습니다.
이 루프가 순환하기 시작하면, Claude Code와의 관계가 진정으로 바뀝니다.
"도구를 연마하는" 느낌에서 "함께 성장하는" 느낌으로 바뀝니다.
"키우는 시대"에서 "성장하는 메커니즘을 설정하는 시대"로.
1년 후의 제 Claude Code는 오늘 제가 손수 키운 것보다 훨씬 더 똑똑할 것입니다.
그런 마음가짐으로, 저는 오늘도 레포지토리의 체질을 개선하고 있습니다.
여러분도 Claude Code를 "스스로 성장하는" 상태로 만들어 보시길 바랍니다!
분명 시야가 크게 바뀔 것입니다...!!!
*기업 대상 Claude Code 교육 서비스를 출시했습니다!! 관심 있으신 분은 언제든지 DM이나 댓글 부탁드립니다! B2B 비즈니스에서 Claude Code를 실제로 마스터하고 있는 멤버들이 조직에서 Claude Code를 활용하기 위한 필수 이야기를 기초부터 진지하게 교육해 드립니다. 보조금을 활용하여 합리적으로 수강할 수 있는 메커니즘으로 만들어 두었으니, 부담 없이 문의 주세요...!!!
