bmad-code-org/BMAD-METHOD

BMad Method – AI 기반 애자일 개발 프레임워크

무엇인가요 – BMad Method는 AI 코딩 어시스턴트(Claude, Codex 등)를 사용하여 아이디어, 변경 요청, 제품 사양을 실행 가능한 소프트웨어로 전환할 수 있는 오픈소스 워크플로우 및 스킬 세트입니다. 인간의 결정을 명확히 유지하면서 개발 주기 전체(명확화 → 계획 → 구현 → 검증 → 학습)를 재사용 가능한 "스킬"로 구조화합니다. 이 프레임워크는 결정을 명시적으로 유지하고, 미래 채팅에서 재사용 가능한 컨텍스트를 저장하며, Node 기반의 스킬 CLI 또는 플러그인 마켓플레이스를 통해 설치할 수 있습니다. 핵심 리포지토리는 딜리버리 루프를 제공하며, 테스트, 창의적 사고, 게임 개발, 자동화 기능을 추가하는 선택적 모듈도 제공합니다. MIT 라이선스이며, Discord, 문서, 동영상 튜토리얼을 통해 지원됩니다.

핵심 아이디어

• 적절한 규모의 프로세스 – 작은 명확한 변경은 바로 Build 단계로 진행되며, 큰 프로젝트는 더 깊은 Plan 활동을 트리거합니다.
• 지속 가능한 컨텍스트 – 결정, 아키텍처 노트, 사양은 구조화된 아티팩트로 저장되어 AI가 재사용할 수 있어, 매번 동일한 배경을 반복할 필요가 없습니다.
• 다중 에이전트 관점 – 선택적 "에이전트"가 제품, 아키텍처, UX, 테스트, 창의적 관점을 기여하며, 모두 BMad 워크플로우에 의해 조율됩니다.
• 플러그인 친화적 – 이 방법은 Skills CLI 패키지(명령어 npx skills add …로 설치 가능) 및 Claude Code와 Codex용 플러그인으로 제공되어, 일반적인 개발 환경에서 bmad setup, bmad‑build, bmad status와 같은 명령어를 실행할 수 있습니다.

설치 방법

1. Skills CLI 설치 (Node.js, npm, Git, uv Python 도구 필요). 예시:

   npx skills add bmad-code-org/BMAD-METHOD
   

   핵심 bmad 스킬에 더해 선택적 모듈(bmod-method, bmod-core-tools)을 추가할 수 있습니다.
2. Claude Code 또는 Codex의 마켓플레이스를 통해 설치:

   /plugin marketplace add bmad-code-org/bmad-plugins
   

3. AI 코딩 도구에서 프로젝트를 열고 bmad setup을 실행하여 런타임을 초기화한 후, 변경하고자 하는 내용을 지정하고 bmad‑build를 실행합니다. 필요 시 bmad 스킬에게 안내를 요청할 수 있습니다.

일반적인 워크플로우

단계	당신이 하는 일 (AI와 함께)	출력
명확화	모호한 아이디어나 요청을 제시. AI가 명확화 질문을 함.	간결한 문제 정의.
계획	계획 깊이 선택 (빠른 스케치, 상세 설계 등). AI가 사양, 아키텍처 다이어그램, 작업 분해 생성.	구조화된 계획 아티팩트.
구현	bmad‑build 실행 – AI가 코드 작성, 테스트 생성, 문서 업데이트.	새 또는 수정된 소스 파일.
검증	AI가 자동 검사 실행, 코드 검토, 승인 요청.	성공/실패 보고서, 제안된 수정안.
학습	교훈 기록, 결정 로그 업데이트, 필요 시 다음 계획 주기로 피드백.	미래 작업에 활용 가능한 업데이트된 컨텍스트.

에코시스템 모듈 – 리포지토리는 핵심 메서드이지만, BMad는 빌더, 창의적 지능 스위트, 테스트 아키텍트, 루프 자동화, 게임 개발 스튜디오 등의 선택적 확장 기능을 제공하며, 동일한 스킬 시스템에 통합됩니다.

문서 및 도움말

• 빠른 시작 가이드: 첫 번째 변경 사항 구축하기 및 기존 코드베이스에 BMad 추가하기.
• 상세한 계획 가이드: 계획 경로 선택하기.
• 커뮤니티 Discord, YouTube 튜토리얼, GitHub Issues/Discussions.

대상 사용자

• 이미 AI 코딩 어시스턴트를 사용하고 있으며 구조적이고 반복 가능한 프로세스를 원하는 팀.
• AI를 활용해 구현을 수행하면서 설계 결정을 문서화하고 싶은 솔로 개발자.
• 결정 로그의 추적 가능성이 필요하고, 프로토타입에서 레거시 시스템까지 AI 지원 개발을 확장해야 하는 조직.

라이선스 – MIT (상용/비상용 모두 자유롭게 사용 가능).

---

위 모든 정보는 리포지토리의 README에서 직접 인용되었으며, 추가 기능은 추측되지 않았습니다.