vibe-collab 0.2.0 → 0.3.0
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/README.md +39 -35
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -8,6 +8,27 @@
|
|
|
8
8
|
|
|
9
9
|
---
|
|
10
10
|
|
|
11
|
+
## 어떻게 작동하나요?
|
|
12
|
+
|
|
13
|
+
```
|
|
14
|
+
[내 PC] [vibeorchestratorserver.vercel.app]
|
|
15
|
+
vibe auth login
|
|
16
|
+
→ 브라우저 GitHub 로그인 ──────────────→ GitHub OAuth
|
|
17
|
+
← JWT 토큰 발급 ←──────────────────────
|
|
18
|
+
→ ~/.vibe/auth.json 저장
|
|
19
|
+
|
|
20
|
+
Claude Code / Cursor / VS Code
|
|
21
|
+
→ MCP 도구 호출 (vibe_start_session 등)
|
|
22
|
+
→ AI 요청 ──────────────────────────→ /api/ai/complete (JWT 인증)
|
|
23
|
+
← AI 응답 ←────────────────────────── Anthropic API 호출 후 반환
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
- **AI API 키 불필요** — 서버(vibeorchestratorserver.vercel.app)가 관리합니다
|
|
27
|
+
- **GitHub 로그인 한 번** — 이후 모든 AI 기능 자동 사용
|
|
28
|
+
- **MCP 자동 연결** — `vibe init` 한 번으로 Claude Code, Cursor, VS Code 동시 설정
|
|
29
|
+
|
|
30
|
+
---
|
|
31
|
+
|
|
11
32
|
## 빠른 시작
|
|
12
33
|
|
|
13
34
|
### 1단계 — 설치
|
|
@@ -24,8 +45,6 @@ vibe auth login
|
|
|
24
45
|
|
|
25
46
|
브라우저가 열리면 GitHub 계정으로 로그인하세요. 완료되면 터미널로 돌아옵니다.
|
|
26
47
|
|
|
27
|
-
> AI API 키는 필요하지 않습니다. 서버에서 관리합니다.
|
|
28
|
-
|
|
29
48
|
### 3단계 — 프로젝트 초기화
|
|
30
49
|
|
|
31
50
|
```bash
|
|
@@ -33,14 +52,15 @@ cd /path/to/your/project
|
|
|
33
52
|
vibe init
|
|
34
53
|
```
|
|
35
54
|
|
|
36
|
-
GitHub 레포 URL을 입력하면
|
|
55
|
+
GitHub 레포 URL을 입력하면 자동으로 설정됩니다:
|
|
37
56
|
- `CHARTER.md` — AI가 분석한 레포 컨벤션
|
|
38
57
|
- `.vibe/state.json` — 팀 협업 상태
|
|
39
|
-
- `.
|
|
58
|
+
- `.claude/settings.json` — Claude Code MCP 설정
|
|
59
|
+
- `.vscode/mcp.json` — VS Code MCP 설정
|
|
40
60
|
|
|
41
61
|
### 4단계 — 작업 시작
|
|
42
62
|
|
|
43
|
-
|
|
63
|
+
Claude Code, Cursor 등 AI 도구에서 `vibe_start_session`을 호출하면 팀 컨텍스트가 자동으로 주입됩니다.
|
|
44
64
|
|
|
45
65
|
```bash
|
|
46
66
|
# CLI로도 직접 시작 가능
|
|
@@ -53,18 +73,20 @@ vibe start
|
|
|
53
73
|
|
|
54
74
|
| 명령어 | 설명 |
|
|
55
75
|
|--------|------|
|
|
56
|
-
| `vibe auth login` | GitHub OAuth 로그인
|
|
76
|
+
| `vibe auth login` | GitHub OAuth 로그인 |
|
|
57
77
|
| `vibe auth logout` | 로그아웃 |
|
|
58
|
-
| `vibe auth status` | 로그인 상태 확인 |
|
|
59
|
-
| `vibe init` | 프로젝트 초기화 (CHARTER, state.json 생성) |
|
|
78
|
+
| `vibe auth status` | 로그인 상태 및 만료일 확인 |
|
|
79
|
+
| `vibe init` | 프로젝트 초기화 (CHARTER, state.json, MCP 설정 생성) |
|
|
60
80
|
| `vibe start` | 작업 시작 또는 이어서 진행 |
|
|
61
81
|
| `vibe status` | 팀 현황 출력 |
|
|
62
|
-
| `vibe serve` | MCP 서버 시작 (AI 도구에서 자동
|
|
82
|
+
| `vibe serve` | MCP 서버 시작 (AI 도구에서 자동 실행됨) |
|
|
63
83
|
|
|
64
84
|
---
|
|
65
85
|
|
|
66
86
|
## MCP 도구 (8개)
|
|
67
87
|
|
|
88
|
+
Claude Code, Cursor, VS Code 등 MCP를 지원하는 모든 AI 도구에서 사용할 수 있습니다.
|
|
89
|
+
|
|
68
90
|
| 도구 | 설명 |
|
|
69
91
|
|------|------|
|
|
70
92
|
| `vibe_start_session` | 세션 시작 — CHARTER, 팀 현황, 내 상태 반환 |
|
|
@@ -81,43 +103,25 @@ vibe start
|
|
|
81
103
|
## 여러 AI 동시 협업 예시
|
|
82
104
|
|
|
83
105
|
```bash
|
|
84
|
-
# 터미널 A — Claude Code
|
|
106
|
+
# 터미널 A — Claude Code로 작업 중
|
|
85
107
|
# vibe_start_session { userName: "김지혁", githubId: "jihyuk-kim" }
|
|
86
108
|
|
|
87
|
-
# 터미널 B — Cursor
|
|
109
|
+
# 터미널 B — Cursor로 다른 기능 동시 작업
|
|
88
110
|
# vibe_start_session { userName: "이민수", githubId: "minsoo-lee" }
|
|
89
111
|
|
|
90
|
-
# 두 세션이 동일한 state.json을 공유 →
|
|
112
|
+
# 두 세션이 동일한 state.json을 공유 → 충돌 없이 병렬 개발
|
|
91
113
|
```
|
|
92
114
|
|
|
93
115
|
---
|
|
94
116
|
|
|
95
|
-
##
|
|
96
|
-
|
|
97
|
-
### CHARTER.md
|
|
98
|
-
|
|
99
|
-
AI가 레포를 분석해 자동 생성하는 팀 헌법입니다.
|
|
117
|
+
## 프록시 서버
|
|
100
118
|
|
|
101
|
-
|
|
102
|
-
- **기술 스택** — 감지된 언어/프레임워크
|
|
103
|
-
- **폴더 구조** — 각 폴더의 역할
|
|
104
|
-
- **기능 맵** — 완료된 기능 테이블 (merge 시 자동 갱신)
|
|
105
|
-
- **금지 패턴** — QA Guardian이 자동으로 검사하는 규칙
|
|
119
|
+
AI 요청은 **https://vibeorchestratorserver.vercel.app** 을 통해 처리됩니다.
|
|
106
120
|
|
|
107
|
-
|
|
121
|
+
- `/api/ai/complete` — JWT 인증 후 Anthropic API 호출
|
|
122
|
+
- `/api/auth/cli-token` — GitHub OAuth 후 CLI 토큰 발급
|
|
108
123
|
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
모든 에이전트가 공유하는 협업 상태 파일입니다.
|
|
112
|
-
|
|
113
|
-
```json
|
|
114
|
-
{
|
|
115
|
-
"project": "my-project",
|
|
116
|
-
"collaborators": { "jihyuk-kim": { "name": "김지혁" } },
|
|
117
|
-
"activeWork": { "issueNumber": 7, "actor": "jihyuk-kim" },
|
|
118
|
-
"issues": [ { "number": 7, "title": "환불 기능", "stage": "work_started" } ]
|
|
119
|
-
}
|
|
120
|
-
```
|
|
124
|
+
직접 운영하고 싶다면 `VIBE_API_URL` 환경변수로 서버 주소를 교체할 수 있습니다.
|
|
121
125
|
|
|
122
126
|
---
|
|
123
127
|
|