이름 있는 에이전트

“Mary, 브레인스토밍하자”라고 말하면 Mary가 활성화됩니다. Mary는 설정에 저장된 사용자 이름을 부르며, 설정한 언어와 고유한 페르소나로 인사합니다. bmad-help를 언제든 사용할 수 있다고 알려준 뒤, 의도가 명확하므로 메뉴를 건너뛰고 바로 브레인스토밍을 시작합니다.

이 페이지에서는 이때 내부에서 무슨 일이 일어나는지, BMad가 왜 이런 방식으로 설계됐는지 설명합니다.

세 축

BMad의 에이전트 모델은 서로 조합되는 세 가지 기본 요소 위에 놓여 있습니다.

기본 요소	제공하는 것	위치
스킬	기능 - 어시스턴트가 할 수 있는 구체적인 일(브레인스토밍, PRD 초안 작성, 스토리 구현)	`.claude/skills/{skill-name}/SKILL.md` 또는 IDE별 동등 경로
이름 있는 에이전트	페르소나 일관성 - 일관된 목소리, 원칙, 시각적 단서로 관련 스킬 메뉴를 묶는 쉽게 알아볼 수 있는 정체성	디렉터리가 `bmad-agent-*`로 시작하는 스킬
커스터마이징	우리 방식으로 맞추기 - 에이전트 동작을 재구성하고, MCP 통합을 추가하고, 템플릿을 교체하고, 조직 관례를 겹쳐 적용하는 오버라이드	`_bmad/custom/{skill-name}.toml`(팀 오버라이드) 및 `.user.toml`(개인, git에서 무시됨)

세 요소 중 하나라도 빠지면 경험이 무너집니다.

에이전트 없는 스킬 → 사용자가 이름이나 코드로 탐색해야 하는 기능 목록
스킬 없는 에이전트 → 할 일이 없는 페르소나
커스터마이징 없음 → 모든 사용자가 같은 기본 제공 동작을 받고, 조직별 필요에는 포크를 강요받음

이름 있는 에이전트의 장점

BMad는 BMad Method의 단계에 맞춘 다섯 이름 있는 에이전트를 제공합니다.

에이전트	단계	모듈
📊 Mary, 비즈니스 분석가	분석	시장 조사, 브레인스토밍, 제품 개요, PRFAQ
📋 John, 제품 관리자	계획	PRD 작성, 에픽/스토리 분해, 구현 준비 상태 점검
🎨 Sally, UX 디자이너	계획	UX 설계 사양
🏗️ Winston, 시스템 아키텍트	솔루션 설계	기술 아키텍처, 정합성 점검
💻 Amelia, 시니어 엔지니어	구현	스토리 실행, Build, 코드 리뷰, 스프린트 계획

각 에이전트에는 하드코딩된 정체성(이름, 직함, 도메인)과 커스터마이즈 가능한 계층(역할, 원칙, 커뮤니케이션 스타일, 아이콘, 메뉴)이 있습니다. Mary의 원칙을 다시 쓰거나 메뉴 항목을 추가할 수는 있지만 이름을 바꿀 수는 없습니다. 이는 의도적입니다. 이름 인식은 커스터마이징 후에도 유지되므로, 팀이 Mary의 동작을 어떻게 조정했든 “Mary”는 항상 분석가를 활성화합니다.

활성화 흐름

이름 있는 에이전트를 호출하면 여덟 단계가 순서대로 실행됩니다.

에이전트 블록 해석 - 제공된 customize.toml을 팀 및 개인 오버라이드와 병합합니다. Python 병합 스크립트가 표준 라이브러리 tomllib을 사용합니다
사전 단계 실행 - 팀이 설정한 사전 동작
페르소나 채택 - 하드코딩된 정체성과 커스터마이즈된 역할, 커뮤니케이션 스타일, 원칙
지속 사실 로드 - 조직 규칙, 컴플라이언스 메모, file: 접두사로 로드되는 파일(예: file:{project-root}/docs/project-context.md)
설정 로드 - 사용자 이름, 커뮤니케이션 언어, 출력 언어, 산출물 경로
인사 - 설정 언어로 개인화된 인사를 하고, 누가 말하는지 한눈에 보이도록 에이전트 이모지 접두사를 포함합니다
후속 단계 실행 - 팀이 설정한 인사 후 동작
바로 실행 또는 메뉴 표시 - 첫 메시지가 메뉴 항목에 매핑되면 바로 실행하고, 아니면 메뉴를 보여주고 입력을 기다립니다

8단계는 의도와 기능이 만나는 곳입니다. “Mary, 브레인스토밍하자”는 bmad-brainstorming이 Mary 메뉴의 BP와 명확히 맞으므로 메뉴 표시를 건너뜁니다. 모호하게 말하면 확인 절차가 아니라 한 번 짧게 묻습니다. 맞는 것이 없으면 일반 대화를 계속합니다.

왜 그냥 메뉴가 아닌가요?

메뉴 방식에서는 사용자가 도구의 구조를 어느 정도 익혀야 합니다. 브레인스토밍이 PM 에이전트가 아니라 분석가 에이전트의 BP 코드 아래 있다는 것을 기억하고, 어떤 페르소나가 어떤 기능을 갖는지 알아야 합니다. 그만큼 도구가 사용자에게 인지 부담을 떠넘깁니다.

이름 있는 에이전트는 이 흐름을 뒤집습니다. 사용자는 원하는 작업과 담당 에이전트를 자연스러운 말로 지정하면 됩니다. 에이전트는 자신이 누구이고 무엇을 하는지 압니다. 의도가 충분히 명확하면 바로 진행합니다.

메뉴는 여전히 대체 경로로 있습니다. 탐색할 때는 보여주고, 필요 없을 때는 건너뜁니다.

왜 그냥 빈 프롬프트가 아닌가요?

빈 프롬프트는 어떤 표현을 써야 통하는지 사용자가 안다고 가정합니다. “브레인스토밍을 도와줘”는 될 수 있지만 “내 SaaS 아이디어를 같이 발전시켜 보자”는 안 될 수 있고, 결과는 요청을 어떻게 표현했는지에 따라 달라집니다. 결국 사용자가 프롬프트를 설계해야 합니다.

이름 있는 에이전트는 자유를 제한하지 않으면서 구조를 제공합니다. 페르소나는 일관되고, 사용할 수 있는 기능은 쉽게 확인할 수 있으며, bmad-help는 명령 하나로 언제든 호출할 수 있습니다. 에이전트가 무엇을 할 수 있는지 추측할 필요도, 사용 설명서가 필요하지도 않습니다.

커스터마이징은 핵심 기능입니다

커스터마이징 모델이 있어야 이 방식이 개별 개발자를 넘어 확장됩니다.

모든 에이전트는 합리적인 기본값이 담긴 customize.toml을 제공합니다. 팀은 _bmad/custom/bmad-agent-{role}.toml에 오버라이드를 커밋합니다. 개인은 .user.toml(git에서 무시됨)에 개인 선호를 겹쳐 적용할 수 있습니다. 병합 스크립트는 활성화 시점에 세 파일을 예측 가능한 구조 규칙으로 병합합니다.

대부분의 사용자는 이 파일을 직접 작성하지 않습니다. bmad-customize 스킬은 대상을 고르고 에이전트와 워크플로 중 알맞은 범위를 선택하도록 안내합니다. 이어서 오버라이드를 작성하고 병합 결과를 검증합니다. 따라서 TOML에 익숙하지 않아도 원하는 변경을 설명할 수 있다면 커스터마이징할 수 있습니다.

예를 들어 팀은 Amelia에게 라이브러리 문서를 찾을 때 항상 Context7 MCP 도구를 사용하고, 로컬 에픽 목록에 스토리가 없으면 Linear를 대신 확인하라고 지시하는 파일 하나를 커밋할 수 있습니다. 그러면 Amelia가 실행하는 모든 개발 워크플로(build, code-review, qa-generate)가 소스를 수정하거나 워크플로마다 같은 설정을 반복하지 않아도 이 동작을 상속합니다.

여러 스킬에 공통으로 적용되는 설정을 위한 두 번째 커스터마이징 영역도 있습니다. 중앙 설정 파일은 _bmad/config.toml과 _bmad/config.user.toml이며, 둘 다 설치 프로그램이 관리하고 각 모듈의 module.yaml에서 다시 만듭니다. 오버라이드 파일은 팀이 커밋하는 _bmad/custom/config.toml과 git에서 무시되는 개인용 _bmad/custom/config.user.toml입니다.

이 중앙 설정에 에이전트 명단이 있습니다. bmad-party-mode, bmad-retrospective, bmad-advanced-elicitation처럼 명단을 사용하는 스킬은 간단한 설명 정보를 읽어 어떤 에이전트를 사용할 수 있고 각 에이전트를 어떻게 표현할지 파악합니다. 팀 오버라이드로 에이전트의 표현 방식을 조직 전체에서 바꾸고, .user.toml 오버라이드로 가상 페르소나(Kirk, Spock, 도메인 전문가)를 개인 실험에 추가할 수 있습니다. 이때 스킬 폴더는 건드리지 않습니다.

스킬별 파일은 Mary가 활성화될 때 어떻게 행동하는지를 조정합니다. 중앙 설정은 다른 스킬이 명단에서 Mary를 어떻게 보는지를 조정합니다.

전체 커스터마이징 영역과 적용 예시는 다음을 참고하세요.

BMad 커스터마이징 방법 - 커스터마이즈할 수 있는 항목과 병합 방식을 설명하는 참고 문서
조직을 위해 BMad 확장하기 - 에이전트 전반 규칙, 워크플로 관례, 외부 게시, 템플릿 교체, 에이전트 명단 커스터마이징을 다루는 다섯 가지 실전 레시피
bmad-customize 스킬 - 의도를 올바른 위치의 검증된 오버라이드 파일로 바꿔 주는 안내형 작성 도우미

더 큰 아이디어

오늘날 대부분의 AI 어시스턴트는 메뉴나 프롬프트 방식이며, 둘 다 인지 부담을 사용자에게 넘깁니다. 이름 있는 에이전트와 커스터마이즈 가능한 스킬을 사용하면 이미 업무를 아는 팀원과 대화하듯 일할 수 있고, 조직은 포크 없이 그 팀원의 동작을 조정할 수 있습니다.

다음에 “Mary, 브레인스토밍하자”라고 입력하자마자 Mary가 바로 진행한다면, 그때 거치지 않은 과정을 떠올려 보세요. 슬래시 명령도, 탐색해야 할 메뉴도, Mary가 무엇을 할 수 있는지 어색하게 되짚는 일도 없었습니다. 이런 절차를 거치지 않아도 된다는 점이 설계의 핵심입니다.