TL;DR

  • BMad Method는 소규모 변경부터 수년간 운영된 시스템까지, 생각하는 과정을 유지하며 아이디어와 변경 요청을 작동하는 소프트웨어로 전환하는 애자일 AI 기반 개발 방식임.
  • AI 기반 개발(AiDD)은 코드 작성뿐 아니라 구축할 대상, 시스템 구성 방식, 학습에 따른 변경까지 아우름.
  • BMad는 의사결정을 명시하고 맥락을 이어가며, 작업 규모에 맞춰 절차를 조정함.
  • npx skills, Claude Code 플러그인, Codex 플러그인 중 하나로 설치하며, AI 코딩 도구와 uv가 필요함.
  • BMad Method와 전문 모듈을 활용해 계획, 구현, 검토, 수정, 학습을 하나의 전달 흐름으로 진행함.

BMad Method 소개

  • 애자일 AI 기반 개발은 아이디어나 변경 요청을 사고 과정을 포기하지 않고 작동하는 소프트웨어로 전환하는 방식임.
  • AI 기반 개발(AiDD)은 코드만이 아니라 무엇을 만들지, 시스템이 어떻게 구성되는지, 학습에 따라 어떻게 바뀌는지까지 포함함.
  • BMad Method는 의사결정을 명시적으로 유지하고 맥락을 후속 작업에 전달하며, 작업 규모에 맞춰 절차를 조정하는 애자일 방식임.
  • 단순한 변경은 곧바로 구현하고, 복잡한 작업에는 필요한 깊이의 계획을 더함.
  • 주말 동안 만드는 프로토타입부터 수년간 축적된 이력이 있는 시스템까지 동일한 방법을 적용함.
  • BMad를 처음부터 끝까지 사용하거나, 브리프·명세·아키텍처만 기존 개발 워크플로에 가져올 수 있음.

시작하기

  • 설치 경로를 하나 선택해야 하며, uv와 파이썬 스크립트를 지원하는 AI 코딩 도구가 필요함.
  • Skills CLI 경로는 Node.js, npm, Git을 설치한 뒤 프로젝트에서 npx skills add bmad-code-org/BMAD-METHOD를 실행하는 방식임.
  • 사용할 스킬과 코딩 도구를 선택하고, 설정과 도움말용 bmad 및 선택한 모듈의 모듈 레코드인 bmod-method와 bmod-core-tools를 포함함.
  • 이름으로 설치하려면 npx skills add bmad-code-org/BMAD-METHOD --skill bmad --skill bmod-core-tools --skill bmod-method --skill bmad-build를 실행함.
  • Claude Code 플러그인 경로는 Claude Code 안에서 /plugin marketplace add bmad-code-org/bmad-plugins를 실행하는 방식임.
  • Codex 플러그인 경로는 터미널에서 codex plugin marketplace add bmad-code-org/bmad-plugins를 실행하는 방식임.
  • 두 마켓플레이스 경로 모두 전달 워크플로용 bmad-method와 BMad 허브를 포함한 독립형 스킬용 bmad-core-tools를 설치함.
  • 프로젝트에서 코딩 도구를 열고 bmad 스킬에 bmad setup 실행을 요청한 뒤, 변경하려는 내용을 bmad-build로 호출함.
  • 다음 단계나 선택 사항에 대한 안내가 필요할 때마다 bmad에 문의할 수 있음.
  • 첫 프로젝트 구축과 기존 코드베이스에 BMad를 추가하는 안내를 제공함.

업데이트 및 상태 확인

  • BMad는 무료 오픈 소스이며 유료로 잠긴 워크플로나 제한된 커뮤니티가 없음.
  • 버전을 확인하고 다음에 실행할 작업을 보려면 bmad status를 요청함.
  • 업데이트를 설치하려면 bmad setup을 요청함. 이 명령은 npx skills update를 실행한 다음 프로젝트를 새로고침하고 이름이 바뀌거나 제거된 스킬을 정리함.
  • 플러그인 마켓플레이스를 사용한다면 마켓플레이스에서 업데이트한 뒤 bmad setup을 요청함.

BMad를 선택하는 이유

  • 코딩 보조 도구는 구현에 효과적이지만, 명시되지 않은 가정을 코드로 바꾸는 경우가 있음.
  • BMad는 에이전트와 워크플로를 활용해 중요한 결정을 명시하고 후속 작업을 위한 맥락으로 보존하면서 사용자의 주도권을 유지함.
  • 작업 규모에 맞는 절차: 명확한 변경은 곧바로 구현하고, 대규모 계획에는 더 깊은 계획 단계를 추가함.
  • 신규 또는 기존 코드: 빈 상태에서 시작하거나, 물려받은 코드베이스의 검증된 맥락을 파악하고 실제 코드에 기반해 작업함.
  • 지속되는 맥락: 제품 및 기술 결정을 매 대화마다 다시 설명하는 대신 다음 작업으로 이어감.
  • 전문 관점: 도움이 될 때 제품, 아키텍처, 사용자 경험(UX), 개발, 테스트 관점을 활용함.
  • 안내형 협업: 판단을 넘기지 않고 구조화된 워크플로와 여러 에이전트의 논의를 활용함.
  • 단일 전달 경로: 초기 구상부터 검토된 구현, 수정, 학습까지 이어감.
  • 변경에 필요한 계획 규모를 확인하는 안내를 제공함.

BMad 생태계

  • 핵심 방법을 설치하거나 전문 작업을 위한 공식 모듈을 추가할 수 있음.
  • BMad Method: 신규 프로토타입부터 기존 코드베이스까지 소프트웨어를 계획하고 전달함.
  • BMad Builder: 스킬, 워크플로, 에이전트를 구축함.
  • BMad Creative Intelligence Suite: 혁신, 디자인 사고, 스토리텔링을 위한 창의적 사고 파트너를 제공함.
  • BMad Test Architect: BMad Method용 엔터프라이즈 테스트 추가 기능임.
  • BMad Loop: 에픽 전체를 무인으로 구축하고 검증하며 회고함.
  • BMad Game Dev Studio: Unity, Unreal, Godot, Phaser를 포함한 모든 프레임워크에서 게임을 구상하고 설계하며 구축함.

문서

  • 첫 변경 사항 구축: BMad를 설치하고 소규모 프로젝트를 구축함.
  • 계획 경로 선택: 변경에 필요한 계획 규모를 선택하고 각 계획 스킬의 산출물을 확인함.
  • 기존 코드베이스에서 시작: 기존 코드베이스에 BMad를 추가함.

커뮤니티

  • Discord: 도움을 받고 아이디어를 공유하며 협업함.
  • YouTube: 튜토리얼과 마스터클래스를 시청함.
  • GitHub Issues: 버그를 신고하고 기능을 요청함.
  • GitHub Discussions: 장기적인 커뮤니티 대화에 참여함.
  • BMad Code: 더 넓은 생태계를 살펴봄.

지원 및 기여

  • BMad는 누구나 무료로 이용할 수 있으며 앞으로도 계속 무료임.
  • 저장소에 별을 남기거나, 커피값을 후원하거나, 기업 후원 문의를 contact@bmadcode.com으로 보낼 수 있음.
  • 기여를 환영하며, 풀 리퀘스트를 열기 전에 CONTRIBUTING.md를 읽어야 함.

라이선스

  • MIT 라이선스를 적용하며 자세한 내용은 LICENSE에 있음.
  • BMad와 BMAD-METHOD는 BMad Code, LLC의 상표이며 자세한 내용은 TRADEMARK.md에 있음.
  • 기여하려면 Discord에 참여하고 먼저 CONTRIBUTORS.md를 읽어야 함.