moai-bi — 경영진 1pager 임원 요약

경영진·이사회·투자자에게 보낼 1페이지 요약을 자동 생성하고, 단일 HTML 파일로 묶어 카톡·이메일에 그대로 첨부할 수 있게 만드는 BI 플러그인입니다. 결재·이사회·공공기관 제출용은 pdf/docx/pptx/hwpx로 변환합니다.

흔히 보고서라 하면 ‘문서 파일’과 ‘거기에 들어간 이미지·글꼴·표’가 제각각 떨어져 나옵니다. 보내는 쪽은 폴더째 압축하고, 받는 쪽은 압축을 풀어야 글꼴이 깨지지 않는지 확인합니다. 한 번이라도 경로가 꼬이면 이미지가 빈 네모로 보이거나 표가 밀려버립니다. 우편에 비유하면, 보통 보고서는 내용물·사진·엽서·봉투가 따로 노는 ‘여러 봉투 묶음’입니다.

이 플러그인은 모든 것을 봉인된 하나의 봉투(단일 HTML 파일) 안에 넣습니다. 여기서 단일 HTML이란 글·그림·꾸밈 요소(CSS)·동작 스크립트(JS)를 전부 한 개의 .html 파일 안에 끼워 넣은 형태를 말합니다. 외부 파일을 아예 끌어오지 않으므로(한국어 폰트 CDN 한 건만 예외) 받는 사람이 어떤 기기·어떤 브라우저에서 열든 깨짐 없이 똑같이 보입니다. 봉투 하나만 카톡이나 이메일에 붙여 넣으면 즉시 결재 라인에 도착합니다. 여러 개를 챙기고 압축을 풀 필요가 없습니다.

flowchart LR
    A["재무·운영 데이터"] --> B["executive-summary
1페이지로 압축"]
    B --> C["단일 HTML 봉투
(글·그림·CSS·JS 인라인)"]
    C --> D["카톡·이메일 첨부"]
    D --> E["받는 사람
어떤 기기에서든 그대로 열림"]

    style A fill:#eaeaea,stroke:#6e6e6e,color:#09110f
    style C fill:#fbf0dc,stroke:#c47b2a,color:#09110f
    style E fill:#e6f0ef,stroke:#144a46,color:#09110f

flowchart TD
    A["data-explorer
(외부 데이터)"] --> B["executive-summary
경영진 1pager 마크다운"]
    B --> C["ai-slop-reviewer
격식체·정량 검수"]
    C --> D["html-report mode=status
단일 HTML (기본)"]
    D --> E1["pdf-writer (선택)
결재·인쇄"]
    D --> E2["docx-generator (선택)
편집"]
    D --> E3["pptx-designer (선택)
이사회 슬라이드"]
    D --> E4["hwpx-writer (선택)
공공기관 제출"]
    style D fill:#eaeaea,stroke:#6e6e6e,color:#09110f
    style C fill:#e6f0ef,stroke:#144a46,color:#09110f

moai-bi는 한국 임원·이사회 표준에 맞춘 BI 리포트 풀스택입니다.

• 경영진 1pager: 복잡한 분석·재무·운영 보고를 ≤500단어 1페이지로 변환
• What / So What / Now What 3-축 구조: 단순 요약이 아닌 의사결정 옵션 + 권고안 포함
• K-IFRS 재무 지표 우선: 매출·영업이익률·EBITDA·운전자본 등 한국 회계 기준
• 한국 통계 친화: KOSIS·DART·공공데이터포털 데이터 직접 인용 가능
• 단일 HTML 기본 출력: 카톡·이메일에 그대로 첨부 → 결재 라인 즉시 공유

본 플러그인의 모든 보고서는 기본적으로 moai-content:html-report로 단일 HTML 파일을 만듭니다.

다른 형식이 필요할 때는 동일한 마크다운에서 분기 변환합니다.

KPI·코호트·재무 변동 분석은 moai-finance variance-analysis·moai-data data-visualizer와 체이닝해 executive-summary로 1pager로 압축합니다.

기본: 재무 → 카톡 공유용 단일 HTML

moai-finance:variance-analysis
  → moai-bi:executive-summary
  → moai-core:ai-slop-reviewer
  → moai-content:html-report (mode=status)
  → 1개 .html 파일 (카톡 첨부 가능)

변환 1: HTML → 결재용 PDF

... → html-report → moai-office:pdf-writer → .pdf

변환 2: HTML → 이사회 슬라이드

... → html-report → moai-office:pptx-designer → .pptx (1매)

변환 3: HTML → 편집 가능한 DOCX

... → html-report → moai-office:docx-generator → .docx

변환 4: HTML → 공공기관 제출 HWPX

... → html-report → moai-office:hwpx-writer → .hwpx

executive-summary는 내용을 단순히 줄여 나열하는 게 아니라 세 단계의 의사결정 파이프라인으로 구성합니다. 의사 진료에 비유하면 이해가 쉽습니다. What은 ‘증상 관찰’입니다 — 무슨 일이 있었는지, 수치가 어땠는지 사실만 보고합니다. So What은 ‘진단’입니다 — 그 사실이 왜 중요한지, 무엇을 의미하는지 읽어냅니다. Now What은 ‘처방’입니다 — 그래서 지금 어떤 선택지(A/B/C)가 있고, 무엇을 권하는지를 밝힙니다.

일반 ‘줄인 요약’이 증상 나열에서 끝난다면, 이 3축 구조는 진단과 처방까지 한 장에 담습니다. 임원은 문서를 다 읽은 뒤에야 결정을 고민하는 게 아니라, Now What 단계에 놓인 권고안을 보고 바로 결재 버튼을 누를 수 있습니다. 이것이 ‘단순 요약’과 ‘임원용 요약’을 가르는 핵심 차이입니다.

flowchart LR
    W["① What
무슨 일이 있었나
(증상·수치)"] --> S["② So What
무엇을 의미하나
(진단·해석)"]
    S --> N["③ Now What
무엇을 해야 하나
(처방·권고)"]

    style W fill:#eaeaea,stroke:#6e6e6e,color:#09110f
    style S fill:#fbf0dc,stroke:#c47b2a,color:#09110f
    style N fill:#e6f0ef,stroke:#144a46,color:#09110f

• 격식체 우선: …합니다 종결, 이사회·감사 보고 어조에 맞춤
• 정량 우선: 모든 주장에 수치·출처 결합 (서술형 형용사 최소화)
• 의사결정 옵션 명시: A/B/C 옵션 + 각 옵션의 리스크·기대효과 요약
• K-IFRS·DART: 한국 회계 기준에 맞춘 재무 지표 표기
• 한국어 폰트 인라인: Pretendard 등 가독성 폰트를 HTML에 결합

> 지난 분기 마케팅 성과 보고서(20페이지)를 임원 1pager로 줄여서 카톡으로 보낼 수 있는 단일 HTML로 만들어줘.
> 형식: What/So What/Now What, 격식체, 핵심 수치 5개 + 의사결정 옵션 3개 + 권고안

> DART 공시한 우리 회사 분기 보고서를 이사회용 HTML 1pager + PPT 1매로 동시에 만들어줘.
> K-IFRS 기준 매출·영업이익률·운전자본 변동 강조.

> 이번 주 weekly-report를 C레벨 보고로 압축해서 HTML(카톡)·PDF(결재)·HWPX(공공) 세 가지로 한 번에.

• moai-content — html-report 단일 HTML 렌더러 (본 플러그인의 기본 출력 엔진)
• moai-office — pdf/docx/pptx/hwpx 변환 분기
• moai-finance — K-IFRS·세무 데이터 소스
• moai-business — 시장조사·전략 보고서 체이닝
• moai-pm — 주간보고 자동화

• modu-ai/cowork-plugins README
• moai-bi 디렉터리
• Thariq Shihipar — The Unreasonable Effectiveness of HTML (html-report 사상 출처)
• KOSIS 국가통계포털, DART 전자공시시스템