ai-nexus 1.3.11 → 1.3.13
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 +190 -190
- package/README.ko.md +398 -384
- package/README.md +398 -384
- package/bin/ai-rules.cjs +151 -151
- package/config/agents/code-standards.md +81 -81
- package/config/agents/review-checklist.md +70 -70
- package/config/agents/security-rules.md +51 -51
- package/config/codex/AGENTS.md +69 -69
- package/config/commands/commit.md +34 -34
- package/config/commands/debug.md +31 -31
- package/config/commands/refactor.md +30 -30
- package/config/commands/review.md +36 -36
- package/config/commands/test.md +47 -47
- package/config/contexts/debug.md +35 -35
- package/config/contexts/dev.md +20 -20
- package/config/contexts/research.md +33 -33
- package/config/hooks/README.md +106 -106
- package/config/hooks/semantic-router.cjs +285 -285
- package/config/rules/code-thresholds.md +12 -12
- package/config/rules/commit.md +49 -49
- package/config/rules/development-workflow.md +19 -19
- package/config/rules/error-handling.md +52 -52
- package/config/rules/essential.md +19 -19
- package/config/rules/naming.md +35 -35
- package/config/rules/pr.md +54 -54
- package/config/rules/security.md +19 -19
- package/config/rules/testing.md +37 -37
- package/config/rules/typescript.md +38 -38
- package/config/settings.json +15 -15
- package/config/skills/api-design.md +59 -59
- package/config/skills/docker.md +50 -50
- package/config/skills/go.md +43 -43
- package/config/skills/nextjs.md +41 -41
- package/config/skills/python.md +49 -49
- package/config/skills/react.md +42 -42
- package/config/skills/review.md +42 -42
- package/config/skills/rust.md +49 -49
- package/config/skills/svelte.md +49 -49
- package/config/skills/vue.md +45 -45
- package/config/templates/basic/CLAUDE.md +23 -23
- package/config/templates/node-express/CLAUDE.md +75 -75
- package/config/templates/react-nextjs/CLAUDE.md +59 -59
- package/dist/browse/browse.html +352 -352
- package/dist/commands/init-interactive.js +6 -6
- package/dist/utils/semantic-router.js +12 -12
- package/package.json +63 -63
package/README.ko.md
CHANGED
|
@@ -1,384 +1,398 @@
|
|
|
1
|
-
**한국어** | [English](README.md)
|
|
2
|
-
|
|
3
|
-
# ai-nexus
|
|
4
|
-
|
|
5
|
-
>
|
|
6
|
-
|
|
7
|
-
**Claude Code**, **Cursor**, **Codex**를 위한
|
|
8
|
-
|
|
9
|
-
[](https://www.npmjs.com/package/ai-nexus)
|
|
10
|
-
[
|
|
2
|
+
|
|
3
|
+
# ai-nexus
|
|
4
|
+
|
|
5
|
+
> 룰을 한 번 작성하세요. 어디서든 사용하세요. 토큰도 절약하세요.
|
|
6
|
+
|
|
7
|
+
**Claude Code**, **Cursor**, **Codex**를 위한 통합 룰 매니저.
|
|
8
|
+
|
|
9
|
+
[](https://www.npmjs.com/package/ai-nexus)
|
|
10
|
+
[](https://www.npmjs.com/package/ai-nexus)
|
|
11
|
+
[](https://opensource.org/licenses/Apache-2.0)
|
|
12
|
+
|
|
13
|
+
**[홈페이지](https://jsk9999.github.io/ai-nexus/)** | **[문서](https://jsk9999.github.io/ai-nexus/docs.html)**
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
npx ai-nexus install
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
---
|
|
20
|
+
|
|
21
|
+
## 문제
|
|
22
|
+
|
|
23
|
+
AI 코딩 도구마다 룰 형식이 다릅니다 — `.claude/rules/*.md`, `.cursor/rules/*.mdc`, `.codex/AGENTS.md`. 같은 룰을 여러 곳에 관리하다 보면 결국 서로 달라집니다. 게다가 매 프롬프트마다 모든 룰이 로드되어 불필요한 토큰이 낭비됩니다.
|
|
24
|
+
|
|
25
|
+
## 해결
|
|
26
|
+
|
|
27
|
+
**ai-nexus**로 룰을 한 번 작성하고 모든 도구에 배포하세요 — 스마트 룰 로딩으로 토큰 낭비도 줄입니다:
|
|
28
|
+
|
|
29
|
+
```
|
|
30
|
+
한 번 작성:
|
|
31
|
+
config/rules/commit.md
|
|
32
|
+
config/skills/react.md
|
|
33
|
+
|
|
34
|
+
어디서든 배포:
|
|
35
|
+
✓ Claude Code → .claude/rules/ (시맨틱 라우팅 포함)
|
|
36
|
+
✓ Cursor → .cursor/rules/*.mdc (자동 변환)
|
|
37
|
+
✓ Codex → .codex/AGENTS.md (통합)
|
|
38
|
+
|
|
39
|
+
하나의 소스. 모든 도구가 동기화됩니다.
|
|
40
|
+
프롬프트마다 필요한 룰만 로딩됩니다.
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
## 왜 ai-nexus?
|
|
46
|
+
|
|
47
|
+
| | 강점 | 상세 |
|
|
48
|
+
|---|---|---|
|
|
49
|
+
| **필요한 룰만 로드** | 30+ 룰 중 프롬프트당 2-3개만 선택 | 시맨틱 라우터가 프롬프트를 분석해 관련 룰만 골라 로드합니다. 불필요한 토큰 낭비 제거 → AI 응답 품질 향상 + 비용 절감. |
|
|
50
|
+
| **한 번 작성, 어디서든 배포** | 하나의 룰 파일 → 세 가지 도구 | `.md` 룰 하나만 작성하면 Cursor용 `.mdc`, Codex용 `AGENTS.md`로 자동 변환됩니다. 복붙 불필요. |
|
|
51
|
+
| **AI 기반 룰 선택** | GPT-4o-mini 또는 Claude Haiku가 룰 선택 | 매 프롬프트마다 훅이 실행되어 필요한 룰만 로딩합니다. 월 ~$0.50. AI 없이도 키워드 매칭으로 무료 동작. |
|
|
52
|
+
| **팀 전체 일관성** | Git 기반 룰 공유 | 모든 팀원이 같은 저장소에서 설치. `npx ai-nexus update` 한 번으로 전팀 동기화. |
|
|
53
|
+
| **내 수정은 안전** | 비파괴적 업데이트 | install과 update 모두 로컬 커스터마이징을 절대 덮어쓰지 않습니다. 새 파일만 추가. |
|
|
54
|
+
| **커뮤니티 마켓플레이스** | 브라우저에서 검색, 설치, 제거 | `npx ai-nexus browse`로 로컬 웹 UI를 엽니다. PR merge 즉시 커뮤니티 룰 사용 가능. |
|
|
55
|
+
|
|
56
|
+
---
|
|
57
|
+
|
|
58
|
+
## 빠른 시작
|
|
59
|
+
|
|
60
|
+
```bash
|
|
61
|
+
# 대화형 설치 마법사 (기본값)
|
|
62
|
+
npx ai-nexus install
|
|
63
|
+
|
|
64
|
+
# 기본값으로 빠른 설치
|
|
65
|
+
npx ai-nexus install -q
|
|
66
|
+
|
|
67
|
+
# 팀 룰 사용
|
|
68
|
+
npx ai-nexus install --rules github.com/your-org/team-rules
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
### 데모
|
|
72
|
+
|
|
73
|
+
**설치 마법사**
|
|
74
|
+
|
|
75
|
+
|
|
76
|
+
|
|
77
|
+
**설치된 룰 목록**
|
|
78
|
+
|
|
79
|
+
|
|
80
|
+
|
|
81
|
+
**룰 마켓플레이스**
|
|
82
|
+
|
|
83
|
+
|
|
84
|
+
|
|
85
|
+
---
|
|
86
|
+
|
|
87
|
+
## 지원 도구
|
|
88
|
+
|
|
89
|
+
| 도구 | 동작 방식 | 토큰 부담 |
|
|
90
|
+
|------|-----------|-----------|
|
|
91
|
+
| **Claude Code** | 시맨틱 라우터가 프롬프트마다 동적으로 룰 교체 | 필요한 룰만 로딩 |
|
|
92
|
+
| **Cursor** | 룰을 `.mdc` 형식으로 변환; Cursor 내장 검색이 필터링 | Cursor 검색에 의존 |
|
|
93
|
+
| **Codex** | 정적 `AGENTS.md` (동적 로딩 없음) | 전체 룰 로딩 |
|
|
94
|
+
|
|
95
|
+
---
|
|
96
|
+
|
|
97
|
+
## 작동 원리
|
|
98
|
+
|
|
99
|
+
### Claude Code: 시맨틱 라우터
|
|
100
|
+
|
|
101
|
+
매 프롬프트마다 훅이 실행되어 실제로 필요한 룰을 분석합니다:
|
|
102
|
+
|
|
103
|
+
```
|
|
104
|
+
~/.claude/
|
|
105
|
+
├── hooks/
|
|
106
|
+
│ └── semantic-router.cjs # 매 프롬프트마다 실행
|
|
107
|
+
├── settings.json # 훅 설정
|
|
108
|
+
├── rules/ # 활성 룰
|
|
109
|
+
└── rules-inactive/ # 비활성 룰 (로드 안 됨)
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
**AI 라우팅 사용** (권장):
|
|
113
|
+
```bash
|
|
114
|
+
export OPENAI_API_KEY=sk-xxx # 또는 ANTHROPIC_API_KEY
|
|
115
|
+
export SEMANTIC_ROUTER_ENABLED=true
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
GPT-4o-mini 또는 Claude Haiku가 프롬프트를 분석해 적절한 룰을 선택합니다. 비용: 월 ~$0.50.
|
|
119
|
+
|
|
120
|
+
**AI 없이** (폴백):
|
|
121
|
+
프롬프트의 키워드를 매칭해서 룰을 활성화합니다.
|
|
122
|
+
|
|
123
|
+
### Cursor: 룰 변환기
|
|
124
|
+
|
|
125
|
+
ai-nexus가 `.md` 룰을 Cursor의 `.mdc` 형식으로 변환하면서 `description`과 `alwaysApply` 메타데이터를 자동 추가합니다:
|
|
126
|
+
|
|
127
|
+
```markdown
|
|
128
|
+
---
|
|
129
|
+
description: Git 커밋 메시지 컨벤션 및 모범 사례
|
|
130
|
+
alwaysApply: false
|
|
131
|
+
---
|
|
132
|
+
|
|
133
|
+
# 커밋 룰
|
|
134
|
+
...
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
변환 후 룰 필터링은 **Cursor 내장 시맨틱 서치**가 처리합니다 — ai-nexus가 Cursor에서 라우터를 실행하지는 않습니다. 핵심 가치는 통합 룰 관리: 룰을 한 번 작성하면 Claude Code, Cursor, Codex에서 모두 사용할 수 있습니다.
|
|
138
|
+
|
|
139
|
+
### Codex: 정적 룰
|
|
140
|
+
|
|
141
|
+
세션 시작 시 단일 `AGENTS.md` 파일이 로드됩니다. 동적 로딩 없음.
|
|
142
|
+
|
|
143
|
+
---
|
|
144
|
+
|
|
145
|
+
## 명령어
|
|
146
|
+
|
|
147
|
+
| 명령어 | 설명 |
|
|
148
|
+
|--------|------|
|
|
149
|
+
| `install` | 전역 설치 (대화형 마법사) |
|
|
150
|
+
| `install -q` | 기본값으로 빠른 설치 |
|
|
151
|
+
| `init` | 현재 프로젝트에 설치 (`.claude/`) |
|
|
152
|
+
| `update` | 최신 룰로 동기화 (로컬 변경 보호) |
|
|
153
|
+
| `list` | 설치된 룰 목록 |
|
|
154
|
+
| `test <prompt>` | 어떤 룰이 로드될지 미리보기 |
|
|
155
|
+
| `search [keyword]` | 커뮤니티 레지스트리에서 룰 검색 |
|
|
156
|
+
| `get <filename>` | 커뮤니티 레지스트리에서 룰 다운로드 |
|
|
157
|
+
| `add <url>` | Git 저장소에서 룰 추가 |
|
|
158
|
+
| `remove <name>` | 룰 소스 제거 |
|
|
159
|
+
| `browse` | 브라우저에서 룰 마켓플레이스 열기 |
|
|
160
|
+
| `doctor` | 설치 상태 진단 |
|
|
161
|
+
| `uninstall` | ai-nexus 제거 |
|
|
162
|
+
|
|
163
|
+
---
|
|
164
|
+
|
|
165
|
+
## 팀 룰
|
|
166
|
+
|
|
167
|
+
Git을 통해 팀 전체에 룰을 공유하세요:
|
|
168
|
+
|
|
169
|
+
```bash
|
|
170
|
+
# 모든 팀원이 같은 소스에서 설치
|
|
171
|
+
npx ai-nexus install --rules github.com/acme/team-rules
|
|
172
|
+
|
|
173
|
+
# 룰 업데이트 시
|
|
174
|
+
npx ai-nexus update
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
### 룰 저장소 구조
|
|
178
|
+
|
|
179
|
+
```
|
|
180
|
+
team-rules/
|
|
181
|
+
├── config/
|
|
182
|
+
│ ├── rules/ # 핵심 룰 (essential.md, security.md)
|
|
183
|
+
│ ├── commands/ # 슬래시 커맨드 (/commit, /review)
|
|
184
|
+
│ ├── skills/ # 도메인 지식 (react.md, rust.md)
|
|
185
|
+
│ ├── agents/ # 서브 에이전트 (code-reviewer.md)
|
|
186
|
+
│ ├── contexts/ # 컨텍스트 파일 (@dev, @research)
|
|
187
|
+
│ ├── hooks/ # semantic-router.cjs
|
|
188
|
+
│ └── settings.json # Claude Code 훅 설정
|
|
189
|
+
└── README.md
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
### 룰 형식
|
|
193
|
+
|
|
194
|
+
```markdown
|
|
195
|
+
---
|
|
196
|
+
description: 이 룰을 로드할 시점 (시맨틱 라우터가 사용)
|
|
197
|
+
---
|
|
198
|
+
|
|
199
|
+
# 룰 제목
|
|
200
|
+
|
|
201
|
+
룰 내용...
|
|
202
|
+
```
|
|
203
|
+
|
|
204
|
+
---
|
|
205
|
+
|
|
206
|
+
## 설치 모드
|
|
207
|
+
|
|
208
|
+
### Symlink (기본값)
|
|
209
|
+
|
|
210
|
+
```bash
|
|
211
|
+
npx ai-nexus install
|
|
212
|
+
```
|
|
213
|
+
|
|
214
|
+
- 룰이 소스에 링크 → `update`로 즉시 동기화
|
|
215
|
+
- 룰을 직접 수정 불가 (소스에서 수정)
|
|
216
|
+
|
|
217
|
+
### Copy
|
|
218
|
+
|
|
219
|
+
```bash
|
|
220
|
+
npx ai-nexus install --copy
|
|
221
|
+
```
|
|
222
|
+
|
|
223
|
+
- 룰이 독립적인 복사본
|
|
224
|
+
- 로컬에서 자유롭게 수정 가능
|
|
225
|
+
- `update`는 새 파일만 추가, 기존 파일 덮어쓰지 않음
|
|
226
|
+
|
|
227
|
+
---
|
|
228
|
+
|
|
229
|
+
## 로컬 우선
|
|
230
|
+
|
|
231
|
+
사용자의 커스터마이징은 항상 안전합니다:
|
|
232
|
+
|
|
233
|
+
- **기존 파일은 절대 덮어쓰지 않음** (install, update 모두)
|
|
234
|
+
- 소스에서 새 파일만 추가
|
|
235
|
+
- `--force`로 강제 덮어쓰기 (백업 먼저!)
|
|
236
|
+
|
|
237
|
+
```bash
|
|
238
|
+
# 커스텀 commit.md를 덮어쓰지 않음
|
|
239
|
+
npx ai-nexus update
|
|
240
|
+
|
|
241
|
+
# 모든 파일 강제 덮어쓰기
|
|
242
|
+
npx ai-nexus update --force
|
|
243
|
+
```
|
|
244
|
+
|
|
245
|
+
---
|
|
246
|
+
|
|
247
|
+
## 디렉토리 구조
|
|
248
|
+
|
|
249
|
+
```
|
|
250
|
+
.ai-nexus/ # ai-nexus 메타데이터
|
|
251
|
+
├── config/ # 모든 소스에서 병합된 룰
|
|
252
|
+
├── sources/ # 클론된 Git 저장소
|
|
253
|
+
└── meta.json # 설치 정보
|
|
254
|
+
|
|
255
|
+
.claude/ # Claude Code
|
|
256
|
+
├── hooks/semantic-router.cjs
|
|
257
|
+
├── settings.json
|
|
258
|
+
├── rules/ → .ai-nexus/config/rules
|
|
259
|
+
└── commands/ → .ai-nexus/config/commands
|
|
260
|
+
|
|
261
|
+
.cursor/rules/ # Cursor (.mdc 파일)
|
|
262
|
+
├── essential.mdc
|
|
263
|
+
└── commit.mdc
|
|
264
|
+
|
|
265
|
+
.codex/AGENTS.md # Codex
|
|
266
|
+
```
|
|
267
|
+
|
|
268
|
+
---
|
|
269
|
+
|
|
270
|
+
## 사용 예시
|
|
271
|
+
|
|
272
|
+
### 개인 설정
|
|
273
|
+
|
|
274
|
+
```bash
|
|
275
|
+
npx ai-nexus install
|
|
276
|
+
# 선택: Claude Code, Cursor
|
|
277
|
+
# 선택: rules, commands, hooks, settings
|
|
278
|
+
# 템플릿: React/Next.js
|
|
279
|
+
# 모드: symlink
|
|
280
|
+
```
|
|
281
|
+
|
|
282
|
+
### 팀 설정
|
|
283
|
+
|
|
284
|
+
```bash
|
|
285
|
+
# 1. GitHub에 팀 룰 저장소 생성
|
|
286
|
+
|
|
287
|
+
# 2. 각 개발자:
|
|
288
|
+
npx ai-nexus install --rules github.com/acme/team-rules
|
|
289
|
+
|
|
290
|
+
# 3. 주간 동기화:
|
|
291
|
+
npx ai-nexus update
|
|
292
|
+
```
|
|
293
|
+
|
|
294
|
+
### 멀티 소스 설정
|
|
295
|
+
|
|
296
|
+
```bash
|
|
297
|
+
# 기본 회사 룰
|
|
298
|
+
npx ai-nexus install --rules github.com/acme/base-rules
|
|
299
|
+
|
|
300
|
+
# 프론트엔드 팀 룰 추가
|
|
301
|
+
npx ai-nexus add github.com/acme/frontend-rules
|
|
302
|
+
|
|
303
|
+
# 보안 룰 추가
|
|
304
|
+
npx ai-nexus add github.com/acme/security-rules
|
|
305
|
+
|
|
306
|
+
# 전체 업데이트
|
|
307
|
+
npx ai-nexus update
|
|
308
|
+
```
|
|
309
|
+
|
|
310
|
+
---
|
|
311
|
+
|
|
312
|
+
## 룰 마켓플레이스
|
|
313
|
+
|
|
314
|
+
|
|
315
|
+
|
|
316
|
+
웹 기반 마켓플레이스에서 룰을 검색, 설치, 제거할 수 있습니다:
|
|
317
|
+
|
|
318
|
+
```bash
|
|
319
|
+
npx ai-nexus browse
|
|
320
|
+
```
|
|
321
|
+
|
|
322
|
+
- 커뮤니티 룰 실시간 검색 및 카테고리 필터
|
|
323
|
+
- 브라우저에서 직접 설치/제거
|
|
324
|
+
- 도구 상태 (Claude Code, Cursor, Codex) 및 진단 확인
|
|
325
|
+
- `http://localhost:3847`에서 로컬 실행
|
|
326
|
+
|
|
327
|
+
---
|
|
328
|
+
|
|
329
|
+
## 커뮤니티 레지스트리
|
|
330
|
+
|
|
331
|
+
커뮤니티가 기여한 룰을 GitHub에서 직접 검색하고 다운로드하세요 — `npm publish` 불필요.
|
|
332
|
+
|
|
333
|
+
```bash
|
|
334
|
+
# 전체 룰 목록 보기
|
|
335
|
+
npx ai-nexus search
|
|
336
|
+
|
|
337
|
+
# 키워드로 검색
|
|
338
|
+
npx ai-nexus search react
|
|
339
|
+
```
|
|
340
|
+
|
|
341
|
+
```
|
|
342
|
+
Results for "react":
|
|
343
|
+
|
|
344
|
+
skills/
|
|
345
|
+
react.md - React/Next.js best practices
|
|
346
|
+
|
|
347
|
+
1 file(s) found.
|
|
348
|
+
Use "ai-nexus get <filename>" to download.
|
|
349
|
+
```
|
|
350
|
+
|
|
351
|
+
```bash
|
|
352
|
+
# 룰 다운로드
|
|
353
|
+
npx ai-nexus get react.md
|
|
354
|
+
|
|
355
|
+
# 동일 이름이 여러 카테고리에 있을 때 카테고리 지정
|
|
356
|
+
npx ai-nexus get commit.md --category commands
|
|
357
|
+
```
|
|
358
|
+
|
|
359
|
+
룰은 [최신 GitHub 저장소](https://github.com/JSK9999/ai-nexus/tree/main/config)에서 `~/.claude/`로 다운로드됩니다. PR로 새 룰을 기여하면 merge 즉시 `search`와 `get`으로 사용 가능합니다.
|
|
360
|
+
|
|
361
|
+
---
|
|
362
|
+
|
|
363
|
+
## 테스트
|
|
364
|
+
|
|
365
|
+
주어진 프롬프트에 어떤 룰이 로드될지 미리 확인:
|
|
366
|
+
|
|
367
|
+
```bash
|
|
368
|
+
$ npx ai-nexus test "react 컴포넌트에 hooks 사용해서 작성해줘"
|
|
369
|
+
|
|
370
|
+
Selected rules (3):
|
|
371
|
+
• rules/essential.md
|
|
372
|
+
• rules/react.md
|
|
373
|
+
• skills/react.md
|
|
374
|
+
```
|
|
375
|
+
|
|
376
|
+
---
|
|
377
|
+
|
|
378
|
+
## 기여하기
|
|
379
|
+
|
|
380
|
+
룰 기여를 환영합니다! 기여된 룰은 `ai-nexus search`와 `ai-nexus get`으로 즉시 사용 가능합니다 — npm publish 불필요.
|
|
381
|
+
|
|
382
|
+
1. **룰 제안**: [Rule Request 열기](https://github.com/JSK9999/ai-nexus/issues/new?template=rule-request.yml)
|
|
383
|
+
2. **룰 제출**: [CONTRIBUTING.md](CONTRIBUTING.md) 전체 가이드 참고
|
|
384
|
+
|
|
385
|
+
```bash
|
|
386
|
+
# 기여자 빠른 시작
|
|
387
|
+
git clone https://github.com/JSK9999/ai-nexus.git
|
|
388
|
+
cd ai-rules && npm install && npm run build
|
|
389
|
+
|
|
390
|
+
# config/rules/에 룰 추가 후 테스트:
|
|
391
|
+
node bin/ai-rules.cjs test "your prompt"
|
|
392
|
+
```
|
|
393
|
+
|
|
394
|
+
---
|
|
395
|
+
|
|
396
|
+
## 라이선스
|
|
397
|
+
|
|
398
|
+
Apache 2.0
|