bmad-setup 1.5.0 → 1.6.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 +124 -335
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,91 +1,119 @@
|
|
|
1
1
|
# BMAD Framework Submodule
|
|
2
2
|
|
|
3
|
-

|
|
4
4
|

|
|
5
5
|

|
|
6
6
|

|
|
7
|
-

|
|
8
8
|
|
|
9
|
-
BMAD
|
|
9
|
+
BMAD 프레임워크를 Git Submodule로 관리하여 **팀별, 프로젝트별로 간편하게 커스터마이징**할 수 있는 세팅 도구입니다.
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
한 줄 설치(`npx bmad-setup`)로 에이전트, 워크플로우, 지식 베이스를 프로젝트에 즉시 적용하고, 필요한 모듈만 골라 사용할 수 있습니다.
|
|
12
12
|
|
|
13
|
-
|
|
14
|
-
| ------------------ | ----------------- |
|
|
15
|
-
| Submodule Version | v1.4.0 |
|
|
16
|
-
| BMAD Framework | 6.0.0-beta.8 |
|
|
13
|
+
> **Claude Code 전용** — 슬래시 커맨드 및 에이전트 시스템이 Claude Code의 커맨드 구조에 맞춰 설계되어 있습니다.
|
|
17
14
|
|
|
18
|
-
|
|
15
|
+
| 항목 | 버전 |
|
|
16
|
+
| ----------------- | ------------ |
|
|
17
|
+
| Submodule Version | v1.5.0 |
|
|
18
|
+
| BMAD Framework | 6.0.0-beta.8 |
|
|
19
|
+
|
|
20
|
+
> [Changelog](./CHANGELOG.md)에서 변경 이력을 확인하세요.
|
|
19
21
|
|
|
20
22
|
---
|
|
21
23
|
|
|
22
|
-
##
|
|
24
|
+
## BMAD Method란?
|
|
23
25
|
|
|
24
|
-
|
|
26
|
+
**BMAD(Breakthrough Method of Agile AI-Driven Development)** 는 AI 기반 소프트웨어 개발을 위한 오픈소스 프레임워크입니다.
|
|
25
27
|
|
|
26
|
-
|
|
28
|
+
아이디어 기획부터 구현까지 전체 개발 과정을 **전문화된 AI 에이전트**와 **가이드 워크플로우**로 지원하며, 프로젝트 복잡도에 맞춘 적응형 접근 방식을 제공합니다.
|
|
27
29
|
|
|
28
|
-
|
|
30
|
+
- **전문 에이전트** — Analyst, PM, Architect, Dev, Test Architect 등 역할별 AI 에이전트
|
|
31
|
+
- **가이드 워크플로우** — 단계별 개발 프로세스로 일관된 품질 확보
|
|
32
|
+
- **적응형 계획** — 버그 수정부터 엔터프라이즈 플랫폼까지 프로젝트 규모에 맞게 동적 조정
|
|
29
33
|
|
|
30
|
-
|
|
34
|
+
> 공식 문서: [https://docs.bmad-method.org](https://docs.bmad-method.org/)
|
|
31
35
|
|
|
32
|
-
|
|
33
|
-
- `.gitmodules` 파일에 원격 저장소 URL이 기록됩니다
|
|
34
|
-
- 특정 커밋(SHA)을 가리키므로 버전 고정이 가능합니다
|
|
36
|
+
---
|
|
35
37
|
|
|
36
|
-
|
|
38
|
+
## 왜 이 서브모듈을 사용하나요?
|
|
37
39
|
|
|
38
|
-
|
|
39
|
-
**Submodule** = 도서관 책의 위치(서가 번호)만 메모해둠
|
|
40
|
+
BMAD 프레임워크 원본은 범용으로 설계되어 있습니다. 이 서브모듈은 그것을 **우리 팀의 실정에 맞게 가져다 쓰는 방법**을 제공합니다.
|
|
40
41
|
|
|
41
|
-
|
|
42
|
+
### 팀/프로젝트별 커스터마이징
|
|
42
43
|
|
|
43
|
-
-
|
|
44
|
-
-
|
|
45
|
-
-
|
|
44
|
+
- **모듈 선택** — 필요한 모듈(소프트웨어 개발, 테스트, 데이터 분석 등)만 골라 사용
|
|
45
|
+
- **에이전트 커스텀** — 팀 컨벤션, 기술 스택, 도메인 용어를 에이전트에 반영
|
|
46
|
+
- **워크플로우 조정** — 팀의 개발 프로세스에 맞게 워크플로우를 추가/수정
|
|
47
|
+
- **메모리 템플릿** — 프로젝트별 컨텍스트(서비스 정보, 퍼널, 지표 등)를 사전 설정
|
|
46
48
|
|
|
47
|
-
|
|
49
|
+
### Submodule 방식의 이점
|
|
48
50
|
|
|
49
|
-
|
|
51
|
+
| 구분 | 직접 복사 | Submodule 사용 |
|
|
52
|
+
| --------- | ------------------------- | ------------------------- |
|
|
53
|
+
| PR 크기 | 300개 이상 파일 변경 | 2개 파일만 변경 |
|
|
54
|
+
| 업데이트 | 각 프로젝트마다 수동 복사 | `git pull` 한 번으로 해결 |
|
|
55
|
+
| 버전 관리 | 어떤 버전인지 추적 어려움 | 커밋 SHA로 정확한 버전 추적 |
|
|
56
|
+
| 설치 | 수동 복사 | `npx bmad-setup` 한 줄 |
|
|
50
57
|
|
|
51
|
-
|
|
58
|
+
프레임워크 원본이 업데이트되더라도, 커스터마이징한 설정은 프로젝트에 그대로 유지됩니다.
|
|
52
59
|
|
|
53
|
-
|
|
54
|
-
| ----------- | --------------------------- | --------------------------- |
|
|
55
|
-
| PR 크기 | 300개 이상 파일 변경 | 2개 파일만 변경 |
|
|
56
|
-
| 업데이트 | 각 프로젝트마다 수동 복사 | `git pull` 한 번으로 해결 |
|
|
57
|
-
| 버전 관리 | 어떤 버전인지 추적 어려움 | 커밋 SHA로 정확한 버전 추적 |
|
|
58
|
-
| 디스크 용량 | 프로젝트마다 전체 파일 중복 | 참조만 저장 |
|
|
59
|
-
| 설치 자동화 | 불가능 | `npm install`로 자동 초기화 |
|
|
60
|
+
---
|
|
60
61
|
|
|
61
|
-
|
|
62
|
+
## 제공 모듈
|
|
62
63
|
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
64
|
+
| 모듈 | 설명 | 주요 에이전트/워크플로우 |
|
|
65
|
+
| ------ | ------------------------ | ---------------------------------------- |
|
|
66
|
+
| `core` | 핵심 기능 | bmad-master, brainstorming, party-mode |
|
|
67
|
+
| `bmm` | 소프트웨어 개발 | analyst, architect, dev, pm, sm, ux |
|
|
68
|
+
| `bmb` | 모듈 빌더 | agent-builder, workflow-builder |
|
|
69
|
+
| `gds` | 게임 개발 | game-designer, game-dev, game-qa |
|
|
70
|
+
| `tea` | 테스트 아키텍처 | test-engineer-architect |
|
|
71
|
+
| `cis` | 크리에이티브 & 혁신 전략 | design-thinking, innovation, storytelling |
|
|
72
|
+
| `dae` | 데이터 분석 (커스텀) | data-analyst, Amplitude 연동 |
|
|
66
73
|
|
|
67
74
|
---
|
|
68
75
|
|
|
69
|
-
##
|
|
76
|
+
## 빠른 시작
|
|
77
|
+
|
|
78
|
+
### 설치
|
|
79
|
+
|
|
80
|
+
```bash
|
|
81
|
+
npx bmad-setup
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
자동으로 수행되는 작업:
|
|
70
85
|
|
|
71
|
-
|
|
86
|
+
1. `bmad-submodule` Git Submodule 추가 및 초기화
|
|
87
|
+
2. `.gitmodules`에 `ignore = dirty` 설정
|
|
88
|
+
3. `install.sh` 실행 (심볼릭 링크 생성)
|
|
89
|
+
4. `.gitignore`에 BMAD 항목 추가
|
|
90
|
+
5. `package.json`에 postinstall / bmad:install / bmad:uninstall 스크립트 추가
|
|
72
91
|
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
92
|
+
> 이미 설치된 항목은 자동으로 스킵됩니다 (멱등성 보장).
|
|
93
|
+
|
|
94
|
+
### 업데이트
|
|
95
|
+
|
|
96
|
+
```bash
|
|
97
|
+
npx bmad-setup --update
|
|
98
|
+
```
|
|
77
99
|
|
|
78
|
-
|
|
100
|
+
Submodule을 최신 버전으로 pull하고 심볼릭 링크를 갱신합니다.
|
|
79
101
|
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
102
|
+
### 동작 확인
|
|
103
|
+
|
|
104
|
+
```bash
|
|
105
|
+
claude
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
Claude Code 실행 후 `/bmad-`를 입력하면 사용 가능한 커맨드 목록이 자동완성됩니다.
|
|
109
|
+
|
|
110
|
+
```bash
|
|
111
|
+
# 예시: 에이전트 실행
|
|
112
|
+
/bmad-agent-bmm-dev # 개발자 에이전트
|
|
113
|
+
/bmad-agent-bmm-architect # 아키텍트 에이전트
|
|
114
|
+
/bmad-agent-bmad-master # 마스터 에이전트
|
|
115
|
+
/bmad-agent-dae-data-analyst # 데이터 분석가
|
|
116
|
+
```
|
|
89
117
|
|
|
90
118
|
---
|
|
91
119
|
|
|
@@ -95,7 +123,7 @@ Git을 처음 접하시거나 Submodule이 생소하신 분들을 위한 설명
|
|
|
95
123
|
bmad-submodule/
|
|
96
124
|
├── .claude/
|
|
97
125
|
│ └── commands/
|
|
98
|
-
│ ├── bmad-agent-*.md # 에이전트 슬래시 커맨드
|
|
126
|
+
│ ├── bmad-agent-*.md # 에이전트 슬래시 커맨드
|
|
99
127
|
│ ├── bmad-bmm-*.md # BMM 워크플로우 커맨드
|
|
100
128
|
│ ├── bmad-bmb-*.md # BMB 빌더 커맨드
|
|
101
129
|
│ ├── bmad-gds-*.md # GDS 게임 개발 커맨드
|
|
@@ -120,61 +148,32 @@ bmad-submodule/
|
|
|
120
148
|
|
|
121
149
|
---
|
|
122
150
|
|
|
123
|
-
## 설치
|
|
151
|
+
## 수동 설치
|
|
124
152
|
|
|
125
|
-
|
|
153
|
+
`npx bmad-setup` 대신 직접 설치하려면 아래 단계를 따르세요.
|
|
126
154
|
|
|
127
|
-
|
|
155
|
+
### 1단계: Submodule 추가
|
|
128
156
|
|
|
129
157
|
```bash
|
|
130
|
-
npx bmad-setup
|
|
131
|
-
```
|
|
132
|
-
|
|
133
|
-
이 명령어는 다음을 자동으로 수행합니다:
|
|
134
|
-
|
|
135
|
-
1. `bmad-submodule` Git Submodule 추가 및 초기화
|
|
136
|
-
2. `.gitmodules`에 `ignore = dirty` 설정
|
|
137
|
-
3. `install.sh` 실행 (심볼릭 링크 생성)
|
|
138
|
-
4. `.gitignore`에 BMAD 항목 추가
|
|
139
|
-
5. `package.json`에 postinstall / bmad:install / bmad:uninstall 스크립트 추가
|
|
140
|
-
|
|
141
|
-
> 이미 설치된 항목은 자동으로 스킵됩니다 (멱등성 보장).
|
|
142
|
-
|
|
143
|
-
---
|
|
144
|
-
|
|
145
|
-
### 수동 설치
|
|
146
|
-
|
|
147
|
-
아래는 수동으로 단계별 설치하는 방법입니다.
|
|
148
|
-
|
|
149
|
-
#### 1단계: Submodule 추가
|
|
150
|
-
|
|
151
|
-
프로젝트 루트 디렉토리에서 실행:
|
|
152
|
-
|
|
153
|
-
```bash
|
|
154
|
-
# Submodule 추가
|
|
155
158
|
git submodule add https://github.com/OhSeungWan/bmad-submodule.git bmad-submodule
|
|
156
|
-
|
|
157
|
-
# Submodule 초기화 및 파일 다운로드
|
|
158
159
|
git submodule init
|
|
159
160
|
git submodule update
|
|
160
|
-
|
|
161
|
-
# dirty 상태 무시 설정 (아래 '설정 파일 설명' 참조)
|
|
162
161
|
git config -f .gitmodules submodule.bmad-submodule.ignore dirty
|
|
163
162
|
```
|
|
164
163
|
|
|
165
|
-
|
|
164
|
+
### 2단계: 심볼릭 링크 생성
|
|
166
165
|
|
|
167
166
|
```bash
|
|
168
167
|
./bmad-submodule/install.sh
|
|
169
168
|
```
|
|
170
169
|
|
|
171
|
-
|
|
170
|
+
생성되는 링크:
|
|
172
171
|
|
|
173
|
-
-
|
|
174
|
-
-
|
|
175
|
-
-
|
|
172
|
+
- `.claude/commands/bmad-*.md` → `bmad-submodule/.claude/commands/bmad-*.md`
|
|
173
|
+
- `.claude/commands/commit.md` → `bmad-submodule/.claude/commands/commit.md`
|
|
174
|
+
- `_bmad` → `bmad-submodule/_bmad`
|
|
176
175
|
|
|
177
|
-
|
|
176
|
+
### 3단계: package.json 설정 (권장)
|
|
178
177
|
|
|
179
178
|
팀원들의 자동 설치를 위해 추가:
|
|
180
179
|
|
|
@@ -188,27 +187,13 @@ git config -f .gitmodules submodule.bmad-submodule.ignore dirty
|
|
|
188
187
|
}
|
|
189
188
|
```
|
|
190
189
|
|
|
191
|
-
**각 스크립트 설명:**
|
|
192
|
-
|
|
193
190
|
| 스크립트 | 실행 시점 | 동작 |
|
|
194
191
|
| ---------------- | ---------------- | ------------------------------------- |
|
|
195
192
|
| `postinstall` | `npm install` 후 | Submodule 초기화 + 최신화 + 링크 생성 |
|
|
196
193
|
| `bmad:install` | 수동 실행 | 심볼릭 링크만 생성 |
|
|
197
194
|
| `bmad:uninstall` | 수동 실행 | 심볼릭 링크 제거 |
|
|
198
195
|
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
```bash
|
|
202
|
-
[ -z "$CI" ] # CI 환경이 아닐 때만 실행
|
|
203
|
-
&& git submodule update --init --recursive # Submodule 초기화 및 업데이트
|
|
204
|
-
&& git -C bmad-submodule pull origin master # 최신 버전으로 업데이트
|
|
205
|
-
&& ./bmad-submodule/install.sh # 심볼릭 링크 생성
|
|
206
|
-
|| true # 실패해도 npm install은 계속 진행
|
|
207
|
-
```
|
|
208
|
-
|
|
209
|
-
#### 4단계: .gitignore 추가
|
|
210
|
-
|
|
211
|
-
루트 프로젝트의 `.gitignore`에 추가:
|
|
196
|
+
### 4단계: .gitignore 추가
|
|
212
197
|
|
|
213
198
|
```
|
|
214
199
|
# BMAD 심볼릭 링크 (실제 파일은 submodule에 있음)
|
|
@@ -218,52 +203,9 @@ _bmad
|
|
|
218
203
|
|
|
219
204
|
---
|
|
220
205
|
|
|
221
|
-
##
|
|
222
|
-
|
|
223
|
-
### .gitmodules
|
|
224
|
-
|
|
225
|
-
Submodule 정보가 저장되는 파일입니다. `git submodule add` 실행 시 자동 생성됩니다.
|
|
226
|
-
|
|
227
|
-
```ini
|
|
228
|
-
[submodule "bmad-submodule"]
|
|
229
|
-
path = bmad-submodule
|
|
230
|
-
url = https://github.com/OhSeungWan/bmad-submodule.git
|
|
231
|
-
ignore = dirty
|
|
232
|
-
```
|
|
233
|
-
|
|
234
|
-
| 항목 | 설명 |
|
|
235
|
-
| -------- | --------------------------------------------- |
|
|
236
|
-
| `path` | Submodule이 위치할 로컬 경로 |
|
|
237
|
-
| `url` | Submodule의 원격 저장소 URL |
|
|
238
|
-
| `ignore` | `dirty` = 내부 변경사항을 git status에서 무시 |
|
|
239
|
-
|
|
240
|
-
### ignore = dirty 설정
|
|
241
|
-
|
|
242
|
-
**왜 필요한가요?**
|
|
243
|
-
|
|
244
|
-
VSCode 등 에디터가 파일을 열면 자동으로:
|
|
245
|
-
|
|
246
|
-
- 줄 끝 공백 제거
|
|
247
|
-
- 파일 끝 빈 줄 추가
|
|
248
|
-
- 탭→스페이스 변환
|
|
249
|
-
|
|
250
|
-
이런 자동 변경으로 인해 `git status`에서 `bmad-submodule (modified content)`가 표시됩니다.
|
|
251
|
-
|
|
252
|
-
**해결 방법:**
|
|
253
|
-
|
|
254
|
-
```bash
|
|
255
|
-
# dirty 상태 무시 설정
|
|
256
|
-
git config -f .gitmodules submodule.bmad-submodule.ignore dirty
|
|
257
|
-
|
|
258
|
-
# 이미 발생한 변경사항 되돌리기
|
|
259
|
-
git submodule foreach --recursive git checkout .
|
|
260
|
-
```
|
|
261
|
-
|
|
262
|
-
---
|
|
263
|
-
|
|
264
|
-
## Submodule과 함께 Clone
|
|
206
|
+
## 팀원 온보딩
|
|
265
207
|
|
|
266
|
-
|
|
208
|
+
새 팀원이 프로젝트를 받을 때:
|
|
267
209
|
|
|
268
210
|
```bash
|
|
269
211
|
# 방법 1: 한 번에 (권장)
|
|
@@ -275,167 +217,16 @@ cd <your-repo>
|
|
|
275
217
|
git submodule update --init --recursive
|
|
276
218
|
```
|
|
277
219
|
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
---
|
|
281
|
-
|
|
282
|
-
## Submodule 업데이트
|
|
283
|
-
|
|
284
|
-
BMAD에 새 기능이 추가되었을 때:
|
|
285
|
-
|
|
286
|
-
```bash
|
|
287
|
-
# 1. Submodule 디렉토리로 이동
|
|
288
|
-
cd bmad-submodule
|
|
289
|
-
|
|
290
|
-
# 2. 최신 버전 가져오기
|
|
291
|
-
git pull origin master
|
|
292
|
-
|
|
293
|
-
# 3. 심볼릭 링크 재생성 (새 파일이 추가된 경우)
|
|
294
|
-
./install.sh
|
|
220
|
+
> `--recurse-submodules` 없이 clone하면 `bmad-submodule` 폴더가 비어있습니다.
|
|
295
221
|
|
|
296
|
-
|
|
297
|
-
cd ..
|
|
298
|
-
git add bmad-submodule
|
|
299
|
-
git commit -m "chore: update bmad-submodule"
|
|
300
|
-
git push
|
|
301
|
-
```
|
|
302
|
-
|
|
303
|
-
---
|
|
304
|
-
|
|
305
|
-
## 스크립트 상세 설명
|
|
306
|
-
|
|
307
|
-
### install.sh
|
|
308
|
-
|
|
309
|
-
```bash
|
|
310
|
-
./bmad-submodule/install.sh
|
|
311
|
-
```
|
|
312
|
-
|
|
313
|
-
**동작:**
|
|
314
|
-
|
|
315
|
-
1. 기존 심볼릭 링크/폴더가 있으면 삭제
|
|
316
|
-
2. 루트 프로젝트에 `.claude/commands` 디렉토리 생성
|
|
317
|
-
3. 심볼릭 링크 생성:
|
|
318
|
-
- `.claude/commands/bmad` → submodule의 `.claude/commands/bmad`
|
|
319
|
-
- `_bmad` → submodule의 `_bmad`
|
|
320
|
-
|
|
321
|
-
**언제 실행하나요?**
|
|
322
|
-
|
|
323
|
-
- 최초 설치 시
|
|
324
|
-
- Submodule 업데이트 후 (새 파일이 추가된 경우)
|
|
325
|
-
- 심볼릭 링크가 깨진 경우
|
|
326
|
-
|
|
327
|
-
### uninstall.sh
|
|
328
|
-
|
|
329
|
-
```bash
|
|
330
|
-
./bmad-submodule/uninstall.sh
|
|
331
|
-
```
|
|
332
|
-
|
|
333
|
-
**동작:**
|
|
334
|
-
|
|
335
|
-
1. 심볼릭 링크인 경우: 바로 삭제
|
|
336
|
-
2. 일반 디렉토리인 경우: 확인 후 삭제
|
|
337
|
-
|
|
338
|
-
**언제 실행하나요?**
|
|
339
|
-
|
|
340
|
-
- BMAD 사용을 중단할 때
|
|
341
|
-
- 심볼릭 링크 대신 직접 파일을 관리하고 싶을 때
|
|
342
|
-
|
|
343
|
-
---
|
|
344
|
-
|
|
345
|
-
## 동작 확인
|
|
346
|
-
|
|
347
|
-
설치가 완료되면 BMAD 에이전트가 정상적으로 작동하는지 확인합니다.
|
|
348
|
-
|
|
349
|
-
### 1. Claude Code 실행
|
|
350
|
-
|
|
351
|
-
프로젝트 루트 디렉토리에서 Claude Code를 실행합니다:
|
|
352
|
-
|
|
353
|
-
```bash
|
|
354
|
-
claude
|
|
355
|
-
```
|
|
356
|
-
|
|
357
|
-
### 2. 슬래시 커맨드 확인
|
|
358
|
-
|
|
359
|
-
Claude Code 내에서 `/bmad-`를 입력하면 사용 가능한 커맨드 목록이 자동완성됩니다.
|
|
360
|
-
|
|
361
|
-
### 3. 에이전트 실행 테스트
|
|
362
|
-
|
|
363
|
-
예시로 Data Analyst 에이전트를 실행해봅니다:
|
|
364
|
-
|
|
365
|
-
```
|
|
366
|
-
/bmad-agent-dae-data-analyst
|
|
367
|
-
```
|
|
368
|
-
|
|
369
|
-
**정상 실행 시 출력 예시:**
|
|
370
|
-
|
|
371
|
-
```
|
|
372
|
-
안녕하세요, 렌트리 개발팀님! 📊
|
|
373
|
-
|
|
374
|
-
저는 재만이에요 - 여러분의 데이터 분석 파트너입니다.
|
|
375
|
-
|
|
376
|
-
----
|
|
377
|
-
현재 서비스 컨텍스트
|
|
378
|
-
|
|
379
|
-
아직 서비스 정보가 설정되지 않았어요. [SC] 서비스 컨텍스트 설정을 통해
|
|
380
|
-
렌트리 서비스의 퍼널과 핵심 지표를 학습하면 더 정확한 분석을 도와드릴 수 있어요!
|
|
381
|
-
|
|
382
|
-
----
|
|
383
|
-
메뉴
|
|
384
|
-
|
|
385
|
-
| # | 명령어 | 설명 |
|
|
386
|
-
| --- | ------ | -------------------------------------- |
|
|
387
|
-
| 1 | [MH] | 메뉴 도움말 다시 표시 |
|
|
388
|
-
| 2 | [CH] | 에이전트와 자유롭게 대화하기 |
|
|
389
|
-
| 3 | [QA] | 빠른 데이터 분석 - 질문에 답하기 |
|
|
390
|
-
| 4 | [FA] | 퍼널 분석 - 전환율, 병목, 이탈 분석 |
|
|
391
|
-
| 5 | [ED] | 실험 설계 - A/B 테스트 계획 수립 |
|
|
392
|
-
| 6 | [ER] | 실험 결과 분석 - 테스트 결과 해석 |
|
|
393
|
-
| 7 | [IA] | 영향도 분석 - 기능 변경 영향 예측 |
|
|
394
|
-
| 8 | [RM] | 위험 모니터링 - 이상 징후 감지 |
|
|
395
|
-
| 9 | [SC] | 서비스 컨텍스트 설정 - 퍼널, 지표 학습 |
|
|
396
|
-
| 10 | [GR] | 리포트 생성 - 분석 결과 문서화 |
|
|
397
|
-
| 11 | [DA] | 에이전트 종료 |
|
|
398
|
-
|
|
399
|
-
----
|
|
400
|
-
번호나 명령어를 입력해주세요. 무엇을 도와드릴까요?
|
|
401
|
-
```
|
|
402
|
-
|
|
403
|
-
위와 같이 에이전트 메뉴가 표시되면 설치가 정상적으로 완료된 것입니다.
|
|
404
|
-
|
|
405
|
-
### 4. 다른 에이전트/워크플로우 테스트
|
|
406
|
-
|
|
407
|
-
모듈별로 다양한 에이전트와 워크플로우를 테스트해볼 수 있습니다:
|
|
408
|
-
|
|
409
|
-
```bash
|
|
410
|
-
# BMM (소프트웨어 개발)
|
|
411
|
-
/bmad-agent-bmm-dev # 개발자 에이전트
|
|
412
|
-
/bmad-agent-bmm-architect # 아키텍트 에이전트
|
|
413
|
-
|
|
414
|
-
# Core (핵심)
|
|
415
|
-
/bmad-agent-bmad-master # 마스터 에이전트
|
|
416
|
-
/bmad-brainstorming # 브레인스토밍
|
|
417
|
-
|
|
418
|
-
# DAE (데이터 분석)
|
|
419
|
-
/bmad-agent-dae-data-analyst # 데이터 분석가
|
|
420
|
-
/bmad-dae-data-analysis # 데이터 분석 워크플로우
|
|
421
|
-
```
|
|
422
|
-
|
|
423
|
-
### 5. 설치 실패 시 체크리스트
|
|
424
|
-
|
|
425
|
-
에이전트가 실행되지 않으면 다음을 확인하세요:
|
|
426
|
-
|
|
427
|
-
| 확인 항목 | 명령어 |
|
|
428
|
-
| --------------------------- | ------------------------------ |
|
|
429
|
-
| Submodule이 초기화되었는가? | `ls bmad-submodule/` |
|
|
430
|
-
| 심볼릭 링크가 생성되었는가? | `ls -la .claude/commands/bmad` |
|
|
431
|
-
| _bmad 링크가 생성되었는가? | `ls -la _bmad` |
|
|
432
|
-
| install.sh를 실행했는가? | `./bmad-submodule/install.sh` |
|
|
222
|
+
`package.json`에 postinstall이 설정되어 있다면, `npm install`만으로 자동 초기화됩니다.
|
|
433
223
|
|
|
434
224
|
---
|
|
435
225
|
|
|
436
226
|
## 문제 해결
|
|
437
227
|
|
|
438
|
-
|
|
228
|
+
<details>
|
|
229
|
+
<summary><b>bmad-submodule 폴더가 비어있어요</b></summary>
|
|
439
230
|
|
|
440
231
|
Submodule이 초기화되지 않은 상태입니다.
|
|
441
232
|
|
|
@@ -443,41 +234,44 @@ Submodule이 초기화되지 않은 상태입니다.
|
|
|
443
234
|
git submodule update --init --recursive
|
|
444
235
|
```
|
|
445
236
|
|
|
446
|
-
|
|
237
|
+
</details>
|
|
238
|
+
|
|
239
|
+
<details>
|
|
240
|
+
<summary><b>git status에서 bmad-submodule (modified content)가 보여요</b></summary>
|
|
447
241
|
|
|
448
|
-
에디터 자동 포맷팅 때문입니다.
|
|
242
|
+
에디터 자동 포맷팅(줄 끝 공백 제거, 탭→스페이스 등) 때문입니다.
|
|
449
243
|
|
|
450
244
|
```bash
|
|
451
|
-
# 설정으로 방지
|
|
452
245
|
git config -f .gitmodules submodule.bmad-submodule.ignore dirty
|
|
453
|
-
|
|
454
|
-
# 현재 변경사항 되돌리기
|
|
455
246
|
git submodule foreach --recursive git checkout .
|
|
456
247
|
```
|
|
457
248
|
|
|
458
|
-
|
|
249
|
+
</details>
|
|
250
|
+
|
|
251
|
+
<details>
|
|
252
|
+
<summary><b>심볼릭 링크가 작동하지 않아요</b></summary>
|
|
459
253
|
|
|
460
254
|
Windows에서는 관리자 권한이 필요할 수 있습니다.
|
|
461
255
|
|
|
462
256
|
```bash
|
|
463
|
-
# 심볼릭 링크 재생성
|
|
464
257
|
./bmad-submodule/install.sh
|
|
465
|
-
|
|
466
|
-
# 링크 확인
|
|
467
258
|
ls -la .claude/commands/bmad
|
|
468
259
|
ls -la _bmad
|
|
469
260
|
```
|
|
470
261
|
|
|
471
|
-
|
|
262
|
+
</details>
|
|
263
|
+
|
|
264
|
+
<details>
|
|
265
|
+
<summary><b>완전 재설치</b></summary>
|
|
472
266
|
|
|
473
267
|
문제가 지속되면 깨끗하게 다시 시작:
|
|
474
268
|
|
|
475
269
|
```bash
|
|
476
|
-
# 1.
|
|
270
|
+
# 1. 리셋
|
|
477
271
|
git reset HEAD -- .gitmodules bmad-submodule 2>/dev/null || true
|
|
478
272
|
git checkout HEAD -- .gitmodules 2>/dev/null || true
|
|
479
273
|
|
|
480
|
-
# 2.
|
|
274
|
+
# 2. 제거
|
|
481
275
|
git submodule deinit -f bmad-submodule 2>/dev/null || true
|
|
482
276
|
git rm -f bmad-submodule 2>/dev/null || true
|
|
483
277
|
rm -rf bmad-submodule
|
|
@@ -490,29 +284,24 @@ git add .gitmodules
|
|
|
490
284
|
# 4. 다시 추가
|
|
491
285
|
git submodule add https://github.com/OhSeungWan/bmad-submodule.git bmad-submodule
|
|
492
286
|
git config -f .gitmodules submodule.bmad-submodule.ignore dirty
|
|
493
|
-
|
|
494
|
-
# 5. 확인
|
|
495
|
-
ls -la bmad-submodule/
|
|
496
|
-
git submodule status
|
|
497
287
|
```
|
|
498
288
|
|
|
499
|
-
gitignore
|
|
289
|
+
> .gitignore에서 관련 폴더를 제거했는지도 확인하세요. 특정 Claude 버전에서 .gitignore에 추가된 파일을 인식하지 못할 수 있습니다.
|
|
500
290
|
|
|
501
|
-
|
|
502
|
-
|
|
503
|
-
## 자주 묻는 질문
|
|
291
|
+
</details>
|
|
504
292
|
|
|
505
|
-
|
|
506
|
-
|
|
507
|
-
A: 가능하지만 권장하지 않습니다. 수정사항은 bmad-submodule 저장소에 별도로 커밋/푸시해야 합니다. 팀 프로젝트라면 원본 저장소에 PR을 보내세요.
|
|
293
|
+
---
|
|
508
294
|
|
|
509
|
-
|
|
295
|
+
## FAQ
|
|
510
296
|
|
|
511
|
-
|
|
297
|
+
**Q: Submodule 내부에서 직접 수정해도 되나요?**
|
|
298
|
+
가능하지만 권장하지 않습니다. 수정사항은 bmad-submodule 저장소에 별도로 커밋/푸시해야 합니다. 팀 프로젝트라면 원본 저장소에 PR을 보내세요.
|
|
512
299
|
|
|
513
|
-
|
|
300
|
+
**Q: 특정 버전의 BMAD를 고정하고 싶어요**
|
|
301
|
+
Submodule은 특정 커밋을 가리키므로 기본적으로 버전이 고정됩니다. `git pull`을 하지 않으면 해당 버전이 유지됩니다.
|
|
514
302
|
|
|
515
|
-
|
|
303
|
+
**Q: CI/CD에서는 어떻게 하나요?**
|
|
304
|
+
postinstall 스크립트에 `[ -z "$CI" ]` 조건이 있어 CI 환경에서는 스킵됩니다. CI에서 BMAD가 필요하다면 이 조건을 제거하세요.
|
|
516
305
|
|
|
517
306
|
---
|
|
518
307
|
|