79 lines
2.3 KiB
Markdown
79 lines
2.3 KiB
Markdown
---
|
|
title: '문서 샤딩 가이드'
|
|
description: 큰 Markdown 파일을 더 작고 정리된 파일로 나눠 컨텍스트 관리를 개선합니다
|
|
sidebar:
|
|
order: 11
|
|
---
|
|
|
|
큰 Markdown 파일을 더 작고 정리된 파일로 나눠 컨텍스트 관리를 개선해야 한다면 `bmad-shard-doc` 도구를 사용하세요.
|
|
|
|
:::caution[지원 중단]
|
|
이 방식은 더 이상 권장되지 않습니다. 업데이트된 워크플로와 대부분의 주요 LLM 및 도구가 하위 프로세스를 지원하게 되면 곧 필요 없어질 것입니다.
|
|
:::
|
|
|
|
## 사용 시점
|
|
|
|
선택한 도구/모델 조합이 필요한 모든 문서를 입력으로 로드하고 읽지 못한다는 것을 확인한 경우에만 사용하세요.
|
|
|
|
## 문서 샤딩이란?
|
|
|
|
문서 샤딩은 큰 Markdown 파일을 2단계 제목(`## 제목`)을 기준으로 더 작고 정리된 파일로 나눕니다.
|
|
|
|
### 아키텍처
|
|
|
|
```text
|
|
샤딩 전:
|
|
_bmad-output/planning-artifacts/
|
|
└── PRD.md (큰 50k 토큰 파일)
|
|
|
|
샤딩 후:
|
|
_bmad-output/planning-artifacts/
|
|
└── prd/
|
|
├── index.md # 설명이 있는 목차
|
|
├── overview.md # 섹션 1
|
|
├── user-requirements.md # 섹션 2
|
|
├── technical-requirements.md # 섹션 3
|
|
└── ... # 추가 섹션
|
|
```
|
|
|
|
## 단계
|
|
|
|
### 1. 문서 샤딩 도구 실행
|
|
|
|
```bash
|
|
/bmad-shard-doc
|
|
```
|
|
|
|
### 2. 대화형 과정 따르기
|
|
|
|
```text
|
|
에이전트: 어떤 문서를 샤딩할까요?
|
|
사용자: docs/PRD.md
|
|
|
|
에이전트: 기본 대상: docs/prd/
|
|
기본값을 사용할까요? [y/n]
|
|
사용자: y
|
|
|
|
에이전트: PRD.md를 샤딩하는 중...
|
|
✓ 섹션 파일 12개 생성
|
|
✓ index.md 생성
|
|
✓ 완료!
|
|
```
|
|
|
|
## 워크플로 발견 방식
|
|
|
|
BMad 워크플로는 **이중 발견 시스템**을 사용합니다.
|
|
|
|
1. **먼저 전체 문서 시도** - `document-name.md`를 찾습니다
|
|
2. **샤딩된 버전 확인** - `document-name/index.md`를 찾습니다
|
|
3. **우선순위 규칙** - 둘 다 있으면 전체 문서가 우선합니다. 샤딩된 버전을 사용하려면 전체 문서를 제거하세요
|
|
|
|
## 워크플로 지원
|
|
|
|
모든 BMM 워크플로는 두 형식을 모두 지원합니다.
|
|
|
|
- 전체 문서
|
|
- 샤딩된 문서
|
|
- 자동 감지
|
|
- 사용자에게 투명하게 동작
|