Client-Docs (고객 제출 산출물 온디맨드 생성)

원칙: 산출물은 자주 안 만든다. 요청받은 그 산출물만, 이미 있는 원재료(docs/·코드·실행 결과)에서 변환 생성한다.

산출물 라우팅

산출물	원재료 (없으면 먼저 생성)	비고
아키텍처설계서	docs/ARCHITECTURE.md + 구성도 + ERD (없으면 /docs arch 먼저)
인터페이스설계서	docs/api/ OpenAPI 명세 (없으면 /docs api 먼저)	내외부 연계 목록 포함
DB설계서	ERD + 모델/마이그레이션 코드 → 테이블정의서 표
요구사항정의서/추적표(RTM)	SPEC.md·PRD.md + 요구사항↔구현(파일/커밋)↔테스트 매핑	매핑 근거 없이 칸 채우기 금지
단위/통합테스트결과서	실제 테스트 실행 출력 (pytest/CI 로그)	실행하지 않은 결과 기재 절대 금지 — 증거 기반 완료 보고 원칙
사용자/운영자 매뉴얼	docs/manuals/, docs/ops/ (없으면 /docs manual·ops 먼저)
운영보고서(AO)	AUDIT.log, 장애·변경 기록, git log	기간을 사용자에게 확인

생성 규칙

1. 출력 위치: {project}/deliverables/[산출물명]_[YYYY-MM-DD].md
2. 공통 골격: 표지(사업명·작성일·버전) → 개정이력 → 목차 → 본문 → 첨부. 본문 구조는 산출물 유형별 관례를 따른다
3. 고객 양식이 있으면 양식 우선: ~/.claude/templates/client/ 또는 {project}/templates/에 고객사 템플릿이 있으면 그 구조·항목명을 그대로 따른다. 없으면 위 공통 골격의 마크다운으로 생성 (추후 엑셀/워드 변환은 pandoc 등으로)
4. 사실만 기재: 코드·docs·실행 결과에서 확인된 내용만. 확인 안 된 항목은 비워두고 [확인 필요]로 표시 — 그럴듯하게 채우지 않는다
5. 원재료가 낡았으면 먼저 /docs sync 후 산출물 생성
6. 생성 후 memory/INDEX.md에 deliverables/ 라우팅 행이 없으면 추가 (키워드: 산출물,검수,납품)
7. 검수 수준 요건 (독립 평가에서 도출된 반려 방지 규칙):
   • 테스트결과서는 집계표만으로 부족 — 케이스별 상세(ID·테스트명·판정)를 별첨으로 포함 (실제 -v 출력에서 생성)
   • 커버리지는 측정 명령과 범위를 명시하고, tests/ 포함 수치만 단독 기재 금지 — 소스 패키지 기준 수치를 병기 (분모 차이로 2배 부풀려 읽힐 수 있음)
   • 결재란(작성/검토/승인)과 요구사항 추적성 매트릭스 골격 포함 — 값이 없으면 [확인 필요]로
8. 생성 후 가능하면 별도 에이전트로 사실 대조(수치 재현) 검증 — 생성자가 자기 산출물을 채점하지 않는다

진입점

• 슬래시 명령: /client-docs [arch|api|db|rtm|test|manual|ops|report]
• 자연어: "검수 산출물", "납품 문서", "테스트결과서 뽑아줘" 등의 요청 시 이 스킬로 라우팅

금지

• 요청 안 받은 산출물까지 일괄 생성 (온디맨드 원칙)
• 실행하지 않은 테스트 결과·검증하지 않은 수치 기재
• docs/ 원본 수정 (산출물은 deliverables/에만 생성 — 원본은 /docs 계열이 소유)