BMAD-METHOD/shard-large-documents.md at c8784a167b00a1620b71bf593a8096bf5a9ea18e

2.3 KiB

Raw Blame History

title

description

sidebar

문서 샤딩 가이드

큰 Markdown 파일을 더 작고 정리된 파일로 나눠 컨텍스트 관리를 개선합니다

order
10

큰 Markdown 파일을 더 작고 정리된 파일로 나눠 컨텍스트 관리를 개선해야 한다면 bmad-shard-doc 도구를 사용하세요.

:::caution[지원 중단] 이 방식은 더 이상 권장되지 않습니다. 업데이트된 워크플로와 대부분의 주요 LLM 및 도구가 하위 프로세스를 지원하게 되면 곧 필요 없어질 것입니다. :::

사용 시점

선택한 도구/모델 조합이 필요한 모든 문서를 입력으로 로드하고 읽지 못한다는 것을 확인한 경우에만 사용하세요.

문서 샤딩이란?

문서 샤딩은 큰 Markdown 파일을 2단계 제목(## 제목)을 기준으로 더 작고 정리된 파일로 나눕니다.

아키텍처

샤딩 전:
_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. 문서 샤딩 도구 실행

/bmad-shard-doc

2. 대화형 과정 따르기

에이전트: 어떤 문서를 샤딩할까요?
사용자: docs/PRD.md

에이전트: 기본 대상: docs/prd/
       기본값을 사용할까요? [y/n]
사용자: y

에이전트: PRD.md를 샤딩하는 중...
       ✓ 섹션 파일 12개 생성
       ✓ index.md 생성
       ✓ 완료!

워크플로 발견 방식

BMad 워크플로는 이중 발견 시스템을 사용합니다.

먼저 전체 문서 시도 - document-name.md를 찾습니다
샤딩된 버전 확인 - document-name/index.md를 찾습니다
우선순위 규칙 - 둘 다 있으면 전체 문서가 우선합니다. 샤딩된 버전을 사용하려면 전체 문서를 제거하세요

워크플로 지원

모든 BMM 워크플로는 두 형식을 모두 지원합니다.

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

2.3 KiB Raw Blame History