문서 플래너은(는) 무엇을 하나요?
문서 사이트의 격차를 식별하고 우선순위가 지정된 백로그를 생성합니다.
입력
- 범위: 평가할 영역 — 전체 문서, 특정 섹션 또는 기능 영역. 기본값: 전체.
- 신호 (선택 사항): GitHub 이슈, 커뮤니티 질문, 지원 스레드.
- 경쟁 컨텍스트 (선택 사항): 경쟁사가 문서화했지만 우리가 문서화하지 않은 내용.
프로세스
1단계: 현재 문서 인벤토리 작성
site/src/config/navigation.yml을 읽어 전체 네비게이션 트리를 확인합니다. 이는 Astro 사이트의 공식 네비게이션 소스이며 site/astro.config.mjs를 통해 site/src/sidebar.ts에 로드됩니다. site/src/content/docs/**/*.{md,mdx}를 글로브(glob)하여 모든 콘텐츠 파일을 찾습니다. 각 파일을 콘텐츠 유형(튜토리얼, 방법 가이드, 참조, 설명, 혼합)과 적용 범위 영역(퀵스타트, 도구, 에이전트, 멀티 에이전트, 배포 등)으로 분류합니다.
2단계: 격차 식별
인벤토리를 다음 항목과 비교합니다:
- SDK 표면 영역: 모든 주요 기능이 문서화되었습니까? 문서 페이지가 없는 기능은 격차입니다.
- Diataxis 완전성: 각 기능 영역에 대해 네 가지 유형의 문서가 모두 존재합니까? 참조는 있지만 튜토리얼이 없는 기능은 격차가 있습니다.
- 커뮤니티 신호: GitHub CLI를 사용할 수 있다면
strands-agents/harness-sdk저장소에서 "documentation" 레이블이 달린 열린 이슈를 가져옵니다. 질문을 기존 문서(불명확/찾기 어려움) 또는 누락된 문서(콘텐츠 격차)에 매핑합니다. - 경쟁사 비교 (제공된 경우): LangChain, CrewAI, Anthropic, OpenAI가 동등한 기능에 대해 문서화했지만 우리가 문서화하지 않은 내용은 무엇입니까?
3단계: 우선순위 지정
각 격차에 개발자 영향도와 노력에 따라 점수를 매깁니다:
- P0 (지금 바로): 영향도 높음, 모든 노력. 퀵스타트, 시작 가이드, 핵심 개념.
- P1 (곧): 영향도 중간, 노력 낮음. 일반적인 작업에 대한 누락된 방법 가이드.
- P2 (계획): 영향도 중간, 노력 높음. 새로운 튜토리얼, 아키텍처 설명.
- P3 (백로그): 영향도 낮음. 틈새 시나리오, 에지 케이스 문서.
4단계: 백로그 생성
마크다운으로 출력:
## 문서 백로그: [범위]
**생성일:** [날짜]
**인벤토리 페이지 수:** [개수]
**식별된 격차:** [개수]
### P0: 지금 바로
- [ ] [작업] — [콘텐츠 유형] — [대상 페이지] — [이유]
### P1: 곧
- [ ] [작업] — [콘텐츠 유형] — [대상 페이지] — [이유]
### P2: 계획
- [ ] [작업] — [콘텐츠 유형] — [대상 페이지] — [이유]
### P3: 백로그
- [ ] [작업] — [콘텐츠 유형] — [대상 페이지] — [이유]
### 적용 범위 매트릭스
| 기능 영역 | 튜토리얼 | 방법 가이드 | 참조 | 설명 |
|---|---|---|---|---|
| 에이전트 기본 | Y | ~ | Y | N |
| 사용자 정의 도구 | Y | Y | Y | N |
| 멀티 에이전트 | ~ | N | Y | ~ |
### 신호 기반 인사이트
- [커뮤니티 신호에서 특정 문서 격차로 매핑된 테마]
이 스킬이 수행하지 않는 작업
- 문서를 작성하지 않음 (문서 작성자는 docs-writer 사용)
- 외부 신호 파이프라인이 필요하지 않음 (로컬 인벤토리만으로 작동)
- 외부 도구에서 자동으로 작업을 생성하지 않음