Skip to content

docs: add comprehensive Korean documentation in .docs folder #997

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open

docs: add comprehensive Korean documentation in .docs folder #997

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
f883e26
docs: add comprehensive Korean documentation in .docs folder
claude Nov 9, 2025
efff6e8
docs: add comprehensive prompt system documentation in .docs/prompts
claude Nov 9, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
138 changes: 138 additions & 0 deletions .docs/01-project-overview.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,138 @@
# ν”„λ‘œμ νŠΈ κ°œμš”

## Qwen Codeλž€?

**Qwen Code**λŠ” AI 기반 λͺ…령쀄 μΈν„°νŽ˜μ΄μŠ€(CLI) λ„κ΅¬λ‘œ, κ°œλ°œμžκ°€ ν„°λ―Έλ„μ—μ„œ 직접 AI λͺ¨λΈκ³Ό μƒν˜Έμž‘μš©ν•˜λ©° μ†Œν”„νŠΈμ›¨μ–΄ 개발 μž‘μ—…μ„ μˆ˜ν–‰ν•  수 μžˆλ„λ‘ μ„€κ³„λ˜μ—ˆμŠ΅λ‹ˆλ‹€.

이 ν”„λ‘œμ νŠΈλŠ” Google의 Gemini CLIλ₯Ό 기반으둜 ν•˜μ—¬ Qwen3-Coder λͺ¨λΈμ— μ΅œμ ν™”λ˜μ—ˆμœΌλ©°, 개발자의 생산성을 κ·ΉλŒ€ν™”ν•˜κΈ° μœ„ν•œ λ‹€μ–‘ν•œ κΈ°λŠ₯을 μ œκ³΅ν•©λ‹ˆλ‹€.

## ν”„λ‘œμ νŠΈ λͺ©μ 

Qwen CodeλŠ” λ‹€μŒκ³Ό 같은 λͺ©μ μ„ 가지고 κ°œλ°œλ˜μ—ˆμŠ΅λ‹ˆλ‹€:

1. **개발 μ›Œν¬ν”Œλ‘œμš° μžλ™ν™”**: 반볡적인 μ½”λ”© μž‘μ—…μ„ AI둜 μžλ™ν™”
2. **μ½”λ“œ 이해 ν–₯상**: λŒ€κ·œλͺ¨ μ½”λ“œλ² μ΄μŠ€λ₯Ό λΉ λ₯΄κ²Œ μ΄ν•΄ν•˜κ³  뢄석
3. **AI 기반 μ½”λ“œ μž‘μ„±**: μžμ—°μ–΄λ‘œ μš”μ²­ν•˜μ—¬ μ½”λ“œ 생성 및 λ¦¬νŒ©ν† λ§
4. **터미널 쀑심 μ›Œν¬ν”Œλ‘œμš°**: IDEλ₯Ό λ²—μ–΄λ‚˜ ν„°λ―Έλ„μ—μ„œ λͺ¨λ“  μž‘μ—… μˆ˜ν–‰
5. **무료 AI μ ‘κ·Ό**: Qwen OAuthλ₯Ό 톡해 ν•˜λ£¨ 2,000회 무료 μš”μ²­ 제곡

## μ£Όμš” κΈ°λŠ₯

### 1. AI와 λŒ€ν™”ν˜• μ½”λ“œ μž‘μ—…

```bash
$ qwen
> 이 ν”„λ‘œμ νŠΈμ˜ 인증 λ‘œμ§μ„ μ„€λͺ…ν•΄μ€˜
> UserService.ts의 login ν•¨μˆ˜λ₯Ό λ¦¬νŒ©ν† λ§ν•΄μ€˜
> λͺ¨λ“  μ»΄ν¬λ„ŒνŠΈμ—μ„œ μ‚¬μš©λ˜μ§€ μ•ŠλŠ” import μ œκ±°ν•΄μ€˜
```

### 2. 파일 μ‹œμŠ€ν…œ μž‘μ—…

- **파일 읽기/μ“°κΈ°/νŽΈμ§‘**: AIκ°€ μžλ™μœΌλ‘œ 파일 μ‘°μž‘
- **디렉토리 탐색**: ν”„λ‘œμ νŠΈ ꡬ쑰 μžλ™ 뢄석
- **νŒ¨ν„΄ 맀칭**: Glob νŒ¨ν„΄μœΌλ‘œ 파일 검색

### 3. Shell λͺ…λ Ή μ‹€ν–‰

- AIκ°€ ν•„μš”ν•œ λͺ…λ Ήμ–΄λ₯Ό μžλ™μœΌλ‘œ μ‹€ν–‰
- λͺ…λ Ή μ‹€ν–‰ κ²°κ³Όλ₯Ό μ»¨ν…μŠ€νŠΈλ‘œ ν™œμš©
- μ•ˆμ „ν•œ μƒŒλ“œλ°•μŠ€ ν™˜κ²½ 지원 (Docker/Podman)

### 4. μ½”λ“œλ² μ΄μŠ€ 뢄석

- λŒ€κ·œλͺ¨ ν”„λ‘œμ νŠΈμ˜ ꡬ쑰 μžλ™ 뢄석
- μ˜μ‘΄μ„± κ·Έλž˜ν”„ 좔적
- μ½”λ“œ ν’ˆμ§ˆ κ²€ν†  및 κ°œμ„  μ œμ•ˆ

### 5. μ›Ή μ ‘κ·Ό 및 검색

- μ΅œμ‹  기술 λ¬Έμ„œ 검색
- API λ¬Έμ„œ μžλ™ μ°Έμ‘°
- 온라인 λ¦¬μ†ŒμŠ€ ν™œμš©

### 6. μž‘μ—… 관리

- TODO 리슀트 μžλ™ 생성 및 좔적
- λ³΅μž‘ν•œ μž‘μ—…μ„ λ‹¨κ³„λ³„λ‘œ λΆ„ν• 
- 진행 상황 μ‹€μ‹œκ°„ μ—…λ°μ΄νŠΈ

## 핡심 차별화 μš”μ†Œ

### 1. 무료 ν‹°μ–΄
- Qwen OAuthλ₯Ό 톡해 **ν•˜λ£¨ 2,000회 무료 μš”μ²­**
- λ³„λ„μ˜ API ν‚€ 없이 μ¦‰μ‹œ μ‚¬μš© κ°€λŠ₯

### 2. Qwen-Coder μ΅œμ ν™”
- Qwen3-Coder λͺ¨λΈμ— νŠΉν™”λœ νŒŒμ„œ
- ν–₯μƒλœ μ½”λ“œ 생성 ν’ˆμ§ˆ
- λΉ λ₯Έ 응닡 속도

### 3. λΉ„μ „ λͺ¨λΈ 지원
- 이미지 μžλ™ 처리
- μŠ€ν¬λ¦°μƒ· 뢄석
- λ‹€μ΄μ–΄κ·Έλž¨ 이해

### 4. μ„œλΈŒμ—μ΄μ „νŠΈ μ‹œμŠ€ν…œ
- νŠΉν™”λœ μž‘μ—…λ³„ AI μ—μ΄μ „νŠΈ
- 파일 검색, μ½”λ“œ 리뷰 λ“± μ „λ¬Έ μ—μ΄μ „νŠΈ
- ν™•μž₯ κ°€λŠ₯ν•œ μ—μ΄μ „νŠΈ μ•„ν‚€ν…μ²˜

### 5. κ³„νš λͺ¨λ“œ (Plan Mode)
- λ³΅μž‘ν•œ μž‘μ—…μ„ λ¨Όμ € κ³„νš
- 단계별 μ‹€ν–‰ κ³„νš 수립
- μ‚¬μš©μž 승인 ν›„ μ‹€ν–‰

### 6. OpenAI API ν˜Έν™˜μ„±
- OpenAI SDK와 μ™„λ²½ ν˜Έν™˜
- κΈ°μ‘΄ OpenAI μ›Œν¬ν”Œλ‘œμš° μž¬μ‚¬μš© κ°€λŠ₯

## μ‚¬μš© 사둀

### μ½”λ“œ λ¦¬νŒ©ν† λ§
```bash
$ qwen "이 ν”„λ‘œμ νŠΈμ˜ λͺ¨λ“  클래슀 μ»΄ν¬λ„ŒνŠΈλ₯Ό ν•¨μˆ˜ μ»΄ν¬λ„ŒνŠΈλ‘œ λ³€ν™˜ν•΄μ€˜"
```

### 버그 μˆ˜μ •
```bash
$ qwen "UserControllerμ—μ„œ λ°œμƒν•˜λŠ” null pointer μ—λŸ¬ μ°Ύμ•„μ„œ μˆ˜μ •ν•΄μ€˜"
```

### ν…ŒμŠ€νŠΈ μž‘μ„±
```bash
$ qwen "AuthService의 λͺ¨λ“  ν•¨μˆ˜μ— λŒ€ν•œ λ‹¨μœ„ ν…ŒμŠ€νŠΈ μž‘μ„±ν•΄μ€˜"
```

### λ¬Έμ„œ 생성
```bash
$ qwen "API μ—”λ“œν¬μΈνŠΈμ— λŒ€ν•œ README.md μž‘μ„±ν•΄μ€˜"
```

### μ½”λ“œλ² μ΄μŠ€ 이해
```bash
$ qwen "이 ν”„λ‘œμ νŠΈμ˜ 인증 ν”Œλ‘œμš°λ₯Ό λ‹€μ΄μ–΄κ·Έλž¨μœΌλ‘œ μ„€λͺ…ν•΄μ€˜"
```

## 지원 ν™˜κ²½

- **운영체제**: Linux, macOS, Windows (WSL)
- **Node.js**: β‰₯20.0.0
- **IDE 톡합**: VS Code, Zed
- **μ»¨ν…Œμ΄λ„ˆ**: Docker, Podman

## ν”„λ‘œμ νŠΈ 역사

- **기반**: Google Gemini CLI
- **μ΅œμ ν™”**: Qwen3-Coder λͺ¨λΈ
- **ν˜„μž¬ 버전**: 0.2.0
- **λΌμ΄μ„ μŠ€**: Apache 2.0
- **개발**: QwenLM νŒ€

## λ‹€μŒ 단계

μžμ„Έν•œ λ‚΄μš©μ€ λ‹€μŒ λ¬Έμ„œλ₯Ό μ°Έμ‘°ν•˜μ„Έμš”:

- [기술 μŠ€νƒ](02-technology-stack.md) - μ‚¬μš©λœ 기술 상세
- [μ•„ν‚€ν…μ²˜](04-architecture.md) - μ‹œμŠ€ν…œ 섀계 ꡬ쑰
- [개발 κ°€μ΄λ“œ](06-development-guide.md) - 개발 ν™˜κ²½ μ„€μ • 방법
Loading