---
title: '기존 프로젝트'
description: 기존 코드베이스에서 BMad Method를 사용하는 방법
sidebar:
  order: 7
---

기존 프로젝트와 레거시 코드베이스에서 작업할 때 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 에이전트가 이미 자리 잡은 관례를 따릅니다.
:::

프로젝트 컨텍스트 생성 워크플로를 실행합니다.

```bash
bmad-generate-project-context
```

이 워크플로는 코드베이스를 스캔해 다음을 식별합니다.

- 기술 스택과 버전
- 코드 구성 패턴
- 명명 규칙
- 테스트 접근 방식
- 프레임워크별 패턴

생성된 파일을 검토하고 다듬거나, 원한다면 `_bmad-output/project-context.md`에 직접 만들 수 있습니다.

[프로젝트 컨텍스트 자세히 알아보기](../explanation/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 과정은 필요하지 않습니다.

### 아키텍처 고려 사항

아키텍처를 진행할 때 아키텍트가 다음을 하도록 확인하세요.

- 적절한 문서 파일을 사용합니다
- 기존 코드베이스를 스캔합니다

여기서는 특히 주의하세요. 이미 있는 것을 다시 만들거나 기존 아키텍처와 어긋나는 결정을 방지해야 합니다.

## 더 보기

- **[빠른 수정](./quick-fixes.md)** - 버그 수정과 임시 변경
- **[기존 프로젝트 FAQ](../explanation/established-projects-faq.md)** - 기존 프로젝트 작업에 대한 일반 질문