BMAD: 혼자 하는 바이브코딩에 '팀'을 붙이기

이름부터 풀어보면

BMAD는 Breakthrough Method for Agile AI-Driven Development의 줄임말이에요. 풀어 쓰면 ‘AI와 팀처럼 일하는 애자일 개발 방법’ 정도가 됩니다. 거창해 보이지만 핵심은 단순해요.

왜 나눌까? — 관점이 달라야 좋은 결과가 나온다

한 명에게 다 맡기면 ‘대충 그럴듯한’ 답으로 수렴하기 쉬워요. 반면 역할을 나누면 각자 지키는 게 달라집니다 — 기획자는 범위를, 설계자는 구조를, 개발자는 ‘진짜 만들 수 있는가’를 봅니다. 이 긴장이 결과의 완성도를 끌어올려요.

잠깐 — 여기서 ‘페르소나’가 뭔가요?

같은 Claude라도 “기획자로서 생각해줘”라고 하면 기획자처럼, “개발자로서”라고 하면 개발자처럼 답이 달라져요. BMAD는 이 역할별 사고방식을 아예 이름과 성격을 가진 캐릭터로 만들어 둔 거예요. 이걸 페르소나(전문가 분신)라고 부릅니다. 각자 자기 관점만 신경 쓰는 Claude의 ‘분신’들이라고 보면 돼요 — 실제로는 각자 따로 생각하는 서브에이전트(작은 AI 일꾼)로 돌아갑니다.

이름은 부르기 쉬우라고 붙은 것뿐이에요. 외울 필요 없습니다.아래가 설치하면 기본으로 들어오는 팀원들이에요.

부를 땐 이름 대신 ‘설계자’, ‘기획자’처럼 역할로 불러도 알아들어요. 누가 있는지 궁금하면 언제든 bmad에게 물어보세요. (테크라이터 Paige는 지금 ‘휴식 중’이라 기본 팀에서 빠져 있어요. 테스트 만들기와 코드 리뷰는 개발자 Amelia가 맡아요.)

각 페르소나를 직접 읽어보세요

이 팀원들은 그냥 이름만 다른 게 아니에요. 설치하면 각자 정체성·말투·원칙이 적힌 정의 파일이 함께 들어옵니다. 아래는 BMAD에 실제로 들어 있는 정의를 원문 그대로 옮기고, 한글 풀이를 붙인 거예요. 눌러서 펼쳐보세요.

원본은 BMAD 공식 저장소의 skills/bmad-agent-…/customize.toml파일이에요(설치하면 프로젝트 안에도 들어와요). Claude Code에서 “Winston의 페르소나 정의 파일을 보여줘”라고 해도 열어 보여줍니다.

BMAD를 설치하려면 컴퓨터에 몇 가지 준비물이 있어야 해요. 공식 문서가 정한 준비물은 이래요.

• 스킬을 지원하는 AI 코딩 도구 — 지금 쓰는 Claude Code예요
• Node.js · npm · Git — 설치 도구(npx)를 돌리는 데 필요해요 (Node.js는 20.12 이상)
• uv — BMAD 설정 스크립트를 돌리는 데 필요해요

이름이 낯설어도 괜찮아요. 아래 문장에 “없으면 네가 먼저 설치해줘”가 들어 있어서 Claude가 알아서 확인하고 채워줘요.

설치했어요 — 이제 어떻게 쓰나요?

새 프로그램을 배우는 게 아니에요. 평소처럼 Claude에게 말을 걸되, 부르는 방법이 딱 두 가지 생겼다고 생각하면 됩니다. 헷갈릴 땐 bmad에게 “어떻게 시작해?”라고 물어보세요. 지금 상황을 보고 다음 할 일을 알려줘요.

시작하는 법

Claude Code에 아래 한 줄만 입력하면 방이 열려요. 주제를 던지면 전문가들이 각자 관점에서 의견을 내고, 내가 방을 닫을 때까지 이어집니다.

방이 열리면 이렇게 주제를 던져보세요. 중간에 사람을 부르거나 바꿀 수도 있어요 (“UX 디자이너도 불러줘”, “Winston, 그 부분 더 파고들어봐”).

실제 사례 — 전문가별로 따로 검토 → 하나로 종합

기본 모드는 한 모델이 여러 명을 연기하는 대화방이에요. 더 날카롭게 보고 싶을 땐 전문가마다 따로 검토를 시키는 방식(subagent 모드)이 있어요. 아래는 지어낸 예시가 아니라, 바로 이 교재 사이트를 만들면서 실제로 돌린검토예요 — Day2 커리큘럼 구성을 놓고 기획자·설계자·개발자·UX 네 명에게 동시에 검토를 맡겼습니다.

언제 쓰면 좋나

① 정석 코스 (Full Method)

파티 모드가 ‘여럿이 모여 토론’이라면, 정석 코스는 한 명씩 바통을 넘기는 릴레이예요. 실제 개발팀이 일하는 순서 그대로 — 앞 사람의 결과물을 다음 사람이 받아 이어갑니다. 아래 네 단계가 기본 흐름이에요.

핵심은 산출물이 다음 단계로 넘어간다는 거예요 — 브리프가 기획서가 되고, 기획서가 설계가 되고, 설계가 코드가 됩니다. 순서가 헷갈리면 bmad에게 물어보세요. 지금 문서가 어디까지 있는지 보고 다음 할 일을 알려줘요. (작은 일은 처음부터 /bmad-build로 바로 만들고, 큰 일은 기획·설계를 거쳐요. 일의 크기에 맞춰 단계를 조절하는 게 BMAD의 방식이에요.)

② 나만의 에이전트 · 워크플로우 만들기 (BMad Builder)

공식 모듈인 BMad Builder를 추가하면, 내 업무에 딱 맞는 전문가(에이전트)와 작업 순서(워크플로우)를 대화만으로 만들 수 있어요. 빌더가 질문을 던지며 하나씩 잡아주고, 결과는 스킬 폴더로 나와서 바로 쓸 수 있어요.

설치도 똑같이 Claude에게 부탁하면 돼요.

③ 실제로 바꿔 쓴 사례 — BMAD를 3D 프린팅으로

제품 기획용 BMAD를 3D 프린팅에 그대로 쓸 순 없어요 — 도메인이 완전히 다르니까요. 그래서 투명 PETG 마스코트를 출력하면서, Claude에게 “BMAD 페르소나를 본떠 3D 프린팅용으로 만들자”고 해서 확장팩을 만들었어요. 뼈대(페르소나·파티 모드·지휘자·버전 관리)는 그대로 두고, 안에 든 전문 지식과 산출물만 갈아끼운 거예요. 무엇을 어떻게 바꿨는지 한눈에 보면 이렇습니다.