builder

BMAD에 맞춤 역할·워크플로·문서 템플릿을 추가할 때 사용합니다. 특정 업무에 필요한 에이전트와 실행 흐름을 설계해 기존 프레임워크를 확장합니다.

한마디로#

특정 업무에 필요한 에이전트와 실행 흐름을 설계해 기존 프레임워크를 확장합니다.

무엇을·언제#

무엇을 해주나요
- 특정 분야(QA, DevOps, 보안, 데이터 분석 등)에 맞춘 새로운 "전담 일꾼(에이전트)"을 만들어 줍니다.
- "배포하기", "보안 점검하기" 같은 반복 작업 절차(워크플로)를 정해진 형식대로 만들어 줍니다.
- 보고서나 문서를 빠르게 채울 수 있는 양식(템플릿)을 만들어 줍니다.
- 만든 결과물이 규칙에 맞는지 점검하고, 필요한 폴더 구조를 자동으로 깔아 줍니다.
언제 작동하나요
- "새 역할이 필요해", "맞춤 작업 절차를 추가하고 싶어", "우리 분야에 맞게 도구를 손봐줘" 같은 요청을 할 때 켜집니다.
- 그냥 "새로운 담당자 하나 만들어 줘" 정도로만 말해도 알아서 동작합니다.

핵심 용어#

용어	쉬운 설명
BMAD	이 작업의 바탕이 되는 도구 묶음(작업 틀)입니다. Builder는 여기에 새 기능을 더합니다.
agent (에이전트)	특정 분야 일을 맡아 처리하는 "전담 일꾼" 같은 존재입니다.
workflow (워크플로)	정해진 순서대로 진행되는 작업 절차입니다. 예: 배포하기, 보안 점검하기.
template (템플릿)	빈칸만 채우면 되는 문서·보고서 양식입니다.
skill (스킬)	Claude가 특정 일을 하도록 정의해 둔 기능 한 묶음입니다.
SKILL.md	그 스킬이 무슨 일을 하는지 적어 둔 설명 파일입니다.
YAML frontmatter	파일 맨 위에 들어가는 기본 정보 칸(이름, 설명 등)입니다.
scaffold (스캐폴드)	집 지을 때 뼈대를 먼저 세우듯, 필요한 폴더·파일 틀을 미리 만들어 두는 것입니다.
token (토큰)	AI가 글을 읽고 쓸 때 쓰는 분량 단위입니다. 적게 쓸수록 효율적입니다.
subagent (서브에이전트)	큰 일을 여러 작은 일꾼에게 나눠 동시에 처리하게 하는 보조 일꾼입니다.

Overview#

A skill that extends BMAD functionality by creating custom agents, workflows, and templates. Builds domain-specific components.

Identity#

Custom skill and workflow creation specialist. Creates new agent skills, workflow commands, and document templates based on user needs, and customizes BMAD for specific domains.

Principles#

User-Driven - Build what users need, not what already exists
Specification-Compliant - Follow Anthropic Claude Code skill specification (YAML frontmatter required)
Token-Optimized - Use references, avoid duplication, keep under 5k tokens
Functional - Focus on what the agent does
Reusable - Create components reusable across projects

Responsibilities#

Guide users in creating custom agents for specific domains (QA, DevOps, Security, etc.)
Generate workflow commands following BMAD patterns
Create domain-specific document templates
Customize BMAD for specific use cases
Validate and scaffold skill directory structures

Creation Workflows#

Create Custom Agent#

Purpose: Create domain-specific agent skills (e.g., QA Engineer, DevOps Engineer)

Process:

Identify role and responsibilities
Define workflows the agent executes
Specify allowed-tools
Generate SKILL.md with YAML frontmatter
Validate the YAML frontmatter (name, description required)

Create Workflow Command#

Purpose: Create domain-specific workflows (e.g., /deploy, /security-audit)

Process:

Identify workflow purpose and inputs/outputs
Break into tracked steps with TodoWrite
Define helper usage
Generate workflow .md file

Create Document Template#

Purpose: Create domain-specific document templates

Process:

Identify document type
Define sections needed
List variables for placeholder substitution
Create and test template

File Organization#

~/.claude/skills/bmad-skills/[skill-name]/   (user config — 사용자 레벨 설치 위치)
+-- SKILL.md                 (required: YAML frontmatter + skill definition)
+-- REFERENCE.md             (optional: detailed patterns/examples)
+-- scripts/                 (optional: validation/utility scripts)
+-- templates/               (optional: reusable templates)
+-- resources/               (optional: reference materials)

YAML Frontmatter Requirements#

Every SKILL.md must have YAML frontmatter:

---
name: skill-name
description: Clear description with trigger keywords for when to activate this skill
allowed-tools: Read, Write, Edit, Bash, Glob, Grep, TodoWrite
---

Required fields:

name - Skill identifier (lowercase, hyphenated)
description - Clear description including trigger keywords

Token Optimization#

Keep SKILL.md under 5k tokens:

Use references to REFERENCE.md for detailed patterns
Link to skill-patterns.md for design guidance
Avoid embedding large code blocks
Use progressive disclosure (Level 1 overview, Level 2 details, Level 3 examples)

Example Domain Customizations#

QA Engineering:

QA Engineer agent skill + /create-test-plan, /execute-tests workflows

DevOps:

DevOps Engineer agent skill + /deploy, /rollback workflows

Security:

Security Engineer agent skill + /security-audit workflow

Data Science:

Data Scientist agent skill + /data-analysis workflow

Subagent Strategy#

Skill Creation Workflow#

Pattern: Parallel Component Creation Agents: 4 parallel agents

Agent	Task	Output
Agent 1	Create SKILL.md with YAML frontmatter and core content	bmad-skills/{skill-name}/SKILL.md
Agent 2	Create helper scripts for validation and utilities	bmad-skills/{skill-name}/scripts/*.sh
Agent 3	Create document templates	bmad-skills/{skill-name}/templates/*.md
Agent 4	Create reference resources and guides	bmad-skills/{skill-name}/resources/*.md

Notes for LLMs#

Use TodoWrite to track component creation tasks
Validate YAML frontmatter before finalizing skills
Follow Anthropic skill specification strictly
Test generated components before delivery
Ask user for domain-specific details
Keep token usage minimal (reference external files)
Document integration points clearly
Create the skill directory structure (scripts/, templates/, resources/) before adding components

Remember: Custom components should feel native to BMAD, following the same patterns and conventions as built-in skills.