BMad Method 사용가이드 - 뭉탱이의 까칠한 생활

## 목차 1. BMad Method 개요 2. 설치된 모듈 목록 3. BMad Method (bmm) — 핵심 개발 방법론 4. Web Design Studio (wds) — UI/UX 중심 설계 5. Test Architecture Enterprise (tea) — 테스트 전문 모듈 6. Creative Intelligence Suite (cis) — 창의적 발상 도구 7. BMad Builder (bmb) — 에이전트 및 워크플로우 제작 8. Core — 범용 유틸리티 9. 모듈 간 연계 전략 (BMadExample 프로젝트 권장) 10. 출력물 위치 레퍼런스 --- ## 1. BMad Method 개요 BMad Method는 AI 에이전트가 프로젝트 생명주기 전체를 일관되게 진행할 수 있도록 설계된 **단계별 워크플로우 오케스트레이션 프레임워크**다. 각 스킬(SKILL.md)은 독립된 실행 단위이며, `workflow.md` + `steps/step-NN.md` 파일로 세분화된 마이크로 아키텍처를 사용한다. ### 핵심 실행 원칙 | 원칙 | 설명 | |------|------| | **단계별 파일 아키텍처** | 각 스텝은 독립 파일로 분리 — 동시에 여러 스텝을 로드하지 않음 | | **Just-In-Time 로딩** | 현재 스텝 완료 후에만 다음 스텝 파일을 로드 | | **단방향 진행** | 스텝 순서는 절대 건너뛰지 않으며 순차 실행 | | **사용자 게이트** | 메뉴 또는 체크포인트에서 반드시 사용자 입력 대기 | | **Append-Only 문서 빌딩** | 출력 문서는 덧붙이는 방식으로만 구성 | | **설정 중앙화** | 모든 워크플로우는 각 모듈의 `config.yaml`에서 설정값을 로드 | ### 설정 파일 위치 ``` _bmad/bmm/config.yaml ← BMad Method 설정 _bmad/wds/config.yaml ← Web Design Studio 설정 _bmad/tea/config.yaml ← TEA 설정 ``` **BMadExample 프로젝트 기본 설정:** - `user_name`: moongtaeng - `communication_language`: Korean - `document_output_language`: Korean - `planning_artifacts`: `_bmad-output/planning-artifacts` - `implementation_artifacts`: `_bmad-output/implementation-artifacts` - `project_knowledge`: `_bmad-docs` --- ## 2. 설치된 모듈 목록 | 모듈명 | 코드 | 버전 | 목적 | |--------|------|------|------| | **Core** | core | 6.2.2 | 범용 유틸리티 (브레인스토밍, 문서 편집, 리뷰) | | **BMad Method** | bmm | 6.2.2 | 전체 프로젝트 생명주기 관리 (분석→계획→설계→개발) | | **BMad Builder** | bmb | 1.1.0 | 에이전트/워크플로우 스킬 제작 및 모듈 빌드 | | **Creative Intelligence Suite** | cis | 0.1.9 | 브레인스토밍, 디자인 씽킹, 혁신 전략, 스토리텔링 | | **Test Architecture Enterprise** | tea | 1.7.2 | 테스트 설계, 프레임워크, ATDD, CI/CD, 추적성 | | **Web Design Studio** | wds | 0.3.1 | UI/UX 전문 설계 (트리거 맵, 시나리오, 스펙, 개발) | --- ## 3. BMad Method (bmm) — 핵심 개발 방법론 BMad Method는 프로젝트 초기 분석부터 배포까지 전체 생명주기를 커버하는 핵심 모듈이다. **4개 단계**로 구성되며 각 단계는 이전 단계의 산출물을 입력으로 받는다. ### 전체 흐름 다이어그램 ``` +--- Phase 1: ANALYSIS ---+ +----------------------------------------------------------------------+ | DR (bmad-domain-research) 도메인 리서치 │ MR (bmad-market-research) 시장 리서치 │ TR (bmad-technical-research) 기술 리서치 │ BP (bmad-brainstorming) 브레인스토밍 │ ↓ 통합 │ CB (bmad-product-brief) 프로덕트 브리프 +----------------------------------------------------------------------+ ↓ +--- Phase 2: PLANNING ---+ +----------------------------------------------------------------------+ │ CP (bmad-create-prd) PRD 작성 │ ├→ VP (bmad-validate-prd) PRD 검증 │ │ ↔ EP (bmad-edit-prd) PRD 편집 │ +→ CU (bmad-create-ux-design) UX 설계 (선택) +----------------------------------------------------------------------+ ↓ +--- Phase 3: SOLUTIONING ---+ +----------------------------------------------------------------------+ │ CA (bmad-create-architecture) 아키텍처 설계 │ → CE (bmad-create-epics-and-stories) 에픽/스토리 작성 │ → IR (bmad-check-implementation-readiness) 구현 준비 검증 +----------------------------------------------------------------------+ ↓ +--- Phase 4: IMPLEMENTATION ---+ +----------------------------------------------------------------------+ │ SP (bmad-sprint-planning) 스프린트 플래닝 │ → CS (bmad-create-story) 스토리 생성 │ → VS (bmad-create-story validate) 스토리 검증 │ → DS (bmad-dev-story) 스토리 개발 │ → CR (bmad-code-review) 코드 리뷰 │ ├-[이슈 발견]------------→ DS 로 복귀 │ +-[승인]→ QA (bmad-qa-generate-e2e-tests) E2E 테스트 │ ├-[다음 스토리]→ CS 로 반복 │ +→ ER (bmad-retrospective) 회고 (에픽 완료 시) +----------------------------------------------------------------------+ +--- 언제든지 ---+ +----------------------------------------------------------------------+ │ SS (bmad-sprint-status) 스프린트 상태 │ CC (bmad-correct-course) 방향 수정 │ QQ (bmad-quick-dev) 빠른 개발 │ DP (bmad-document-project) 프로젝트 문서화 │ GPC (bmad-generate-project-context) 컨텍스트 생성 +----------------------------------------------------------------------+ ``` --- ### Phase 1: Analysis (분석 단계) | 코드 | 스킬명 명령어 | 설명 출력물 | |------|--------|------| | **DR** | Domain Research 명령어: `bmad-domain-research` | 도메인 및 산업 분야 심층 리서치. 전문 용어와 지식 체계 정립 출력물 : `planning-artifacts/research/` | | **MR** | Market Research 명령어: `bmad-market-research` | 시장 분석, 경쟁 환경, 고객 니즈, 트렌드 파악 출력물 : `planning-artifacts/research/` | | **TR** | Technical Research 명령어: `bmad-technical-research` | 기술 타당성, 아키텍처 옵션, 구현 방식 연구 출력물 :`planning-artifacts/research/`| | **CB** | Create Brief 명령어: `bmad-product-brief` | 프로덕트 브리프 작성. 1-2페이지 경영진 요약 + LLM 최적화 디스틸레이트 출력물 : `planning-artifacts/`| | **BP** | Brainstorm Project 명령어: `bmad-brainstorming` | 전문 퍼실리테이터의 브레인스토밍 진행 출력물 : `planning-artifacts/`| | **DP** | Document Project 명령어: `bmad-document-project` | 기존 프로젝트 분석 → 유용한 문서 자동 생성 (브라운필드 전용) 출력물 :`_bmad-docs/`| **DR(도메인 리서치) 상세 단계:** > ⚠️ 웹 검색 필수 — 미사용 시 실행 불가 ``` step-01: 리서치 스코프 확인 및 접근 방식 결정 step-02: 산업 분석 (시장 구조·주요 플레이어·경쟁 역학) step-03: 경쟁 환경 분석 (경쟁사 포지셔닝·차별화 요소) step-04: 규제 환경 분석 (컴플라이언스·법적 프레임워크) step-05: 기술 트렌드 분석 (혁신 패턴·디지털 전환) step-06: 리서치 종합 및 문서화 출력: planning-artifacts/research/domain-{topic}-research-{date}.md ``` **MR(시장 리서치) 상세 단계:** > ⚠️ 웹 검색 필수 — 미사용 시 실행 불가 ``` step-01: 리서치 스코프 확인 및 접근 방식 결정 step-02: 고객 행동 분석 (구매 패턴·사용 습관) step-03: 고객 페인 포인트 분석 (불편함·미충족 니즈) step-04: 고객 의사결정 요인 분석 (구매 동기·장벽) step-05: 경쟁 분석 (경쟁사 비교·시장 포지션) step-06: 리서치 완료 및 문서화 출력: planning-artifacts/research/market-{topic}-research-{date}.md ``` **TR(기술 리서치) 상세 단계:** > ⚠️ 웹 검색 필수 — 미사용 시 실행 불가 ``` step-01: 리서치 스코프 확인 및 기술 영역 설정 step-02: 기술 개요 분석 (핵심 기술·생태계 파악) step-03: 통합 패턴 분석 (API·서드파티 통합 방식) step-04: 아키텍처 패턴 분석 (검증된 설계 패턴·트레이드오프) step-05: 구현 리서치 (라이브러리·프레임워크·도구 평가) step-06: 리서치 종합 및 권장 사항 도출 출력: planning-artifacts/research/technical-{topic}-research-{date}.md ``` **CB(프로덕트 브리프) 실행 모드:** - `--autonomous` / `-A` : 제공된 입력으로 대화 없이 자동 생성 - `--yolo` : 전체 초안 먼저 작성 후 정제 - 기본 (Guided) : 단계별 대화형 발견 과정 **CB(프로덕트 브리프) 내부 처리 단계 (Stage Pipeline):** ``` Stage 1: 의도 파악 — 어떤 제품인지 이해. 브리프 유형 감지, 복수 아이디어 정리 Stage 2: 맥락 발견 — 서브에이전트 팬아웃 → 기존 문서 분석 + 웹 리서치 병렬 실행 Stage 3: 가이드 인터뷰 — 스마트 질문으로 정보 갭 채우기. 중복 질문 없이 핵심만 Stage 4: 초안 작성 — 수집된 인사이트를 1-2페이지 경영진 요약으로 정제 Stage 5: 검토 및 완료 — 사용자 검토 → LLM 최적화 디스틸레이트 옵션 제공 ``` --- ### Phase 2: Planning (계획 단계) | 코드 | 스킬명 명령어 | 설명 선행 조건 출력물 | |------|--------|------| | **CP** | Create PRD 명령어: `bmad-create-prd` | 전문가 퍼실리테이션으로 제품 요구사항 문서 작성. 선행 조건: CB 권장 출력물: `planning-artifacts/prd.md` | | **VP** | Validate PRD 명령어: `bmad-validate-prd [path]` | PRD를 표준과 모범 사례에 검증. 선행 조건: CP 이후 출력물: `planning-artifacts/prd-validation.md` | | **EP** | Edit PRD 명령어: `bmad-edit-prd [path]` | VP 피드백을 반영하여 PRD 수정. 선행 조건: VP 이후 출력물: `planning-artifacts/prd.md` (updated prd) | | **CU** | Create UX 명령어: `bmad-create-ux-design` | UX 계획 수립. UI가 핵심인 경우 권장. 선행 조건: CP 이후 출력물: `planning-artifacts/ux-design.md` | **PRD 작성 흐름:** ``` CP → VP → [ 수정 필요? → EP → VP ] → 완료 ``` **CP(PRD 작성) 상세 단계:** ``` step-01: 초기화 및 기존 문서 스캔 step-02: 프로젝트 발견 (핵심 문제·솔루션 정의) step-02b: 비전 및 목표 수립 step-02c: 경영진 요약 초안 step-03: 성공 지표 정의 (KPI·OKR) step-04: 사용자 여정 및 핵심 플로우 step-05: 도메인 지식 통합 step-06: 혁신 및 차별화 요소 step-07: 프로젝트 유형 분류 (SaaS·내부 도구·API 등) step-08: 스코핑 (MVP 범위·우선순위) step-09: 기능 요구사항 작성 step-10: 비기능 요구사항 작성 (성능·보안·접근성) step-11: 문서 완성도 검토 및 폴리싱 step-12: 최종 완료 및 서명 ``` --- ### Phase 3: Solutioning (설계 및 설루션 단계) | 코드 | 스킬명 명령어 | 설명 선행 조건 출력물 | |------|--------|------| | **CA** | Create Architecture 명령어: `bmad-create-architecture` | 기술 아키텍처 결정사항 문서화. 마이크로 파일 아키텍처 사용. 선행 조건: PRD 완료 출력물: `planning-artifacts/architecture.md` | | **CE** | Create Epics & Stories 명령어: `bmad-create-epics-and-stories` | PRD + 아키텍처 기반으로 에픽과 사용자 스토리 분해. 완전한 인수 기준 포함. 선행 조건: CA 완료 출력물: `planning-artifacts/epics.md` | | **IR** | Implementation Readiness 명령어: `bmad-check-implementation-readiness` | PRD, UX, 아키텍처, 에픽/스토리가 정합한지 검증. 선행 조건: CE 완료 출력물: `planning-artifacts/readiness-report.md` | | **GPC** | Generate Project Context 명령어: `bmad-generate-project-context` | 기존 코드 스캔 → LLM 최적화 `project-context.md` 생성 (브라운필드 필수). 선행 조건: 코드베이스 존재 시 출력물: `_bmad-output/project-context.md` | **CA(아키텍처 설계) 상세 단계:** ``` step-01: 초기화 및 기존 문서 스캔 step-02: 기술 스택 결정 step-03: 시스템 구조 설계 step-04: 데이터 모델 정의 step-05: API 설계 step-06: 보안 및 배포 전략 step-07: 문서 최종화 ``` **CE(에픽/스토리) 상세 단계:** ``` step-01: 선행 조건 검증 (PRD, 아키텍처 확인) step-02: 에픽 구조 초안 step-03: 스토리 분해 및 우선순위 step-04: 인수 기준 작성 (Given/When/Then) step-05: 최종 검토 및 확정 ``` --- ### 전문 에이전트 (페르소나 모드) BMM은 워크플로우 스킬을 직접 호출하는 방식 외에, **전문 에이전트 페르소나**를 소환해 지속적인 캐릭터와 함께 대화형으로 작업하는 방식도 지원한다. 에이전트는 자신의 담당 Phase 스킬들을 내부에서 직접 호출할 수 있다. | 에이전트 명령어 | 이름 | 담당 Phase | 주요 역할 | |----------|------|-----------|----------| | Business Analyst `bmad-agent-analyst`| **Mary** | Phase 1 (분석) | 시장·도메인·기술 리서치, 요구사항 도출. 보물찾기 하듯 인사이트를 발굴 | | Product Manager `bmad-agent-pm`| **John** | Phase 2 (계획) | PRD 작성·검증·편집. "WHY?"를 집요하게 파고드는 탐정형 PM | | UX Designer `bmad-agent-ux-designer`| **Sally** | Phase 2 (UX) | UX 계획 수립. 사용자 문제를 생생하게 전달하는 공감형 디자이너 | | Architect `bmad-agent-architect`| **Winston** | Phase 3 (설계) | 기술 아키텍처 결정. 실용주의적 균형으로 트레이드오프를 안내 | | Scrum Master `bmad-agent-sm`| **Bob** | Phase 4 (스프린트) | 스프린트 계획·스토리 준비. 체크리스트 기반의 제로 모호성 마스터 | | Developer `bmad-agent-dev`| **Amelia** | Phase 4 (개발) | 스토리 구현·코드 리뷰. 테스트 없이 완료 체크 절대 불가 원칙 | | Solo Dev (Quick Flow) `bmad-agent-quick-flow-solo-dev`| **Barry** | 언제든지 | 스펙 → 구현 원스톱. 최소 절차, 최대 효율의 솔로 풀스택 | > **워크플로우 vs 에이전트**: 워크플로우는 단발성 작업에, 에이전트는 지속적인 협업 세션에 적합하다. 에이전트 소환 후에는 해당 Phase의 모든 스킬을 에이전트와 대화하며 실행할 수 있다. --- ### Phase 4: Implementation (구현 단계) 구현 단계는 **반복 사이클(Sprint Cycle)**로 동작한다. 스프린트 상태는 `sprint-status.yaml`로 추적된다. #### 스프린트 사이클 워크플로우 | 코드 | 스킬명 명령어 | 설명 출력물 | |------|--------|------| | **SP** | Sprint Planning 명령어: `bmad-sprint-planning` | 에픽 파일 스캔 → 스토리 상태 파싱 → sprint-status.yaml 생성/갱신 출력물: `implementation-artifacts/sprint-status.yaml` | | **CS** | Create Story 명령어: `bmad-create-story create` | sprint-status.yaml 기반 다음 스토리 식별 → 완전한 스토리 파일 생성. 선행 조건: SP 이후 출력물: `implementation-artifacts/story-*.md` | | **VS** | Validate Story 명령어: `bmad-create-story validate` | 스토리 완전성·인수 기준·의존성 검증. 선행 조건: CS 이후 출력물: story validation report | | **DS** | Dev Story 명령어: `bmad-dev-story` | 스토리 파일 기반 구현. 완료 시까지 중단 없이 실행. 선행 조건: VS 이후 출력물: 구현 코드 (스토리 파일 내 체크박스·Dev Agent Record 업데이트) | | **CR** | Code Review 명령어: `bmad-code-review` | 3가지 병렬 리뷰 레이어(Blind Hunter·Edge Case Hunter·Acceptance Auditor). 선행 조건: DS 이후 출력물: BLOCKER/MAJOR/MINOR/APPROVED 트리아지 보고서 | | **QA** | QA Automation Test 명령어: `bmad-qa-generate-e2e-tests` | 구현된 코드에 대한 자동화 API/E2E 테스트 생성. 코드 리뷰 대체 불가. 선행 조건: DS 이후 출력물: `implementation-artifacts/test-suite` | | **ER** | Retrospective 명령어: `bmad-retrospective` | 에픽 완료 시 회고. 완료 작업 검토·교훈 추출·다음 에픽 준비. 선행 조건: CR 이후 출력물: `implementation-artifacts/retrospective` | #### 언제든 사용 가능한 워크플로우 | 코드 | 스킬명 명령어 | 설명 출력물 | |------|--------|------| | **SS** | Sprint Status 명령어: `bmad-sprint-status` | 현재 스프린트 상태 요약 및 다음 진행 경로 제안 출력물: 상태 요약 | | **CC** | Correct Course 명령어: `bmad-correct-course` | 중요 변경 발생 시 방향 수정 (PRD 수정·아키텍처 재설계·에픽 수정 중 선택) 출력물: `planning-artifacts/change-proposal` | | **QQ** | Quick Dev 명령어: `bmad-quick-dev` | 스프린트 사이클 외부에서 즉석 구현. 단일 목표 900~1600 토큰 범위에 최적화 출력물: `implementation-artifacts/spec-wip.md` + 구현 코드 | --- #### SP — Sprint Planning (스프린트 플래닝) ``` 동작: 1. 모든 epic 파일 스캔 (*epic*.md) 2. 스토리 상태 파싱 (not-started / in-progress / done) 3. sprint-status.yaml 생성 또는 업데이트 출력: implementation-artifacts/sprint-status.yaml ``` #### CS — Create Story (스토리 생성) ``` 동작: 1. sprint-status.yaml에서 다음 스토리 식별 2. PRD, 아키텍처, 에픽 컨텍스트를 모두 수집 3. 개발 에이전트가 바로 사용할 수 있는 완전한 스토리 파일 생성 출력: implementation-artifacts/story-[epic]-[story].md ``` #### VS — Validate Story (스토리 검증) ``` 동작: 1. 스토리 파일 완전성 검증 2. 인수 기준 명확성 확인 3. 의존성 및 선행 조건 확인 4. 개발 준비 완료 여부 판단 출력: 검증 보고서 또는 수정 요청 ``` #### DS — Dev Story (스토리 개발) ``` 동작: 1. 스토리 파일 로드 (명시 경로 또는 자동 탐색) 2. project-context.md 로드 (존재 시) 3. 모든 Tasks/Subtasks 실행 (체크박스 순서대로) 4. 완료 시까지 중단하지 않음 (세션 경계 없음) 5. 스토리 파일의 전용 영역만 수정: - Tasks/Subtasks 체크박스 - Dev Agent Record (디버그 로그, 완료 노트) - File List / Change Log / Status HALT 조건 (개발 중단이 허용되는 경우): - 명확화가 필요한 차단 이슈 - 예상치 못한 아키텍처 충돌 - 테스트 실패가 해결 불가능한 경우 ``` #### CR — Code Review (코드 리뷰) ``` 실행 단계: step-01: 컨텍스트 수집 — sprint-status.yaml, project-context.md, 스토리 파일, 변경된 코드 로드 step-02: 3가지 병렬 리뷰 레이어 동시 실행 [레이어 1] Blind Hunter — 코드만 보고 버그/취약점 탐색 [레이어 2] Edge Case Hunter — 경계 조건 및 미처리 예외 케이스 탐색 [레이어 3] Acceptance Auditor — 스토리 인수 기준 충족 여부 확인 step-03: 트리아지 — 발견 사항을 카테고리별로 분류 BLOCKER — 머지 불가, 반드시 수정 MAJOR — 수정 강력 권장 MINOR — 선택적 개선 APPROVED — 승인 step-04: 결과 제시 — 사용자에게 트리아지 보고서 전달 결과: → BLOCKER/MAJOR → DS(스토리 개발)로 돌아감 → APPROVED → 다음 스토리 또는 QA ``` #### QQ — Quick Dev (빠른 개발) ``` 스프린트 사이클 외부에서 즉석 구현이 필요할 때 사용. 단일 사용자 목표 (900~1600 토큰 범위)에 최적화. 단계: step-01: 요청 명확화 및 라우팅 step-02: 스펙 작성 (인수 기준 포함) step-03: 구현 step-04: 자체 리뷰 step-05: 결과 제시 출력: implementation-artifacts/spec-wip.md + 구현 코드 ``` --- ## 4. Web Design Studio (wds) — UI/UX 중심 설계 WDS는 UI가 핵심인 프로젝트에서 BMad Method의 UX 단계를 대체하거나 병행하는 전문 모듈이다. **Design Log**(`_progress/00-design-log.md`)가 전체 세션에 걸쳐 상태를 추적한다. ### 두 전문 에이전트 | 에이전트 | 코드 | 담당 단계 | |----------|------|-----------| | **Saga** (전략 분석가) | SAGA | Phase 0-2 (전략 및 설계) | | **Freya** (UX 디자이너) | FREYA | Phase 3-4 (개발 및 진화) | ### 전체 흐름 ``` +--- Phase 0: 준비 ---+ +----------------------------------------------------------------------+ │ SAGA (bmad-wds-saga) 전략 분석가 활성화 │ FREYA (bmad-wds-freya) UX 디자이너 활성화 │ AS (bmad-wds-alignment) 이해관계자 합의 (외주 시) │ SB (wds-0-project-setup) 프로젝트 셋업 +----------------------------------------------------------------------+ ↓ +--- Phase 1: Strategy (전략) ---+ +----------------------------------------------------------------------+ │ PB (bmad-wds-project-brief) 프로젝트 브리프 │ → PR (bmad-wds-platform-requirements) 플랫폼 요구사항 (선택) │ → TM (bmad-wds-trigger-mapping) 트리거 맵핑 +----------------------------------------------------------------------+ ↓ +--- Phase 2: Design (설계) ---+ +----------------------------------------------------------------------+ │ OS (bmad-wds-outline-scenarios) 시나리오 개요 (필수) │ ├→ CS (bmad-wds-conceptual-sketching) 개념적 스케치 (선택) │ ├→ SB (bmad-wds-storyboarding) 스토리보드 (선택) │ +→ SP (bmad-wds-conceptual-specs) 스펙 명세 (필수) │ ├→ FI (bmad-wds-functional-components) 기능 컴포넌트 (선택) │ ├→ DS (bmad-wds-design-system) 디자인 시스템 (선택) │ ├→ VD (bmad-wds-visual-design) 비주얼 디자인 (선택) │ +→ DD (bmad-wds-design-delivery) 딜리버리 (필수, FI·DS·VD 수렴) +----------------------------------------------------------------------+ ↓ +--- Phase 3: Build (개발) ---+ +----------------------------------------------------------------------+ │ AD (bmad-wds-agentic-development) 에이전트 개발 │ [P]프로토 [D]개발 [F]버그수정 [E]기능추가 │ [A]분석 [R]역공학 [T]테스트 │ → AT (bmad-wds-usability-testing) 인수/사용성 테스트 │ → PE (bmad-wds-product-evolution) 프로덕트 진화 │ +-[피드백 루프]------------------------------→ AD +----------------------------------------------------------------------+ ``` ### WDS 단계별 상세 설명 #### SB — Project Setup (프로젝트 셋업) — Greenfield / Brownfield 라우팅 WDS의 **가장 중요한 첫 분기점**. 프로젝트 유형에 따라 실행 경로가 완전히 달라진다. ``` Phase 0: Project Setup │ ├-→ Step 1: WDS 소개 + 프로젝트 유형 판단 │ ├-→ Greenfield (신규 개발)? │ +-→ Brownfield (기존 제품 개선)? │ +-→ Step 2: 환경 설정 ├-→ 프로젝트명, 복잡도 (랜딩/웹사이트/앱) ├-→ 기술 스택, 컴포넌트 라이브러리 (선택) ├-→ 브리프 레벨 (complete / simplified) ├-→ 전략 분석 깊이 (full / simplified / skip) ├-→ 폴더 구조 생성 +-→ wds-workflow-status.yaml 생성 │ ├-→ Greenfield → Phase 1 (Strategy) +-→ Brownfield → Phase 8 (Product Evolution) ``` | 경로 | 대상 | 다음 단계 | |------|------|-----------| | **Greenfield** | 새로운 제품·서비스 개발 | Phase 1 → Phase 7 순차 진행 | | **Brownfield** | 기존 운영 중인 제품 개선/변경 | Phase 8 (Product Evolution)로 바로 진행 | > ⚠️ **가장 흔한 실수**: 기존 코드베이스가 있는데 Phase 1부터 시작하는 것. Phase 0이 이를 방지한다. --- #### PB — Project Brief (프로젝트 브리프) WDS의 기반 문서. 모든 설계 결정이 이 문서로 추적된다. ``` 완성형(complete) 브리프 단계: 01. 초기화 → 09. 경쟁 분석 02. 비전 → 10. 제약 조건 03. 포지셔닝 → 11. 톤 오브 보이스 05. 비즈니스 모델 → 12. 프로덕트 브리프 문서 생성 06. B2B 고객 → 13~18. 콘텐츠/언어/SEO 전략 07. 타겟 유저 ``` #### TM — Trigger Mapping (트리거 맵핑) Effect Mapping 방법론 기반. 비즈니스 목표↔사용자 심리 연결. ``` 두 경로: (A) 처음부터: Workshop / Suggest / Dream 모드 중 선택 (B) 기존 문서에서: 자동 합성 후 검증 출력: - trigger-map.md (페르소나 × 욕구/두려움 × 기능 임팩트) - personas/*.md - feature-impact-analysis.md ``` #### OS → SP — Scenarios → Specs (시나리오 → 스펙) ``` OS: 각 페르소나별 시나리오 정의 (persona + goal + outcome) → scenario-overview.md SP: 모든 페이지의 모든 요소를 상세 기술 → 개발자가 바로 구현 가능한 레벨의 스펙 → page-specs/*.md + scenario-specs/*.md ``` #### DD — Design Delivery (설계 딜리버리) ``` 스펙이 완전한지 검증 → YAML 딜리버리 패키지로 변환 출력: - design_artifacts/E-PRD/Design-Deliveries/*.yaml - acceptance-criteria.md ``` #### AD — Agentic Development (에이전트 개발) WDS Phase 3의 핵심이다. **7가지 액티비티** 중 현재 작업에 맞는 것을 선택하는 메뉴 방식으로 동작하며, 액티비티 간 순서 없이 자유롭게 전환할 수 있다. | 코드 | 액티비티 | 사용 시점 | |------|----------|-----------| | `[P]` | **Prototyping** | 스펙 기반 인터랙티브 프로토타입 구축. 프로덕션 코드 작성 전 사용성 검증 | | `[D]` | **Development** | 승인된 스펙에서 프로덕션 코드 직접 작성 | | `[F]` | **Bugfixing** | 기존 코드의 버그·오류 수정 | | `[E]` | **Evolution** | 기존 프로덕트에 새 기능 추가 | | `[A]` | **Analysis** | 자체 코드베이스의 구조 이해 및 분석 | | `[R]` | **Reverse Engineering** | 임의의 소프트웨어·사이트 → 스펙 추출 | | `[T]` | **Acceptance Testing** | 스펙 기준으로 인수 테스트 설계 및 실행 | > 모든 액티비티는 실행 시 `_progress/00-design-log.md`를 읽고 업데이트하여 세션 간 상태를 유지한다. #### Phase 6 — Asset Generation (에셋 생성) 스펙에서 프로덕션 에셋을 자동 생성하는 **메뉴 방식** Phase. 모든 에셋은 승인된 페이지 스펙·디자인 시스템을 기반으로 하며 MCP 서비스를 통해 배치 생성한다. | 코드 | 액티비티 | 생성 결과물 | |------|----------|-----------| | `[W]` | **Wireframes** | 페이지 스펙에서 와이어프레임 아웃라인 | | `[P]` | **Page Designs** | 완성형 페이지 디자인 컴포지션 | | `[U]` | **UI Elements** | 버튼·카드·폼·컴포넌트 등 UI 요소 | | `[I]` | **Icons** | 아이콘 세트 및 개별 아이콘 | | `[M]` | **Images** | 사진·일러스트·배경 이미지 | | `[V]` | **Videos** | 모션 콘텐츠 및 애니메이션 | | `[C]` | **Content** | 5-모델 프레임워크 기반 전략적 텍스트 콘텐츠 | | `[E]` | **Export to Figma** | 스펙과 에셋을 Figma로 푸시 | #### Phase 7 — Design System (디자인 시스템) 컴포넌트·토큰을 코드로 관리하고 로컬호스트 앱으로 시각 탐색하는 **리빙 디자인 시스템**. | 코드 | 액티비티 | 설명 | |------|----------|------| | `[C]` | **Create Design System** | 스펙에서 새 디자인 시스템 구축 | | `[I]` | **Import Design System** | 기존 디자인 시스템 가져오기 | | `[V]` | **View Components** | 선택한 컴포넌트를 로컬호스트로 미리보기 | | `[E]` | **Edit Components** | Figma에서 컴포넌트 시각 편집 | | `[B]` | **Browse Design System** | 토큰·컴포넌트 검색 및 탐색 (로컬호스트) | > `design_system_mode` 설정값 (none / basic / full)에 따라 기능 범위가 결정된다. #### Phase 8 — Product Evolution (제품 진화, Brownfield 전용) 기존 운영 중인 제품의 점진적 개선을 위한 **Kaizen 방식** Phase. 한 번에 하나의 뷰·시나리오·개선에 집중한다. | 코드 | 액티비티 | 설명 | |------|----------|------| | `[A]` | **Analyze Product** | 현재 상태 파악, 개선 대상 발굴 | | `[S]` | **Scope Improvement** | 특정 업데이트를 위한 시나리오 정의 | | `[D]` | **Design Solution** | 업데이트 스케치 및 스펙 작성 | | `[I]` | **Implement** | 새 브랜치에서 코드 작성 | | `[T]` | **Acceptance Test** | 스펙 기준으로 인수 테스트 실행 | | `[P]` | **Deploy** | PR 생성 및 팀 딜리버리 | ``` 한 사이클 = Analyze → Scope → Design → Implement → Test → Deploy 각 사이클은 독립적인 브랜치에서 진행되며, 완료 후 다음 사이클의 입력이 된다. ``` --- ## 5. Test Architecture Enterprise (tea) — 테스트 전문 모듈 TEA는 전문 테스트 아키텍처를 위한 모듈이다. TEA 에이전트 **Murat**이 모든 워크플로우를 담당한다. ### 전체 흐름 ``` +--- Phase 0: Learning (선택) ---+ +----------------------------------------------------------------------+ │ TMT (bmad-teach-me-testing) 테스트 강의 — TEA Academy 7세션 +----------------------------------------------------------------------+ ↓ (선택) +--- Phase 3: Setup — BMM Phase 3과 병행 ---+ +----------------------------------------------------------------------+ │ TD (bmad-testarch-test-design) 테스트 설계 │ → TF (bmad-testarch-framework) 프레임워크 초기화 │ → CI (bmad-testarch-ci) CI/CD 파이프라인 +----------------------------------------------------------------------+ ↓ +--- Phase 4: Implementation — BMM Phase 4와 병행 ---+ +----------------------------------------------------------------------+ │ AT (bmad-testarch-atdd) ATDD │ → TA (bmad-testarch-automate) 자동화 확장 │ → NR (bmad-testarch-nfr) NFR 평가 │ → RV (bmad-testarch-test-review) 테스트 리뷰 │ → TR (bmad-testarch-trace) 추적성 매트릭스 │ +-[반복 사이클]------------------------------→ AT +----------------------------------------------------------------------+ ``` ### 워크플로우 상세 | 코드 | 스킬명 명령어 | 설명 출력물 | |------|--------|------| | **TMT** | Teach Me Testing 명령어: `bmad-teach-me-testing` | 테스팅 기초 교육 (TEA Academy 7세션). 실행 모드: 세션 강의 출력물: `test-artifacts/` — 진도 파일 + 세션 노트 + 수료증 | **TMT — TEA Academy 7세션 커리큘럼:** | 세션 | 주제 | 내용 | 소요 시간 | |------|------|------|-----------| | **Session 1** | Quick Start | TEA Lite 소개 + Automate 워크플로우 핸즈온 실습 | 30분 | | **Session 2** | Core Concepts | 리스크 기반 테스팅, 완료 기준(DoD), 테스팅 엔지니어링 철학 | 45분 | | **Session 3** | Architecture & Patterns | Fixture 패턴, 네트워크 목킹, 테스트 프레임워크 셋업 | 60분 | | **Session 4** | Test Design | 리스크 평가 방법론, 테스트 설계 워크플로우 실습 | 60분 | | **Session 5** | ATDD & Automate | TDD Red-Green 접근법, 실패 테스트 작성 후 통과시키기 | 60분 | | **Session 6** | Quality & Trace | 테스트 리뷰(0-100점), 추적성 매트릭스, 품질 게이트 결정 | 45분 | | **Session 7** | Advanced Patterns | 고급 패턴 심화 탐색 (메뉴 방식, 자율 진행) | 자율 | > 세션 간 진도는 `test-artifacts/teaching-progress/{user_name}-tea-progress.yaml`에 저장되며 언제든 중단/재개할 수 있다. | 코드 | 스킬명 명령어 | 설명 실행 모드 출력물 | |------|------|------| | **TD** | Test Design 명령어: `bmad-testarch-test-design` | 리스크 기반 테스트 계획 수립. 실행 모드: C/R/V/E 출력물: `test-artifacts/test-design/*.md` | | **TF** | Test Framework 명령어: `bmad-testarch-framework` | Playwright 또는 Cypress 테스트 프레임워크 초기화. 실행 모드: C/R/V/E 출력물: `test-artifacts/` — 프레임워크 스캐폴드 | | **CI** | CI Setup 명령어: `bmad-testarch-ci` | CI/CD 품질 게이트 파이프라인 구성. 실행 모드: C/R/V/E 출력물: `test-artifacts/` — CI 설정 파일 | | **AT** | ATDD 명령어: `bmad-testarch-atdd` | 구현 전 실패 테스트 작성 (TDD Red 단계). 실행 모드: C/R/V/E 출력물: `test-artifacts/` — ATDD 테스트 파일 | | **TA** | Test Automation 명령어: `bmad-testarch-automate` | 테스트 커버리지 확장. 실행 모드: C/R/V/E 출력물: `test-artifacts/` — 테스트 스위트 | | **NR** | NFR Assessment 명령어: `bmad-testarch-nfr` | 성능, 보안, 신뢰성 비기능 요구사항 평가. 실행 모드: C/R/V/E 출력물: `test-artifacts/` — NFR 보고서 | | **RV** | Test Review 명령어: `bmad-testarch-test-review` | 0-100점 품질 감사 (모범 사례 대조). 실행 모드: C/R/V/E 출력물: `test-artifacts/` — 리뷰 보고서 | | **TR** | Traceability 명령어: `bmad-testarch-trace` | 요구사항↔테스트 추적성 매트릭스 + 게이트 결정. 실행 모드: C/R/V/E 출력물: `test-artifacts/` — 추적성 매트릭스 + 게이트 결정 | **모든 TEA 워크플로우 실행 모드:** - `[C] Create` : 처음부터 생성 - `[R] Resume` : 중단된 워크플로우 재개 - `[V] Validate` : 기존 산출물 검증 - `[E] Edit` : 기존 산출물 편집 **TEA 설정 값 (BMadExample 프로젝트):** ```yaml test_stack_type: fullstack tea_execution_mode: subagent tea_use_playwright_utils: true risk_threshold: p2 ci_platform: auto test_framework: auto ``` ### BMM Phase 4와의 연계 ``` BMM: DS (bmad-dev-story) 스토리 개발 시작 ↓ [개발 전] TEA: AT (bmad-testarch-atdd) ATDD — 실패 테스트 작성 ↓ BMM: DS (bmad-dev-story) 실패 테스트를 통과시키도록 구현 ↓ TEA: TA (bmad-testarch-automate) 자동화 — 커버리지 확장 ↓ ├→ BMM: CR (bmad-code-review) 코드 리뷰 +→ TEA: RV (bmad-testarch-test-review) 테스트 리뷰 ↓ TEA: TR (bmad-testarch-trace) 추적성 → 배포 게이트 결정 ``` --- ## 6. Creative Intelligence Suite (cis) — 창의적 발상 도구 CIS는 독립적으로 또는 BMM의 Analysis 단계 보조로 사용하는 창의성 도구 모음이다. 순서 없이 자유롭게 사용 가능하다. ### 워크플로우 | 코드 | 스킬명 명령어 | 설명 전문 에이전트 출력물 | |------|--------|--------| | **BSP/BS** | Brainstorming 명령어: `bmad-brainstorming` | 다양한 기법 활용 퍼실리테이션 (SCAMPER, 역브레인스토밍 등). 전문 에이전트: Carson 출력물: `output_folder/brainstorming/` | | **DT** | Design Thinking 명령어: `bmad-cis-design-thinking` | 공감 기반 HCD 5단계 프로세스 (공감→정의→아이디어→프로토→테스트). 전문 에이전트: Maya 출력물: `output_folder/design-thinking/` | | **IS** | Innovation Strategy 명령어: `bmad-cis-innovation-strategy` | 비즈니스 모델 혁신, 와해적 기회 발견. 전문 에이전트: Victor 출력물: `output_folder/innovation-strategy/` | | **PS** | Problem Solving 명령어: `bmad-cis-problem-solving` | PDCA, 5Why, 피시본 등 체계적 문제 해결 방법론. 전문 에이전트: Dr. Quinn 출력물: `output_folder/problem-solving/` | | **ST** | Storytelling 명령어: `bmad-cis-storytelling` | 영웅의 여정, 3막 구조 등 증명된 스토리 프레임워크. 전문 에이전트: Sophia 출력물: `output_folder/storytelling/` | ### 사용 시점 ``` 프로젝트 초기 → BS (아이디어 발산) PRD 작성 전 → DT (사용자 공감, 문제 정의) 전략 수립 시 → IS (혁신 기회 탐색) 복잡한 문제 직면 → PS (체계적 분석) 발표/제안 준비 → ST (설득력 있는 스토리 구성) ``` --- ## 7. BMad Builder (bmb) — 에이전트 및 워크플로우 제작 BMad 자체를 확장할 때 사용하는 메타 모듈이다. 일반 개발 프로젝트와는 분리하여 사용한다. ### 흐름 ``` +--- 에이전트 제작 트랙 ---+ +----------------------------------------------------------------------+ │ BA 에이전트 빌드 │ (대화형 발견으로 스킬 생성/수정/재구성) │ ↔ AA 에이전트 품질 분석 │ (구조/응집도/프롬프트/효율성/스크립트/개선) +----------------------------------------------------------------------+ +--- 워크플로우 제작 트랙 ---+ +----------------------------------------------------------------------+ │ CW 기존 스킬 변환 (BMad 표준 변환 + 비교 보고서) │ → BW 워크플로우 빌드 │ ↔ AW 워크플로우 품질 분석 +----------------------------------------------------------------------+ +--- 모듈 제작 트랙 ---+ +----------------------------------------------------------------------+ │ IM 모듈 아이디어화 │ → CM 모듈 생성 (스킬 폴더 → 설치 가능한 모듈) │ → VM 모듈 검증 +----------------------------------------------------------------------+ +--- Setup 트랙 ---+ +----------------------------------------------------------------------+ │ SB Builder 모듈 설정 (config.yaml 및 help 항목) +----------------------------------------------------------------------+ ``` ### 스킬 상세 | 코드 | 스킬명 명령어 | 설명 주요 인수 옵션 | |------|--------|------| | **SB** | Setup Builder Module 명령어: `bmad-bmb-setup configure` | Builder 모듈 설정. config.yaml 및 help 항목 구성 `-H` (headless 모드) | | **BA** | Build an Agent 명령어: `bmad-agent-builder build-process` | 에이전트 스킬 생성·편집·재구성. 대화형 발견 기반 `-H` (headless), `{description}` (개념 설명), `{path}` (기존 에이전트 경로) | | **AA** | Analyze an Agent 명령어: `bmad-agent-builder quality-analysis` | 에이전트 품질 분석 — 구조·응집도·프롬프트·효율성·개선 기회 `-H` (headless), `{path}` (분석 대상 에이전트) | | **BW** | Build a Workflow 명령어: `bmad-workflow-builder build-process` | 워크플로우·유틸리티 스킬 생성·편집·재구성 `-H` (headless), `{description}` (개념 설명), `{path}` (기존 스킬 경로) | | **AW** | Analyze a Workflow 명령어: `bmad-workflow-builder quality-analysis` | 워크플로우 품질 분석 — 구조·효율성·개선 기회 `-H` (headless), `{path}` (분석 대상 스킬) | | **CW** | Convert a Skill 명령어: `bmad-workflow-builder convert-process` | 기존 스킬을 BMad 표준으로 변환 + 변환 전후 HTML 비교 보고서 생성 `--convert` (변환할 스킬 경로 또는 URL), `-H` (headless) | | **IM** | Ideate Module 명령어: `bmad-module-builder ideate-module` | BMad 모듈 아이디어화 — 구조 탐색·아키텍처 결정·빌드 계획 수립 `{description}` (초기 모듈 아이디어) | | **CM** | Create Module 명령어: `bmad-module-builder create-module` | 스킬 폴더를 설치 가능한 BMad 모듈로 스캐폴딩 `-H` (headless), `{path}` (스킬 폴더 또는 SKILL.md 경로) | | **VM** | Validate Module 명령어: `bmad-module-builder validate-module` | 모듈 구조 완전성·정확성·역량 등록 확인 `-H` (headless), `{path}` (검증할 모듈 또는 스킬) | **트랙별 사용 패턴:** ``` 에이전트 제작: BA(빌드) ↔ AA(품질 분석) — 반복 가능 워크플로우 제작: BW(빌드) ↔ AW(품질 분석) — 반복 가능 CW(기존 스킬 변환) → BW(수정) 모듈 제작: IM(아이디어화) → CM(생성) → VM(검증) Builder 설정: SB (최초 1회 또는 재설정 시) ``` --- ## 8. Core — 범용 유틸리티 언제든 사용할 수 있는 범용 도구 모음이다. | 코드 | 스킬명 명령어 | 설명 출력물 | |------|--------|--------| | **BSP** | Brainstorming 명령어: `bmad-brainstorming` | 하나 또는 복수의 기법으로 브레인스토밍 퍼실리테이션 출력물: `{output_folder}/brainstorming/` | | **DG** | Distillator 명령어: `bmad-distillator [path]` | 문서를 LLM 최적화 형식으로 손실 없이 압축 출력물: 소스 문서 인접 위치 | | **EP** | Editorial Review — Prose 명령어: `bmad-editorial-review-prose [path]` | 표현, 어조, 명확성 등 산문 수준 교정 출력물: 3열 마크다운 테이블 (대상 문서 인접) | | **ES** | Editorial Review — Structure 명령어: `bmad-editorial-review-structure [path]` | 문서 구조 개선 (잘라내기, 재구성, 단순화) 출력물: 구조 개선 보고서 (대상 문서 인접) | | **AR** | Adversarial Review 명령어: `bmad-review-adversarial-general [path]` | 적대적 관점의 품질 검증 (문서, 코드 모두 가능) 출력물: 발견 보고서 | | **ECH** | Edge Case Hunter 명령어: `bmad-review-edge-case-hunter [path]` | 경계 조건 및 처리되지 않은 예외 케이스 발굴 출력물: 미처리 엣지 케이스 목록 | | **SD** | Shard Document 명령어: `bmad-shard-doc [path]` | 500줄 이상의 대형 문서를 섹션별로 분할 출력물: 분할된 파일들 | | **PM** | Party Mode 명령어: `bmad-party-mode` | 다중 에이전트 토론 오케스트레이션 출력물: 토론 세션 | | **BH** | BMad Help 명령어: `bmad-help` | 현재 상태 분석 후 다음 스킬 추천 출력물: 안내 | | **ID** | Index Docs 명령어: `bmad-index-docs` | 폴더 내 문서들의 index.md 자동 생성 출력물: `index.md` | --- ## 9. 모듈 간 연계 전략 (BMadExample 프로젝트 권장) 사주(四柱) 프로젝트 — 사주 정보 입력 → 계산 → 표시 — 에 최적화된 진행 경로다. ### 현재 상태 - 산출물 없음 (빈 상태) - 도메인 지식 리서치 필요 - 기술 스택 미결정 ### 권장 진행 경로 ``` +--- Phase A: 리서치 & 발상 ---+ +----------------------------------------------------------------------+ │ bmm: DR 사주 도메인 리서치 (천간지지·오행·십신 등) │ bmm: TR 기술 리서치 (스택·라이브러리 조사) │ cis: BS 기능 브레인스토밍 (선택) │ ↓ 세 항목의 인사이트 통합 │ bmm: CB 프로덕트 브리프 (DR+TR+BS → 1~2페이지 요약) +----------------------------------------------------------------------+ ↓ +--- Phase B: 계획 수립 ---+ +----------------------------------------------------------------------+ │ wds 트랙: PB → TM → OS → SP → DD (UI 중심) │ bmm 트랙: CP → CU (백엔드 중심) +----------------------------------------------------------------------+ ↓ +--- Phase C: 아키텍처 & 설계 ---+ +----------------------------------------------------------------------+ │ bmm: CA 아키텍처 설계 │ ├→ bmm: CE 에픽 & 스토리 │ │ → bmm: IR 구현 준비 검증 (선택) │ +→ tea: TD 테스트 설계 (CA와 병행) +----------------------------------------------------------------------+ ↓ +--- Phase D: 개발 사이클 (반복) ---+ +----------------------------------------------------------------------+ │ [최초 1회] tea: TF 테스트 프레임워크 │ tea: CI CI/CD 파이프라인 │ ↓ │ bmm: SP 스프린트 플래닝 │ → bmm: CS 스토리 생성 │ → bmm: VS 스토리 검증 │ → tea: AT ATDD │ → bmm: DS 스토리 개발 │ → bmm: CR 코드 리뷰 │ → tea: TA 테스트 자동화 (다음 스토리: CS 로 반복) │ │ [에픽 완료 시] │ → tea: NR NFR 평가 │ → tea: RV 테스트 리뷰 │ → tea: TR 추적성 매트릭스 (배포 前) │ → bmm: ER 회고 +----------------------------------------------------------------------+ ``` --- ## 10. 출력물 위치 레퍼런스 | 산출물 유형 | 위치 | |-------------|------| | 리서치 문서 | `_bmad-output/planning-artifacts/research/` | | 프로덕트 브리프 | `_bmad-output/planning-artifacts/` | | PRD | `_bmad-output/planning-artifacts/prd.md` | | UX 설계 | `_bmad-output/planning-artifacts/ux-design.md` | | 아키텍처 | `_bmad-output/planning-artifacts/architecture.md` | | 에픽 & 스토리 | `_bmad-output/planning-artifacts/epics.md` | | 스프린트 상태 | `_bmad-output/implementation-artifacts/sprint-status.yaml` | | 스토리 파일 | `_bmad-output/implementation-artifacts/story-*.md` | | 빠른 개발 스펙 | `_bmad-output/implementation-artifacts/spec-wip.md` | | WDS 디자인 브리프 | `_bmad-output/design-artifacts/A-Product-Brief/` | | WDS 트리거 맵 | `_bmad-output/design-artifacts/B-Trigger-Map/` | | WDS UX 시나리오 | `_bmad-output/design-artifacts/C-UX-Scenarios/` | | WDS 디자인 시스템 | `_bmad-output/design-artifacts/D-Design-System/` | | WDS PRD/딜리버리 | `_bmad-output/design-artifacts/E-PRD/` | | 테스트 설계 | `_bmad-output/test-artifacts/` | | 프로젝트 지식 베이스 | `_bmad-docs/` | | WDS 디자인 로그 | `_bmad-output/_progress/00-design-log.md` | | WDS 워크플로우 상태 | `_bmad-output/wds-workflow-status.yaml` | --- *이 문서는 `_bmad-docs/bmad-workflow-guide.md`에 저장되었으며, `_bmad/bmm/config.yaml`의 `project_knowledge` 경로를 통해 AI 에이전트가 자동으로 참조합니다.*