BMAD Method 튜토리얼 2편: 설치하고 바로 시작하는 BMAD 첫 사용법

요약#

참고 자료#

• BMAD Method - How to Install BMad - 설치 절차와 생성되는 파일
• BMAD Method - Getting Started - 설치 직후 첫 단계와 전체 흐름
• BMAD Method - How to Get Answers About BMad - bmad-help 사용법
• BMAD Method - Skills - skill과 agent menu trigger 차이

바로 써먹는 템플릿#

처음 설치할 때는 아래 명령만 기억해도 충분합니다.

터미널에서 먼저 실행할 명령

1
npx bmad-method install

설치가 끝나면 AI 도구 안에서 바로 이렇게 시작하면 됩니다.

설치 직후 가장 먼저 물어볼 질문

1
bmad-help
2

3
방금 BMAD를 설치했습니다.
4
무엇부터 시작하면 될까요?

설치 전에 이것만 확인하세요#

BMAD 설치 전에 필요한 준비물은 생각보다 단순합니다.
공식 문서 기준으로 핵심 조건은 Node.js² 20 이상과 npx³입니다.

여기에 Git⁴도 사실상 필수로 보는 편이 맞습니다.
BMAD가 만드는 산출물과 이후 변경 흐름을 관리하려면 버전 관리가 반드시 필요하기 때문입니다.

또 하나 필요한 것은 AI 코딩 도구입니다.
공식 문서는 Claude Code, Cursor 같은 AI IDE를 예시로 들고, 비슷한 도구도 설치 대상으로 설명합니다.
즉 BMAD는 단독 앱이라기보다, 이미 쓰고 있는 AI 코딩 환경 위에 얹는 구조라고 이해하면 됩니다.

설치는 정말 이 한 줄에서 시작합니다#

BMAD 설치의 출발점은 단순합니다.
프로젝트 폴더에서 아래 명령을 실행하면 됩니다.

기본 설치 명령

1
npx bmad-method install

공식 설치 문서는 여기서부터 대화형으로 안내가 이어진다고 설명합니다.
즉 처음에는 긴 옵션을 외울 필요가 없습니다.

설치 중에는 보통 네 가지를 고르게 됩니다.

• 어디에 설치할지
• 어떤 AI 도구를 쓸지
• 어떤 module⁵을 넣을지
• 나머지 설정을 어떤 값으로 둘지

처음 쓰는 입장에서는 이 선택지가 많아 보여도, 실제로는 어렵지 않습니다.
대부분의 개인 사용자는 현재 프로젝트 디렉터리에 설치하고, 자기가 쓰는 AI 도구를 하나 고르고, BMad Method 모듈만 선택하면 충분합니다.

공식 문서도 “대부분의 사용자는 BMad Method 모듈만 원한다”고 설명합니다.
즉 처음부터 여러 모듈을 억지로 고를 필요는 없습니다.

설치 과정에서 무엇을 고르게 될까요?#

설치가 끝나면 무엇이 생길까요?#

설치가 끝나면 가장 먼저 눈에 띄는 폴더는 _bmad/와 _bmad-output/입니다.

• _bmad/: agents, workflows, tasks, 설정 파일이 들어갑니다
• _bmad-output/: 앞으로 생성할 문서와 artifact⁶가 저장됩니다

Getting Started 문서도 이 두 폴더를 먼저 소개합니다.
즉 _bmad/는 BMAD의 엔진이고, _bmad-output/은 결과물이 쌓이는 공간이라고 보면 이해하기 쉽습니다.

여기에 도구별 skill 디렉터리도 함께 생깁니다.
예를 들어 공식 Reference 문서는 Claude Code라면 .claude/skills/, Cursor라면 .cursor/skills/ 아래에 skill 디렉터리가 생성된다고 설명합니다.

중요한 점은 이 skill 파일을 사람이 직접 손으로 만들 필요가 없다는 점입니다.
설치 프로그램이 선택한 모듈과 도구 기준으로 각 skill⁷을 생성합니다.
즉 bmad-help, bmad-create-prd, bmad-dev 같은 이름이 이 과정에서 준비됩니다.

설치 직후 첫 30분은 bmad-help만 써도 됩니다#

BMAD를 처음 설치하고 나면 많은 분이 곧바로 agent 목록이나 workflow 목록부터 확인하고 싶어집니다.
하지만 공식 문서는 더 쉬운 출발점을 줍니다.
설치 직후에는 바로 bmad-help를 실행하라고 말합니다.

Getting Started가 제시하는 가장 쉬운 경로도 이렇습니다.

• 설치합니다
• bmad-help로 지금 무엇부터 시작하면 되는지 묻습니다
• 이후는 workflow⁸ 단위로 안내를 따라갑니다

이 흐름이 좋은 이유는 분명합니다.
처음부터 phases와 commands를 모두 외울 필요가 없기 때문입니다.
bmad-help는 현재 설치된 모듈을 보고, 지금 상황에서 맞는 다음 단계를 추천해 줍니다.

공식 문서 기준으로 bmad-help는 이런 역할을 합니다.

• 지금 무엇이 설치됐는지 반영합니다
• 어떤 선택지가 있는지 보여줍니다
• 첫 번째 필수 작업이 무엇인지 알려줍니다
• 다음 workflow가 무엇인지 이어서 안내합니다

즉 bmad-help는 설치 확인 도구이면서 동시에 길 안내 역할도 합니다.
처음 며칠은 이것만 제대로 써도 BMAD 사용 감각이 꽤 빨리 잡힙니다.

처음부터 agent와 trigger를 외울 필요는 없습니다#

BMAD를 처음 접하면 bmad-help, bmad-pm, CP, DS 같은 이름이 한꺼번에 보여서 부담스럽습니다.
여기서 중요한 것은 공식 문서도 시작 방식을 두 가지로 나눠 설명한다는 점입니다.

• skill 이름을 직접 호출하는 방식
• agent를 먼저 연 뒤 menu trigger를 쓰는 방식

Reference 문서는 초심자에게 더 쉬운 쪽이 skill 방식이라고 사실상 말하고 있습니다.
이미 어떤 workflow를 실행할지 알고 있다면 bmad-create-prd처럼 skill 이름을 직접 부르면 됩니다.
반대로 CP, DS처럼 짧은 코드로 부르는 명령은 이미 agent 대화 안에서 일하고 있을 때 더 자연스럽습니다.

즉 처음에는 이렇게 생각하면 됩니다.

• 시작점은 bmad-help
• 익숙해지면 bmad-create-prd, bmad-dev 같은 skill 이름 사용
• CP, DS처럼 agent 안에서 쓰는 짧은 코드 명령은 나중에 익혀도 충분

이렇게 접근하면 BMAD가 훨씬 덜 복잡하게 느껴집니다.

fresh chat는 설치 직후부터 습관으로 들이는 편이 좋습니다#

Getting Started 문서는 각 workflow마다 fresh chat⁹를 쓰라고 분명하게 설명합니다.
이건 고급 팁이 아니라, 초반부터 들여야 할 기본 습관에 가깝습니다.

이유는 단순합니다.
한 대화 안에 설치, 기획, 설계, 구현을 모두 밀어 넣으면 맥락이 길어지고, 앞에서 정한 기준이 뒤로 갈수록 흐려집니다.

반대로 workflow 하나를 끝내고 새 대화로 넘어가면, 지금 필요한 문서와 목적만 들고 시작할 수 있습니다.
BMAD가 문서를 중요하게 보는 이유도 여기에 있습니다.
기억을 긴 대화에 맡기지 않고, 필요한 내용을 문서에 남겨 다음 단계로 넘기기 때문입니다.

즉 BMAD 설치는 명령 하나로 끝나지만, BMAD 사용 습관은 여기서부터 시작됩니다.
설치 직후부터 fresh chat를 의식해 두면 이후 회차가 훨씬 자연스럽게 이어집니다.

처음에 가장 많이 헷갈리는 지점#

1
bmad-help
2

3
방금 BMAD를 설치했습니다.
4
무엇부터 시작하면 될까요?

2편의 핵심은 설치보다 첫 진입입니다#

많은 설치 가이드는 명령을 보여주고 끝납니다.
하지만 BMAD에서는 설치 자체보다, 설치 직후 무엇을 하느냐가 더 중요합니다.

이 글에서 꼭 기억할 것은 세 가지입니다.

• 설치는 npx bmad-method install에서 시작합니다
• 설치 직후에는 bmad-help부터 실행합니다
• 처음에는 skill 이름만 익히고, 복잡한 trigger는 나중으로 미룹니다

이 세 가지만 잡히면 BMAD는 훨씬 덜 낯설어집니다.
다음 글에서는 이 흐름을 더 실전적으로 가져가서, 작은 작업을 빠르게 처리하는 Quick Flow와 Quick Dev 쪽으로 넘어가겠습니다.