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 +21 -0
- package/README.md +80 -84
- package/agents/code-reviewer.md +458 -251
- package/agents/fundamentals-code.md +993 -0
- package/agents/junior-checker.md +822 -0
- package/agents/react-performance-optimizer.md +416 -400
- package/agents/refactor-analyzer.md +548 -193
- package/agents/subagent-builder.md +523 -714
- package/bin/cli.js +3 -12
- package/commands/branch.md +47 -47
- package/commands/code-review.md +94 -100
- package/commands/commit.md +33 -33
- package/commands/pr.md +49 -49
- package/commands/review-pr.md +231 -0
- package/docs/BUILDER_GUIDE.md +53 -578
- package/package.json +1 -1
- package/src/sync.js +48 -32
- package/agents/advanced-code-reviewer.md +0 -438
- package/agents/advanced-junior-checker.md +0 -838
- package/agents/advanced-refactor-analyzer.md +0 -610
- package/agents/junior-friendly-checker.md +0 -365
- package/agents/toss-cohesion-analyzer.md +0 -853
- package/docs/COMPARISON.md +0 -743
- package/docs/SUBAGENTS.md +0 -533
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의 강력한 서브에이전트와 슬래시 명령어를 모아놓은 모노레포입니다. 코드 리뷰, 리팩토링 분석, 주니어 개발자 친화성 체크 등 다양한 서브에이전트와 자동
|
|
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
|
-
|
|
46
|
-
# 서브에이전트만 동기화
|
|
18
|
+
# 에이전트만 / 명령어만
|
|
47
19
|
npx binary-agents sync --agents
|
|
48
|
-
|
|
49
|
-
# 슬래시 명령어만 동기화
|
|
50
20
|
npx binary-agents sync --commands
|
|
51
21
|
|
|
52
|
-
#
|
|
53
|
-
npx binary-agents sync --
|
|
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
|
-
|
|
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
|
-
| `
|
|
95
|
-
| `
|
|
96
|
-
| `
|
|
97
|
-
| `
|
|
98
|
-
| `
|
|
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
|
-
│ ├──
|
|
132
|
-
│ ├──
|
|
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
|
-
│
|
|
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
|
-
- [
|
|
185
|
-
- [Basic vs Advanced 비교](docs/COMPARISON.md)
|
|
181
|
+
- [Toss Frontend Fundamentals](https://frontend-fundamentals.com/code-quality/code/)
|
|
186
182
|
- [커스텀 서브에이전트 제작](docs/BUILDER_GUIDE.md)
|