promptbox
스킬· Skills
원본 보기

superoffice (cskwork/superoffice-skills)

한국 직장인 업무 문서(보고서·덱·엑셀·한글 공문)를 회사 브랜드로 결론 먼저 작성하고, 결정론적 office-gate를 통과할 때까지 납품하지 않는 Claude 스킬.

Generates, reads, and converts business documents (docx/pptx/xlsx/hwpx/pdf) for Korean office workers — company brand applied, conclusion first, and delivery gated on a deterministic office-gate check.

#skill#claude-code#office#document#korean#brand#quality-gate

사용법

How to use
설치 · Install
git clone https://github.com/cskwork/superoffice-skills && ln -s "$(pwd)/superoffice-skills" ~/.claude/skills/superoffice
트리거 · Trigger
/superoffice · 보고서 만들어줘 · 제안서 docx로 · 분기 실적 PPT · 정산표 엑셀로 · 한글 공문 hwpx
작성자 · Author cskwork 라이선스 · License MIT

한 줄

한국 직장인이 팀장·경영자에게 보고하는 업무 문서(보고서, 발표 덱(slide deck), 정산표, 한글 공문 등)를 결론 먼저(BLUF: Bottom Line Up Front) 구조로 작성하고, 회사 브랜드(색·폰트·로고)를 일관 적용하며, office-gate.sh(안전성·한국어·무결성·대비도(contrast) 검증 스크립트)가 통과할 때까지 납품을 선언하지 않는 Claude 스킬.

EN: One brief in, a polished Korean business document out — company brand wired in, message structured conclusion-first, and gate-checked before delivery.

언제 쓰는가

  • “1분기 실적 보고 PPT 12장 만들어줘” — PPTX 빌드 모드
  • “제안서 docx로 뽑아줘, 회사 양식 있어” — 회사 템플릿 상속 + DOCX 빌드
  • “분기 KPI 대시보드 엑셀로” — XLSX 빌드 모드 (openpyxl/XlsxWriter/pandas)
  • “이 hwpx 공문 표 추출해줘” — READ 모드 (기존 문서 읽기)
  • “pdf → docx 변환만 해줘” — CONVERT 모드
  • 입력 신호로 형식을 자동 판별하며, 같은 스킬 안에서 DOCX / PPTX / XLSX / HWPX / PDF / READ / CONVERT 모드를 전환한다.

무엇을 하는가

브리프(brief: 작업 지시 요약)를 읽어 형식·대상·목적·분량을 한 줄로 선언한 뒤 5단계 루프를 돈다.

  1. Read — 형식·기밀 등급·변환 타깃 추론, vault(문서당 작업 디렉토리) 생성.
  2. Brand — 회사 자체 양식이 있으면 색·폰트·레이아웃을 추출해 brand-kit.json으로 확정; 없으면 brand-interviewer 에이전트가 ≤5 질문으로 캡처.
  3. Build — doc-producer(문서)·xlsx-producer(엑셀) 서브에이전트가 메시지 구조(biz-report.md: 결론 먼저·action title·한장보고)와 디자인 팔레트를 적용해 문서를 생성. 자기 승인 금지.
  4. Critique — doc-critic이 office-gate.sh를 실행하고 스크립트가 못 보는 것(BLUF·MECE·한국어 자연스러움·브랜드 일관성)을 독립 판정. 모든 위반 로그.
  5. Verify — 위반마다 최소 수정 후 gate 재실행. 최대 3 사이클; 같은 규칙이 계속 실패하면 중단 후 정직하게 보고.

수치·날짜는 facts.json 출처가 있거나 삭제(위조 금지). 이모지 없음, 범용 한글 폰트(맑은 고딕/나눔), cross-platform 경로는 templates/doc-env.py에 위임.

함정

  • 멀티파일 스킬이다. agents/(서브에이전트 페르소나), reference/(형식별 가이드), templates/(gate 스크립트·환경 헬퍼), examples/(견본)가 함께 있어야 동작한다. SKILL.md 단독으로는 부족하다 — 위 install 명령으로 repo 전체를 clone + symlink 해야 한다.
  • 회사 템플릿 파일이 없으면 brand-interviewer가 브랜드 인터뷰(최대 5 질문)를 진행한다. 비대화형 환경이면 보수적 가정 + 로그로 대체.
  • PPTX는 python-pptx 기반 정밀 제어 전용이다. 빠른 마크다운 초안이 목적이면 이 스킬이 아닌 다른 도구를 쓴다.
  • AI 초안 수업 덱·교육 자료, 단일면 인쇄 포스터는 이 스킬 범위 밖이다.
  • 외부 전송·회사 기밀 외부 업로드·파괴적 단계는 명시적 동의 없이 실행하지 않는다.

원문 — SKILL.md

---
name: superoffice
description: Business-document maker for Korean office workers (팀장·경영자) - read the brief, route to the right format, apply the company brand, and ship a report/deck/sheet that passes a deterministic office-gate. Generates, reads, and converts docx/pptx/xlsx/hwpx/pdf cross-platform (Windows/macOS). Use for "/superoffice", "보고서 만들어줘", "제안서 docx로", "분기 실적 PPT", "정산표 엑셀로", "KPI 대시보드", "한글 공문 hwpx", "회사 템플릿/브랜드로 만들어줘", "이 문서 표 추출해줘", "pdf로 변환". 학생/학부모 배포 교육 자료가 아니라 회사 업무 문서를 만들 때.
---

# /superoffice - 직장인 업무 문서, 회사 브랜드로, 결론 먼저

Intent -> 형식 판별 -> 회사 브랜드 적용 -> 결론 먼저 메시지 구조 -> 결정론적 `office-gate` 통과. 기존 문서 한 줄 수정: skip this skill, edit directly.

## Core principles

- 결론 먼저. 팀장·경영자는 60초 안에 권고를 이해해야 한다 - BLUF/action title/한장보고. 색·레이아웃보다 메시지 구조가 먼저다 (`reference/biz-report.md`).
- 브리프 먼저 읽는다. 형식(docx/pptx/xlsx/hwpx/pdf)·대상·목적·분량·변환 타깃을 추론해 한 줄로 선언하고, 기본 템플릿이 아니라 그 브리프에 맞춘다.
- 회사 브랜드를 입힌다. 회사 템플릿 파일 상속 + brand-kit.json(색/폰트/로고/정책)을 한 번 캡처해 모든 형식에 일관 적용 (`reference/brand-kit.md`). 회사 색도 contrast AA를 지킨다.
- 검증은 눈대중이 아니다. 모든 산출물은 `templates/office-gate.sh`(safety+korean+integrity+contrast)를 통과한다. Builder는 자기 승인하지 않는다.
- 절대 위조하지 않는다. 없는 수치·날짜·통계는 `facts.json` 출처 또는 삭제. 라이브러리/변환 도구 부재 -> 문서화된 placeholder + `[substitution]`, 가짜 파일·가짜 렌더 금지.
- 협업 안전. 이모지 금지(대괄호 마커 `[현황]`/`[조치]`), 어절 띄어쓰기·맞춤법, 범용 한글 폰트(맑은 고딕/나눔). cross-platform 경로·폰트는 `templates/doc-env.py`에 위임.
- Hard stops. 외부 전송/게시, 회사 기밀 문서의 외부 서비스 업로드, 파괴적 단계는 명시적 동의. 모호한 브리프 -> 한 질문, 비대화형 -> 보수적 가정 + 로그.

## Mode (형식+작업으로 분류, 한 줄로 선언)

State e.g. `Making this as: PPTX 1분기 실적 보고 덱, 회사 브랜드 적용, 16:9, 12장`.

| Signal | Mode | Route |
|---|---|---|
| 보고서 / 제안서 / 기안 / 공문 본문 / docx | DOCX | `reference/docx.md` |
| 발표 덱 / 보고 슬라이드 / 정밀 표·도형 / pptx | PPTX | `reference/pptx.md` |
| 정산 / KPI / 대시보드 / 표·수식·차트 / 엑셀 / xlsx | XLSX | `reference/xlsx.md` |
| 한글 공문서 / 공공·기업 표준 / hwpx | HWPX | `reference/hwpx.md` |
| 다페이지 본문 PDF 생성 / PDF 읽기·표 추출 | PDF | `reference/pdf.md` |
| 기존 문서(docx/pptx/xlsx/pdf/hwpx) 읽기·표 추출 | READ | `reference/doc-ingest.md` |
| 형식 변환 / 마크다운 (hwpx<->docx<->pdf<->xlsx<->md) | CONVERT | 각 형식 reference의 변환 섹션 (`templates/doc-env.sh`); .md는 `reference/markdown.md` |

오버레이(빌드 모드 위에 얹음): **BRAND** 회사 템플릿/스타일 반영 -> `reference/brand-kit.md` (어느 빌드 모드든). **메시지 구조** 보고서·덱 -> `reference/biz-report.md` (보고 문서면 항상).

Tie-breaks: AI 초안 수업 덱·교육 자료 -> 이 레포 아님(supercontent). 단일면 인쇄 포스터 -> 이 레포 아님. "표 추출/읽어줘" -> READ. "변환만" -> CONVERT. 정밀 셀·좌표 .pptx vs 빠른 초안 -> 이 레포는 정밀(python-pptx)만.

## Default loop - role-separated, subagent-default

각 역할은 fresh-context 서브에이전트가 기본(디스패치하는 에이전트가 conductor). 단순 단일 수정은 루프를 건너뛰고 인라인. 2+ 문서나 병렬 배치는 문서당 producer 하나로 오케스트레이션. **Vault** = 문서당 작업 디렉토리, 기본 `.superoffice/<doc>/`: `doc-claims.md` + `facts.json` (+선택 `contrast-pairs.json`/`brand-kit.json`), `templates/`에서 시작. `office-gate.sh <vault> <text files>`가 이를 읽는다 - no vault, no gate.

1. **Read (브리프).** 형식·대상·목적·분량·변환 타깃·기밀 등급을 추론, 한 줄 선언. 두 해석이 갈리면 한 질문, 비대화형이면 보수적 가정 + 로그. vault 생성. (`reference/office.md`)
2. **Brand (오버레이, 필요 시).** 회사 자체 양식이 있으면 그 파일을 분석해 색·폰트·레이아웃을 추출하고 사용자 확인을 받아(상호작용) brand-kit.json 확정; 없으면 `brand-interviewer`가 ≤5 질문으로 캡처. `.superoffice/brand-kit.json`에 저장해 재사용. 회사 양식은 형식 예시로도 쓴다(`reference/examples.md`). (`reference/brand-kit.md`, `agents/brand-interviewer.md`)
3. **Build.** docx/pptx/pdf/hwpx는 `doc-producer`, xlsx는 `xlsx-producer`. 메시지 구조는 `biz-report.md`, 디자인 팔레트는 형식 reference, 사용자가 형식/예시를 주면 그 구조를 따른다(`reference/examples.md`), 실제 자산만(위조 금지). `doc-claims.md` + `facts.json` 누적. 자기 승인 금지. (`agents/doc-producer.md`, `agents/xlsx-producer.md`)
4. **Critique (독립; 문서 무수정).** `doc-critic`이 본문/셀을 텍스트로 enumerate, `office-gate.sh` 실행, 그다음 스크립트가 못 보는 것 판정: BLUF/action title/So-what/MECE, 한국어 자연스러움, 브랜드 일관성, 표·수치 정합. 모든 위반 로그. (`agents/doc-critic.md`)
5. **Verify.** 위반마다 최소 수정, green까지 재실행. 통과를 명령 출력으로 보고. Cap: 3 사이클; 같은 규칙이 계속 실패하면 멈추고 남은 것을 정직하게 보고.

Roles -> personas: 브랜드=`agents/brand-interviewer.md`, 문서빌드=`agents/doc-producer.md`, 엑셀빌드=`agents/xlsx-producer.md`, 검수=`agents/doc-critic.md`.

## Mode contract (deliverable + done-when)

| Mode | Deliverable | Verified by |
|---|---|---|
| DOCX / PPTX / XLSX / HWPX / PDF | 문서 파일 + vault (+변환 산출물) | `office-gate.sh` green (korean+integrity, +contrast when pairs declared); 라이브러리/변환 부재 시 문서화된 placeholder |
| READ | 추출 텍스트/표(.txt/.csv/.md) + 출처 기록 | 형식별 파서로 추출; 스캔 PDF는 OCR 미적용 명시(위조 금지) |
| CONVERT | 변환 산출물 (또는 원본 + 수동 변환 안내) | 변환 직접 확인; H2Orestart 등 환경 변경은 동의 후 |
| BRAND (오버레이) | `.superoffice/brand-kit.json` | 스키마 유효 + 색이 contrast AA |

## Reference map (load only what the phase/mode needs)

| Read | When |
|---|---|
| `reference/office.md` | 시작: 형식/작업 판별 + 게이트 + vault + 환경 허브 |
| `reference/biz-report.md` | 보고서·덱: 결론 먼저 메시지 구조(BLUF/action title/SCQA/RAG) |
| `reference/brand-kit.md` | BRAND: 회사 템플릿 상속 + brand-kit.json 인터뷰·적용 |
| `reference/examples.md` | 형식 따라하기: 하우스 견본 + 사용자 예시/회사 양식 구조 모방 |
| `reference/docx.md` | DOCX 빌드/읽기 (python-docx) |
| `reference/pptx.md` | PPTX 빌드/읽기 (python-pptx, 정밀 제어 + 덱 디자인) |
| `reference/xlsx.md` | XLSX 빌드/읽기 (openpyxl/XlsxWriter/pandas) |
| `reference/hwpx.md` | HWPX 빌드/편집/읽기/검증 (python-hwpx) |
| `reference/pdf.md` | PDF 생성/읽기 (Chromium/WeasyPrint/ReportLab; pdfplumber/pypdf) |
| `reference/doc-ingest.md` | READ: 형식 무관 기존 문서 읽기 매트릭스 |
| `reference/markdown.md` | 마크다운 <-> office 변환·추출 (.md 소스/산출) |
| `reference/sources.md` | 라이브러리·라이선스·attribution |

## Final checklist

- [ ] Mode + 한 줄 Read 선언; 형식·대상·목적·변환 타깃이 브리프에
- [ ] 회사 브랜드 필요 시 brand-kit 적용(템플릿 상속 또는 인터뷰); 브랜드 색 contrast AA
- [ ] 메시지 구조 먼저(`biz-report.md`): 결론 먼저, action title, 한장보고; 그다음 디자인 팔레트
- [ ] 이모지 없음, 어절 띄어쓰기·맞춤법, 범용 한글 폰트; cross-platform은 `doc-env.py` 위임
- [ ] 실제/생성 자산만(위조 없음), 수치·날짜는 `facts.json` 출처
- [ ] Mode contract 충족: 빌드 모드 -> `templates/office-gate.sh` green(출력 보고) + critic HIGH 0건
- [ ] 의도에 대한 최소 변경; 요청 없는 재작성 없음
- [ ] 외부 전송/게시·기밀 외부 업로드·파괴적 단계는 명시적 동의
## 한 줄

한국 직장인이 팀장·경영자에게 보고하는 업무 문서(보고서, 발표 덱(slide deck), 정산표, 한글 공문 등)를 결론 먼저(BLUF: Bottom Line Up Front) 구조로 작성하고, 회사 브랜드(색·폰트·로고)를 일관 적용하며, `office-gate.sh`(안전성·한국어·무결성·대비도(contrast) 검증 스크립트)가 통과할 때까지 납품을 선언하지 않는 Claude 스킬.

*EN: One brief in, a polished Korean business document out — company brand wired in, message structured conclusion-first, and gate-checked before delivery.*

## 언제 쓰는가

- "1분기 실적 보고 PPT 12장 만들어줘" — PPTX 빌드 모드
- "제안서 docx로 뽑아줘, 회사 양식 있어" — 회사 템플릿 상속 + DOCX 빌드
- "분기 KPI 대시보드 엑셀로" — XLSX 빌드 모드 (`openpyxl`/`XlsxWriter`/`pandas`)
- "이 hwpx 공문 표 추출해줘" — READ 모드 (기존 문서 읽기)
- "pdf → docx 변환만 해줘" — CONVERT 모드
- 입력 신호로 형식을 자동 판별하며, 같은 스킬 안에서 DOCX / PPTX / XLSX / HWPX / PDF / READ / CONVERT 모드를 전환한다.

## 무엇을 하는가

브리프(brief: 작업 지시 요약)를 읽어 형식·대상·목적·분량을 한 줄로 선언한 뒤 5단계 루프를 돈다.

1. **Read** — 형식·기밀 등급·변환 타깃 추론, vault(문서당 작업 디렉토리) 생성.
2. **Brand** — 회사 자체 양식이 있으면 색·폰트·레이아웃을 추출해 `brand-kit.json`으로 확정; 없으면 `brand-interviewer` 에이전트가 ≤5 질문으로 캡처.
3. **Build** — `doc-producer`(문서)·`xlsx-producer`(엑셀) 서브에이전트가 메시지 구조(`biz-report.md`: 결론 먼저·action title·한장보고)와 디자인 팔레트를 적용해 문서를 생성. 자기 승인 금지.
4. **Critique** — `doc-critic`이 `office-gate.sh`를 실행하고 스크립트가 못 보는 것(BLUF·MECE·한국어 자연스러움·브랜드 일관성)을 독립 판정. 모든 위반 로그.
5. **Verify** — 위반마다 최소 수정 후 gate 재실행. 최대 3 사이클; 같은 규칙이 계속 실패하면 중단 후 정직하게 보고.

수치·날짜는 `facts.json` 출처가 있거나 삭제(위조 금지). 이모지 없음, 범용 한글 폰트(맑은 고딕/나눔), cross-platform 경로는 `templates/doc-env.py`에 위임.

## 함정

- 멀티파일 스킬이다. `agents/`(서브에이전트 페르소나), `reference/`(형식별 가이드), `templates/`(gate 스크립트·환경 헬퍼), `examples/`(견본)가 함께 있어야 동작한다. **SKILL.md 단독으로는 부족하다** — 위 install 명령으로 repo 전체를 clone + symlink 해야 한다.
- 회사 템플릿 파일이 없으면 `brand-interviewer`가 브랜드 인터뷰(최대 5 질문)를 진행한다. 비대화형 환경이면 보수적 가정 + 로그로 대체.
- PPTX는 `python-pptx` 기반 정밀 제어 전용이다. 빠른 마크다운 초안이 목적이면 이 스킬이 아닌 다른 도구를 쓴다.
- AI 초안 수업 덱·교육 자료, 단일면 인쇄 포스터는 이 스킬 범위 밖이다.
- 외부 전송·회사 기밀 외부 업로드·파괴적 단계는 명시적 동의 없이 실행하지 않는다.

## 원문 — SKILL.md

````markdown
---
name: superoffice
description: Business-document maker for Korean office workers (팀장·경영자) - read the brief, route to the right format, apply the company brand, and ship a report/deck/sheet that passes a deterministic office-gate. Generates, reads, and converts docx/pptx/xlsx/hwpx/pdf cross-platform (Windows/macOS). Use for "/superoffice", "보고서 만들어줘", "제안서 docx로", "분기 실적 PPT", "정산표 엑셀로", "KPI 대시보드", "한글 공문 hwpx", "회사 템플릿/브랜드로 만들어줘", "이 문서 표 추출해줘", "pdf로 변환". 학생/학부모 배포 교육 자료가 아니라 회사 업무 문서를 만들 때.
---

# /superoffice - 직장인 업무 문서, 회사 브랜드로, 결론 먼저

Intent -> 형식 판별 -> 회사 브랜드 적용 -> 결론 먼저 메시지 구조 -> 결정론적 `office-gate` 통과. 기존 문서 한 줄 수정: skip this skill, edit directly.

## Core principles

- 결론 먼저. 팀장·경영자는 60초 안에 권고를 이해해야 한다 - BLUF/action title/한장보고. 색·레이아웃보다 메시지 구조가 먼저다 (`reference/biz-report.md`).
- 브리프 먼저 읽는다. 형식(docx/pptx/xlsx/hwpx/pdf)·대상·목적·분량·변환 타깃을 추론해 한 줄로 선언하고, 기본 템플릿이 아니라 그 브리프에 맞춘다.
- 회사 브랜드를 입힌다. 회사 템플릿 파일 상속 + brand-kit.json(색/폰트/로고/정책)을 한 번 캡처해 모든 형식에 일관 적용 (`reference/brand-kit.md`). 회사 색도 contrast AA를 지킨다.
- 검증은 눈대중이 아니다. 모든 산출물은 `templates/office-gate.sh`(safety+korean+integrity+contrast)를 통과한다. Builder는 자기 승인하지 않는다.
- 절대 위조하지 않는다. 없는 수치·날짜·통계는 `facts.json` 출처 또는 삭제. 라이브러리/변환 도구 부재 -> 문서화된 placeholder + `[substitution]`, 가짜 파일·가짜 렌더 금지.
- 협업 안전. 이모지 금지(대괄호 마커 `[현황]`/`[조치]`), 어절 띄어쓰기·맞춤법, 범용 한글 폰트(맑은 고딕/나눔). cross-platform 경로·폰트는 `templates/doc-env.py`에 위임.
- Hard stops. 외부 전송/게시, 회사 기밀 문서의 외부 서비스 업로드, 파괴적 단계는 명시적 동의. 모호한 브리프 -> 한 질문, 비대화형 -> 보수적 가정 + 로그.

## Mode (형식+작업으로 분류, 한 줄로 선언)

State e.g. `Making this as: PPTX 1분기 실적 보고 덱, 회사 브랜드 적용, 16:9, 12장`.

| Signal | Mode | Route |
|---|---|---|
| 보고서 / 제안서 / 기안 / 공문 본문 / docx | DOCX | `reference/docx.md` |
| 발표 덱 / 보고 슬라이드 / 정밀 표·도형 / pptx | PPTX | `reference/pptx.md` |
| 정산 / KPI / 대시보드 / 표·수식·차트 / 엑셀 / xlsx | XLSX | `reference/xlsx.md` |
| 한글 공문서 / 공공·기업 표준 / hwpx | HWPX | `reference/hwpx.md` |
| 다페이지 본문 PDF 생성 / PDF 읽기·표 추출 | PDF | `reference/pdf.md` |
| 기존 문서(docx/pptx/xlsx/pdf/hwpx) 읽기·표 추출 | READ | `reference/doc-ingest.md` |
| 형식 변환 / 마크다운 (hwpx<->docx<->pdf<->xlsx<->md) | CONVERT | 각 형식 reference의 변환 섹션 (`templates/doc-env.sh`); .md는 `reference/markdown.md` |

오버레이(빌드 모드 위에 얹음): **BRAND** 회사 템플릿/스타일 반영 -> `reference/brand-kit.md` (어느 빌드 모드든). **메시지 구조** 보고서·덱 -> `reference/biz-report.md` (보고 문서면 항상).

Tie-breaks: AI 초안 수업 덱·교육 자료 -> 이 레포 아님(supercontent). 단일면 인쇄 포스터 -> 이 레포 아님. "표 추출/읽어줘" -> READ. "변환만" -> CONVERT. 정밀 셀·좌표 .pptx vs 빠른 초안 -> 이 레포는 정밀(python-pptx)만.

## Default loop - role-separated, subagent-default

각 역할은 fresh-context 서브에이전트가 기본(디스패치하는 에이전트가 conductor). 단순 단일 수정은 루프를 건너뛰고 인라인. 2+ 문서나 병렬 배치는 문서당 producer 하나로 오케스트레이션. **Vault** = 문서당 작업 디렉토리, 기본 `.superoffice/<doc>/`: `doc-claims.md` + `facts.json` (+선택 `contrast-pairs.json`/`brand-kit.json`), `templates/`에서 시작. `office-gate.sh <vault> <text files>`가 이를 읽는다 - no vault, no gate.

1. **Read (브리프).** 형식·대상·목적·분량·변환 타깃·기밀 등급을 추론, 한 줄 선언. 두 해석이 갈리면 한 질문, 비대화형이면 보수적 가정 + 로그. vault 생성. (`reference/office.md`)
2. **Brand (오버레이, 필요 시).** 회사 자체 양식이 있으면 그 파일을 분석해 색·폰트·레이아웃을 추출하고 사용자 확인을 받아(상호작용) brand-kit.json 확정; 없으면 `brand-interviewer`가 ≤5 질문으로 캡처. `.superoffice/brand-kit.json`에 저장해 재사용. 회사 양식은 형식 예시로도 쓴다(`reference/examples.md`). (`reference/brand-kit.md`, `agents/brand-interviewer.md`)
3. **Build.** docx/pptx/pdf/hwpx는 `doc-producer`, xlsx는 `xlsx-producer`. 메시지 구조는 `biz-report.md`, 디자인 팔레트는 형식 reference, 사용자가 형식/예시를 주면 그 구조를 따른다(`reference/examples.md`), 실제 자산만(위조 금지). `doc-claims.md` + `facts.json` 누적. 자기 승인 금지. (`agents/doc-producer.md`, `agents/xlsx-producer.md`)
4. **Critique (독립; 문서 무수정).** `doc-critic`이 본문/셀을 텍스트로 enumerate, `office-gate.sh` 실행, 그다음 스크립트가 못 보는 것 판정: BLUF/action title/So-what/MECE, 한국어 자연스러움, 브랜드 일관성, 표·수치 정합. 모든 위반 로그. (`agents/doc-critic.md`)
5. **Verify.** 위반마다 최소 수정, green까지 재실행. 통과를 명령 출력으로 보고. Cap: 3 사이클; 같은 규칙이 계속 실패하면 멈추고 남은 것을 정직하게 보고.

Roles -> personas: 브랜드=`agents/brand-interviewer.md`, 문서빌드=`agents/doc-producer.md`, 엑셀빌드=`agents/xlsx-producer.md`, 검수=`agents/doc-critic.md`.

## Mode contract (deliverable + done-when)

| Mode | Deliverable | Verified by |
|---|---|---|
| DOCX / PPTX / XLSX / HWPX / PDF | 문서 파일 + vault (+변환 산출물) | `office-gate.sh` green (korean+integrity, +contrast when pairs declared); 라이브러리/변환 부재 시 문서화된 placeholder |
| READ | 추출 텍스트/표(.txt/.csv/.md) + 출처 기록 | 형식별 파서로 추출; 스캔 PDF는 OCR 미적용 명시(위조 금지) |
| CONVERT | 변환 산출물 (또는 원본 + 수동 변환 안내) | 변환 직접 확인; H2Orestart 등 환경 변경은 동의 후 |
| BRAND (오버레이) | `.superoffice/brand-kit.json` | 스키마 유효 + 색이 contrast AA |

## Reference map (load only what the phase/mode needs)

| Read | When |
|---|---|
| `reference/office.md` | 시작: 형식/작업 판별 + 게이트 + vault + 환경 허브 |
| `reference/biz-report.md` | 보고서·덱: 결론 먼저 메시지 구조(BLUF/action title/SCQA/RAG) |
| `reference/brand-kit.md` | BRAND: 회사 템플릿 상속 + brand-kit.json 인터뷰·적용 |
| `reference/examples.md` | 형식 따라하기: 하우스 견본 + 사용자 예시/회사 양식 구조 모방 |
| `reference/docx.md` | DOCX 빌드/읽기 (python-docx) |
| `reference/pptx.md` | PPTX 빌드/읽기 (python-pptx, 정밀 제어 + 덱 디자인) |
| `reference/xlsx.md` | XLSX 빌드/읽기 (openpyxl/XlsxWriter/pandas) |
| `reference/hwpx.md` | HWPX 빌드/편집/읽기/검증 (python-hwpx) |
| `reference/pdf.md` | PDF 생성/읽기 (Chromium/WeasyPrint/ReportLab; pdfplumber/pypdf) |
| `reference/doc-ingest.md` | READ: 형식 무관 기존 문서 읽기 매트릭스 |
| `reference/markdown.md` | 마크다운 <-> office 변환·추출 (.md 소스/산출) |
| `reference/sources.md` | 라이브러리·라이선스·attribution |

## Final checklist

- [ ] Mode + 한 줄 Read 선언; 형식·대상·목적·변환 타깃이 브리프에
- [ ] 회사 브랜드 필요 시 brand-kit 적용(템플릿 상속 또는 인터뷰); 브랜드 색 contrast AA
- [ ] 메시지 구조 먼저(`biz-report.md`): 결론 먼저, action title, 한장보고; 그다음 디자인 팔레트
- [ ] 이모지 없음, 어절 띄어쓰기·맞춤법, 범용 한글 폰트; cross-platform은 `doc-env.py` 위임
- [ ] 실제/생성 자산만(위조 없음), 수치·날짜는 `facts.json` 출처
- [ ] Mode contract 충족: 빌드 모드 -> `templates/office-gate.sh` green(출력 보고) + critic HIGH 0건
- [ ] 의도에 대한 최소 변경; 요청 없는 재작성 없음
- [ ] 외부 전송/게시·기밀 외부 업로드·파괴적 단계는 명시적 동의
````