기존 프로젝트 FAQ

BMad Method(BMM)로 기존 프로젝트에서 작업할 때 자주 묻는 질문에 빠르게 답합니다.

질문

• 프로젝트 문서화를 먼저 실행해야 하나요?
• 프로젝트 문서화 실행을 잊었다면 어떻게 하나요?
• 기존 프로젝트에서는 구현을 어떻게 하나요?
• 기존 코드가 모범 사례를 따르지 않으면 어떻게 하나요?

프로젝트 문서화를 먼저 실행해야 하나요?

bmad-document-project는 더 이상 사용하지 않습니다. 이를 대체하는 bmad-project-context는 별도의 문서를 생성하지 않고 저장소의 AGENTS.md에 작고 검증된 블록을 작성합니다. 특히 다음 상황에서는 먼저 실행하는 것이 좋습니다.

• 기존 문서가 없습니다
• 문서가 오래되었습니다
• AI 에이전트가 기존 코드에 대한 컨텍스트가 필요합니다

저장소에 이미 잘 관리되는 에이전트 지침이 있거나, 다른 도구나 기법으로 에이전트가 기존 시스템을 파악하게 할 예정이라면 건너뛸 수 있습니다.

프로젝트 문서화 실행을 잊었다면 어떻게 하나요?

걱정하지 마세요. 언제든 bmad-project-context를 실행할 수 있습니다. Refresh와 Audit을 실행하면 프로젝트 도중이나 이후에도 컨텍스트를 정확하게 유지합니다. 이미 생성한 문서도 검증할 소스로 활용합니다.

기존 프로젝트에서는 구현을 어떻게 하나요?

새 프로젝트와 마찬가지로 bmad-build를 실행하세요. Build는 다음을 수행합니다.

• 기존 기술 스택 자동 감지
• 기존 코드 패턴 분석
• 관례 감지 및 확인 요청
• 기존 코드를 존중하는, 맥락이 충분히 담긴 사양 생성

범위가 명확한 변경은 바로 시작할 수 있습니다. 작업 규모가 크다면 계획된 스토리와 상위 산출물을 함께 제공하세요.

기존 코드가 모범 사례를 따르지 않으면 어떻게 하나요?

Build는 관례를 감지한 뒤 “이 기존 관례를 따를까요?”라고 묻고, 사용자가 결정하게 합니다.

• 예 → 현재 코드베이스와의 일관성 유지
• 아니요 → 새 표준 수립(사양에 이유를 문서화)

BMM은 선택을 존중합니다. 현대화를 강제하지 않지만 필요한 제안은 합니다.

여기에 답이 없는 질문이 있나요? GitHub Issue를 열거나 Discord에서 물어보세요. 추가하겠습니다.