4.7 KiB
| title | description | sidebar | ||
|---|---|---|---|---|
| 기존 프로젝트 | 기존 코드베이스에서 BMad Method를 사용하는 방법 |
|
기존 프로젝트와 레거시 코드베이스에서 작업할 때 BMad Method를 효과적으로 사용하세요.
이 가이드는 BMad Method로 기존 프로젝트에 적응하는 핵심 워크플로를 다룹니다.
:::note[필수 조건]
- BMad Method 설치(
npx bmad-method install) - 작업하려는 기존 코드베이스
- AI 기반 IDE(Claude Code 또는 Cursor) 접근 권한 :::
1단계: 완료된 계획 산출물 정리
BMad 과정으로 모든 PRD 에픽과 스토리를 완료했다면 해당 파일을 정리하세요. 필요하다면 보관하거나 삭제하거나 버전 기록에 의존하세요. 다음 위치에 이 파일들을 계속 두지 마세요.
docs/_bmad-output/planning-artifacts/_bmad-output/implementation-artifacts/
2단계: 프로젝트 컨텍스트 만들기
:::tip[기존 프로젝트에 권장]
project-context.md를 생성해 기존 코드베이스의 패턴과 규칙을 포착하세요. 이렇게 하면 변경을 구현할 때 AI 에이전트가 이미 자리 잡은 관례를 따릅니다.
:::
프로젝트 컨텍스트 생성 워크플로를 실행합니다.
bmad-generate-project-context
이 워크플로는 코드베이스를 스캔해 다음을 식별합니다.
- 기술 스택과 버전
- 코드 구성 패턴
- 명명 규칙
- 테스트 접근 방식
- 프레임워크별 패턴
생성된 파일을 검토하고 다듬거나, 원한다면 _bmad-output/project-context.md에 직접 만들 수 있습니다.
3단계: 품질 높은 프로젝트 문서 유지
docs/ 폴더에는 프로젝트를 정확하게 나타내는 간결하고 잘 구성된 문서가 있어야 합니다.
- 의도와 비즈니스 근거
- 비즈니스 규칙
- 아키텍처
- 그 밖의 관련 프로젝트 정보
복잡한 프로젝트라면 bmad-document-project 워크플로 사용을 고려하세요. 전체 프로젝트를 스캔하고 실제 현재 상태를 문서화하는 실행 시 선택 가능한 변형을 제공합니다.
4단계: 도움 받기
BMad 도움말: 시작점
다음에 무엇을 해야 할지 확실하지 않을 때 언제든 bmad-help를 실행하세요. 이 지능형 가이드는 다음을 수행합니다.
- 프로젝트를 검사해 이미 완료된 작업을 확인합니다
- 설치된 모듈을 기준으로 선택지를 보여줍니다
- 자연어 질문을 이해합니다
bmad-help 기존 Rails 앱이 있는데 어디서 시작하면 좋나요?
bmad-help 빠른 흐름과 전체 BMad Method는 무엇이 다른가요?
bmad-help 사용할 수 있는 워크플로를 보여 주세요
BMad 도움말은 모든 워크플로 끝에서 자동으로 실행되어 다음에 무엇을 해야 할지 명확히 안내합니다.
접근 방식 선택
변경 범위에 따라 두 가지 주요 선택지가 있습니다.
| 범위 | 권장 접근 방식 |
|---|---|
| 작은 업데이트나 추가 | bmad-quick-dev를 실행해 의도 정리, 계획, 구현, 리뷰를 하나의 워크플로에서 처리합니다. 전체 4단계 BMad Method는 과할 가능성이 큽니다. |
| 큰 변경이나 추가 | 필요한 만큼만 엄격하게 적용하면서 BMad Method로 시작합니다. |
PRD 작성 중
제품 개요를 만들거나 바로 PRD로 들어갈 때 에이전트가 다음을 하도록 확인하세요.
- 기존 프로젝트 문서를 찾고 분석합니다
- 현재 시스템에 대한 적절한 컨텍스트를 읽습니다
에이전트를 명시적으로 안내할 수 있지만 목표는 새 기능이 기존 시스템과 잘 통합되게 하는 것입니다.
UX 고려 사항
UX 작업은 선택 사항입니다. 결정 기준은 프로젝트에 UX가 있는지가 아니라 다음입니다.
- UX 변경을 작업할 예정인지
- 의미 있는 새 UX 디자인이나 패턴이 필요한지
만족스러운 기존 화면을 단순히 업데이트하는 정도라면 전체 UX 과정은 필요하지 않습니다.
아키텍처 고려 사항
아키텍처를 진행할 때 아키텍트가 다음을 하도록 확인하세요.
- 적절한 문서 파일을 사용합니다
- 기존 코드베이스를 스캔합니다
여기서는 특히 주의하세요. 이미 있는 것을 다시 만들거나 기존 아키텍처와 어긋나는 결정을 방지해야 합니다.
더 보기
- 빠른 수정 - 버그 수정과 임시 변경
- 기존 프로젝트 FAQ - 기존 프로젝트 작업에 대한 일반 질문