@kood/claude-code 0.1.6 → 0.1.9
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/dist/index.js +109 -216
- package/package.json +8 -2
- package/templates/hono/CLAUDE.md +59 -328
- package/templates/hono/docs/architecture/architecture.md +93 -747
- package/templates/hono/docs/deployment/cloudflare.md +59 -513
- package/templates/hono/docs/deployment/docker.md +41 -356
- package/templates/hono/docs/deployment/index.md +54 -190
- package/templates/hono/docs/deployment/railway.md +36 -306
- package/templates/hono/docs/deployment/vercel.md +49 -434
- package/templates/hono/docs/library/ai-sdk/index.md +53 -290
- package/templates/hono/docs/library/ai-sdk/openrouter.md +19 -387
- package/templates/hono/docs/library/ai-sdk/providers.md +28 -394
- package/templates/hono/docs/library/ai-sdk/streaming.md +52 -353
- package/templates/hono/docs/library/ai-sdk/structured-output.md +63 -395
- package/templates/hono/docs/library/ai-sdk/tools.md +62 -431
- package/templates/hono/docs/library/hono/env-setup.md +24 -313
- package/templates/hono/docs/library/hono/error-handling.md +34 -295
- package/templates/hono/docs/library/hono/index.md +29 -121
- package/templates/hono/docs/library/hono/middleware.md +21 -188
- package/templates/hono/docs/library/hono/rpc.md +40 -341
- package/templates/hono/docs/library/hono/validation.md +35 -195
- package/templates/hono/docs/library/pino/index.md +42 -333
- package/templates/hono/docs/library/prisma/cloudflare-d1.md +64 -367
- package/templates/hono/docs/library/prisma/config.md +19 -260
- package/templates/hono/docs/library/prisma/index.md +67 -320
- package/templates/hono/docs/library/zod/index.md +53 -257
- package/templates/npx/CLAUDE.md +62 -274
- package/templates/npx/docs/references/patterns.md +160 -0
- package/templates/tanstack-start/CLAUDE.md +100 -256
- package/templates/tanstack-start/docs/architecture/architecture.md +44 -589
- package/templates/tanstack-start/docs/deployment/cloudflare.md +37 -424
- package/templates/tanstack-start/docs/deployment/index.md +57 -286
- package/templates/tanstack-start/docs/deployment/nitro.md +36 -318
- package/templates/tanstack-start/docs/deployment/railway.md +40 -409
- package/templates/tanstack-start/docs/deployment/vercel.md +43 -465
- package/templates/tanstack-start/docs/design/components.md +77 -311
- package/templates/tanstack-start/docs/design/index.md +113 -69
- package/templates/tanstack-start/docs/design/safe-area.md +51 -250
- package/templates/tanstack-start/docs/design/tailwind-setup.md +45 -359
- package/templates/tanstack-start/docs/guides/conventions.md +103 -0
- package/templates/tanstack-start/docs/guides/env-setup.md +34 -340
- package/templates/tanstack-start/docs/guides/getting-started.md +22 -209
- package/templates/tanstack-start/docs/guides/hooks.md +166 -0
- package/templates/tanstack-start/docs/guides/routes.md +166 -0
- package/templates/tanstack-start/docs/guides/services.md +143 -0
- package/templates/tanstack-start/docs/library/better-auth/2fa.md +27 -115
- package/templates/tanstack-start/docs/library/better-auth/advanced.md +22 -105
- package/templates/tanstack-start/docs/library/better-auth/index.md +17 -66
- package/templates/tanstack-start/docs/library/better-auth/plugins.md +11 -88
- package/templates/tanstack-start/docs/library/better-auth/session.md +12 -92
- package/templates/tanstack-start/docs/library/better-auth/setup.md +9 -91
- package/templates/tanstack-start/docs/library/prisma/cloudflare-d1.md +30 -358
- package/templates/tanstack-start/docs/library/prisma/config.md +27 -327
- package/templates/tanstack-start/docs/library/prisma/crud.md +46 -174
- package/templates/tanstack-start/docs/library/prisma/index.md +23 -113
- package/templates/tanstack-start/docs/library/prisma/relations.md +31 -153
- package/templates/tanstack-start/docs/library/prisma/schema.md +40 -217
- package/templates/tanstack-start/docs/library/prisma/setup.md +12 -112
- package/templates/tanstack-start/docs/library/prisma/transactions.md +20 -110
- package/templates/tanstack-start/docs/library/tanstack-query/index.md +26 -97
- package/templates/tanstack-start/docs/library/tanstack-query/invalidation.md +28 -107
- package/templates/tanstack-start/docs/library/tanstack-query/optimistic-updates.md +44 -146
- package/templates/tanstack-start/docs/library/tanstack-query/use-mutation.md +33 -127
- package/templates/tanstack-start/docs/library/tanstack-query/use-query.md +49 -149
- package/templates/tanstack-start/docs/library/tanstack-start/auth-patterns.md +19 -112
- package/templates/tanstack-start/docs/library/tanstack-start/index.md +33 -80
- package/templates/tanstack-start/docs/library/tanstack-start/middleware.md +28 -106
- package/templates/tanstack-start/docs/library/tanstack-start/routing.md +21 -118
- package/templates/tanstack-start/docs/library/tanstack-start/server-functions.md +34 -246
- package/templates/tanstack-start/docs/library/tanstack-start/setup.md +6 -39
- package/templates/tanstack-start/docs/library/zod/complex-types.md +32 -156
- package/templates/tanstack-start/docs/library/zod/index.md +31 -144
- package/templates/tanstack-start/docs/library/zod/transforms.md +20 -129
- package/templates/tanstack-start/docs/library/zod/validation.md +39 -155
- package/templates/hono/docs/commands/git.md +0 -145
- package/templates/hono/docs/mcp/context7.md +0 -106
- package/templates/hono/docs/mcp/index.md +0 -176
- package/templates/hono/docs/mcp/sequential-thinking.md +0 -101
- package/templates/hono/docs/mcp/serena.md +0 -269
- package/templates/hono/docs/mcp/sgrep.md +0 -105
- package/templates/hono/docs/skills/gemini-review/SKILL.md +0 -220
- package/templates/hono/docs/skills/gemini-review/references/checklists.md +0 -136
- package/templates/hono/docs/skills/gemini-review/references/prompt-templates.md +0 -303
- package/templates/npx/docs/commands/git.md +0 -145
- package/templates/npx/docs/mcp/index.md +0 -60
- package/templates/npx/docs/skills/gemini-review/SKILL.md +0 -220
- package/templates/npx/docs/skills/gemini-review/references/checklists.md +0 -134
- package/templates/npx/docs/skills/gemini-review/references/prompt-templates.md +0 -301
- package/templates/tanstack-start/docs/commands/git.md +0 -145
- package/templates/tanstack-start/docs/design/accessibility.md +0 -433
- package/templates/tanstack-start/docs/design/color.md +0 -235
- package/templates/tanstack-start/docs/design/spacing.md +0 -341
- package/templates/tanstack-start/docs/design/typography.md +0 -324
- package/templates/tanstack-start/docs/guides/best-practices.md +0 -950
- package/templates/tanstack-start/docs/guides/husky-lint-staged.md +0 -303
- package/templates/tanstack-start/docs/guides/prettier.md +0 -189
- package/templates/tanstack-start/docs/guides/project-templates.md +0 -710
- package/templates/tanstack-start/docs/library/tanstack-query/setup.md +0 -107
- package/templates/tanstack-start/docs/library/zod/basic-types.md +0 -186
- package/templates/tanstack-start/docs/mcp/context7.md +0 -204
- package/templates/tanstack-start/docs/mcp/index.md +0 -177
- package/templates/tanstack-start/docs/mcp/sequential-thinking.md +0 -180
- package/templates/tanstack-start/docs/mcp/serena.md +0 -269
- package/templates/tanstack-start/docs/mcp/sgrep.md +0 -174
- package/templates/tanstack-start/docs/skills/gemini-review/SKILL.md +0 -220
- package/templates/tanstack-start/docs/skills/gemini-review/references/checklists.md +0 -144
- package/templates/tanstack-start/docs/skills/gemini-review/references/prompt-templates.md +0 -292
|
@@ -1,145 +0,0 @@
|
|
|
1
|
-
현재 git 상태를 확인하고, 아래 규칙에 따라 작업을 진행해주세요.
|
|
2
|
-
|
|
3
|
-
**추가 지시사항**: $ARGUMENTS
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
## 실행 절차
|
|
8
|
-
|
|
9
|
-
### 추가 지시사항이 없는 경우 (기본 동작)
|
|
10
|
-
1. `git status`로 현재 상태 확인
|
|
11
|
-
2. `git diff`로 변경 내용 분석
|
|
12
|
-
3. 스테이징 안 된 변경사항 → `git add`
|
|
13
|
-
4. 커밋 안 된 변경사항 → 논리적 단위로 분리하여 `git commit`
|
|
14
|
-
5. 최종 `git status`로 완료 확인
|
|
15
|
-
|
|
16
|
-
### 추가 지시사항이 있는 경우
|
|
17
|
-
- 사용자의 지시사항을 우선적으로 따름
|
|
18
|
-
- 예: `/git push` → push 진행, `/git 특정파일만 커밋` → 해당 파일만 처리
|
|
19
|
-
|
|
20
|
-
---
|
|
21
|
-
|
|
22
|
-
## ⛔ NEVER (절대 금지)
|
|
23
|
-
|
|
24
|
-
```
|
|
25
|
-
❌ 커밋에 "Generated with Claude Code" 포함
|
|
26
|
-
❌ 커밋에 "🤖" 또는 AI 관련 이모지 포함
|
|
27
|
-
❌ 커밋에 "Co-Authored-By:" 헤더 포함
|
|
28
|
-
❌ 커밋에 AI/봇이 작성했다는 어떤 표시도 포함
|
|
29
|
-
❌ 커밋 메시지 여러 줄 작성
|
|
30
|
-
❌ 커밋 메시지에 이모지 사용
|
|
31
|
-
❌ 커밋 메시지에 마침표(.) 사용
|
|
32
|
-
❌ 여러 작업을 하나의 커밋으로 퉁치기
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
---
|
|
36
|
-
|
|
37
|
-
## ✅ ALWAYS (필수)
|
|
38
|
-
|
|
39
|
-
### 커밋 형식
|
|
40
|
-
|
|
41
|
-
```
|
|
42
|
-
<prefix>: <설명>
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
**한 줄로 간결하게** 작성합니다. 본문이나 푸터는 작성하지 않습니다.
|
|
46
|
-
|
|
47
|
-
### ⭐ 커밋 분리 원칙
|
|
48
|
-
|
|
49
|
-
**하나의 커밋 = 하나의 논리적 변경 단위**
|
|
50
|
-
|
|
51
|
-
```bash
|
|
52
|
-
# ❌ 잘못된 방식: 모든 작업을 하나로 퉁침
|
|
53
|
-
git add .
|
|
54
|
-
git commit -m "feat: 여러 기능 추가"
|
|
55
|
-
|
|
56
|
-
# ✅ 올바른 방식: 논리적 단위로 분리
|
|
57
|
-
git add src/auth/
|
|
58
|
-
git commit -m "feat: 사용자 인증 기능 추가"
|
|
59
|
-
|
|
60
|
-
git add src/users/
|
|
61
|
-
git commit -m "feat: 사용자 관리 기능 추가"
|
|
62
|
-
|
|
63
|
-
git add docs/
|
|
64
|
-
git commit -m "docs: API 문서 업데이트"
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
---
|
|
68
|
-
|
|
69
|
-
## 🏷 Prefix 목록
|
|
70
|
-
|
|
71
|
-
| Prefix | 용도 | 예시 |
|
|
72
|
-
|--------|------|------|
|
|
73
|
-
| `feat` | 새로운 기능 | `feat: 사용자 인증 기능 추가` |
|
|
74
|
-
| `fix` | 버그 수정 | `fix: 토큰 검증 오류 수정` |
|
|
75
|
-
| `refactor` | 리팩토링 | `refactor: 인증 로직 분리` |
|
|
76
|
-
| `style` | 코드 스타일 | `style: prettier 적용` |
|
|
77
|
-
| `docs` | 문서 수정 | `docs: API 문서 업데이트` |
|
|
78
|
-
| `test` | 테스트 | `test: 인증 테스트 추가` |
|
|
79
|
-
| `chore` | 빌드/설정 | `chore: 의존성 업데이트` |
|
|
80
|
-
| `perf` | 성능 개선 | `perf: 쿼리 최적화` |
|
|
81
|
-
| `ci` | CI/CD | `ci: GitHub Actions 추가` |
|
|
82
|
-
|
|
83
|
-
---
|
|
84
|
-
|
|
85
|
-
## ✅ 올바른 예시
|
|
86
|
-
|
|
87
|
-
```bash
|
|
88
|
-
feat: 사용자 로그인 기능 추가
|
|
89
|
-
fix: 세션 만료 오류 수정
|
|
90
|
-
refactor: 서비스 클래스 구조 개선
|
|
91
|
-
docs: README 설치 가이드 추가
|
|
92
|
-
chore: 의존성 버전 업그레이드
|
|
93
|
-
```
|
|
94
|
-
|
|
95
|
-
---
|
|
96
|
-
|
|
97
|
-
## ❌ 잘못된 예시
|
|
98
|
-
|
|
99
|
-
```bash
|
|
100
|
-
# prefix 없음
|
|
101
|
-
사용자 인증 기능 추가함
|
|
102
|
-
|
|
103
|
-
# 마침표 불필요
|
|
104
|
-
feat: 사용자 인증 추가.
|
|
105
|
-
|
|
106
|
-
# 대문자 사용
|
|
107
|
-
FEAT: 사용자 인증 추가
|
|
108
|
-
|
|
109
|
-
# scope 불필요
|
|
110
|
-
feat(auth): 인증 추가
|
|
111
|
-
|
|
112
|
-
# AI 작성 표시 (절대 금지!)
|
|
113
|
-
feat: 로그인 기능 추가
|
|
114
|
-
|
|
115
|
-
🤖 Generated with Claude Code
|
|
116
|
-
|
|
117
|
-
# Co-Author 표시 (절대 금지!)
|
|
118
|
-
feat: 로그인 기능 추가
|
|
119
|
-
|
|
120
|
-
Co-Authored-By: Claude <noreply@anthropic.com>
|
|
121
|
-
|
|
122
|
-
# 여러 줄 본문 (금지)
|
|
123
|
-
feat: 로그인 기능 추가
|
|
124
|
-
|
|
125
|
-
- 이메일 인증 추가
|
|
126
|
-
- 세션 관리 구현
|
|
127
|
-
|
|
128
|
-
# 여러 작업을 하나로 퉁침 (금지)
|
|
129
|
-
feat: 로그인, 회원가입, 프로필 기능 추가
|
|
130
|
-
```
|
|
131
|
-
|
|
132
|
-
---
|
|
133
|
-
|
|
134
|
-
## 📦 커밋 분리 가이드
|
|
135
|
-
|
|
136
|
-
### 언제 커밋을 분리해야 하나요?
|
|
137
|
-
|
|
138
|
-
| 상황 | 커밋 분리 |
|
|
139
|
-
|------|----------|
|
|
140
|
-
| 서로 다른 기능 구현 | ✅ 분리 |
|
|
141
|
-
| 버그 수정 + 새 기능 | ✅ 분리 |
|
|
142
|
-
| 코드 변경 + 문서 변경 | ✅ 분리 |
|
|
143
|
-
| 리팩토링 + 기능 추가 | ✅ 분리 |
|
|
144
|
-
| 동일 기능의 관련 파일들 | 🔄 묶어도 됨 |
|
|
145
|
-
| 동일 기능의 타입 + 구현 | 🔄 묶어도 됨 |
|
|
@@ -1,106 +0,0 @@
|
|
|
1
|
-
# Context7
|
|
2
|
-
|
|
3
|
-
> 라이브러리 공식 문서 조회 도구
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
## 개요
|
|
8
|
-
|
|
9
|
-
Context7은 주요 라이브러리의 공식 문서를 조회하여 정확한 API 정보와 사용 패턴을 제공합니다.
|
|
10
|
-
|
|
11
|
-
---
|
|
12
|
-
|
|
13
|
-
## 사용 시점
|
|
14
|
-
|
|
15
|
-
### ✅ 사용 권장
|
|
16
|
-
- **API 확인**: 라이브러리 함수/메서드 사용법
|
|
17
|
-
- **공식 패턴**: 권장되는 코드 패턴
|
|
18
|
-
- **버전별 차이**: 특정 버전의 API 확인
|
|
19
|
-
- **최신 정보**: 최신 릴리즈 기능 확인
|
|
20
|
-
|
|
21
|
-
### ❌ 사용 불필요
|
|
22
|
-
- 이미 알고 있는 기본 API
|
|
23
|
-
- 프로젝트 내부 코드 관련 질문
|
|
24
|
-
- 일반적인 프로그래밍 개념
|
|
25
|
-
|
|
26
|
-
---
|
|
27
|
-
|
|
28
|
-
## 지원 라이브러리
|
|
29
|
-
|
|
30
|
-
### 주요 지원
|
|
31
|
-
- **Hono**: 라우팅, 미들웨어, RPC
|
|
32
|
-
- **Zod**: 스키마 정의, 검증
|
|
33
|
-
- **Prisma**: ORM, 쿼리, 마이그레이션
|
|
34
|
-
- **TypeScript**: 타입 시스템
|
|
35
|
-
|
|
36
|
-
### 기타 지원
|
|
37
|
-
- React, Vue, Angular
|
|
38
|
-
- Express, Fastify
|
|
39
|
-
- 기타 주요 npm 패키지
|
|
40
|
-
|
|
41
|
-
---
|
|
42
|
-
|
|
43
|
-
## 사용 예시
|
|
44
|
-
|
|
45
|
-
### Hono 문서 조회
|
|
46
|
-
```
|
|
47
|
-
"Hono의 zValidator 사용법 조회"
|
|
48
|
-
"Hono middleware 작성 패턴 조회"
|
|
49
|
-
"Hono RPC client 설정 방법 조회"
|
|
50
|
-
```
|
|
51
|
-
|
|
52
|
-
### Zod 문서 조회
|
|
53
|
-
```
|
|
54
|
-
"Zod v4의 z.email() 사용법 조회"
|
|
55
|
-
"Zod transform 패턴 조회"
|
|
56
|
-
"Zod discriminatedUnion 사용법 조회"
|
|
57
|
-
```
|
|
58
|
-
|
|
59
|
-
### Prisma 문서 조회
|
|
60
|
-
```
|
|
61
|
-
"Prisma v7 generator 설정 조회"
|
|
62
|
-
"Prisma transaction 패턴 조회"
|
|
63
|
-
"Prisma relation 쿼리 방법 조회"
|
|
64
|
-
```
|
|
65
|
-
|
|
66
|
-
---
|
|
67
|
-
|
|
68
|
-
## 장점
|
|
69
|
-
|
|
70
|
-
### 1. 정확한 정보
|
|
71
|
-
- 공식 문서 기반
|
|
72
|
-
- 검증된 코드 예시
|
|
73
|
-
|
|
74
|
-
### 2. 최신 정보
|
|
75
|
-
- 최신 버전 반영
|
|
76
|
-
- 업데이트된 API
|
|
77
|
-
|
|
78
|
-
### 3. 버전 특정
|
|
79
|
-
- 특정 버전 문서 조회
|
|
80
|
-
- 버전 간 차이 확인
|
|
81
|
-
|
|
82
|
-
---
|
|
83
|
-
|
|
84
|
-
## 워크플로우
|
|
85
|
-
|
|
86
|
-
```
|
|
87
|
-
1. 필요한 정보 파악
|
|
88
|
-
└─ 어떤 라이브러리의 어떤 기능?
|
|
89
|
-
|
|
90
|
-
2. Context7 조회
|
|
91
|
-
└─ 해당 라이브러리 문서 검색
|
|
92
|
-
|
|
93
|
-
3. 정보 확인
|
|
94
|
-
└─ API 시그니처, 사용 예시
|
|
95
|
-
|
|
96
|
-
4. 코드 적용
|
|
97
|
-
└─ 프로젝트에 맞게 적용
|
|
98
|
-
```
|
|
99
|
-
|
|
100
|
-
---
|
|
101
|
-
|
|
102
|
-
## 관련 문서
|
|
103
|
-
|
|
104
|
-
- [MCP 개요](./index.md)
|
|
105
|
-
- [sgrep](./sgrep.md)
|
|
106
|
-
- [Sequential Thinking](./sequential-thinking.md)
|
|
@@ -1,176 +0,0 @@
|
|
|
1
|
-
# MCP (Model Context Protocol)
|
|
2
|
-
|
|
3
|
-
> Claude Code 작업 효율성을 높이는 MCP 서버 활용 가이드
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
## ⛔ 프로젝트 시작 전 필수 확인
|
|
8
|
-
|
|
9
|
-
**작업 시작 전 반드시 아래 3가지 MCP가 활성화되어 있는지 확인하세요:**
|
|
10
|
-
|
|
11
|
-
```
|
|
12
|
-
1. Serena - 프로젝트 활성화 확인
|
|
13
|
-
→ mcp__serena__get_current_config 호출
|
|
14
|
-
→ 프로젝트 미활성화 시: mcp__serena__activate_project
|
|
15
|
-
|
|
16
|
-
2. Sequential Thinking - 복잡한 문제 분석용
|
|
17
|
-
→ 사용 가능 여부 확인
|
|
18
|
-
|
|
19
|
-
3. sgrep - 코드베이스 검색용
|
|
20
|
-
→ grep/rg 대신 반드시 sgrep 사용
|
|
21
|
-
```
|
|
22
|
-
|
|
23
|
-
---
|
|
24
|
-
|
|
25
|
-
## 🚨 필수 사용 규칙
|
|
26
|
-
|
|
27
|
-
```
|
|
28
|
-
✅ 프로젝트 시작 전 → Serena 활성화 확인 (필수!)
|
|
29
|
-
✅ 코드베이스 검색 → sgrep 사용 (grep/rg 금지)
|
|
30
|
-
✅ 복잡한 분석/디버깅 → Sequential Thinking 사용
|
|
31
|
-
✅ 라이브러리 문서 조회 → Context7 사용
|
|
32
|
-
✅ 세션 컨텍스트 유지 → Serena 메모리 활용
|
|
33
|
-
✅ 도구 조합: sgrep로 위치 파악 → Sequential로 분석 → Context7로 문서 확인
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
---
|
|
37
|
-
|
|
38
|
-
## 🚀 Quick Reference
|
|
39
|
-
|
|
40
|
-
### Serena - 프로젝트 컨텍스트 관리 (필수)
|
|
41
|
-
|
|
42
|
-
```
|
|
43
|
-
프로젝트 시작 시 (필수):
|
|
44
|
-
1. get_current_config → 현재 상태 확인
|
|
45
|
-
2. activate_project → 프로젝트 활성화
|
|
46
|
-
3. check_onboarding_performed → 온보딩 확인
|
|
47
|
-
|
|
48
|
-
사용 시점:
|
|
49
|
-
- 프로젝트 시작/재개 시 (필수)
|
|
50
|
-
- 심볼 탐색/수정
|
|
51
|
-
- 세션 간 컨텍스트 유지 (메모리)
|
|
52
|
-
```
|
|
53
|
-
|
|
54
|
-
### Sequential Thinking - 복잡한 문제 해결
|
|
55
|
-
|
|
56
|
-
```
|
|
57
|
-
사용 시점:
|
|
58
|
-
- 버그 분석 및 디버깅
|
|
59
|
-
- 아키텍처 설계
|
|
60
|
-
- 복잡한 로직 구현
|
|
61
|
-
- 코드 리팩토링 계획
|
|
62
|
-
- 성능 최적화 분석
|
|
63
|
-
|
|
64
|
-
사용법: 문제를 단계별로 분해하여 체계적으로 해결
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
### sgrep - 코드베이스 검색 (필수)
|
|
68
|
-
|
|
69
|
-
```
|
|
70
|
-
사용 시점:
|
|
71
|
-
- 코드 위치 파악
|
|
72
|
-
- 자연어 검색
|
|
73
|
-
- 심볼 참조 찾기
|
|
74
|
-
|
|
75
|
-
주의: grep/rg 대신 반드시 sgrep 사용!
|
|
76
|
-
```
|
|
77
|
-
|
|
78
|
-
### Context7 - 라이브러리 문서 조회
|
|
79
|
-
|
|
80
|
-
```
|
|
81
|
-
사용 시점:
|
|
82
|
-
- API 사용법 확인
|
|
83
|
-
- 라이브러리 최신 문법 확인
|
|
84
|
-
- 공식 문서 기반 구현
|
|
85
|
-
- 버전별 변경사항 확인
|
|
86
|
-
|
|
87
|
-
사용법:
|
|
88
|
-
1. resolve-library-id로 라이브러리 ID 조회
|
|
89
|
-
2. get-library-docs로 문서 가져오기
|
|
90
|
-
```
|
|
91
|
-
|
|
92
|
-
---
|
|
93
|
-
|
|
94
|
-
## 📁 문서 구조
|
|
95
|
-
|
|
96
|
-
```
|
|
97
|
-
docs/mcp/
|
|
98
|
-
├── index.md # 이 문서 (개요)
|
|
99
|
-
├── serena.md # Serena 프로젝트 관리 (필수)
|
|
100
|
-
├── sgrep.md # 코드베이스 검색 (필수)
|
|
101
|
-
├── sequential-thinking.md # Sequential Thinking 상세 (필수)
|
|
102
|
-
└── context7.md # Context7 상세
|
|
103
|
-
```
|
|
104
|
-
|
|
105
|
-
---
|
|
106
|
-
|
|
107
|
-
## 📋 도구 목록
|
|
108
|
-
|
|
109
|
-
| 도구 | 용도 | 필수 여부 |
|
|
110
|
-
|-----|------|----------|
|
|
111
|
-
| [Serena](./serena.md) | 프로젝트 컨텍스트 관리 | ⭐ 필수 |
|
|
112
|
-
| [sgrep](./sgrep.md) | 코드베이스 검색 | ⭐ 필수 |
|
|
113
|
-
| [Sequential Thinking](./sequential-thinking.md) | 체계적 문제 해결 | ⭐ 필수 |
|
|
114
|
-
| [Context7](./context7.md) | 라이브러리 문서 | 권장 |
|
|
115
|
-
|
|
116
|
-
---
|
|
117
|
-
|
|
118
|
-
## ⚡ 작업별 MCP 선택 가이드
|
|
119
|
-
|
|
120
|
-
### 프로젝트 시작 (필수)
|
|
121
|
-
```
|
|
122
|
-
1. Serena: get_current_config로 상태 확인
|
|
123
|
-
2. Serena: activate_project로 프로젝트 활성화
|
|
124
|
-
3. Serena: list_memories로 이전 컨텍스트 확인
|
|
125
|
-
```
|
|
126
|
-
|
|
127
|
-
### 버그 수정
|
|
128
|
-
```
|
|
129
|
-
1. sgrep로 관련 코드 위치 파악
|
|
130
|
-
2. Sequential Thinking으로 문제 분석
|
|
131
|
-
3. 원인 파악 후 Context7로 관련 API 확인
|
|
132
|
-
4. 수정 구현
|
|
133
|
-
```
|
|
134
|
-
|
|
135
|
-
### 새 기능 구현
|
|
136
|
-
```
|
|
137
|
-
1. sgrep로 기존 패턴 검색
|
|
138
|
-
2. Sequential Thinking으로 구현 계획 수립
|
|
139
|
-
3. Context7로 사용할 라이브러리 문서 확인
|
|
140
|
-
4. 단계별 구현
|
|
141
|
-
5. Serena: write_memory로 주요 결정 저장
|
|
142
|
-
```
|
|
143
|
-
|
|
144
|
-
### 라이브러리 사용
|
|
145
|
-
```
|
|
146
|
-
1. Context7로 공식 문서 조회
|
|
147
|
-
2. 필요시 Sequential Thinking으로 복잡한 통합 분석
|
|
148
|
-
```
|
|
149
|
-
|
|
150
|
-
### 성능 최적화
|
|
151
|
-
```
|
|
152
|
-
1. sgrep로 병목 의심 코드 검색
|
|
153
|
-
2. Sequential Thinking으로 병목 분석
|
|
154
|
-
3. Context7로 최적화 관련 API 확인
|
|
155
|
-
4. 개선 구현
|
|
156
|
-
```
|
|
157
|
-
|
|
158
|
-
### 코드베이스 탐색
|
|
159
|
-
```
|
|
160
|
-
1. sgrep로 자연어 쿼리 검색
|
|
161
|
-
2. 관련 코드 위치 파악
|
|
162
|
-
3. 필요시 Sequential Thinking으로 흐름 분석
|
|
163
|
-
```
|
|
164
|
-
|
|
165
|
-
### 세션 종료
|
|
166
|
-
```
|
|
167
|
-
1. Serena: write_memory로 진행 상황 저장
|
|
168
|
-
2. 다음 세션에서 read_memory로 복구
|
|
169
|
-
```
|
|
170
|
-
|
|
171
|
-
---
|
|
172
|
-
|
|
173
|
-
## 🔗 관련 문서
|
|
174
|
-
|
|
175
|
-
- [Hono](../library/hono/index.md) - Web Framework
|
|
176
|
-
- [Zod](../library/zod/index.md) - Validation
|
|
@@ -1,101 +0,0 @@
|
|
|
1
|
-
# Sequential Thinking
|
|
2
|
-
|
|
3
|
-
> 복잡한 문제를 단계별로 분석하는 사고 도구
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
## 개요
|
|
8
|
-
|
|
9
|
-
Sequential Thinking은 복잡한 문제를 체계적으로 분석하고 해결하기 위한 MCP 도구입니다.
|
|
10
|
-
|
|
11
|
-
---
|
|
12
|
-
|
|
13
|
-
## 사용 시점
|
|
14
|
-
|
|
15
|
-
### ✅ 사용 권장
|
|
16
|
-
- **복잡한 버그 디버깅**: 원인 파악이 어려운 버그
|
|
17
|
-
- **아키텍처 분석/설계**: 시스템 구조 이해 및 설계
|
|
18
|
-
- **성능 병목 분석**: 성능 문제 원인 파악
|
|
19
|
-
- **리팩토링 계획**: 대규모 코드 변경 계획
|
|
20
|
-
- **보안 취약점 분석**: 보안 이슈 탐지 및 해결
|
|
21
|
-
|
|
22
|
-
### ❌ 사용 불필요
|
|
23
|
-
- 단순한 코드 작성
|
|
24
|
-
- 명확한 버그 수정
|
|
25
|
-
- 간단한 질문 응답
|
|
26
|
-
|
|
27
|
-
---
|
|
28
|
-
|
|
29
|
-
## 분석 프로세스
|
|
30
|
-
|
|
31
|
-
```
|
|
32
|
-
1. 문제 정의
|
|
33
|
-
└─ 무엇을 해결해야 하는가?
|
|
34
|
-
|
|
35
|
-
2. 정보 수집
|
|
36
|
-
└─ 관련 코드, 로그, 에러 메시지
|
|
37
|
-
|
|
38
|
-
3. 가설 설정
|
|
39
|
-
└─ 가능한 원인들 나열
|
|
40
|
-
|
|
41
|
-
4. 가설 검증
|
|
42
|
-
└─ 각 가설을 코드/데이터로 검증
|
|
43
|
-
|
|
44
|
-
5. 결론 도출
|
|
45
|
-
└─ 검증된 원인과 해결책
|
|
46
|
-
|
|
47
|
-
6. 실행 계획
|
|
48
|
-
└─ 구체적인 수정 단계
|
|
49
|
-
```
|
|
50
|
-
|
|
51
|
-
---
|
|
52
|
-
|
|
53
|
-
## 예시 상황
|
|
54
|
-
|
|
55
|
-
### 복잡한 버그 디버깅
|
|
56
|
-
```
|
|
57
|
-
문제: "API 응답이 간헐적으로 느림"
|
|
58
|
-
|
|
59
|
-
Sequential Thinking 활용:
|
|
60
|
-
1. 느린 요청의 패턴 분석
|
|
61
|
-
2. 가능한 원인 나열 (DB, 네트워크, 코드)
|
|
62
|
-
3. 각 원인별 증거 수집
|
|
63
|
-
4. 병목 지점 확인
|
|
64
|
-
5. 해결책 제시
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
### 아키텍처 분석
|
|
68
|
-
```
|
|
69
|
-
문제: "마이크로서비스 분리 계획"
|
|
70
|
-
|
|
71
|
-
Sequential Thinking 활용:
|
|
72
|
-
1. 현재 모놀리스 구조 분석
|
|
73
|
-
2. 도메인 경계 식별
|
|
74
|
-
3. 의존성 그래프 작성
|
|
75
|
-
4. 분리 우선순위 결정
|
|
76
|
-
5. 마이그레이션 계획 수립
|
|
77
|
-
```
|
|
78
|
-
|
|
79
|
-
---
|
|
80
|
-
|
|
81
|
-
## 장점
|
|
82
|
-
|
|
83
|
-
### 1. 체계적 접근
|
|
84
|
-
- 단계별 사고 과정 기록
|
|
85
|
-
- 놓치는 부분 최소화
|
|
86
|
-
|
|
87
|
-
### 2. 가설 기반 분석
|
|
88
|
-
- 추측이 아닌 검증 기반
|
|
89
|
-
- 명확한 근거 제시
|
|
90
|
-
|
|
91
|
-
### 3. 재사용 가능
|
|
92
|
-
- 분석 과정 문서화
|
|
93
|
-
- 유사 문제에 적용 가능
|
|
94
|
-
|
|
95
|
-
---
|
|
96
|
-
|
|
97
|
-
## 관련 문서
|
|
98
|
-
|
|
99
|
-
- [MCP 개요](./index.md)
|
|
100
|
-
- [sgrep](./sgrep.md)
|
|
101
|
-
- [Context7](./context7.md)
|