Superoffice

/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는 자기 승인하지 않는다. 바이너리 산출물은 OfficeCLI(선택; brew/scoop/npm)가 있으면 렌더 검증(screenshot/issues/validate)으로 시각 결함까지 확인한다.
• 절대 위조하지 않는다. 없는 수치·날짜·통계는 facts.json 출처 또는 삭제. 라이브러리/변환 도구 부재 -> 문서화된 placeholder + [substitution], 가짜 파일·가짜 렌더 금지.
• 협업 안전. 이모지 금지(대괄호 마커 [현황]/[조치]), 어절 띄어쓰기·맞춤법, 범용 한글 폰트(맑은 고딕/나눔). cross-platform 경로·폰트는 templates/doc-env.py에 위임.
• Hard stops. 외부 전송/게시, 회사 기밀 문서의 외부 서비스 업로드, 파괴적 단계는 명시적 동의.

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

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

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

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

Default loop - role-separated

단순 단일 수정은 인라인으로 처리한다. 그 외에도 준비·작성은 직접 진행할 수 있으며, 문서 수만으로 producer를 늘리지 않는다. 사실·수식·변환·시각 결함의 위험이 큰 산출물은 fresh-context critic으로 독립 검증한다. 각 역할의 세부 계약은 해당 역할을 수행할 때만 읽는다. 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 실행, officecli 있으면 산출물을 PNG로 렌더해 육안 검수(텍스트 넘침·잔여 플레이스홀더; 부재 시 "렌더 미검증" 명시), 그다음 스크립트가 못 보는 것 판정: BLUF/action title/So-what/MECE, 한국어 자연스러움, 브랜드 일관성, 표·수치 정합. 모든 위반 로그. (agents/doc-critic.md)
5. Verify. 위반을 최소 수정하고 영향받은 게이트를 다시 실행한다. 통과는 명령 출력으로 보고한다. 동일 실패를 변경 없이 반복하지 말고 원인을 좁힌다. 유용한 범위 내 진전이 불가능한 실제 차단 조건에서 멈추고 필요한 입력과 미검증을 보고한다.

Mode contract (deliverable + done-when)

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

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건
• 바이너리 산출물은 officecli 있으면 렌더 PNG 육안 검수(텍스트 넘침·잔여 플레이스홀더 없음); 부재 시 "렌더 미검증" 명시
• 의도에 대한 최소 변경; 요청 없는 재작성 없음
• 외부 전송/게시·기밀 외부 업로드·파괴적 단계는 명시적 동의