# ubisam-deliverables (Claude Code Skill)

Ubisam 협업관리 구조로 **어떤 프로젝트에서든 동일한 산출물 트리·양식**을 생성·관리하는 스킬.
`ref/` 원본 파일 없이도 동작하도록 양식 골격을 MD에 내장(자기완결).

## 설치
대상 프로젝트에 폴더째 복사:
```
<프로젝트>/.claude/skills/ubisam-deliverables/
```
(개인 전역으로 쓰려면 `~/.claude/skills/` 아래에 둬도 됨.)

## 사용
- "Ubisam 산출물 구조 만들어줘" / "산출물 트리 스캐폴딩" → 트리 생성(A).
- "이 양식 채워줘"(`docs/[Ubisam산출물]/산출물문서/양식/`에 파일 투입 후) → 양식 채움(B).

## 구성
```
SKILL.md                  # 인덱스 + 오케스트레이션(0 하네스 / A 스캐폴딩 / B 채움)
references/
  00-harness.md           # 호스트 레포 맞물림·비침습 계약
  01-tree.md              # 목표 트리·배치 규칙
  02-enums.md             # 상태4·유형9·티켓코드
  03-schema.md            # 일감·프로젝트 스키마
  04-stage-deliverables.md# 6단계↔슬롯 매핑
  05-form-schemas.md      # 설계 양식 시트·컬럼(ref 불필요)
  06-procedure.md         # 분석→채움 절차
  07-fill-mapping.md      # 프로젝트 분석→산출물 필드 자동 채움
  08-design-system.md     # 색상 팔레트·배너·뱃지·진행률 HTML 템플릿
  09-pptx-integration.md  # PPTX 생성 — ubisam-ppt-make 연동 절차
  xlsxfill.py             # xlsx 스타일 상수 + scratch-build API
  build_02설계_xlsx.py    # 02.설계 xlsx 4종 생성 (독립 실행)
  build_02설계_pptx.py    # 02.설계 SW_설계서.pptx 생성 (독립 실행)
templates/
  _task.template.md       # 일감 카드 템플릿
  project.yaml.template   # 프로젝트 메타 템플릿
```

## 원칙
- 모든 MD 200줄 이내 (`rules.md` #4), 상호 링크로 매핑.
- enum 고정(상태/유형) · 출처 명시 · 조건부 서식 보존 · 레포 루트 보호.