Package Exports
- binary-agents
- binary-agents/src/sync.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (binary-agents) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
Binary Agents
Claude Code 서브에이전트 및 슬래시 명령어 컬렉션 + 동기화 도구
소개
binary-agents는 Claude Code의 강력한 서브에이전트와 슬래시 명령어를 모아놓은 모노레포입니다. 코드 리뷰, 리팩토링 분석, 주니어 개발자 친화성 체크 등 다양한 서브에이전트와 자동 커밋/PR 생성 등의 슬래시 명령어를 제공하며, 이를 프로젝트에 쉽게 설치할 수 있는 CLI 도구를 포함합니다.
사용법
# 대화형 설치 (권장)
npx binary-agents
# 목록 보기
npx binary-agents list실행하면 대화형으로 설치 옵션을 선택할 수 있습니다:
🤖 Binary Agents 설치
? 어디에 설치하시겠습니까?
❯ 전역 (~/.claude/)
현재 프로젝트 (.claude/)
? 무엇을 설치하시겠습니까?
❯ 모두 (에이전트 + 명령어)
에이전트만
명령어만
? 기존 binary-agents 파일을 삭제하고 새로 설치할까요?
❯ 예 (binary-agents 파일만 삭제, 커스텀 파일 보존)
아니오 (기존 파일 유지)서브에이전트 종류
| 이름 | 설명 |
|---|---|
code-reviewer |
아키텍처, 타입 안전성, 에러 처리, 테스트, 접근성, 보안 리뷰 |
refactor-analyzer |
코드 중복, 복잡성, 추상화 기회, 코드 스멜 분석 |
junior-checker |
주니어 개발자 관점 가독성, 네이밍, 복잡도 체크 |
fundamentals-code |
Toss Frontend Fundamentals 기반 (가독성, 예측 가능성, 응집도, 결합도) |
react-performance-optimizer |
React 리렌더, 메모이제이션, 훅 최적화 분석 |
react-principles-reviewer |
React 개발 원칙 (응집도/명시성, Props 관리, 네이밍, 부수효과, AsyncBoundary) |
maintainable-code-reviewer |
유지보수성 리뷰 (UI-코드 1:1 대응, 분리의 4원칙, 추상화 원칙) |
subagent-builder |
커스텀 서브에이전트 빌더 |
슬래시 명령어
| 명령어 | 설명 |
|---|---|
/commit |
git log 분석 후 컨벤션에 맞는 커밋 메시지 자동 생성 및 커밋 |
/branch |
main에서 pull 후 브랜치 네이밍 컨벤션에 맞는 새 브랜치 생성 |
/pr |
브랜치 변경사항 분석 후 PR 자동 생성 |
/review-pr |
PR 링크를 받아 변경사항 분석 후 GitHub 스타일 라인별 코드 리뷰 |
/code-review |
여러 에이전트를 병렬 실행하여 종합 코드 리뷰 |
/design-to-code |
설계/요구사항을 분석하여 구현 계획 생성 |
/figma-check |
Figma MCP로 디자인 정보를 가져와 구현 코드와 비교 분석 |
/commit 사용법
# 1. 변경 사항 스테이징
git add .
# 2. Claude Code에서 /commit 실행
/commitClaude가 자동으로:
- 최근 커밋 로그에서 컨벤션 분석
- staged changes 확인
- 컨벤션에 맞는 커밋 메시지 생성
- 커밋 실행
/branch 사용법
# Claude Code에서 /branch 실행
/branchClaude가 자동으로:
- 기존 브랜치 이름에서 컨벤션 분석
- main 브랜치에서 최신 코드 pull
- 작업 목적에 맞는 브랜치 이름 생성 (feature/, fix/, chore/ 등)
- 새 브랜치 생성 및 전환
/pr 사용법
# Claude Code에서 /pr 실행
/prClaude가 자동으로:
- 현재 브랜치와 main 브랜치 차이 분석
- 커밋 내역 및 변경 파일 확인
- PR 제목 및 설명 생성
- GitHub CLI로 PR 생성
/review-pr 사용법
# PR 번호로 실행
/review-pr 123
# PR URL로 실행
/review-pr https://github.com/owner/repo/pull/123Claude가 자동으로:
- PR 정보 및 diff 가져오기
- 리뷰 타입 선택 (전체 리뷰/커스텀)
- 6개 에이전트를 병렬 실행하여 분석
- GitHub 스타일 라인별 코드 리뷰 생성
/code-review 사용법
# Claude Code에서 /code-review 실행
/code-reviewClaude가 자동으로:
- 리뷰 타입 선택 (전체 리뷰/커스텀)
- 선택된 에이전트들을 병렬 실행
- 결과 집계 및 우선순위 정렬
- 종합 리뷰 리포트 생성
/design-to-code 사용법
# 1. 먼저 설계/요구사항 설명
"사용자 프로필 페이지를 만들어야 해.
- 프로필 이미지, 이름, 이메일 표시
- 프로필 수정 모달
- 비밀번호 변경 기능"
# 2. Claude Code에서 /design-to-code 실행
/design-to-codeClaude가 자동으로:
- 대화 컨텍스트에서 설계/요구사항 파악
- Explore 에이전트로 코드베이스 분석
- Plan 에이전트로 구현 계획 수립
- fundamentals-code, refactor-analyzer로 설계 검증
- React 프로젝트면 react-principles-reviewer도 실행
- 종합 구현 계획 리포트 생성
저장소 구조
binary-agents/
├── agents/ # 서브에이전트 MD 파일들
│ ├── code-reviewer.md
│ ├── refactor-analyzer.md
│ ├── junior-checker.md
│ ├── fundamentals-code.md
│ ├── react-performance-optimizer.md
│ ├── react-principles-reviewer.md
│ ├── maintainable-code-reviewer.md
│ └── subagent-builder.md
├── commands/ # 슬래시 명령어 MD 파일들
│ ├── commit.md
│ ├── branch.md
│ ├── pr.md
│ ├── review-pr.md
│ ├── code-review.md
│ ├── design-to-code.md
│ └── figma-check.md
├── bin/ # CLI 실행 파일
├── src/ # CLI 소스 코드
├── docs/ # 문서
│ └── BUILDER_GUIDE.md # 커스텀 서브에이전트 제작 가이드
└── README.md작동 원리
- 로컬
agents/,commands/디렉토리에서 파일 목록 읽기 - YAML frontmatter 검증
- 사용자 프로젝트의
.claude/agents/,.claude/commands/디렉토리로 복사
요구사항
- Node.js >= 18.0.0
라이센스
MIT
기여
이슈 및 PR을 환영합니다!
직접 사용하기
NPM 패키지를 설치하지 않고 이 저장소의 파일을 직접 사용할 수도 있습니다:
# 저장소 클론
git clone https://github.com/01-binary/binary-agents.git
# 서브에이전트 복사
cp binary-agents/agents/*.md your-project/.claude/agents/
# 슬래시 명령어 복사
cp binary-agents/commands/*.md your-project/.claude/commands/