create-mintly 1.0.0

package/kit/CLAUDE.md

@@ -0,0 +1,330 @@
+# CLAUDE.md — Mintly
+
+이 파일은 Claude Code가 읽고 직접 실행하는 지침서입니다.
+
+## 이 킷의 목적
+
+사용자가 회의 자료를 넣으면, Claude Code가 자동으로 분석하고 시각화 결과물을 생성합니다.
+
+산출물:
+- `brief.md` — 작업 브리프
+- `analysis.md` — 분석 문서
+- `dashboard.html` — 시각화 대시보드
+
+## 시작 문구
+
+아래 중 하나가 들어오면 이 킷을 시작합니다:
+
+- `시작해줘`
+- `Mintly 시작`
+- `자료 스캔하고 시작해줘`
+- `브리프 확정하고 결과물 만들어줘`
+
+---
+
+## 온보딩 플로우
+
+### Step 1: 환영 + 안내
+
+```
+Mintly에 오신 걸 환영합니다.
+
+sources/ 폴더에 회의 파일(txt, md)을 넣어주세요.
+지금 바로 파일이 있으면 스캔을 시작하고,
+아직 없으면 준비되면 다시 말씀해주세요.
+```
+
+### Step 2: sources/ 스캔
+
+파일이 있으면:
+1. sources/ 폴더와 인접 폴더를 스캔합니다.
+2. `*.txt`, `*_요약.md`, 관련 `*.md`, `*.m4a` 파일을 우선 찾습니다.
+3. 파일명과 폴더 구조로 bundle 후보를 추론합니다.
+4. 자료만으로 알 수 있는 정보를 먼저 확정합니다.
+5. **회의 유형을 자동 감지합니다.**
+
+파일이 없으면:
+- 샘플 파일 구조를 안내하고 대기합니다.
+
+첫 응답 형식:
+
+```markdown
+자료를 먼저 확인했습니다.
+
+### 발견한 bundle 후보
+- [bundle-id]: txt, 요약, m4a 있음
+
+### 회의 유형 감지
+- 감지된 유형: [유형 라벨]
+- 감지 근거: [신호 설명]
+
+### 현재 파악한 내용
+- 도메인 추정:
+- 주요 대상:
+- 바로 만들 수 있는 산출물:
+
+### 추가로 필요한 정보
+1.
+2.
+```
+
+### Step 3: 대화형 인터뷰
+
+회의 유형 감지 결과를 사용자에게 확인한 후, 부족한 정보만 질문합니다.
+
+### Step 4: 결과물 생성
+
+brief.md 확정 → analysis.md → dashboard.html 순서로 생성합니다.
+
+---
+
+## 회의 유형 자동 감지
+
+아래 10가지 유형 중 하나를 자동 감지합니다. 복수 유형도 가능합니다.
+
+| 유형 ID | 라벨 | 감지 신호 |
+|---------|------|----------|
+| `team-sync` | 팀 회의 / 주간회의 | 여러 안건, 상태 업데이트, 진행 공유 |
+| `one-on-one` | 1:1 미팅 | 참석자 2명, 피드백, 개인 목표 |
+| `client-call` | 고객/파트너 미팅 | 외부 참석자, 제안, 요구사항 |
+| `brainstorm` | 브레인스토밍 | 아이디어 발산, 자유 토론, 확정 없음 |
+| `retrospective` | 회고 / 리뷰 | 잘한 점, 개선할 점, 다음 약속 |
+| `kickoff` | 프로젝트 킥오프 | 범위, 역할 배분, 마일스톤 |
+| `decision` | 의사결정 회의 | 선택지, 장단점, 최종 결정 |
+| `board` | 경영/이사회 | KPI, 전략, 재무 지표 |
+| `sales` | 영업/제휴 | 파이프라인, 제안가, 후속 전략 |
+| `workshop` | 워크숍 / 교육 | 학습 목표, 실습, 테이크어웨이 |
+
+감지 방법:
+1. 파일명에서 키워드 확인 (회고, 킥오프, 1on1, 주간회의 등)
+2. 참석자 수와 역할 확인
+3. 문서 내용에서 반복 패턴 확인
+4. 불확실하면 사용자에게 확인
+
+---
+
+## 유형별 섹션 매핑
+
+### 공통 섹션 (모든 유형)
+- 핵심 요약 (summary)
+- 주요 신호 (signals)
+- 리스크/쟁점 (risks)
+- 액션 아이템 (actions)
+- 타임라인 (timeline)
+
+### 유형별 추가 섹션
+
+| 유형 | 추가 섹션 |
+|------|----------|
+| `sales` / `client-call` | pipeline, profiles, follow_up |
+| `retrospective` | retrospective (went_well, to_improve, commitments) |
+| `kickoff` | project_scope (goals, roles, milestones) |
+| `one-on-one` | feedback (given, received, goals_progress) |
+| `decision` | decisions (topic, options, chosen, rationale) |
+| `board` | kpis (name, value, target, trend) |
+| `brainstorm` | ideas (title, votes, category, note) |
+| `team-sync` | decisions (있을 경우), blockers |
+| `workshop` | ideas, actions (학습 목표 기반) |
+
+---
+
+## 산출물 생성 위치
+
+```text
+outputs/<bundle-id>/
+├── brief.md
+├── analysis.md
+└── dashboard.html
+```
+
+`<bundle-id>`는 탐색한 파일들의 공통 prefix를 사용합니다.
+공통 prefix를 확정할 수 없으면 사용자에게 폴더 이름을 한 번만 물어봅니다.
+
+---
+
+## 질문 규칙
+
+### 절대 다시 묻지 말아야 하는 정보
+
+파일에서 이미 알 수 있는 정보:
+- 날짜
+- 제목
+- 참석자
+- 회의 유형 추정
+- 관련 업체/사람 이름
+- 기존 산출물 존재 여부
+
+### 부족할 때만 물어야 하는 정보
+
+1. 이 결과물의 목적
+   - 예: 회의 정리, 현황 공유, 내부 보고, 의사결정 기록
+2. 최종 독자
+   - 예: 대표, 내부 팀, 파트너, 외부 공유용
+3. 결과물에 반드시 들어갈 섹션
+   - 예: 타임라인, 액션 아이템, 의사결정, 리스크
+4. 꼭 기록해야 할 데이터
+   - 예: 진행률, 기한, 담당자, 우선순위, 예산
+5. 빼야 할 정보
+   - 예: 실명, 연락처, 민감 메모
+6. 톤
+   - 예: 보고용, 공유용, 내부 참고용
+
+### 질문 방식
+
+- 질문은 한 번에 너무 많이 던지지 않습니다.
+- 결과물에 바로 영향을 주는 항목은 번호 목록으로 한 번에 물어도 됩니다.
+- 사용자가 답하지 않아도 진행 가능한 항목은 기본값을 제안하고 기록합니다.
+
+---
+
+## 브리프 작성 규칙
+
+결과물 생성 전 반드시 `brief.md`를 먼저 만듭니다.
+
+템플릿: `.mintly/templates/brief.md`
+
+필수 항목:
+- `source_bundle`
+- `meeting_type`
+- `goal`
+- `audience`
+- `must_include`
+- `must_exclude`
+- `key_data_points`
+- `visual_sections`
+- `tone`
+- `open_questions`
+
+브리프를 만든 뒤 사용자에게 짧게 확인을 받습니다.
+
+---
+
+## 분석 문서 작성 규칙
+
+템플릿: `.mintly/templates/analysis.md`
+
+필수 포함:
+- 한 줄 결론
+- 중요한 신호
+- 리스크와 쟁점
+- 후속 액션
+- 유형별 추가 섹션 (해당하는 경우)
+- 미해결 질문
+- 사용한 source 파일 목록
+
+분석 문서는 길게 쓰지 말고, 시각화로 넘길 핵심만 남깁니다.
+
+---
+
+## 대시보드 작성 규칙
+
+템플릿: `.mintly/templates/dashboard.html`
+
+대시보드는 **JSON+JS 하이브리드 방식**으로 동작합니다:
+
+1. 템플릿의 `<script id="dashboard-data" type="application/json">` 블록에 JSON 데이터를 삽입합니다.
+2. JS 렌더러가 존재하는 섹션만 자동 렌더링합니다.
+3. 빈 섹션은 표시하지 않습니다.
+
+### JSON 데이터 구조
+
+공통 필드:
+- `meta`: title, subtitle, type, date, sources
+- `summary`: conclusion, status, next_action
+- `signals[]`: title, severity, evidence
+- `risks[]`: title, severity, evidence
+- `timeline[]`: date, title, type, note
+- `actions[]`: title, owner, due_date, priority, status
+
+유형별 선택 필드 (있으면 렌더링, 없으면 생략):
+- `decisions[]` — 의사결정 유형
+- `pipeline[]` — 영업/고객 유형
+- `profiles[]` — 영업/고객 유형
+- `retrospective{}` — 회고 유형
+- `project_scope{}` — 킥오프 유형
+- `feedback{}` — 1:1 유형
+- `kpis[]` — 경영회의 유형
+- `ideas[]` — 브레인스토밍 유형
+- `unresolved[]` — 선택
+- `blockers[]` — 선택
+- `follow_up{}` — 선택
+
+스키마 상세: `.mintly/schema/dashboard-schema.json`
+
+---
+
+## 도메인별 기본 동작
+
+### 영업/제휴형 자료일 때
+기본 포함: 핵심 요약, 파이프라인 상태, 주요 쟁점, 액션 아이템, 상대 프로파일, 타임라인, 후속 메시지
+
+### 팀 회의 / 주간회의일 때
+기본 포함: 핵심 요약, 의사결정, 리스크, 액션 아이템, 타임라인, 차단 요소
+
+### 회고일 때
+기본 포함: 핵심 요약, 잘한 점/개선할 점/팀 약속, 액션 아이템, 타임라인
+
+### 1:1일 때
+기본 포함: 핵심 요약, 피드백, 목표 진행상황, 액션 아이템
+
+### 의사결정 회의일 때
+기본 포함: 핵심 요약, 선택지 비교, 결정 근거, 리스크, 액션 아이템
+
+### 경영/이사회일 때
+기본 포함: 핵심 요약, KPI 현황, 전략 결정, 리스크, 액션 아이템, 타임라인
+
+---
+
+## 파일이 부족할 때 규칙
+
+### txt나 요약 없이 audio만 있을 때
+- transcript 또는 요약본이 있는지 먼저 다시 탐색
+- 없으면 사용자에게 전사/요약 준비 여부를 묻기
+- 텍스트 없이 억지로 분석하지 않기
+
+### bundle 후보가 여러 개일 때
+- 가장 완성도가 높은 후보를 추천
+- 사용자가 선택하면 그 bundle만 처리
+- 사용자가 원하면 여러 bundle을 순서대로 처리
+
+### 기존 outputs가 이미 있을 때
+- 덮어쓸지, 업데이트할지 짧게 확인
+- 기본값은 `업데이트`
+
+---
+
+## 레시피 참조
+
+분석 시 `.mintly/recipes/core.md`의 4가지 핵심 레시피를 참조합니다:
+1. Meeting Summary — 목적, 결론, 핵심 주제, 의사결정
+2. Insight Extraction — 기회, 리스크, 패턴, 미해결 질문
+3. Action Tracker — 액션 아이템 추출
+4. Context Linker — 이전 회의와 연결, 변화/반복/신규 식별
+
+유형별 추가 레시피: `.mintly/recipes/meeting-types.md`
+
+---
+
+## 응답 스타일
+
+- 설명은 짧고 명확하게
+- 먼저 탐색, 나중에 질문
+- 문서형 설명보다 실행 문장 위주
+- 사용자가 바로 다음 행동을 알 수 있게 작성
+
+---
+
+## 작업 완료 후
+
+```markdown
+완료한 파일
+- outputs/<bundle-id>/brief.md
+- outputs/<bundle-id>/analysis.md
+- outputs/<bundle-id>/dashboard.html
+
+기준 자료
+- 사용한 파일 목록
+
+남은 확인 사항
+- 있으면 1~3개만
+```

package/kit/recipes/core.md

@@ -0,0 +1,79 @@
+# Core Recipes
+
+4가지 범용 레시피입니다. 모든 회의 유형에 적용합니다.
+
+---
+
+## 1. Meeting Summary
+
+```text
+다음 source bundle을 바탕으로 회의 요약을 작성해주세요.
+
+목표:
+1. 회의 목적과 결론 5줄 이내 요약
+2. 주요 논의 주제와 의사결정 정리
+3. 참석자별 중요한 발언 또는 입장 차이 정리
+4. 후속 액션 후보 정리
+
+출력 형식:
+- summary 섹션 (conclusion, status, next_action)
+- timeline에 넣을 수 있는 날짜 기반 주요 이벤트 3~7개
+```
+
+---
+
+## 2. Insight Extraction
+
+```text
+다음 자료를 분석해 기회, 리스크, 반복 패턴, 미해결 질문을 구조화해주세요.
+
+분석 원칙:
+- 요약이 아니라 해석 중심으로 작성
+- 근거가 있는 인사이트만 남길 것
+- 긍정 시그널과 리스크를 분리할 것
+- severity를 high / medium / low로 판단
+
+출력 형식:
+- signals[] (title, severity, evidence)
+- risks[] (title, severity, evidence)
+- unresolved[] (title, owner, status)
+```
+
+---
+
+## 3. Action Tracker
+
+```text
+다음 회의 자료에서 실행 가능한 액션 아이템만 추출해주세요.
+
+규칙:
+- 담당자가 없으면 owner를 "미정"으로 표기
+- 기한이 없으면 due_date를 null로 유지
+- 우선순위는 high / medium / low로 통일
+- 추정이나 해석이 필요한 항목은 note로 분리
+
+출력 형식:
+- actions[] (title, owner, due_date, priority, status)
+- blockers[] (title, owner, status, note)
+- follow_up (channel, subject, body) — 후속 메시지 초안
+```
+
+---
+
+## 4. Context Linker
+
+```text
+다음 회의 자료와 이전 산출물(있을 경우)을 비교해 변화, 반복, 신규 사항을 식별해주세요.
+
+분석 관점:
+- 이전 회의에서 결정한 사항이 실행되었는지
+- 반복적으로 나타나는 리스크나 차단 요소
+- 새롭게 등장한 주제나 참여자
+- 상태가 변경된 액션 아이템
+
+출력 형식:
+- 변화 사항: 이전 대비 달라진 점
+- 반복 사항: 여전히 진행 중이거나 미해결인 점
+- 신규 사항: 이번에 처음 등장한 점
+- context_from_previous: brief.md에 기록할 연결 정보
+```

package/kit/recipes/meeting-types.md

@@ -0,0 +1,159 @@
+# Meeting Type Detection & Add-on Recipes
+
+## 회의 유형 감지 규칙
+
+자료를 스캔한 후 아래 신호를 기반으로 유형을 판단합니다.
+
+### 감지 우선순위
+
+1. **파일명 키워드** (가장 강한 신호)
+   - 회고, retro, review → `retrospective`
+   - 킥오프, kickoff → `kickoff`
+   - 1on1, 1:1, 면담 → `one-on-one`
+   - 주간, weekly, 팀회의 → `team-sync`
+   - 브레인스토밍, ideation → `brainstorm`
+   - 이사회, 경영, board → `board`
+   - 영업, sales, 제휴 → `sales`
+   - 워크숍, workshop → `workshop`
+
+2. **참석자 패턴**
+   - 2명 → `one-on-one` 가능성 높음
+   - 외부 참석자 포함 → `client-call` 또는 `sales`
+   - 다수 + 다양한 직군 → `team-sync` 또는 `kickoff`
+
+3. **내용 패턴**
+   - 잘한 점/개선할 점 → `retrospective`
+   - 선택지/장단점/결정 → `decision`
+   - 파이프라인/제안가/계약 → `sales`
+   - KPI/매출/전략 → `board`
+   - 아이디어/발산 → `brainstorm`
+   - 범위/역할/마일스톤 → `kickoff`
+   - 피드백/목표/성장 → `one-on-one`
+
+4. **복수 유형 가능**: 주요 유형 1개 + 보조 유형 1개까지
+
+---
+
+## 유형별 Add-on Recipes
+
+### sales / client-call
+
+```text
+다음 영업/고객 미팅 자료를 바탕으로 파이프라인과 프로파일을 추출해주세요.
+
+필수 항목:
+- pipeline[]: id, label, stage, confidence, key_issue, owner, volume
+- profiles[]: id, name, type, status, owner, summary
+- follow_up: channel, subject, body
+
+분석 포인트:
+- 현재 단계와 다음 단계 판단
+- 전환 가능성(confidence) 근거
+- 핵심 쟁점과 해결 조건
+- 상대방의 의사결정 구조와 타이밍
+```
+
+### retrospective
+
+```text
+다음 회고 자료를 구조화해주세요.
+
+출력 형식:
+- retrospective.went_well[]: 잘한 점 (구체적 사례 포함)
+- retrospective.to_improve[]: 개선할 점 (원인 분석 포함)
+- retrospective.commitments[]: 다음에 실천할 약속 (측정 가능하게)
+
+분석 원칙:
+- 감상이 아닌 사실 기반으로 정리
+- 개선할 점에는 원인과 개선 방향을 함께 기록
+- 약속은 담당자와 기한이 있으면 명시
+```
+
+### kickoff
+
+```text
+다음 킥오프 자료에서 프로젝트 범위를 정리해주세요.
+
+출력 형식:
+- project_scope.goals[]: 프로젝트 목표
+- project_scope.roles[]: 역할과 담당자 (role, person, responsibility)
+- project_scope.milestones[]: 마일스톤 (title, date, deliverable)
+
+분석 포인트:
+- 범위 안/밖 경계가 명확한지
+- 역할 간 의존성이나 병목
+- 마일스톤 간격과 실현 가능성
+```
+
+### one-on-one
+
+```text
+다음 1:1 미팅 자료에서 피드백과 목표를 정리해주세요.
+
+출력 형식:
+- feedback.given[]: 전달한 피드백 (topic, content, tone)
+- feedback.received[]: 받은 피드백 (topic, content, tone)
+- feedback.goals_progress[]: 목표 진행 (goal, status, note)
+
+분석 원칙:
+- 피드백의 톤(긍정/건설적/우려)을 구분
+- 목표 진행상황은 이전 기록이 있으면 비교
+- 민감한 개인 정보는 비식별화 여부 확인
+```
+
+### decision
+
+```text
+다음 의사결정 회의 자료에서 선택지와 결정을 정리해주세요.
+
+출력 형식:
+- decisions[]: topic, options[], chosen, rationale
+
+분석 포인트:
+- 각 선택지의 장단점이 명확한지
+- 결정 근거가 데이터 기반인지 직관 기반인지
+- 미결정 사항이 있는지 (unresolved로 분리)
+```
+
+### board
+
+```text
+다음 경영/이사회 자료에서 KPI와 전략 결정을 추출해주세요.
+
+출력 형식:
+- kpis[]: name, value, target, trend (up/down/flat)
+- decisions[]: topic, options[], chosen, rationale
+
+분석 포인트:
+- KPI 달성률과 추세
+- 전략적 결정의 재무적 영향
+- 리스크의 비즈니스 임팩트
+```
+
+### brainstorm
+
+```text
+다음 브레인스토밍 자료에서 아이디어를 정리해주세요.
+
+출력 형식:
+- ideas[]: title, votes (0 if not voted), category, note
+
+분석 원칙:
+- 카테고리로 그룹핑 (기능, 프로세스, 마케팅, 기술 등)
+- 투표나 우선순위가 있으면 반영
+- 실행 가능성 메모 (note)
+```
+
+### workshop
+
+```text
+다음 워크숍 자료에서 학습 내용과 실행 항목을 정리해주세요.
+
+출력 형식:
+- ideas[]: 핵심 테이크어웨이
+- actions[]: 실행할 학습 적용 항목
+
+분석 포인트:
+- 학습 목표 달성 여부
+- 즉시 적용 가능한 항목과 장기 과제 구분
+```