binary-agents 1.0.13 → 1.0.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 01-binary
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -4,98 +4,37 @@ Claude Code 서브에이전트 및 슬래시 명령어 컬렉션 + 동기화 도
4
4
 
5
5
  ## 소개
6
6
 
7
- `binary-agents`는 Claude Code의 강력한 서브에이전트와 슬래시 명령어를 모아놓은 모노레포입니다. 코드 리뷰, 리팩토링 분석, 주니어 개발자 친화성 체크 등 다양한 서브에이전트와 자동 커밋 등의 슬래시 명령어를 제공하며, 이를 프로젝트에 쉽게 설치할 수 있는 CLI 도구를 포함합니다.
8
-
9
- ## 설치
10
-
11
- ### NPX 사용 (권장)
12
-
13
- 별도 설치 없이 바로 사용:
14
-
15
- ```bash
16
- npx binary-agents sync
17
- ```
18
-
19
- ### 글로벌 설치
20
-
21
- ```bash
22
- npm install -g binary-agents
23
- binary-agents sync
24
- ```
25
-
26
- ### 로컬 설치
27
-
28
- ```bash
29
- npm install binary-agents
30
- npx binary-agents sync
31
- ```
7
+ `binary-agents`는 Claude Code의 강력한 서브에이전트와 슬래시 명령어를 모아놓은 모노레포입니다. 코드 리뷰, 리팩토링 분석, 주니어 개발자 친화성 체크 등 다양한 서브에이전트와 자동 커밋/PR 생성 등의 슬래시 명령어를 제공하며, 이를 프로젝트에 쉽게 설치할 수 있는 CLI 도구를 포함합니다.
32
8
 
33
9
  ## 사용법
34
10
 
35
- ### 기본 동기화
36
-
37
- 현재 프로젝트의 `.claude/` 디렉토리에 agents와 commands 모두 설치:
38
-
39
11
  ```bash
12
+ # 현재 프로젝트에 설치 (.claude/)
40
13
  npx binary-agents sync
41
- ```
42
14
 
43
- ### 선택적 동기화
15
+ # 전역 설치 (~/.claude/)
16
+ npx binary-agents sync -g
44
17
 
45
- ```bash
46
- # 서브에이전트만 동기화
18
+ # 에이전트만 / 명령어만
47
19
  npx binary-agents sync --agents
48
-
49
- # 슬래시 명령어만 동기화
50
20
  npx binary-agents sync --commands
51
21
 
52
- # 기본 서브에이전트만 (Haiku 모델)
53
- npx binary-agents sync --agents --basic
54
-
55
- # 고급 서브에이전트만 (Opus 모델)
56
- npx binary-agents sync --agents --advanced
57
- ```
58
-
59
- ### 전역 설치
60
-
61
- 홈 디렉토리의 `~/.claude/`에 설치 (모든 프로젝트에서 사용 가능):
62
-
63
- ```bash
64
- # 전역으로 모두 설치
65
- npx binary-agents sync --global
66
- # 또는
67
- npx binary-agents sync -g
68
-
69
- # 전역 + 서브에이전트만
70
- npx binary-agents sync -g --agents
71
-
72
- # 전역 + 슬래시 명령어만
73
- npx binary-agents sync -g --commands
74
- ```
75
-
76
- ### 목록 보기
22
+ # 기존 파일 삭제 후 새로 설치
23
+ npx binary-agents sync --clean
77
24
 
78
- ```bash
25
+ # 목록 보기
79
26
  npx binary-agents list
80
27
  ```
81
28
 
82
29
  ## 서브에이전트 종류
83
30
 
84
- ### 기본 버전 (Haiku 모델)
85
- | 이름 | 설명 |
86
- |------|------|
87
- | `code-reviewer` | 코드 리뷰어 |
88
- | `refactor-analyzer` | 리팩토링 분석기 |
89
- | `junior-friendly-checker` | 주니어 친화성 체커 |
90
-
91
- ### 고급 버전 (Opus 모델)
92
31
  | 이름 | 설명 |
93
32
  |------|------|
94
- | `advanced-code-reviewer` | 고급 코드 리뷰어 (웹 검색 포함) |
95
- | `advanced-refactor-analyzer` | 고급 리팩토링 분석기 (웹 검색 포함) |
96
- | `advanced-junior-checker` | 고급 주니어 친화성 체커 (웹 검색 포함) |
97
- | `react-performance-optimizer` | React 성능 최적화 |
98
- | `toss-cohesion-analyzer` | Toss 원칙 기반 응집도 분석기 |
33
+ | `code-reviewer` | 아키텍처, 타입 안전성, 에러 처리, 테스트, 접근성, 보안 리뷰 |
34
+ | `refactor-analyzer` | 코드 중복, 복잡성, 추상화 기회, 코드 스멜 분석 |
35
+ | `junior-checker` | 주니어 개발자 관점 가독성, 네이밍, 복잡도 체크 |
36
+ | `fundamentals-code` | Toss Frontend Fundamentals 기반 (가독성, 예측 가능성, 응집도, 결합도) |
37
+ | `react-performance-optimizer` | React 리렌더, 메모이제이션, 최적화 분석 |
99
38
  | `subagent-builder` | 커스텀 서브에이전트 빌더 |
100
39
 
101
40
  ## 슬래시 명령어
@@ -103,6 +42,10 @@ npx binary-agents list
103
42
  | 명령어 | 설명 |
104
43
  |--------|------|
105
44
  | `/commit` | git log 분석 후 컨벤션에 맞는 커밋 메시지 자동 생성 및 커밋 |
45
+ | `/branch` | main에서 pull 후 브랜치 네이밍 컨벤션에 맞는 새 브랜치 생성 |
46
+ | `/pr` | 브랜치 변경사항 분석 후 PR 자동 생성 |
47
+ | `/review-pr` | PR 링크를 받아 변경사항 분석 후 GitHub 스타일 라인별 코드 리뷰 |
48
+ | `/code-review` | 여러 에이전트를 병렬 실행하여 종합 코드 리뷰 |
106
49
 
107
50
  ### /commit 사용법
108
51
 
@@ -120,27 +63,81 @@ Claude가 자동으로:
120
63
  3. 컨벤션에 맞는 커밋 메시지 생성
121
64
  4. 커밋 실행
122
65
 
66
+ ### /branch 사용법
67
+
68
+ ```bash
69
+ # Claude Code에서 /branch 실행
70
+ /branch
71
+ ```
72
+
73
+ Claude가 자동으로:
74
+ 1. 기존 브랜치 이름에서 컨벤션 분석
75
+ 2. main 브랜치에서 최신 코드 pull
76
+ 3. 작업 목적에 맞는 브랜치 이름 생성 (feature/, fix/, chore/ 등)
77
+ 4. 새 브랜치 생성 및 전환
78
+
79
+ ### /pr 사용법
80
+
81
+ ```bash
82
+ # Claude Code에서 /pr 실행
83
+ /pr
84
+ ```
85
+
86
+ Claude가 자동으로:
87
+ 1. 현재 브랜치와 main 브랜치 차이 분석
88
+ 2. 커밋 내역 및 변경 파일 확인
89
+ 3. PR 제목 및 설명 생성
90
+ 4. GitHub CLI로 PR 생성
91
+
92
+ ### /review-pr 사용법
93
+
94
+ ```bash
95
+ # PR 번호로 실행
96
+ /review-pr 123
97
+
98
+ # PR URL로 실행
99
+ /review-pr https://github.com/owner/repo/pull/123
100
+ ```
101
+
102
+ Claude가 자동으로:
103
+ 1. PR 정보 및 diff 가져오기
104
+ 2. 리뷰 타입 선택 (전체 리뷰/커스텀)
105
+ 3. 5개 에이전트를 병렬 실행하여 분석
106
+ 4. GitHub 스타일 라인별 코드 리뷰 생성
107
+
108
+ ### /code-review 사용법
109
+
110
+ ```bash
111
+ # Claude Code에서 /code-review 실행
112
+ /code-review
113
+ ```
114
+
115
+ Claude가 자동으로:
116
+ 1. 리뷰 타입 선택 (전체 리뷰/커스텀)
117
+ 2. 선택된 에이전트들을 병렬 실행
118
+ 3. 결과 집계 및 우선순위 정렬
119
+ 4. 종합 리뷰 리포트 생성
120
+
123
121
  ## 저장소 구조
124
122
 
125
123
  ```
126
124
  binary-agents/
127
125
  ├── agents/ # 서브에이전트 MD 파일들
128
126
  │ ├── code-reviewer.md
129
- │ ├── advanced-code-reviewer.md
130
127
  │ ├── refactor-analyzer.md
131
- │ ├── advanced-refactor-analyzer.md
132
- │ ├── junior-friendly-checker.md
133
- │ ├── advanced-junior-checker.md
134
- │ ├── toss-cohesion-analyzer.md
128
+ │ ├── junior-checker.md
129
+ │ ├── fundamentals-code.md
135
130
  │ ├── react-performance-optimizer.md
136
131
  │ └── subagent-builder.md
137
132
  ├── commands/ # 슬래시 명령어 MD 파일들
138
- └── commit.md
133
+ ├── commit.md
134
+ │ ├── branch.md
135
+ │ ├── pr.md
136
+ │ ├── review-pr.md
137
+ │ └── code-review.md
139
138
  ├── bin/ # CLI 실행 파일
140
139
  ├── src/ # CLI 소스 코드
141
140
  ├── docs/ # 문서
142
- │ ├── SUBAGENTS.md # 서브에이전트 상세 설명
143
- │ ├── COMPARISON.md # Basic vs Advanced 비교
144
141
  │ └── BUILDER_GUIDE.md # 커스텀 서브에이전트 제작 가이드
145
142
  └── README.md
146
143
  ```
@@ -181,6 +178,5 @@ cp binary-agents/commands/*.md your-project/.claude/commands/
181
178
  ## 관련 링크
182
179
 
183
180
  - [Claude Code Documentation](https://docs.anthropic.com/en/docs/claude-code)
184
- - [서브에이전트 상세 가이드](docs/SUBAGENTS.md)
185
- - [Basic vs Advanced 비교](docs/COMPARISON.md)
181
+ - [Toss Frontend Fundamentals](https://frontend-fundamentals.com/code-quality/code/)
186
182
  - [커스텀 서브에이전트 제작](docs/BUILDER_GUIDE.md)