Binary Agents

Claude Code 서브에이전트 컬렉션 및 동기화 도구

소개

binary-agents는 Claude Code의 강력한 서브에이전트들을 모아놓은 모노레포입니다. 코드 리뷰, 리팩토링 분석, 주니어 개발자 친화성 체크 등 다양한 서브에이전트와 이를 프로젝트에 쉽게 설치할 수 있는 CLI 도구를 제공합니다.

설치

NPX 사용 (권장)

별도 설치 없이 바로 사용:

npx binary-agents sync

글로벌 설치

npm install -g binary-agents
binary-agents sync

로컬 설치

npm install binary-agents
npx binary-agents sync

사용법

로컬 프로젝트에 설치 (기본)

현재 프로젝트의 .claude/agents/ 디렉토리에 설치:

# 모든 서브에이전트 동기화
npx binary-agents sync

# 기본 버전만 (Haiku 모델)
npx binary-agents sync --basic

# 고급 버전만 (Sonnet 모델)
npx binary-agents sync --advanced

전역 설치

홈 디렉토리의 ~/.claude/agents/에 설치 (모든 프로젝트에서 사용 가능):

# 전역으로 모든 서브에이전트 설치
npx binary-agents sync --global
# 또는
npx binary-agents sync -g

# 전역 + 기본 버전만
npx binary-agents sync --global --basic

# 전역 + 고급 버전만
npx binary-agents sync --global --advanced

사용 가능한 서브에이전트 목록 보기

npx binary-agents list

서브에이전트 종류

기본 버전 (Haiku 모델)

• code-reviewer.md - 코드 리뷰어
• refactor-analyzer.md - 리팩토링 분석기
• junior-friendly-checker.md - 주니어 친화성 체커

고급 버전 (Opus 모델)

• advanced-code-reviewer.md - 고급 코드 리뷰어
• advanced-refactor-analyzer.md - 고급 리팩토링 분석기
• advanced-junior-checker.md - 고급 주니어 친화성 체커
• react-performance-optimizer.md - React 성능 최적화
• toss-cohesion-analyzer.md - Toss 응집도 분석기
• subagent-builder.md - 서브에이전트 빌더

저장소 구조

binary-agents/
├── agents/              # 서브에이전트 MD 파일들
│   ├── code-reviewer.md
│   ├── advanced-code-reviewer.md
│   ├── refactor-analyzer.md
│   ├── advanced-refactor-analyzer.md
│   ├── junior-friendly-checker.md
│   ├── advanced-junior-checker.md
│   ├── toss-cohesion-analyzer.md
│   ├── react-performance-optimizer.md
│   └── subagent-builder.md
├── bin/                 # CLI 실행 파일
├── src/                 # CLI 소스 코드
├── docs/                # 문서
│   ├── SUBAGENTS.md     # 서브에이전트 상세 설명
│   ├── COMPARISON.md    # Basic vs Advanced 비교
│   └── BUILDER_GUIDE.md # 커스텀 서브에이전트 제작 가이드
└── README.md

작동 원리

1. 로컬 agents/ 디렉토리에서 서브에이전트 파일 목록 읽기
2. YAML frontmatter 검증
3. 사용자 프로젝트의 .claude/agents/ 디렉토리로 복사

요구사항

• Node.js >= 18.0.0

라이센스

MIT

기여

이슈 및 PR을 환영합니다!

서브에이전트 직접 사용하기

NPM 패키지를 설치하지 않고 이 저장소의 서브에이전트를 직접 사용할 수도 있습니다:

1. 저장소 클론:

   git clone https://github.com/01-binary/binary-agents.git

2. 원하는 서브에이전트 파일을 프로젝트의 .claude/agents/ 디렉토리로 복사:

   cp binary-agents/agents/*.md your-project/.claude/agents/

관련 링크

• Claude Code Documentation
• 서브에이전트 상세 가이드
• Basic vs Advanced 비교
• 커스텀 서브에이전트 제작