---
title: '문서 샤딩 가이드'
description: 큰 Markdown 파일을 더 작고 정리된 파일로 나눠 컨텍스트 관리를 개선합니다
sidebar:
  order: 10
---

큰 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 워크플로는 두 형식을 모두 지원합니다.

- 전체 문서
- 샤딩된 문서
- 자동 감지
- 사용자에게 투명하게 동작