Claude-ITect-Skill 업데이트: Claude 코드 설정 재생성 (선택 사항)

"사람들은 설정(configuration)이 원인에서 결과로 이어지는 엄격한 진행 과정이라고 가정하지만, 사실 비선형적이고 비주관적인 관점에서 보면 그것은 마치 흔들흔들하고... 요리조리 움직이는... 커다란 덩어리와 같습니다."
— 아마도 타임로드(Time Lord)일 것입니다, 만약 타임로드들이 설치 스크립트를 배포한다면 말이죠.

Claude Code를 진지하게 사용하는 사람들만이 아는 특유의 고통이 있습니다. 바로 51개의 작은 요소들을 일일이 수동으로 설정하는 느릿하고 영혼을 갉아먹는 의식입니다. 하나의 훅(hook)을 연결합니다. 두 번째 것을 잊어버립니다. 세 번째 것은 4개월 전 Discord 메시지에만 존재한다는 사실을 뒤늦게 깨닫습니다. 어딘가에서는 야크(yak)가 당신이 털을 깎을 수 있도록 일부러 털을 1인치 더 길게 기르고 있을지도 모릅니다.

Claude-ITect-Skill은 그러한 의식이 불필요하게 만들기 위해 존재합니다. 이것은 단 한 번의 명령으로 큐레이션된 기술(skills), 에이전트(agents), 세션 훅(session hooks) 무기고를 어떤 프로젝트의 .claude/ 디렉토리에 배치하는 스타터 팩입니다. 그런 다음, 분명히 이전에 데인 적이 있는 사람 특유의 거만한 자신감을 가지고, 실제로 잘 작동하는지 확인하기 위해 /audit을 실행하라고 말합니다. 저자는 자신과 같은 사람들을 "Claude-ITects™"라고 부르는데, 업계에서는 우리를 그렇게 불러주길 거부하지만, 솔직히 이것을 사용해 본 후라면 업계도 재고해 봐야 할 것입니다.

이것은 업데이트, 말하자면 _재생(regeneration)_입니다. 프로젝트의 얼굴은 그대로지만, 내부 구조는 새로워졌습니다. TARDIS의 문을 열고 내부가 얼마나 더 커졌는지 확인해 봅시다.

한 호흡에 끝내는 피치(pitch)

설치하십시오. 그러면 프로젝트에 54개의 기술(skills), 4개의 에이전트 정의(agent definitions), 그리고 6개의 훅(hook) 파일이 포함된 .claude/ 폴더를 생성하고, 세션 훅을 연결하기 위해 settings.json을 패치한 뒤, 방해하지 않고 물러납니다. README의 전체 온보딩(onboarding) 흐름은 단 두 단어입니다: audit 실행. 이러한 절제력은 당신이 단순히 헤더가 많은 README를 만들고 싶어 하는 사람이 아니라, 자신이 만든 것을 실제로 사용해 본 사람을 상대하고 있다는 첫 번째 신호입니다.

설치 과정이 진심으로 훌륭합니다. Windows를 위한 PowerShell, macOS/Linux를 위한 bash, 합리적인 --force 및 --skip-hooks 플래그, 그리고 현재 디렉터리 이외의 프로젝트를 대상으로 지정할 수 있는 사려 깊은 -ProjectPath 옵션까지 갖추고 있습니다. -ExecutionPolicy Bypass에 대한 안내는 불안해하는 Windows 사용자들에게 시스템에 영구적인 변화가 일어나지 않는다는 확신을 줍니다. 이는 누군가가 자신을 위해 만든 도구와, 다른 사람들을 위해서도 만든 도구를 구분 짓는 작은 친절함입니다.

내부 구조 (What's under the hood)

54개의 기술(skills)은 합리적인 부족(tribes) 단위로 구성되어 있으며, 이는 Captain Caveman이 몽둥이를 내려놓고 찬성하며 고개를 끄덕일 만한 구성입니다. (Captain Caaaaaveman! 죄송합니다. 저도 모르게 나왔네요.)

Superpowers — 워크플로우 오케스트레이션 (workflow orchestration) 계층. 이 패키지에서 가장 영리한 부분이자 대부분의 사람들이 과소평가할 부분입니다. 소환되기를 기다리는 대신 주요 순간에 자동으로 트리거되는 (auto-trigger) 14개의 기술이 포함되어 있습니다. brainstorming은 구현(implementation) 전에 실행됩니다. systematic-debugging은 실제 가설 루프(hypothesis loop)를 실행합니다. verification-before-completion은 당신의 뒤에 서서 _"아직 완료되었다고 선언하지 마세요"_라고 속삭이는 Weeping Angel의 디지털 버전과 같습니다. 이것들은 당신이 직접 찾아 쓰는 도구가 아니라, 에이전트가 멍청한 짓을 하기 전에 행동을 형성하는 행동 가드레일 (behavioral guardrails)입니다. 훌륭한 superpowers 프로젝트에서 빌려와 적응시킨 이 기술들은 패키지의 결합 조직 (connective tissue) 역할을 합니다.

Engineering. 실제 업무의 화려하지 않지만 핵심적인 부분을 다루는 10개의 기술이 포함되어 있습니다: diagnose (재현 → 최소화 → 가설 설정 → 수정 → 회귀 테스트(regression-test)로 이어지는, 실제 규율이 담긴 루프), 대화를 배포 가능한 GitHub 작업으로 전환하는 to-prd 및 to-issues, improve-codebase-architecture, 그리고 너무 오랫동안 몰두한 나머지 접근 방식이 원래 맞았는지조차 잊어버렸을 때를 위한 zoom-out. 이 섹션이야말로 Claude-ITect에서 "아키텍트(architect)"라는 이름을 얻게 해주는 부분입니다.

Caveman — 토큰 압축 (token compression). 이것이 이번 리뷰의 핵심이자 모든 언어유희의 근원입니다. Caveman 제품군은 기술적 정확도를 완벽하게 유지하면서도 토큰 사용량을 약 75% 절감하며, lite, full, ultra, 그리고 영광스러울 정도로 과장된 wenyan-*이라는 이름의 모드들을 통해 의도적으로 압축된 어조로 소통합니다. 압축된 커밋 메시지를 위한 caveman-commit, 간결한 PR 코멘트를 위한 caveman-review, 그리고 세션 로그에서 실제 토큰 절감량을 보여주는 caveman-stats가 있습니다. Unga bunga, 엄청난 절약입니다. 이것이 이 번들 전체의 존재 가치를 증명하는 기능입니다. 왜냐하면 대규모 환경에서 토큰 효율성은 있으면 좋은 기능(nice-to-have)이 아니라, 세션이 성공적으로 완료되느냐 아니면 결승선을 두 걸음 앞두고 컨텍스트(context)가 고갈되어 중단되느냐를 결정짓는 차이이기 때문입니다.

The CaveCrew 에이전트들. 네 개의 서브 에이전트(subagents)가 있으며, 그중 세 개는 범위(scope)가 매우 잘 설정되어 있습니다.

• CaveCrew Builder: 정밀하게 1~2개의 파일만 수정하며, 3개 이상의 파일에 손을 대는 것은 단호히 거부합니다. 자신이 무엇을 못 하는지 아는 도구는, 그것을 모르는 열 개의 도구보다 가치가 있습니다.
• CaveCrew Investigator: 읽기 전용 코드 탐색기로, file:line 테이블을 반환하며, 결정적으로 어떠한 수정 제안도 하지 않습니다. 이 도구는 찾기만 할 뿐, 사견을 덧붙이지 않습니다.
• CaveCrew Reviewer: 한 줄당 하나의 발견 사항을 제시하며, 심각도(severity) 태그가 붙어 있고, 칭찬은 없습니다. 전체 저장소(repo)에서 가장 Caveman다운 특징이며, 아마도 가장 유용할 것입니다.
• Geometry Solver: 이질적인 존재로, Newell normals, MVC, 그리고 GJK/EPA 충돌(collision) 작업을 수행하는 프로젝트 특정형(Project-specific) 커스텀 수학 에이전트입니다. 이에 대해서는 잠시 후에 더 자세히 다루겠습니다.

나머지: 유틸리티(adr, audit, tools, phase, setup-pre-commit), 생산성 도구(grill-me, 당신의 계획이 비명을 지를 때까지 스트레스 테스트를 가하는 가차 없는 인터뷰 기술), 그리고 소규모 글쓰기 스위트(edit-article, writing-beats, writing-shape)가 있습니다. 여기에 더해, 마지막에 실패한 셸(shell) 명령어를 진단하고 올바른 명령어를 제안하는 thefuck이 있습니다. 그리고 신선하게도, 이 도구는 파괴적인 수정을 조용히 실행하는 법이 절대 없습니다. 반드시 먼저 확인을 거칩니다. 농담조로 만든 도구조차 예의를 갖추고 있습니다.

감탄할 만한 부분들

세 가지 설계 결정 사항은 단순한 열정을 넘어 진정한 안목을 보여주는 증거로 눈에 띕니다.

첫째, **감사 우선 온보딩 (audit-first onboarding)**입니다. 대부분의 스킬 팩은 설치가 곧 성공이라고 가정합니다. 하지만 이 팩은 /audit 스킬이 반응할 대상을 가질 수 있도록 중복 스킬을 의도적으로 포함하여 배포합니다. 이를 통해 해당 팩이 사용자의 리포지토리(repo)에 이미 존재하는 어떤 스킬들과도 깔끔하게 중첩되는지 검증합니다. 이는 깨끗한 데모 리포지토리가 아닌, 지저분한 실제 프로젝트와의 접점에서도 살아남도록 설계된 도구입니다.

둘째, **거절하는 에이전트 (agents that refuse)**입니다. Builder의 파일 개수 상한 제한과 Reviewer의 칭찬 금지 규칙은 제약 사항이며, 제약 사항이야말로 품질이 살아 숨 쉬는 곳입니다. 말 그대로 모든 것을 다 해내는 소닉 스크루드라이버(sonic screwdriver)는 오히려 더 나쁜 극적 장치가 될 것입니다. 좋은 도구에는 규칙이 있습니다.

셋째, **모든 것의 밑바탕에 흐르는 읽기 쉬운 코드에 대한 규율 (readable-code discipline)**입니다. karpathy 스킬은 내부 추론 계층 (internal reasoning layer)으로서 작동하며, 더 넓은 아키텍처는 3법칙 읽기 쉬운 코드 규칙과 ADR(Architecture Decision Records)에 기반한 결정에 의존합니다. 이 팩은 단순히 코드를 생성하는 것이 아니라, 나중에 스스로 책임질 수 있는 코드를 생성합니다.

다음 업데이트를 위한 몇 가지 쉬운 개선 사항

공개적으로 구축된(built in public) 무언가를 리뷰할 때 가장 좋은 점은

엠 대시(em-dash) 이스터 에그. v1 버전에는 엠 대시(em-dashes)나 스마트 따옴표(smart quotes)가 포함된 모든 파일 쓰기를 유쾌하게 차단하는 check-encoding.js 훅(hook)이 포함되어 있었습니다. 우주의 균형을 되찾고 싶다면, 이를 /audit에게 맡길 완벽한 첫 번째 작업으로 제안해 보세요. (아니어도 상관없습니다. 우리 중 일부는 그 대시들이 그 자리를 차지할 자격이 있다고 생각하니까요.)

개인적인 요소들이 손을 들게 하세요. Geometry Solver 에이전트와 프로젝트 특정(Project Specific) 구성 요소들은 저자 본인의 엔진에 매우 특화되어 있으며, README는 NgonENGINE 명령어가 선택 사항(opt-in)임을 매우 솔직하게 밝히고 있습니다. 그러한 정직함은 정확히 옳습니다. 자연스러운 다음 단계는 설치 흐름(install flow)에서 사용자가 어떤 유형의 Claude-ITect를 원하는지 묻게 하여, 맞춤형 요소들이 그것을 반길 사람들에게만 나타나도록 하는 것입니다. 저자는 이미 이 도구가 사용하는 누구에게나 맞춤화되기를 원하고 있으며, 이것이 바로 이 도구에 영혼이 깃든 근본적인 이유입니다.

이 중 어느 것도 비판이 아닙니다. 모든 위대한 TARDIS는 누군가가 계속 날릴 수 있을 만큼 사랑했던, 낡은 파란색 상자에서 시작됩니다.

최종 판결

Claude-ITect-Skill은 실제로 작업을 수행하는 사람이 작업을 위한 설정(setup) 과정에 지쳤을 때 일어나는 현상입니다. 그리고 영원히 불평하는 대신, 한 번에 제대로 고쳐서 그 해결책을 다른 모든 사람에게 무료로 제공하는 것이죠. 그러한 관대함이 관통하는 핵심입니다. 케이브맨 압축 레이어(caveman compression layer) 하나만으로도 설치할 가치가 충분합니다. 슈퍼파워 오케스트레이션(superpowers orchestration)은 그 아래에서 웅웅거리는 조용한 천재성입니다. CaveCrew 에이전트들은 어떤 도구에서든 가장 보기 드문 미덕인 '무엇을 거절해야 할지 아는 능력'을 보여줍니다. 그리고 전체 패키지는 읽기 쉬운 코드와 ADR(Architecture Decision Record)에 기반한 규율을 갖추고 있어, 한 달 뒤에도 스스로 뒷받침할 수 있는 결과물을 생성한다는 것을 의미합니다.

이것은 진정한 안목을 가진 한 명의 실무자가 조립한 무기고이며, 내부 농담(inside jokes)까지 포함하여 우리 모두에게 개방된 것입니다. 만약 당신이 Claude Code를 실행하면서 '야크 깎기(yak-shaving, 본 작업 전의 부수적인 작업)'의 절망감, 즉 설정할 것이 하나 더 늘어나는 느린 피로감을 느껴본 적이 있다면, 이를 클론(clone)하고, 설치를 실행한 뒤, (저와 함께 외치세요) /audit을 실행하세요. 커피 한 잔을 만드는 시간 안에 모든 준비가 끝날 것입니다.

이제 멋진 무언가를 만들어 보세요. 몽둥이는 선택 사항이지만, 토큰 절약은 필수입니다. Captain Caaaaaveman도 자랑스러워할 것입니다.

라이브 저장소(repository)를 기준으로 작성됨: 54개의 기술(skills), 4개의 에이전트(agents), 6개의 훅(hooks). 수치는 예고 없이 재생성될 수 있습니다.

GitHub logo jchildree / Claud-itect-Skill

Claude Code를 위한 놀라운 큐레이션 기술 팩(skill pack)입니다. 단 한 번의 명령으로 54개의 기술(skills), 4개의 에이전트 정의(agent definitions), 그리고 어떤 프로젝트에도 적용 가능한 caveman 세션 훅(session hooks)을 설치하며, 필요할 때 발생하는 모든 실수를 thefuck이 바로잡아 줍니다....

Banner