v6로 업그레이드하는 방법

BMad 설치 프로그램을 사용해 v4에서 v6로 업그레이드하세요. 레거시 설치 자동 감지와 마이그레이션 지원이 포함되어 있습니다.

사용 시점

BMad v4가 설치되어 있습니다(.bmad-method 폴더)
새 v6 아키텍처로 마이그레이션하고 싶습니다
보존해야 할 기존 계획 산출물이 있습니다

단계

1. 설치 프로그램 실행

설치 프로그램 안내를 따르세요.

2. 레거시 설치 처리

v4가 감지되면 다음 중 선택할 수 있습니다.

설치 프로그램이 .bmad-method를 백업하고 제거하게 합니다
종료한 뒤 수동으로 정리합니다

BMad Method 폴더 이름을 다르게 지정했다면 직접 폴더를 제거해야 합니다.

3. IDE 스킬 정리

레거시 v4 IDE 명령/스킬을 수동으로 제거하세요. 예를 들어 Claude Code를 사용한다면 bmad로 시작하는 중첩 폴더를 찾아 제거합니다.

.claude/commands/

새 v6 스킬은 다음 위치에 설치됩니다.

.claude/skills/

4. 계획 산출물 마이그레이션

계획 문서(제품 개요/PRD/UX/아키텍처)가 있다면:

설명적인 이름으로 _bmad-output/planning-artifacts/에 옮기세요.

PRD 문서는 파일명에 PRD를 포함합니다
파일 유형에 맞게 brief, architecture, ux-design을 포함합니다
샤딩된 문서는 이름 있는 하위 폴더에 둘 수 있습니다

계획 도중이라면: v6 워크플로로 다시 시작하는 것을 고려하세요. 기존 문서를 입력으로 사용할 수 있습니다. 웹 검색과 IDE 계획 모드를 활용해 단계별로 요구사항을 구체화하는 새 워크플로가 더 나은 결과를 냅니다.

5. 진행 중인 개발 마이그레이션

이미 생성 또는 구현된 스토리가 있다면:

v6 설치를 완료합니다
epics.md 또는 epics/epic*.md를 _bmad-output/planning-artifacts/에 둡니다
개발자의 bmad-sprint-planning 워크플로를 실행합니다
이미 완료된 에픽/스토리를 에이전트에게 알려줍니다

얻는 결과

v6 통합 구조:

your-project/
├── _bmad/               # 단일 설치 폴더
│   ├── _config/         # 커스터마이징
│   │   └── agents/      # 에이전트 커스터마이징 파일
│   ├── core/            # 범용 core 프레임워크
│   ├── bmm/             # BMad Method 모듈
│   ├── bmb/             # BMad 빌더
│   └── cis/             # 창의적 지능 제품군
└── _bmad-output/        # 출력 폴더(v4의 문서 폴더)

모듈 마이그레이션

v4 모듈	v6 상태
`.bmad-2d-phaser-game-dev`	BMGD 모듈에 통합
`.bmad-2d-unity-game-dev`	BMGD 모듈에 통합
`.bmad-godot-game-dev`	BMGD 모듈에 통합
`.bmad-infrastructure-devops`	지원 중단 - 새 DevOps 에이전트 예정
`.bmad-creative-writing`	아직 적용되지 않음 - 새 v6 모듈 예정

주요 변경 사항

개념	v4	v6
코어	`_bmad-core`는 실제로 BMad Method였습니다	`_bmad/core/`는 범용 프레임워크입니다
메서드	`_bmad-method`	`_bmad/bmm/`
설정	파일을 직접 수정	모듈별 `config.yaml`
문서	샤딩 또는 비샤딩 필수 설정	완전히 유연하며 자동 스캔