기존 프로젝트

기존 프로젝트와 레거시 코드베이스에서 작업할 때 BMad Method를 효과적으로 사용하세요.

이 가이드는 BMad Method로 기존 프로젝트에 적응하는 핵심 워크플로를 다룹니다.

1단계: 완료된 계획 산출물 정리

BMad 과정으로 모든 PRD 에픽과 스토리를 완료했다면 해당 파일을 정리하세요. 필요하다면 보관하거나 삭제하거나 버전 기록에 의존하세요. 다음 위치에 이 파일들을 계속 두지 마세요.

docs/
_bmad-output/planning-artifacts/
_bmad-output/implementation-artifacts/

2단계: 프로젝트 컨텍스트 만들기

프로젝트 컨텍스트 스킬을 실행합니다.

bmad-project-context

이 스킬은 기존 자료를 읽고 현재 상태를 평가한 뒤 에이전트가 지켜야 할 규칙을 묻습니다. 나머지 정보는 직접 찾아 검증하며, 명령은 기록하기 전에 모두 실행해 확인합니다. 생성 문서를 늘리지 않고 저장소의 AGENTS.md에 간결하고 검증된 규칙 블록을 작성합니다. 사람이 직접 관리해 온 파일은 개선할 기준으로 삼고, 비대한 docs/ 폴더는 내용을 더 보태지 않은 채 코드와 대조할 자료로 사용합니다.

프로젝트 컨텍스트 자세히 알아보기

3단계: 품질 높은 프로젝트 문서 유지

docs/ 폴더에는 프로젝트를 정확하게 나타내는 간결하고 잘 구성된 문서가 있어야 합니다.

의도와 비즈니스 근거
비즈니스 규칙
아키텍처
그 밖의 관련 프로젝트 정보

bmad-project-context는 이 가운데 에이전트가 읽는 부분을 감사하고 유지합니다. 컨텍스트가 오래됐다고 느껴지면 감사를 실행하세요. 내용을 계속 쌓는 대신 줄이고 다시 검증합니다. 이전 bmad-document-project 워크플로는 더 이상 사용하지 않으며 이 스킬로 연결됩니다.

4단계: 도움 받기

BMad 도움말: 시작점

다음에 무엇을 해야 할지 확실하지 않을 때 언제든 bmad-help를 실행하세요. 이 지능형 가이드는 다음을 수행합니다.

프로젝트를 검사해 이미 완료된 작업을 확인합니다
설치된 모듈을 기준으로 선택지를 보여줍니다
자연어 질문을 이해합니다

bmad-help 기존 Rails 앱이 있는데 어디서 시작하면 좋나요?
bmad-help 이 변경을 구현하기 전에 계획이 얼마나 필요한가요?
bmad-help 사용할 수 있는 워크플로를 보여 주세요

BMad 도움말은 모든 워크플로 끝에서 자동으로 실행되어 다음에 무엇을 해야 할지 명확히 안내합니다.

계획 깊이 선택

모든 구현에는 bmad-build를 사용합니다. 범위에 따라 먼저 준비할 컨텍스트가 달라집니다.

범위	권장 준비 사항
명확한 업데이트나 추가	요청, 이슈 또는 기존 사양을 전달해 `bmad-build`로 바로 시작합니다.
큰 변경이나 추가	필요한 PRD, UX, 아키텍처, 에픽, 스토리, 준비 상태, 스프린트 컨텍스트를 마련한 다음 선택한 작업을 `bmad-build`에 전달합니다.

PRD 작성 중

제품 개요를 만들거나 바로 PRD로 들어갈 때 에이전트가 다음을 하도록 확인하세요.

기존 프로젝트 문서를 찾고 분석합니다
현재 시스템에 대한 적절한 컨텍스트를 읽습니다

에이전트에게 구체적으로 지시할 수도 있습니다. 다만 새 기능이 기존 시스템과 자연스럽게 맞물려야 합니다.

UX 고려 사항

UX 작업은 선택 사항입니다. 결정 기준은 프로젝트에 UX가 있는지가 아니라 다음입니다.

UX 변경을 작업할 예정인지
의미 있는 새 UX 디자인이나 패턴이 필요한지

만족스러운 기존 화면을 단순히 업데이트하는 정도라면 전체 UX 과정은 필요하지 않습니다.

아키텍처 고려 사항

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

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

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