docs(ko-kr): sync localization with latest docs
This commit is contained in:
yeomin4242
parent
47cf70f0e8
commit
c8784a167b
|
|
@ -2,7 +2,7 @@
|
|||
title: "고급 도출"
|
||||
description: 구조화된 추론 방법으로 LLM이 자신의 작업을 다시 생각하게 합니다
|
||||
sidebar:
|
||||
order: 9
|
||||
order: 4
|
||||
---
|
||||
|
||||
LLM이 방금 생성한 결과를 다시 검토하게 만드세요. 추론 방법을 선택하면 LLM이 그 방법을 자신의 출력에 적용하고, 사용자는 개선 사항을 유지할지 결정합니다.
|
||||
|
|
|
|||
|
|
@ -2,7 +2,7 @@
|
|||
title: "적대적 리뷰"
|
||||
description: “괜찮아 보이네”라는 식의 대충 넘어가는 검토를 방지하는 논리적 추론 기법
|
||||
sidebar:
|
||||
order: 8
|
||||
order: 9
|
||||
---
|
||||
|
||||
문제를 반드시 찾게 만들어 더 깊은 분석을 강제합니다.
|
||||
|
|
|
|||
|
|
@ -2,7 +2,7 @@
|
|||
title: "분석 단계: 아이디어에서 기반까지"
|
||||
description: 브레인스토밍, 리서치, 제품 개요, PRFAQ가 무엇이며 언제 쓰는지 설명합니다
|
||||
sidebar:
|
||||
order: 1
|
||||
order: 2
|
||||
---
|
||||
|
||||
분석 단계(단계 1)는 제품을 만들기로 확정하기 전에 명확하게 생각하도록 돕습니다. 이 단계의 모든 도구는 선택 사항이지만, 분석을 완전히 건너뛰면 PRD가 인사이트가 아니라 가정 위에 세워집니다.
|
||||
|
|
|
|||
|
|
@ -2,7 +2,7 @@
|
|||
title: "체크포인트 미리보기"
|
||||
description: 목적에서 세부 사항에 이르기까지의 변경 과정을 단계별로 안내하는, LLM을 활용한 인간 중심 검토
|
||||
sidebar:
|
||||
order: 5
|
||||
order: 8
|
||||
---
|
||||
|
||||
`bmad-checkpoint-preview`는 LLM이 보조하는 대화형 human-in-the-loop 리뷰 워크플로입니다. 코드 변경을 목적과 컨텍스트에서 세부 사항까지 안내해, 출시할지, 다시 작업할지, 더 파고들지에 대해 충분한 정보를 바탕으로 판단할 수 있게 합니다.
|
||||
|
|
|
|||
|
|
@ -2,7 +2,7 @@
|
|||
title: "이름 있는 에이전트"
|
||||
description: BMad 에이전트가 이름, 페르소나, 커스터마이징 영역을 갖는 이유와 메뉴 기반 또는 프롬프트 기반 대안보다 무엇을 가능하게 하는지
|
||||
sidebar:
|
||||
order: 2
|
||||
order: 1
|
||||
---
|
||||
|
||||
"Mary, 브레인스토밍하자"라고 말하면 Mary가 활성화됩니다. 그녀는 설정한 언어로 당신의 이름을 부르고, 고유한 페르소나로 인사합니다. `bmad-help`가 언제나 가능하다고 알려줍니다. 그리고 의도가 명확했기 때문에 메뉴를 건너뛰고 바로 브레인스토밍으로 들어갑니다.
|
||||
|
|
@ -84,7 +84,7 @@ BMad는 BMad Method의 단계에 맞춘 여섯 이름 있는 에이전트를 제
|
|||
전체 커스터마이징 영역과 작동 예시는 다음을 참고하세요.
|
||||
|
||||
- [BMad 커스터마이징 방법](../how-to/customize-bmad.md) - 무엇을 커스터마이즈할 수 있고 병합이 어떻게 동작하는지의 참조
|
||||
- [조직을 위해 BMad 확장하기](../how-to/expand-bmad-for-your-org.md) - 에이전트 전반 규칙, 워크플로 관례, 외부 게시, 템플릿 교체, 에이전트 명단 커스터마이징을 다루는 실전 레시피
|
||||
- [조직을 위해 BMad 확장하기](../how-to/expand-bmad-for-your-org.md) - 에이전트 전반 규칙, 워크플로 관례, 외부 게시, 템플릿 교체, 에이전트 명단 커스터마이징을 다루는 여섯 가지 실전 레시피
|
||||
- `bmad-customize` 스킬 - 의도를 올바른 위치의 검증된 오버라이드 파일로 바꿔 주는 안내형 작성 도우미
|
||||
|
||||
## 더 큰 아이디어
|
||||
|
|
|
|||
|
|
@ -2,7 +2,7 @@
|
|||
title: "에이전트 충돌 방지"
|
||||
description: 여러 에이전트가 시스템을 구현할 때 아키텍처가 충돌을 방지하는 방법
|
||||
sidebar:
|
||||
order: 7
|
||||
order: 6
|
||||
---
|
||||
|
||||
여러 AI 에이전트가 시스템의 서로 다른 부분을 구현하면 충돌하는 기술 결정을 내릴 수 있습니다. 아키텍처 문서화는 공유 표준을 세워 이를 방지합니다.
|
||||
|
|
|
|||
|
|
@ -2,7 +2,7 @@
|
|||
title: "빠른 개발"
|
||||
description: 출력 품질을 보호하는 체크포인트를 포기하지 않고 사람이 개입하는 검토의 마찰을 줄입니다
|
||||
sidebar:
|
||||
order: 4
|
||||
order: 7
|
||||
---
|
||||
|
||||
의도를 넣으면 코드 변경이 나오고, 사람이 개입하는 검토 단계는 가능한 한 적게 사용합니다. 품질은 희생하지 않습니다.
|
||||
|
|
|
|||
|
|
@ -0,0 +1,82 @@
|
|||
---
|
||||
title: 'Web Bundles'
|
||||
description: Google Gemini Gems와 ChatGPT Custom GPT용으로 패키징된 BMad 스킬
|
||||
---
|
||||
|
||||
BMad의 계획 작업은 웹 LLM 구독 환경에서 실행하고, 만들어진 산출물은 IDE로 가져오세요.
|
||||
|
||||
## Web Bundle이란?
|
||||
|
||||
Web bundle은 **Google Gemini Gem** 또는 **ChatGPT Custom GPT**로 설치할 수 있게 다시 패키징한 BMad 스킬입니다. 각 번들에는 지식 파일로 업로드하는 `SKILL.md` 프로토콜, Gem 또는 GPT 지침에 붙여 넣는 `INSTRUCTIONS.md` 블록, 그리고 스킬에 필요한 데이터 파일(CSV, 템플릿, 검증 체크리스트, 추가로 점진 공개되는 콘텐츠)이 포함됩니다. 페르소나는 붙여 넣은 지침에 있고, 프로토콜은 지식 파일에 있습니다. 프로토콜을 건드리지 않고도 페르소나를 바꿀 수 있습니다.
|
||||
|
||||
설치가 원클릭은 아니지만 단계는 안내됩니다. **[bmadcode.com/web-bundles](https://bmadcode.com/web-bundles/)에서 설치하세요**. 이 사이트는 모든 번들을 카드 그리드로 보여 주고, Gemini와 ChatGPT 설치 단계를 페이지 안에서 안내하며, ZIP 다운로드를 제공합니다. 이것이 지원되는 설치 경로입니다. 선반 전체에서 패턴이 같으므로 하나만 설치해 보면 다음 번들은 기계적으로 진행할 수 있습니다.
|
||||
|
||||
BMad V4에도 web bundle이 있었습니다. V6에서는 현재 Gem과 Custom GPT 플랫폼, Canvas, Deep Research, 이미지 생성을 염두에 두고 다시 작성해 되살렸습니다.
|
||||
|
||||
## 사용하는 이유
|
||||
|
||||
계획 작업과 구현 작업에는 서로 다른 도구가 어울립니다. Web bundle은 각 작업을 가장 잘 맞는 곳에서 하게 해 줍니다.
|
||||
|
||||
| 관심사 | Web LLM(Gem 또는 GPT) | IDE(Claude Code, Cursor) |
|
||||
| --- | --- | --- |
|
||||
| 비용 모델 | 정액 구독 | 토큰 사용량 과금 |
|
||||
| 강점 | 대화, Canvas, Deep Research, 이미지 | 파일, 터미널, 코드베이스 컨텍스트 |
|
||||
| 가장 적합한 작업 | 브레인스토밍, brief, PRD, 리서치 | 구현, 리팩터링, 코드 리뷰 |
|
||||
|
||||
전체 PRD나 시장 리서치 대화를 IDE에서 진행하면 토큰을 많이 쓰지만, Gem이나 Custom GPT에서는 이미 가진 구독 비용 안에서 처리할 수 있습니다. 다듬어진 산출물은 저장소에 넣고 Claude Code나 Cursor가 이어받으면 됩니다.
|
||||
|
||||
:::tip[웹에서 계획하고 IDE에서 빌드하세요]
|
||||
작업이 길어질수록 비용 절감 효과가 커집니다. Gem에서 PRFAQ 한 번과 리서치 세 라운드를 돌리는 것은 추가 비용이 없지만, 같은 작업을 IDE에서 하면 실제 지출이 됩니다.
|
||||
:::
|
||||
|
||||
## 선반에 있는 것
|
||||
|
||||
현재 번들 세트는 분석과 계획 단계를 다룹니다.
|
||||
|
||||
| Bundle | Phase | Persona lineage |
|
||||
| --- | --- | --- |
|
||||
| Brainstorming Coach | Analysis | Osborn(기본), Minto(교체) |
|
||||
| Product Brief Coach | Analysis | Mary(BMad 분석가) |
|
||||
| PRFAQ Coach | Analysis | Working Backwards(Bezos) |
|
||||
| PRD Coach | Planning | Cagan |
|
||||
| UX Coach | Planning | Norman |
|
||||
| Market & Industry Research | Analysis | Porter와 Christensen |
|
||||
|
||||
각 번들은 소유 BMad 에이전트가 있는 경우 그 에이전트에서 물려받은 기본 페르소나와, 목소리 변경 패턴을 보여 주는 대비용 교체 예시를 함께 담고 있습니다.
|
||||
|
||||
## 세션 작동 방식
|
||||
|
||||
1. **Gem 또는 Custom GPT를 엽니다.** 페르소나가 캐릭터에 맞게 인사하고 대화형 발견을 시작합니다.
|
||||
2. **범위를 발견합니다.** 페르소나는 무엇을 하려는지, 이미 가진 것이 무엇인지, 어떤 제약이 있는지 묻습니다. 양식 채우기가 아닙니다.
|
||||
3. **Canvas에서 작업합니다.** 프로토콜은 세션 시작 시 Canvas를 열고 계속 업데이트합니다. Mermaid 다이어그램과 HTML 테이블도 글과 함께 들어갑니다.
|
||||
4. **인계합니다.** 작업이 끝나면 저장소에 붙여 넣거나, 내보내거나, 다음 단계를 위해 IDE의 BMad 스킬에 전달할 수 있는 Canvas 문서가 생깁니다.
|
||||
|
||||
Deep Research를 통합한 번들(현재 Market & Industry Research)은 세션 중간에 Gemini 또는 ChatGPT의 Deep Research 모드에 붙여 넣을 brief를 작성하고, 반환된 보고서를 다시 받아들입니다.
|
||||
|
||||
## Web bundle을 사용할 때
|
||||
|
||||
- 프로젝트의 앞단 사고를 진행하고 있고, 페르소나, Canvas, Deep Research를 갖춘 집중 도구가 필요합니다.
|
||||
- IDE 토큰 지출은 실제 코딩에 남겨 두고 싶습니다.
|
||||
- IDE 설정이 없는 협업자와 계획 산출물을 공유해야 합니다.
|
||||
|
||||
## IDE에 머무를 때
|
||||
|
||||
- 작업이 저장소의 코드를 읽거나 수정해야 합니다.
|
||||
- 이미 구현 중이고 컨텍스트를 유지하고 싶습니다.
|
||||
- Gemini Advanced 또는 ChatGPT Plus 구독이 없습니다.
|
||||
|
||||
## 업데이트와 커스터마이징
|
||||
|
||||
번들은 계속 발전합니다. 새 버전의 번들을 가져올 때 일반적으로 바뀌는 것은 지식 파일(`SKILL.md` 프로토콜과 첨부 템플릿, CSV, 검증 체크리스트)입니다. 업데이트를 적용하려면 Gem 또는 Custom GPT에 그 파일들을 다시 업로드하세요. 지침 블록은 보통 바뀌지 않습니다.
|
||||
|
||||
팀이나 자신의 목소리에 맞게 번들을 커스터마이징하려면 지식 파일이 아니라 Gem 또는 GPT에 붙여 넣은 **지침 블록**에서 하세요. 지침 블록은 페르소나, 선호 사항, 로컬 오버라이드가 있는 곳입니다. 지식 파일은 번들이 제공하는 프로토콜입니다. 커스터마이징을 지침 블록에 두면 이후 업데이트는 첨부 파일을 교체하는 작업이 되고, 수정 사항을 다시 병합하는 일이 되지 않습니다.
|
||||
|
||||
:::tip[지침을 커스터마이징하고 지식 파일을 첨부하세요]
|
||||
페르소나 교체, 기본 사용자 이름, 팀별 가드레일, 선호 표현은 모두 붙여 넣은 지침 블록에 둡니다. 지식 파일은 그대로 두어야 변경 사항을 잃지 않고 새로 고칠 수 있습니다.
|
||||
:::
|
||||
|
||||
## 직접 만들기
|
||||
|
||||
Web bundle은 `bmad-os-skill-to-bundle` 유틸리티 스킬을 사용해 BMad 스킬에서 생성합니다. 어떤 BMad 스킬 폴더든 지정하면 소유 에이전트에서 페르소나를 상속한 번들 파일을 만듭니다.
|
||||
|
||||
모든 번들은 [bmadcode.com/web-bundles](https://bmadcode.com/web-bundles/)에서 설치할 수 있습니다.
|
||||
|
|
@ -2,7 +2,7 @@
|
|||
title: "솔루션 설계가 중요한 이유"
|
||||
description: 다중 에픽 프로젝트에서 솔루션 설계 단계가 중요한 이유
|
||||
sidebar:
|
||||
order: 6
|
||||
order: 5
|
||||
---
|
||||
|
||||
단계 3(솔루션 설계)은 계획 단계의 **무엇을** 만들지를 **어떻게** 만들지로 바꿉니다. 구현이 시작되기 전에 아키텍처 결정을 문서화해 다중 에픽 프로젝트에서 에이전트 충돌을 방지합니다.
|
||||
|
|
|
|||
|
|
@ -2,7 +2,7 @@
|
|||
title: '조직을 위해 BMad 확장하기'
|
||||
description: 포크 없이 BMad를 재구성하는 여섯 가지 커스터마이징 패턴 - 에이전트 전반 규칙, 워크플로 관례, 외부 게시, 템플릿 교체, 에이전트 명단 변경, 고급 통합 패턴
|
||||
sidebar:
|
||||
order: 9
|
||||
order: 11
|
||||
---
|
||||
|
||||
BMad의 커스터마이징 영역을 사용하면 설치된 파일을 수정하거나 스킬을 포크하지 않고도 조직에 맞게 동작을 바꿀 수 있습니다. 이 가이드는 대부분의 엔터프라이즈 요구를 다루는 여섯 가지 레시피를 소개합니다.
|
||||
|
|
|
|||
|
|
@ -2,7 +2,7 @@
|
|||
title: '프로젝트 컨텍스트 관리'
|
||||
description: AI 에이전트를 안내하는 project-context.md를 만들고 유지합니다
|
||||
sidebar:
|
||||
order: 10
|
||||
order: 9
|
||||
---
|
||||
|
||||
`project-context.md` 파일을 사용해 모든 워크플로에서 AI 에이전트가 프로젝트의 기술 선호도와 구현 규칙을 따르게 하세요. 이 파일을 항상 참고하게 하려면 도구 컨텍스트나 항상 적용되는 규칙 파일(예: `AGENTS.md`)에 `중요한 프로젝트 컨텍스트와 관례는 [프로젝트 컨텍스트 경로]/project-context.md에 있습니다`라는 줄을 추가할 수도 있습니다.
|
||||
|
|
|
|||
|
|
@ -2,7 +2,7 @@
|
|||
title: '문서 샤딩 가이드'
|
||||
description: 큰 Markdown 파일을 더 작고 정리된 파일로 나눠 컨텍스트 관리를 개선합니다
|
||||
sidebar:
|
||||
order: 11
|
||||
order: 10
|
||||
---
|
||||
|
||||
큰 Markdown 파일을 더 작고 정리된 파일로 나눠 컨텍스트 관리를 개선해야 한다면 `bmad-shard-doc` 도구를 사용하세요.
|
||||
|
|
|
|||
|
|
@ -0,0 +1,41 @@
|
|||
---
|
||||
title: 'Web Bundles 사용하기'
|
||||
description: BMad web bundle을 Google Gemini Gem 또는 ChatGPT Custom GPT로 설치하기
|
||||
---
|
||||
|
||||
Web bundle은 **[bmadcode.com/web-bundles](https://bmadcode.com/web-bundles/)**에서 설치합니다.
|
||||
|
||||
## 단일 진입점이 필요한 이유
|
||||
|
||||
이 사이트는 번들 선반의 유일한 지원 설치 경로입니다. Gemini와 ChatGPT가 바뀌어도 단계가 최신 상태로 유지되고, 항상 가장 최신 태그 릴리스를 가리키며, 한 번 가입하면 새 번들이 나올 때 알림 목록에 들어갈 수 있습니다.
|
||||
|
||||
## 사이트에서 할 일
|
||||
|
||||
1. 카드 그리드에서 번들을 고릅니다.
|
||||
2. 설치 모달을 엽니다. **Gemini Gem** 탭과 **ChatGPT GPT** 탭을 전환해 플랫폼별 단계를 확인합니다.
|
||||
3. 번들 ZIP을 다운로드합니다. 이메일 전용 무료 멤버 가입은 한 번만 필요합니다.
|
||||
4. 페이지 안의 단계를 따릅니다. Gem 또는 Custom GPT를 만들고, 지식 파일을 업로드하고, 지침 블록을 붙여 넣은 뒤 저장합니다.
|
||||
|
||||
## 사전 조건
|
||||
|
||||
- **Gemini Gems**: Gemini Advanced 구독.
|
||||
- **ChatGPT Custom GPTs**: Plus, Pro, Business 또는 Enterprise 플랜.
|
||||
- **Deep Research**를 사용하는 번들(현재 Market & Industry Research)은 프롬프트 바에서 활성화합니다(Tools → Deep Research). Deep Research에는 별도의 플랜 제한이 있습니다.
|
||||
|
||||
## 페르소나 커스터마이징
|
||||
|
||||
각 번들의 `INSTRUCTIONS.md`(ZIP 안에 있음)에는 붙여 넣기 경계 위에 **Persona Swap Example**이 포함됩니다. 설치한 지침의 `[persona]` 블록을 교체 예시로 바꾸면 프로토콜을 바꾸지 않고도 목소리를 바꿀 수 있습니다. 직접 새 페르소나를 작성해도 됩니다. 프로토콜은 그대로 유지됩니다.
|
||||
|
||||
## 얻는 것
|
||||
|
||||
- 하나의 BMad 계획 역량에 맞춰진 재사용 가능한 Gem 또는 Custom GPT.
|
||||
- 구현을 위해 IDE에 바로 넣을 수 있는 다듬어진 산출물(brief, PRD, research report, UX spec).
|
||||
- 계획 대화가 토큰 사용량 과금 IDE가 아니라 기존 웹 LLM 구독에서 실행됩니다.
|
||||
|
||||
:::caution[페르소나 이탈]
|
||||
웹 LLM은 긴 세션 도중 가끔 페르소나를 놓칠 수 있습니다. 모델이 캐릭터 밖으로 말하기 시작하면 페르소나를 다시 상기시키거나 새 세션을 시작하세요.
|
||||
:::
|
||||
|
||||
## 직접 만들기
|
||||
|
||||
기존 BMad 스킬을 web bundle로 바꾸려면 [bmad-utility-skills](https://github.com/bmad-code-org/bmad-utility-skills)의 `bmad-os-skill-to-bundle` 유틸리티 스킬을 사용하세요. 이 스킬은 소유 에이전트에서 페르소나를 상속하고 대비용 교체 목소리 예시를 포함한 번들 파일을 만듭니다. 번들을 선반에 제출하려면 `web-bundles/bundles.json` 항목과 번들 디렉터리를 추가하는 PR을 [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD)에 여세요.
|
||||
|
|
@ -11,18 +11,18 @@ sidebar:
|
|||
|
||||
## 참고
|
||||
|
||||
- 각 에이전트는 설치 프로그램이 생성하는 스킬로 제공됩니다. 스킬 ID(예: `bmad-dev`)를 사용해 에이전트를 호출합니다.
|
||||
- 트리거는 각 에이전트 메뉴에 표시되는 짧은 메뉴 코드(예: `CP`)와 유사 매칭 항목입니다.
|
||||
- 각 에이전트는 설치 프로그램이 생성하는 스킬로 제공됩니다. 스킬 ID(예: `bmad-agent-dev`)를 사용해 에이전트를 호출합니다.
|
||||
- 트리거는 각 에이전트 메뉴에 표시되는 짧은 메뉴 코드(예: `PRD`)와 유사 매칭 항목입니다.
|
||||
- QA 테스트 생성은 개발자 에이전트를 통해 사용할 수 있는 `bmad-qa-generate-e2e-tests` 워크플로 스킬이 처리합니다. 전체 테스트 설계자(TEA)는 별도 모듈에 있습니다.
|
||||
|
||||
| 에이전트 | 스킬 ID | 트리거 | 주요 워크플로 |
|
||||
| --- | --- | --- | --- |
|
||||
| 분석가(Mary) | `bmad-analyst` | `BP`, `MR`, `DR`, `TR`, `CB`, `WB`, `DP` | 브레인스토밍, 시장 리서치, 도메인 리서치, 기술 리서치, 개요 작성, PRFAQ 챌린지, 프로젝트 문서화 |
|
||||
| 제품 관리자(John) | `bmad-pm` | `CP`, `VP`, `EP`, `CE`, `IR`, `CC` | PRD 생성/검증/편집, 에픽과 스토리 생성, 구현 준비 상태, 경로 수정 |
|
||||
| 아키텍트(Winston) | `bmad-architect` | `CA`, `IR` | 아키텍처 생성, 구현 준비 상태 |
|
||||
| 개발자(Amelia) | `bmad-agent-dev` | `DS`, `QD`, `QA`, `CR`, `SP`, `CS`, `ER` | 스토리 구현, 빠른 개발, QA 테스트 생성, 코드 리뷰, 스프린트 계획, 스토리 생성, 에픽 회고 |
|
||||
| UX 디자이너(Sally) | `bmad-ux-designer` | `CU` | UX 설계 생성 |
|
||||
| 기술 작성자(Paige) | `bmad-tech-writer` | `DP`, `WD`, `US`, `MG`, `VD`, `EC` | 프로젝트 문서화, 문서 작성, 표준 업데이트, Mermaid 생성, 문서 검증, 개념 설명 |
|
||||
| 분석가(Mary) | `bmad-agent-analyst` | `BP`, `MR`, `DR`, `TR`, `CB`, `WB`, `DP` | 브레인스토밍, 시장 리서치, 도메인 리서치, 기술 리서치, 개요 작성, PRFAQ 챌린지, 프로젝트 문서화 |
|
||||
| 제품 관리자(John) | `bmad-agent-pm` | `PRD`, `CE`, `IR`, `CC` | PRD 생성/업데이트/검증, 에픽과 스토리 생성, 구현 준비 상태, 경로 수정 |
|
||||
| 아키텍트(Winston) | `bmad-agent-architect` | `CA`, `IR` | 아키텍처 생성, 구현 준비 상태 |
|
||||
| 개발자(Amelia) | `bmad-agent-dev` | `DS`, `QD`, `QA`, `CR`, `SP`, `CS`, `ER`, `IN` | 스토리 구현, 빠른 개발, QA 테스트 생성, 코드 리뷰, 스프린트 계획, 스토리 생성, 에픽 회고, [포렌식 조사](../explanation/forensic-investigation.md) |
|
||||
| UX 디자이너(Sally) | `bmad-agent-ux-designer` | `CU` | UX 설계 생성 |
|
||||
| 기술 작성자(Paige) | `bmad-agent-tech-writer` | `DP`, `WD`, `MG`, `VD`, `EC` | 프로젝트 문서화, 문서 작성, Mermaid 생성, 문서 검증, 개념 설명 |
|
||||
|
||||
## 트리거 유형
|
||||
|
||||
|
|
@ -32,7 +32,7 @@ sidebar:
|
|||
|
||||
대부분의 트리거는 구조화된 워크플로 파일을 로드합니다. 트리거 코드를 입력하면 에이전트가 워크플로를 시작하고 각 단계에서 입력을 요청합니다.
|
||||
|
||||
예: `CP`(PRD 생성), `DS`(스토리 구현), `CA`(아키텍처 생성), `QD`(빠른 개발)
|
||||
예: `PRD`(PRD 생성, 업데이트 또는 검증), `DS`(스토리 구현), `CA`(아키텍처 생성), `QD`(빠른 개발)
|
||||
|
||||
### 대화형 트리거(인수 필요)
|
||||
|
||||
|
|
@ -41,7 +41,6 @@ sidebar:
|
|||
| 에이전트 | 트리거 | 제공할 내용 |
|
||||
| --- | --- | --- |
|
||||
| 기술 작성자(Paige) | `WD` | 작성할 문서 설명 |
|
||||
| 기술 작성자(Paige) | `US` | 표준에 추가할 선호 사항 또는 관례 |
|
||||
| 기술 작성자(Paige) | `MG` | 다이어그램 설명과 유형(시퀀스, 플로차트 등) |
|
||||
| 기술 작성자(Paige) | `VD` | 검증할 문서와 집중 영역 |
|
||||
| 기술 작성자(Paige) | `EC` | 설명할 개념 이름 |
|
||||
|
|
|
|||
|
|
@ -42,8 +42,8 @@ BMad는 작업을 시작하는 두 가지 방법을 제공하며 목적이 다
|
|||
| IDE / CLI | Skills 디렉터리 |
|
||||
| --- | --- |
|
||||
| Claude Code | `.claude/skills/` |
|
||||
| Cursor | `.cursor/skills/` |
|
||||
| Windsurf | `.windsurf/skills/` |
|
||||
| Cursor | `.agents/skills/` |
|
||||
| Windsurf | `.agents/skills/` |
|
||||
| 기타 IDE | 대상 경로는 설치 프로그램 출력 참고 |
|
||||
|
||||
각 스킬은 `SKILL.md` 파일을 포함하는 폴더입니다. Claude Code 설치 예시는 다음과 같습니다.
|
||||
|
|
@ -80,8 +80,8 @@ IDE에서 스킬 이름을 입력해 호출합니다. 일부 플랫폼은 스킬
|
|||
| 예시 스킬 | 에이전트 | 역할 |
|
||||
| --- | --- | --- |
|
||||
| `bmad-agent-dev` | Amelia(개발자) | 사양을 엄격히 준수해 스토리 구현 |
|
||||
| `bmad-pm` | John(제품 관리자) | PRD 생성 및 검증 |
|
||||
| `bmad-architect` | Winston(아키텍트) | 시스템 아키텍처 설계 |
|
||||
| `bmad-agent-pm` | John(제품 관리자) | PRD 생성 및 검증 |
|
||||
| `bmad-agent-architect` | Winston(아키텍트) | 시스템 아키텍처 설계 |
|
||||
|
||||
기본 에이전트와 트리거 전체 목록은 [에이전트](./agents.md)를 참고하세요.
|
||||
|
||||
|
|
@ -94,6 +94,7 @@ IDE에서 스킬 이름을 입력해 호출합니다. 일부 플랫폼은 스킬
|
|||
| `bmad-product-brief` | 제품 개요 생성 또는 업데이트 - 개념이 명확할 때 안내형 발견 |
|
||||
| `bmad-prfaq` | 제품 개념을 스트레스 테스트하는 [워킹 백워드 PRFAQ](../explanation/analysis-phase.md#prfaq-working-backwards) 챌린지 |
|
||||
| `bmad-prd` | 제품 요구사항 문서(PRD) 생성, 업데이트, 검증 |
|
||||
| `bmad-ux` | 사용자 경험 설계 |
|
||||
| `bmad-create-architecture` | 시스템 아키텍처 설계 |
|
||||
| `bmad-create-epics-and-stories` | 에픽과 스토리 생성 |
|
||||
| `bmad-dev-story` | 스토리 구현 |
|
||||
|
|
@ -120,7 +121,7 @@ bmad-help UX 설계에는 어떤 선택지가 있나요?
|
|||
|
||||
**기타 핵심 작업과 도구**
|
||||
|
||||
핵심 모듈에는 리뷰, 압축, 브레인스토밍, 문서 관리 등 11개의 내장 도구가 포함됩니다. 전체 참조는 [핵심 도구](./core-tools.md)를 참고하세요.
|
||||
핵심 모듈에는 스펙, 리뷰, 브레인스토밍, 커스터마이징, 문서 관리 등 12개의 내장 도구가 포함됩니다. 전체 참조는 [핵심 도구](./core-tools.md)를 참고하세요.
|
||||
|
||||
## 이름 규칙
|
||||
|
||||
|
|
|
|||
|
|
@ -18,7 +18,7 @@ IDE에서 스킬 이름(예: `bmad-help`)을 입력해 어떤 핵심 도구든
|
|||
| [`bmad-help`](#bmad-help) | 작업 | 다음에 무엇을 해야 할지 상황에 맞게 안내 |
|
||||
| [`bmad-brainstorming`](#bmad-brainstorming) | 워크플로 | 대화형 브레인스토밍 세션 진행 |
|
||||
| [`bmad-party-mode`](#bmad-party-mode) | 워크플로 | 다중 에이전트 그룹 토론 조율 |
|
||||
| [`bmad-distillator`](#bmad-distillator) | 작업 | 문서의 무손실 LLM 최적화 압축 |
|
||||
| [`bmad-spec`](#bmad-spec) | 워크플로 | 모든 의도 입력을 후속 작업의 표준 계약인 SPEC 커널과 동반 파일로 정제 |
|
||||
| [`bmad-advanced-elicitation`](#bmad-advanced-elicitation) | 작업 | LLM 출력을 반복 개선 방식으로 끌어올림 |
|
||||
| [`bmad-review-adversarial-general`](#bmad-review-adversarial-general) | 작업 | 빠진 것과 틀린 것을 찾는 비판적 리뷰 |
|
||||
| [`bmad-review-edge-case-hunter`](#bmad-review-edge-case-hunter) | 작업 | 처리되지 않은 엣지 케이스를 찾기 위한 철저한 분기 경로 분석 |
|
||||
|
|
@ -26,6 +26,7 @@ IDE에서 스킬 이름(예: `bmad-help`)을 입력해 어떤 핵심 도구든
|
|||
| [`bmad-editorial-review-structure`](#bmad-editorial-review-structure) | 작업 | 구조 편집 - 삭제, 병합, 재구성 |
|
||||
| [`bmad-shard-doc`](#bmad-shard-doc) | 작업 | 큰 Markdown 파일을 정리된 섹션으로 분할 |
|
||||
| [`bmad-index-docs`](#bmad-index-docs) | 작업 | 폴더 내 모든 문서 색인 생성 또는 업데이트 |
|
||||
| [`bmad-customize`](#bmad-customize) | 작업 | BMad 커스터마이징 오버라이드 생성 및 검증 |
|
||||
|
||||
## bmad-help
|
||||
|
||||
|
|
@ -97,32 +98,36 @@ IDE에서 스킬 이름(예: `bmad-help`)을 입력해 어떤 핵심 도구든
|
|||
|
||||
**출력:** 에이전트 페르소나가 유지되는 실시간 다중 에이전트 대화
|
||||
|
||||
## bmad-distillator
|
||||
## bmad-spec
|
||||
|
||||
**소스 문서의 무손실 LLM 최적화 압축입니다.** 후속 LLM 사용을 위해 모든 정보를 보존하는 조밀하고 토큰 효율적인 요약본을 생성합니다. 왕복 재구성으로 검증할 수 있습니다.
|
||||
**모든 의도 입력을 후속 작업의 표준 SPEC 계약으로 정제합니다.** 간단한 아이디어, PRD, GDD, RFC, 브레인 덤프, 회의록, UX 폴더, 여러 소스가 섞인 입력을 받아 다섯 필드 커널(Why, Capabilities, Constraints, Non-goals, Success signal)을 담은 `SPEC.md`와 커널에 들어가지 않는 핵심 내용을 위한 동반 파일을 만듭니다.
|
||||
|
||||
**사용 시점:**
|
||||
|
||||
- 문서가 LLM 컨텍스트 창에 너무 큽니다
|
||||
- 리서치, 사양, 계획 산출물의 토큰 효율적인 버전이 필요합니다
|
||||
- 압축 중 정보 손실이 없는지 검증하고 싶습니다
|
||||
- 에이전트가 자주 참조하고 정보를 찾아야 합니다
|
||||
- 소프트웨어, 게임 디자인, 리서치, 편집, 정책, 비즈니스 등 어떤 작업이든 HOW 전에 WHAT을 고정해야 합니다.
|
||||
- 후속 스킬이 모든 상위 산출물을 다시 읽지 않고도 소비할 수 있는 간결하고 군더더기 없는 LLM 최적화 계약이 필요합니다.
|
||||
- 기존 spec을 검증하거나 업데이트하고 싶습니다.
|
||||
|
||||
**작동 방식:**
|
||||
|
||||
1. **분석** - 소스 문서를 읽고 정보 밀도와 구조를 식별합니다
|
||||
2. **압축** - 문장을 조밀한 글머리표 형식으로 바꾸고 장식적 서식을 제거합니다
|
||||
3. **확인** - 원래 정보가 모두 보존되었는지 완전성을 확인합니다
|
||||
4. **검증(선택 사항)** - 왕복 재구성 테스트로 무손실 압축을 증명합니다
|
||||
1. 입력과 연결된 보조 자료를 읽습니다.
|
||||
2. 설정 가능한 템플릿으로 다섯 필드 커널을 정제하고, 넘치는 내용은 적절한 이름의 동반 파일로 보냅니다.
|
||||
3. 두 단계 자체 검증을 실행합니다. 먼저 일관성 규칙을 확인하고, 다음으로 모든 핵심 소스 주장이 보존됐는지 확인합니다.
|
||||
4. `{output_folder}/specs/spec-{slug}/` 아래에 `SPEC.md`, 동반 파일, `.decision-log.md`를 씁니다.
|
||||
|
||||
Spec Law는 여덟 가지 규칙을 강제합니다. capabilities는 의도와 성공 기준을 모두 담고, intents는 HOW가 아니라 WHAT이며, constraints는 실제 의사결정에 영향을 주고, non-goals는 명시적이며, success signals는 구체적이고, capability ID는 안정적이며, 모든 핵심 소스 주장은 보존되고, 문장은 간결해야 합니다.
|
||||
|
||||
**입력:**
|
||||
|
||||
- `source_documents`(필수) - 파일 경로, 폴더 경로, glob 패턴
|
||||
- `downstream_consumer`(선택 사항) - 이 요약본을 사용할 대상(예: "PRD 작성")
|
||||
- `token_budget`(선택 사항) - 대략적 목표 크기
|
||||
- `--validate`(플래그) - 왕복 재구성 테스트 실행
|
||||
- `input`(필수) - 경로 또는 인라인 텍스트. 모호한 아이디어, 브레인 덤프, PRD, GDD, RFC, brief, transcript, mockup 폴더, 여러 소스 조합.
|
||||
- `slug`(선택 사항) - 입력이 빈약하고 소스 파일명에서 slug를 만들 수 없을 때만 필요합니다.
|
||||
- `target_spec_path`(선택 사항) - 새 spec을 만드는 대신 기존 spec을 업데이트할 때 설정합니다.
|
||||
|
||||
**출력:** 압축률 보고서(예: "3.2:1")가 포함된 요약 Markdown 파일
|
||||
**출력:** `SPEC.md`, 동반 파일, `.decision-log.md`가 들어 있는 spec 폴더. Headless 호출자는 결과 상태와 작성 또는 수정된 파일 목록을 담은 JSON 응답을 받습니다.
|
||||
|
||||
:::note[변경 계약]
|
||||
`bmad-spec`은 `SPEC.md`와 spec이 작성한 동반 파일을 쓸 수 있는 유일한 도구입니다. 다른 스킬은 자체 네이티브 산출물을 만들고, 의도를 표준 계약으로 표현하거나 업데이트를 제안해야 할 때 headless 모드로 `bmad-spec`을 호출합니다.
|
||||
:::
|
||||
|
||||
## bmad-advanced-elicitation
|
||||
|
||||
|
|
@ -291,3 +296,26 @@ IDE에서 스킬 이름(예: `bmad-help`)을 입력해 어떤 핵심 도구든
|
|||
**입력:** 대상 폴더 경로
|
||||
|
||||
**출력:** 정리된 파일 목록, 상대 링크, 짧은 설명이 있는 `index.md`
|
||||
|
||||
## bmad-customize
|
||||
|
||||
**커스터마이징 오버라이드를 만들고 검증합니다.** TOML을 직접 작성하지 않고도 설치된 BMad 에이전트나 워크플로의 동작을 바꿀 수 있게 도와줍니다.
|
||||
|
||||
**사용 시점:**
|
||||
|
||||
- 에이전트나 워크플로 동작을 바꾸고 싶습니다
|
||||
- 지속 사실, 활성화 훅, 커스텀 메뉴 항목을 추가해야 합니다
|
||||
- 올바른 오버라이드 범위를 자동으로 선택하고 검증하고 싶습니다
|
||||
|
||||
**작동 방식:**
|
||||
|
||||
1. 설치된 BMad 스킬에서 커스터마이징 가능한 영역을 스캔합니다
|
||||
2. 요청한 변경에 맞는 범위를 선택합니다
|
||||
3. `_bmad/custom/` 아래에 오버라이드 파일을 작성합니다
|
||||
4. 병합된 설정을 검증합니다
|
||||
|
||||
**입력:** 원하는 커스터마이징을 설명하는 자연어
|
||||
|
||||
**출력:** `_bmad/custom/` 아래의 TOML 오버라이드 파일
|
||||
|
||||
BMad 커스터마이징에 대한 자세한 가이드는 [BMad 커스터마이징 방법](../how-to/customize-bmad.md)을 참고하세요.
|
||||
|
|
|
|||
|
|
@ -13,10 +13,10 @@ BMad Method(BMM)는 BMad 생태계의 모듈이며 컨텍스트 엔지니어링
|
|||
|
||||
마지막으로 중요한 점: 아래 모든 워크플로는 스킬로 직접 실행하거나, 먼저 에이전트를 로드한 뒤 에이전트 메뉴 항목을 사용해 원하는 도구에서 실행할 수 있습니다.
|
||||
|
||||
<iframe src="/workflow-map-diagram-ko-kr.html" title="BMad Method 워크플로 맵 다이어그램" width="100%" height="100%" style="border-radius: 8px; border: 1px solid #334155; min-height: 900px;"></iframe>
|
||||
<iframe src="/workflow-map-diagram-ko.html" title="BMad Method 워크플로 맵 다이어그램" width="100%" height="100%" style="border-radius: 8px; border: 1px solid #334155; min-height: 900px;"></iframe>
|
||||
|
||||
<p style="font-size: 0.8rem; text-align: right; margin-top: -0.5rem; margin-bottom: 1rem;">
|
||||
<a href="/workflow-map-diagram-ko-kr.html" target="_blank" rel="noopener noreferrer">다이어그램 새 탭에서 열기 ↗</a>
|
||||
<a href="/workflow-map-diagram-ko.html" target="_blank" rel="noopener noreferrer">다이어그램 새 탭에서 열기 ↗</a>
|
||||
</p>
|
||||
|
||||
## 단계 1: 분석(선택)
|
||||
|
|
@ -37,7 +37,7 @@ BMad Method(BMM)는 BMad 생태계의 모듈이며 컨텍스트 엔지니어링
|
|||
| 워크플로 | 목적 | 산출물 |
|
||||
| --- | --- | --- |
|
||||
| `bmad-prd` | PRD를 생성, 업데이트, 검증합니다. 안내형 발견 과정과 세 가지 의도를 하나의 스킬에 담았습니다 | 생성/업데이트: `prd.md`, `addendum.md`, `decision-log.md`; 검증: `validation-report.html` + `.md` |
|
||||
| `bmad-create-ux-design` | UX가 중요할 때 사용자 경험을 설계합니다 | `ux-spec.md` |
|
||||
| `bmad-ux` | UX가 중요할 때 사용자 경험을 설계합니다. DESIGN.md(시각)와 EXPERIENCE.md(동작) spine 쌍을 만듭니다 | `DESIGN.md`, `EXPERIENCE.md`, `.decision-log.md` |
|
||||
|
||||
:::tip[하나의 스킬 안에 세 의도]
|
||||
`bmad-prd`는 전체 PRD 수명주기를 처리합니다. 호출할 때 의도를 말하거나 스킬이 물어보게 하세요.
|
||||
|
|
|
|||
|
|
@ -85,7 +85,7 @@ BMad Method, BMad Method 모듈(BMM), BMad 빌더(BMB)는 계속 발전하고
|
|||
<div class="roadmap-future-card">
|
||||
<span class="roadmap-emoji">🎙️</span>
|
||||
<h4>BMad Method 팟캐스트</h4>
|
||||
<p>AI 네이티브 개발에 관한 대화입니다. 2026년 3월 1일 공개 예정입니다.</p>
|
||||
<p>AI 네이티브 개발에 관한 대화입니다.</p>
|
||||
</div>
|
||||
<div class="roadmap-future-card">
|
||||
<span class="roadmap-emoji">🎓</span>
|
||||
|
|
|
|||
|
|
@ -160,7 +160,7 @@ BMad 도움말이 완료된 작업을 감지하고 정확한 다음 단계를
|
|||
- `bmad-quick-dev`를 실행합니다. 계획과 구현을 하나의 워크플로에서 처리하므로 구현 단계로 바로 넘어갑니다
|
||||
|
||||
:::note[UX 설계(선택)]
|
||||
프로젝트에 사용자 인터페이스가 있다면 PRD를 만든 뒤 **UX 디자이너 에이전트**(`bmad-agent-ux-designer`)를 호출하고 UX 설계 워크플로(`bmad-create-ux-design`)를 실행하세요.
|
||||
프로젝트에 사용자 인터페이스가 있다면 PRD를 만든 뒤 **UX 디자이너 에이전트**(`bmad-agent-ux-designer`)를 호출하고 UX 설계 워크플로(`bmad-ux`)를 실행하세요.
|
||||
:::
|
||||
|
||||
### 3단계: 솔루션 설계(BMad Method/엔터프라이즈)
|
||||
|
|
|
|||
|
|
@ -427,7 +427,7 @@
|
|||
<div class="decision">UI가 있나요?</div>
|
||||
<div class="workflow">
|
||||
<div class="workflow-header">
|
||||
<span class="workflow-name">create-ux-design</span>
|
||||
<span class="workflow-name">ux</span>
|
||||
<span class="badge iffy">예</span>
|
||||
</div>
|
||||
<div class="workflow-meta">
|
||||
|
|
@ -435,7 +435,7 @@
|
|||
<div class="agent-icon sally">S</div>
|
||||
<span class="agent-name">Sally</span>
|
||||
</div>
|
||||
<span class="output">ux-spec.md →</span>
|
||||
<span class="output">DESIGN.md + EXPERIENCE.md →</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
|
@ -591,7 +591,7 @@
|
|||
<div class="quickflow-header">
|
||||
<span>⚡</span>
|
||||
<div>
|
||||
<h2>Quick Flow (병렬 트랙)</h2>
|
||||
<h2>빠른 흐름 (병렬 트랙)</h2>
|
||||
<span>범위가 작고 명확한 변경에 사용됩니다 — 1~3단계를 건너뜁니다</span>
|
||||
</div>
|
||||
</div>
|
||||
|
|
|
|||
Loading…
Reference in New Issue