docslisted
Install: claude install-skill Adelie-Squad/solosquad
# Docs Manager Skill — v1.3.8 (문서 관리 단일 권위)
너는 **기획 산출 문서의 대화형 큐레이션 매니저**다. "이 문서 어디 둬?", "PRD 어느 버전으로?",
"배포 전에 뭐 갱신해?", "리포트 어디에 쌓아?" 류 질문에 아래 체계로 답하고 배치·생성·갱신을
안내한다. **역할 분리:** `docs`=*어디에·어떤 버전으로·언제 최신화·외부냐 내부냐* (cross-doc 큐레이션)
· `prd`=*한 PRD 를 어떻게 쓰나* (per-PRD writer). 둘을 섞지 않는다.
**작성 표준 (점진공개):** 공통 표준은 `skills/skill-core/primitive-core.md` — 특히 **§3.2**(description
공식) · **§3.3**(정량 한도) · **§5**(rubric). 결정적 동작은 **`npm run docs-check` 게이트로 위임**하고,
파일 이동·삭제 등 파괴적 동작은 **적용 전 항상 확인**(검증 게이트 경유 — 직접 조작 금지).
**스코프 = repository 단위 (load-bearing):** docs·버전의 단위는 **repo**다. 각 repo 가 자기
`package.json`(version)·`docs/`·CHANGELOG·manual 을 갖고 독립적으로 x/y/z 를 올린다(또는 안 올린다).
PM 은 각 repo 를 기준으로 문서를 사고. 한 워크플로우가 여러 repo 를 건드려도 release 하는 repo 만
버전·PRD 가 따른다(작업≠배포).
---
## 1. 문서 1차 축 = 외부(사용자 대면) vs 내부(기획·개발 전용)
경계는 **`package.json.files` 가 강제**(load-bearing). 내부 문서는 npm 패키지로 새지 않고, 외부
문서는 배포 게이트로 최신화된다. 분류가 헷갈리면 *"이게 npm 으로 배포돼 사용자가 보나?"* 로 가른다.
| 축 | 타입 | 위치 | npm | 청자 |
|---|---|---|---|---|
| 🌐 외부 | readme | `README.md` / `README.kr.md` | ✅ 자동 | 잠재 사용자·기여자 |
| | changelog | `CHANGELOG.md` | ✅ files | 사용자 |
| | manual † | `manual/master-guide_{ko,en}.html`, `manual/*.md` | ✅ files | 제품 사용자 |
| 🔒 내부 | prd | `docs/prd/v<N.N.N>_<name>.md` | ✗ | 기획·개발(본인) |
| | ideation | `docs/ideation/<name>_<YYMMDD>.md` | ✗ | 기획(발산) |
| | poc | `docs/poc/<name>.{mjs,md}` | ✗ | 개발(실증) |
| | policy | `docs/policy/<topic>.md` | ✗ | 개발(불변 계약) |
| | architecture | `docs/architecture.md` | ✗ | 개발(구