Claude Code로 실제 제품을 만들 때 필요한 에이전트와 규칙을 한 번에 갖다 쓰는 방법
Claude Code를 매일 쓰면서도 세션이 길어질 때마다 컨텍스트가 부족해지고, 반복되는 작업에 매번 같은 지시를 입력해야 하는 상황을 겪고 있다면 이 저장소가 답이 됩니다. Anthropic 해커톤 우승자가 10개월 이상 실제 제품 개발에 쓰며 다듬은 에이전트, 스킬, 훅, 명령어, 규칙, MCP 설정을 한데 모은 도구 모음입니다. 설치만 하면 Claude Code가 코드를 검토하고, 테스트를 작성하고, 세션 간 기억을 유지하는 등 개발 워크플로우를 자동화하는 구조를 그대로 가져올 수 있습니다.
해커톤 우승자의 10개월 사용 기록이 담긴 구성
이 저장소는 단순한 설정 파일 모음이 아니라, zenith.chat이라는 실제 제품을 만들며 검증된 프로덕션급 구성입니다. 특히 토큰 최적화, 메모리 영속성, 병렬 처리, 서브에이전트 오케스트레이션 등 고급 주제를 다루는 가이드와 함께 제공되어, 설정을 단순히 복사하는 것을 넘어 왜 그렇게 구성했는지 이해할 수 있게 돕습니다. 모든 스크립트는 Node.js로 재작성되어 Windows, macOS, Linux에서 동일하게 동작하도록 설계되었습니다.
에이전트, 스킬, 훅이 함께 움직이는 구조
저장소는 Claude Code의 확장 요소인 에이전트, 스킬, 훅, 명령어, 규칙을 체계적으로 분류해 제공합니다. 에이전트는 코드 리뷰, 보안 분석, TDD 가이드 등 특정 역할을 수행하는 전문화된 서브에이전트로, 메인 세션의 컨텍스트를 오염시키지 않고 독립적으로 작업을 처리합니다. 스킬은 TDD 워크플로우, 보안 체크리스트, 연속 학습 패턴 등 재사용 가능한 작업 정의이며, 훅은 세션 시작 시 컨텍스트를 불러오거나 종료 시 상태를 저장하는 등 이벤트 기반 자동화를 담당합니다. 또한 /tdd, /plan, /code-review 같은 슬래시 명령어를 통해 복잡한 워크플로우를 한 줄로 실행할 수 있습니다.
패키지 매니저 자동 감지 및 크로스 플랫폼 지원
이 저장소의 최신 업데이트 중 하나는 Node.js 기반 스크립트를 통한 완전한 크로스 플랫폼 지원입니다. npm, pnpm, yarn, bun 중 사용자가 선호하는 패키지 매니저를 환경 변수, 프로젝트 설정, lock 파일 순서로 자동 감지합니다. CLAUDE_PACKAGE_MANAGER 환경 변수를 설정하거나 scripts/setup-package-manager.js 스크립트를 실행해 원하는 매니저를 지정할 수 있습니다. 이 기능 덕분에 팀원마다 다른 패키지 매니저를 사용해도 동일한 설정 파일로 충돌 없이 개발을 진행할 수 있습니다. 또한 tests/ 디렉토리에 포함된 테스트 스위트를 통해 스크립트와 훅의 정상 동작을 확인할 수 있습니다.
컨텍스트 윈도우 관리와 커스터마이징 원칙
README는 모든 MCP 서버를 동시에 활성화하지 말라고 강력히 경고합니다. 200k 컨텍스트 윈도우가 도구 과다로 인해 70k까지 축소될 수 있으며, 프로젝트당 활성화된 MCP는 10개 미만, 활성 도구는 80개 미만으로 유지하는 것이 권장 사항입니다. disabledMcpServers 설정을 통해 사용하지 않는 서버를 비활성화하는 것이 필수적입니다. 이 설정은 저자의 워크플로우에 최적화되어 있으므로, 자신의 스택에 맞게 수정하고 사용하지 않는 항목은 과감히 제거해야 합니다. 처음에는 마음에 드는 부분부터 시작해 점진적으로 자신의 패턴을 추가하는 것이 좋습니다.
적용 전 확인해야 할 사항
이 저장소는 MIT 라이선스로 공개되어 자유롭게 사용 및 수정이 가능합니다. 하지만 Claude Code 플러그인 시스템에 익숙하지 않다면, 플러그인 설치 방식(plugin marketplace add)과 수동 설치 방식 중 자신의 환경에 맞는 방법을 선택해야 합니다. 수동 설치 시 ~/.claude/ 디렉토리에 파일을 복사하고 settings.json에 훅 설정을 추가하는 과정이 필요하며, MCP 설정 시 API 키 플레이스홀더를 실제 값으로 교체해야 합니다. 특히 컨텍스트 윈도우 관리 규칙을 무시하고 모든 도구를 활성화하면 오히려 성능이 저하되므로, README의 권장 사항을 반드시 준수해야 합니다. 자신의 개발 스타일과 이 저장소의 규칙이 충돌하는 부분이 있다면, 해당 규칙 파일을 수정하거나 삭제하는 것이 정상적인 사용법입니다.
