# 📚 문서화·지식관리을 위한 BMad 활용 가이드 <!-- 자동 생성됨. 직접 편집하지 마세요. 콘텐츠는 _guides.yaml을 수정하세요. --> > [!tldr] 누구에게? > 기술 작가, 개발자 레포 소유자, 팀 내 "문서는 내가 다 관리"하는 사람. > 코드와 문서가 항상 엇갈려 괴로운 분. ## BMad가 해결하는 문제 문서화는 "언젠가 할 일"로 밀리지만, 사실은 **에이전트 시대에 가장 중요한 자산**이다. LLM이 작업할 때 문서가 곧 컨텍스트이기 때문. BMad의 Paige(tech-writer)는 CommonMark·DITA·OpenAPI 전문가로서 문서 작성·표준 업데이트·Mermaid 다이어그램·문서 검증까지 커버한다. 브라운필드 프로젝트는 `bmad-document-project`로 기존 코드를 한 방에 LLM 친화적 문서로 변환한다. ## 추천 워크플로우 ### 1. 프로젝트 문서화 — 기존 코드 → LLM 친화 문서 - [[skills#bmad-document-project|프로젝트 문서화]] ### 2. 프로젝트 컨텍스트 생성 — AI 에이전트용 project-context.md - [[skills#bmad-generate-project-context|프로젝트 컨텍스트 생성]] ### 3. 문서 색인 — 폴더 내 문서 index.md - [[skills#bmad-index-docs|문서 색인]] ### 4. 문서 분할 — 500줄 넘는 긴 문서 쪼개기 - [[skills#bmad-shard-doc|문서 분할]] ### 5. 문서 증류 — 토큰 효율적 요약 - [[skills#bmad-distillator|증류기]] ### 6. 편집 검토 — 산문·구조 두 차원 - [[skills#bmad-editorial-review-prose|산문 편집 검토]] - [[skills#bmad-editorial-review-structure|구조 편집 검토]] ## 만날 에이전트 - [[BOX/BMad-Method/agents#Paige|Paige]] — Technical Writer ## 5분 시작 가이드 레거시 프로젝트를 만났다면: ``` tech-writer 를 불러서 document-project 해줘 ``` 몇 분이면 코드베이스의 아키텍처·컴포넌트·데이터 흐름이 문서로 뽑혀 나온다. ## 심화 학습 - 문서가 쌓이면 [[skills#`bmad-index-docs`|`bmad-index-docs`]]로 index.md를 주기적으로 갱신. - 특정 스킬의 내부 지식을 압축 배포하려면 [[skills#`bmad-distillator`|`bmad-distillator`]]. --- ## 관련 문서 - [[guide|← 분야 선택으로 돌아가기]] - [[BOX/BMad-Method/agents]] · [[skills]] · [[modules]]