핵심 도구

모든 BMad 설치에는 핵심 모듈이 포함됩니다. 프로젝트, 모듈, 단계에 관계없이 두루 쓰는 작은 스킬 모음입니다. 이 페이지에서는 커널 도구와 사고 스킬을 설명합니다.

개요

핵심 모듈(항상 설치됨):

도구	목적
`bmad-help`	다음에 무엇을 해야 할지 상황에 맞게 안내
`bmad-advanced-elicitation`	반복 개선 기법으로 LLM 출력을 다시 검토하고 다듬음
`bmad-review`	다중 렌즈 리뷰 - 코드용 적대적·엣지 케이스·검증 공백 렌즈와 문서용 구조·문장·표현 렌즈를 제공
`bmad-customize`	BMad 커스터마이징 오버라이드 생성 및 검증

사고 스킬:

도구	목적
`bmad-brainstorming`	대화형 브레인스토밍 세션 진행
`bmad-deep-recon`	어떤 주제든 의사결정에 필요한 리서치를 초안·처리·실행 방식으로 수행
`bmad-forge-idea`	아이디어를 단련해 가능성을 입증하거나 적은 비용으로 폐기할 때까지 압박 검증
`bmad-party-mode`	다중 에이전트 그룹 토론 조율

bmad-spec은 이제 BMM 모듈의 2단계 계획 워크플로에 포함됩니다. 자세한 위치는 워크플로 맵을 참고하세요.

bmad-shard-doc과 bmad-index-docs 유틸리티는 제거되었습니다.

기존 bmad-editorial-review, bmad-editorial-review-prose, bmad-editorial-review-structure, bmad-review-adversarial-general, bmad-review-edge-case-hunter, bmad-review-verification-gap 스킬은 모두 bmad-review로 통합되었습니다. 별도의 편집 스킬은 문서 편집 렌즈가 대신합니다. 이전 ID 6개도 호환성을 위해 새 스킬로 계속 연결됩니다.

기존 bmad-market-research, bmad-domain-research, bmad-technical-research 워크플로는 리서치 유형으로 bmad-deep-recon에 통합되었습니다. 이전 ID도 같은 방식으로 새 스킬에 연결됩니다.

bmad-help

다음에 무엇을 해야 할지 알려주는 지능형 안내자입니다. 프로젝트 상태와 완료된 작업을 확인하고 다음 필수 또는 선택 단계를 추천합니다.

사용 시점:

워크플로를 끝냈고 다음 단계를 알고 싶습니다
BMad가 처음이라 방향 안내가 필요합니다
막혀서 상황에 맞는 조언이 필요합니다
새 모듈을 설치한 뒤 사용할 수 있는 기능을 확인하고 싶습니다

작동 방식:

프로젝트에서 기존 산출물(PRD, 아키텍처, 스토리 등)를 스캔합니다
설치된 모듈과 사용 가능한 워크플로를 감지합니다
우선순위에 따라 다음 단계를 추천합니다. 필수 단계를 먼저, 선택 단계를 나중에 제시합니다
각 추천을 스킬 명령과 짧은 설명으로 보여줍니다

입력: 선택적 자연어 질문(예: bmad-help SaaS 아이디어가 있는데 어디서 시작하나요?)

출력: 스킬 명령과 함께 우선순위로 정리한 다음 단계 목록

bmad-advanced-elicitation

LLM이 최근 출력을 다시 검토하고 다듬도록 합니다. BMad의 공통 개선 지점으로, 다른 스킬이 작업 중간에 호출할 수도 있고 사용자가 대화의 최근 내용에 직접 적용할 수도 있습니다.

사용 시점:

LLM 출력이 얕거나 너무 일반적으로 느껴집니다
여러 분석 관점에서 주제를 탐색하고 싶습니다
중요한 문서를 다듬으면서 더 깊이 검토하고 싶습니다
소크라테스식 질문, 제1원칙, 사전 실패 분석(pre-mortem), 레드팀처럼 이름이 정해진 기법을 쓰고 싶습니다

작동 방식:

다른 대상을 지정하지 않으면 대화의 가장 최근 출력을 대상으로 삼습니다
내용에 가장 잘 맞는 도출 기법을 짧은 메뉴로 제시합니다
선택한 기법을 대상에 적용합니다
개선본을 반환하면 호출한 흐름이 중단된 지점부터 이어집니다

입력: 기본값은 가장 최근 출력입니다. 다른 내용을 지정하거나 적용할 기법의 이름을 함께 줄 수도 있습니다.

출력: 개선이 적용된 버전

bmad-review

diff, 문서, 산출물을 여러 렌즈로 검토합니다. 리뷰 렌즈마다 기법과 관점은 다르지만 발견 사항은 하나의 표준 형식으로 보고합니다. 발견 사항이 없어도 유효한 결과입니다. 철저해 보이려고 개수를 억지로 채우지 않습니다. 렌즈마다 적용 대상이 정해져 있으므로 diff에는 코드 렌즈를, 문서에는 편집 렌즈를 적용합니다.

제공되는 렌즈:

렌즈	적용 대상	기법
적대적 (`adversarial`)	모든 내용	빠진 것과 잘못된 것을 찾도록 발견 사항 10개 이상을 강제하며 빈 목록은 허용하지 않습니다
엣지 케이스 (`edge-case-hunter`)	모든 내용	동작을 정의한 내용에서 모든 분기 경로와 경계 조건을 확인합니다
검증 공백 (`verification-gap`)	코드	변경된 동작이 회귀해도 신뢰할 만한 검증에서 놓칠 부분을 찾습니다
구조 (`structure`)	문서	문서 구성이 목적에 맞는지 검토하고 삭제·병합·이동·압축을 제안합니다
문장·표현 (`prose`)	문서	이해를 방해하는 표현을 교정합니다

두 편집 렌즈는 아이디어 자체를 비판하지 않습니다. 구성과 표현만 검토합니다. 수정안은 제안만 할 뿐 직접 적용하지 않습니다. 두 렌즈를 함께 선택하면 문장·표현 렌즈가 구조 렌즈의 발견 사항을 이어받아 검토합니다.

렌즈 구성은 고정되어 있지 않습니다. customize.toml에서 렌즈를 추가하거나 기본 렌즈를 바꿀 수 있습니다. 리뷰할 때는 최종 설정에 포함된 렌즈를 실행합니다.

사용 시점:

산출물을 확정하기 전에 품질을 확인하고 싶습니다
코드나 로직의 엣지 케이스를 빠짐없이 검토하고 싶습니다
변경 사항이 충분히 검증됐는지 알고 싶습니다
초안 문서를 더 간결하고 매끄럽게 다듬고 싶습니다
이해도를 유지하면서 문서 길이를 줄이고 싶습니다

작동 방식:

내용을 불러온 뒤 유형(diff, 파일, 함수, 문서)과 성격(코드 또는 문서)을 확인합니다
사용자가 지정한 렌즈를 선택합니다. 따로 지정하지 않았다면 적용 대상과 조건이 맞는 활성 렌즈를 모두 선택합니다
실행할 렌즈와 다른 렌즈의 결과를 이어받을 렌즈를 먼저 알립니다
독립 렌즈부터 실행합니다. 그 결과가 필요한 렌즈는 이어서 실행합니다. 플랫폼이 지원하면 독립 렌즈는 하위 에이전트로 병렬 실행합니다
결과를 하나의 발견 사항 배열로 모읍니다. 같은 문제를 여러 렌즈가 찾았다면 단순 중복이 아니라 중요한 신호로 봅니다

입력:

content(필수) - diff, 브랜치, 커밋하지 않은 변경분, 파일, 사양, 스토리 등 검토할 내용
lenses(선택 사항) - 하나 이상의 렌즈 코드 또는 이름. 지정하지 않으면 내용에 맞는 모든 렌즈를 사용합니다
also_consider(선택 사항) - 함께 검토할 영역
style_guide / reader_type(선택 사항, 편집 렌즈) - 프로젝트 스타일 가이드와 독자 유형. 기본값인 humans는 명확성과 흐름을, llm은 정밀성과 일관성을 우선합니다

출력: 발견 사항을 JSON 배열 및/또는 렌즈별 Markdown 보고서로 제공합니다. 각 항목에는 lens, location, trigger_condition, guard_snippet, potential_consequence가 들어갑니다. 편집 렌즈는 항목별로 수락하거나 거절할 수 있는 표를 만듭니다. 구조 변경을 제안할 때는 예상 감소량도 함께 보여줍니다.

bmad-customize

커스터마이징 오버라이드를 만들고 검증합니다. TOML을 직접 작성하지 않아도 설치된 BMad 에이전트나 워크플로의 동작을 바꿀 수 있습니다.

사용 시점:

에이전트나 워크플로 동작을 바꾸고 싶습니다
지속 사실, 활성화 훅, 커스텀 메뉴 항목을 추가해야 합니다
올바른 오버라이드 범위를 자동으로 선택하고 검증하고 싶습니다

작동 방식:

설치된 BMad 스킬에서 커스터마이징 가능한 영역을 스캔합니다
요청한 변경에 맞는 범위를 선택합니다
_bmad/custom/ 아래에 오버라이드 파일을 작성합니다
병합된 설정을 검증합니다

입력: 원하는 커스터마이징을 설명하는 자연어

출력: _bmad/custom/ 아래의 TOML 오버라이드 파일

BMad 커스터마이징에 대한 자세한 가이드는 BMad 커스터마이징 방법을 참고하세요.

사고 스킬

아래 스킬은 어느 단계나 모듈에서도 쓸 수 있는 범용 사고 도구입니다.

bmad-brainstorming

대화형 창의 기법으로 다양한 아이디어를 생성합니다. 검증된 발상법을 기법 라이브러리에서 불러와 아이디어를 100개 이상 끌어낸 뒤 정리하는 브레인스토밍 세션입니다.

사용 시점:

새 프로젝트를 시작하고 문제 영역을 탐색해야 합니다
아이디어 생성이 막혀 구조화된 창의 기법이 필요합니다
SCAMPER, 역브레인스토밍 같은 검증된 아이디어 발상 프레임워크를 사용하고 싶습니다

작동 방식:

주제로 브레인스토밍 세션을 설정합니다
기법 라이브러리에서 창의 기법을 로드합니다
기법을 하나씩 진행하며 아이디어를 생성합니다
편향 방지 프로토콜을 적용합니다. 10개 아이디어마다 창의 영역을 바꿔 군집화를 방지합니다
모든 아이디어를 기법별로 정리한 누적형 세션 문서를 만듭니다

입력: 브레인스토밍 주제 또는 문제 설명, 필요한 경우 컨텍스트 파일

출력: 세션을 보관하는 독립형 brainstorm.html, 필요한 경우 후속 스킬에 넘길 brainstorm-intent.md, 그리고 .memlog.md 세션 기록

bmad-deep-recon

어떤 주제든 의사결정에 필요한 수준으로 세 가지 방식의 리서치를 수행합니다. 이미 구독 중인 AI 도구에서 사용할 심층 리서치 프롬프트를 작성하거나, 완성된 보고서를 후속 스킬이 바로 쓸 수 있는 인용 포함 요약으로 정리합니다. 여러 웹 리서치를 병렬로 진행해 현재 환경에서 직접 실행할 수도 있습니다.

사용 시점:

모델의 기억이 아니라 근거로 결정해야 합니다
시장, 도메인, 기술, 경쟁, 사용자 의견 또는 문헌 리서치가 필요합니다
어떤 출처에서든 받은 리서치 보고서를 후속 작업에 맞게 정리하고 싶습니다
이름이 정해진 여러 선택지를 체계적으로 비교하고 싶습니다

작동 방식:

초안, 처리, 실행 중 모드를 감지하고 요청에서 리서치 유형을 추론합니다
우선순위를 둔 분석 차원, 출처 탐색법, 최신성 규칙이 담긴 유형별 팩을 불러옵니다
실행 모드는 한 번의 게이트에서 계획합니다. 그런 다음 서로 컨텍스트가 격리된 리서치 어시스턴트를 투입해 수집하는 주장을 즉시 검증합니다
초안과 처리 모드는 사용자가 쓰는 심층 리서치 도구를 오갑니다
Refresh와 Deepen은 전체를 다시 조사하지 않고 기존 보고서를 갱신합니다

입력: 결정과 주제, 처리할 보고서 또는 새로 갱신할 기존 리서치 폴더

출력: 메타데이터 프런트매터와 인용을 갖춘 research.md, 선택 사항인 독립 실행형 HTML 브리핑

세 가지 모드, 선택 기준, 실행 내부 동작은 Deep Recon을 참고하세요.

bmad-forge-idea

아이디어가 단단해지거나 가능성이 입증되거나, 적은 비용으로 폐기될 때까지 압박 검증합니다. 적대적인 질문자가 아직 덜 다듬어진 아이디어를 한 번에 하나의 질문으로 파고듭니다. 논점마다 두 페르소나를 참여시키며, 남은 아이디어에 확신을 갖고 행동할 수 있을 때까지 진행합니다.

사용 시점:

투자하기 전에 아이디어를 스트레스 테스트하고 싶습니다
아이디어를 폐기할지 말지에 대한 정직한 판단이 필요합니다
동의만 하는 상대가 아니라 반박하는 사고 파트너가 필요합니다

작동 방식:

먼저 목표를 정하고 그 목표에 맞춰 질문 방향을 조정합니다
의존성 순서에 따라 한 번에 하나의 질문을 다루며, 사용자가 반박할 수 있도록 권장 답을 제시합니다
논점마다 두 관점을 더합니다. 하나는 설치된 명단에서 고르고, 다른 하나는 주제에 맞춰 즉석에서 만듭니다
모호한 용어를 짚고 기존 프로젝트 자료와 주장을 대조합니다
단련됨, 폐기됨, 명확해짐 중 하나로 결론을 내리고, 보관할 수 있는 독립 보고서를 남깁니다

입력: 기능, 비즈니스 모델, 연구 가설, 개인적 결정 등 어떤 도메인의 아이디어든 가능

출력: 아이디어가 단련된 경우 필요에 따라 forged-idea.md 정제본을 만들고, 실행할 때마다 보관용 forge-report.html 보고서를 생성

bmad-party-mode

다중 에이전트 그룹 토론을 조율합니다. 설치된 모든 BMad 에이전트를 로드하고 각 에이전트가 고유한 전문성과 페르소나로 기여하는 자연스러운 대화를 진행합니다.

사용 시점:

결정에 여러 전문가 관점이 필요합니다
에이전트들이 서로의 가정에 도전하길 원합니다
여러 도메인에 걸친 복잡한 주제를 탐색합니다

작동 방식:

설치된 모든 에이전트 페르소나가 있는 에이전트 매니페스트를 로드합니다
주제를 분석해 가장 관련 있는 에이전트 2-3개를 선택합니다
에이전트들이 차례로 의견을 내고 자연스럽게 서로 대화하며 이견을 드러냅니다
참여 에이전트를 차례로 바꿔 다양한 관점이 고르게 나오도록 합니다
goodbye, end party, quit로 종료합니다

입력: 토론 주제 또는 질문, 참여시키고 싶은 페르소나 지정(선택 사항)

출력: 각 에이전트의 페르소나를 유지하는 실시간 다중 에이전트 대화