create-mintly 1.0.0

package/README.md

@@ -0,0 +1,102 @@
+# Mintly
+
+> Claude Code가 회의 자료를 읽고, 질문하고, 분석하고, HTML 대시보드까지 만드는 올인원 킷
+
+## 설치
+
+```bash
+# 방법 1: npx
+npx create-mintly my-meetings
+
+# 방법 2: git clone
+git clone https://github.com/user/mintly.git
+cd mintly && node bin/init.js my-meetings
+```
+
+## 사용법
+
+```bash
+cd my-meetings
+
+# 1. sources/ 폴더에 회의 파일 넣기 (txt, md)
+# 2. Claude Code 열기
+# 3. "시작해줘" 입력
+```
+
+Claude Code가 자동으로:
+
+1. 파일을 스캔하고 bundle 후보를 정리합니다
+2. 회의 유형을 자동 감지합니다 (10가지 지원)
+3. 부족한 정보만 질문합니다
+4. `brief.md` → `analysis.md` → `dashboard.html` 순서로 생성합니다
+
+## 결과물
+
+```
+outputs/<bundle-id>/
+├── brief.md          # 작업 브리프
+├── analysis.md       # 구조화된 분석 문서
+└── dashboard.html    # 시각화 대시보드 (브라우저에서 열기)
+```
+
+## 지원 회의 유형
+
+| 유형 | 추가 섹션 |
+|------|----------|
+| 팀 회의 / 주간회의 | 의사결정, 차단 요소 |
+| 1:1 미팅 | 피드백, 목표 진행상황 |
+| 고객/파트너 미팅 | 파이프라인, 프로파일 |
+| 브레인스토밍 | 아이디어 목록 |
+| 회고 / 리뷰 | 잘한 점/개선할 점/약속 |
+| 프로젝트 킥오프 | 범위, 역할, 마일스톤 |
+| 의사결정 회의 | 선택지 비교, 결정 근거 |
+| 경영/이사회 | KPI, 전략 결정 |
+| 영업/제휴 | 파이프라인, 프로파일, 후속 전략 |
+| 워크숍 / 교육 | 테이크어웨이, 학습 적용 |
+
+## 대시보드 특징
+
+- **JSON+JS 하이브리드**: Claude가 JSON 데이터만 교체, JS가 자동 렌더링
+- **조건부 섹션**: 데이터가 있는 섹션만 표시, 빈 섹션은 자동 숨김
+- **Self-contained**: 외부 CDN 없이 단일 HTML 파일로 동작
+- **반응형**: 데스크탑/모바일 자동 대응
+- **인쇄 가능**: 프린트 스타일 내장
+
+## 워크스페이스 구조
+
+```
+my-meetings/
+├── CLAUDE.md            # Claude Code 실행 지침
+├── sources/             # 회의 파일을 넣는 곳
+│   └── README.md
+├── outputs/             # 결과물 저장
+│   └── README.md
+├── config.md            # 사용자 설정 (선택)
+└── .mintly/        # 킷 내부 파일
+    ├── templates/       # brief, analysis, dashboard 템플릿
+    ├── recipes/         # 분석 레시피
+    └── schema/          # 데이터 스키마
+```
+
+## 파일 형식
+
+| 형식 | 설명 |
+|------|------|
+| `*.txt` | 녹취 전사본 |
+| `*.md` | 요약본 또는 관련 문서 |
+| `*.m4a` / `*.mp3` | 녹음 파일 (전사본 필요) |
+
+파일명에 `YYMMDD_제목` 형식을 사용하면 자동 인식됩니다.
+
+## 예시 데이터
+
+`examples/` 폴더에 4가지 유형의 예시 JSON이 포함되어 있습니다:
+
+- `sales-partnership.json` — 영업/제휴 (파이프라인, 프로파일)
+- `product-team.json` — 팀 회의 (의사결정, 액션 아이템)
+- `retrospective.json` — 회고 (잘한 점/개선할 점/약속)
+- `one-on-one.json` — 1:1 미팅 (피드백, 목표 진행상황)
+
+## License
+
+MIT

package/bin/init.js

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+
+const targetName = process.argv[2] || "my-meetings";
+const targetDir = path.resolve(process.cwd(), targetName);
+const kitDir = path.resolve(__dirname, "..", "kit");
+
+function copyDir(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+function createWorkspace() {
+  if (fs.existsSync(targetDir)) {
+    console.error(`\n  이미 존재하는 폴더입니다: ${targetName}\n`);
+    process.exit(1);
+  }
+
+  console.log(`\n  Mintly 워크스페이스를 생성합니다...\n`);
+
+  // 메인 폴더 생성
+  fs.mkdirSync(targetDir, { recursive: true });
+
+  // .mintly/ 에 킷 내부 파일 복사
+  const hiddenKit = path.join(targetDir, ".mintly");
+  copyDir(path.join(kitDir, "templates"), path.join(hiddenKit, "templates"));
+  copyDir(path.join(kitDir, "recipes"), path.join(hiddenKit, "recipes"));
+  copyDir(path.join(kitDir, "schema"), path.join(hiddenKit, "schema"));
+
+  // CLAUDE.md 복사 + 워크스페이스 경로 반영
+  let claudeMd = fs.readFileSync(path.join(kitDir, "CLAUDE.md"), "utf-8");
+  claudeMd = claudeMd.replace(/\{\{workspace\}\}/g, targetName);
+  fs.writeFileSync(path.join(targetDir, "CLAUDE.md"), claudeMd);
+
+  // sources/ 폴더 + 안내 README
+  fs.mkdirSync(path.join(targetDir, "sources"));
+  fs.writeFileSync(
+    path.join(targetDir, "sources", "README.md"),
+    `# sources/
+
+이 폴더에 회의 자료를 넣어주세요.
+
+## 지원 파일 형식
+
+- \`.txt\` — 녹취 전사본 (transcript)
+- \`.md\` — 요약본 또는 관련 문서
+- \`.m4a\` / \`.mp3\` — 녹음 파일 (전사본이 함께 필요합니다)
+
+## 파일명 규칙 (권장)
+
+\`YYMMDD_제목.확장자\` 형식을 사용하면 Claude가 자동으로 날짜와 제목을 인식합니다.
+
+예시:
+- \`260315_온보딩개선회의.txt\`
+- \`260315_온보딩개선회의_요약.md\`
+- \`260315_온보딩개선회의.m4a\`
+
+## 시작하기
+
+파일을 넣은 후 Claude Code를 열고 **"시작해줘"** 라고 입력하세요.
+`
+  );
+
+  // outputs/ 폴더 + README
+  fs.mkdirSync(path.join(targetDir, "outputs"));
+  fs.writeFileSync(
+    path.join(targetDir, "outputs", "README.md"),
+    `# outputs/
+
+Claude Code가 생성한 결과물이 저장되는 폴더입니다.
+
+## 결과물 구조
+
+\`\`\`
+outputs/<bundle-id>/
+├── brief.md          ← 작업 브리프
+├── analysis.md       ← 분석 문서
+└── dashboard.html    ← 시각화 대시보드
+\`\`\`
+
+\`<bundle-id>\`는 원본 파일의 공통 prefix를 기반으로 자동 생성됩니다.
+`
+  );
+
+  // 완료 메시지
+  console.log(`  ${targetName}/ 워크스페이스가 생성되었습니다.\n`);
+  console.log(`  다음 단계:`);
+  console.log(`  1. cd ${targetName}`);
+  console.log(`  2. sources/ 폴더에 회의 파일 넣기`);
+  console.log(`  3. Claude Code를 열고 "시작해줘" 입력\n`);
+}
+
+createWorkspace();

package/examples/one-on-one.json

@@ -0,0 +1,119 @@
+{
+  "meta": {
+    "title": "주니어 개발자 1:1 면담",
+    "subtitle": "Q1 성과 리뷰 및 성장 목표 점검",
+    "type": "one-on-one",
+    "date": "2026-03-12",
+    "sources": ["260312_1on1_김주니어.txt"]
+  },
+  "summary": {
+    "conclusion": "코드 리뷰 스킬과 독립적 태스크 수행 능력이 눈에 띄게 향상됨. API 설계 역량을 다음 분기 성장 목표로 설정.",
+    "status": "정기 면담 완료",
+    "next_action": "API 설계 학습 자료 공유 + 다음 프로젝트에서 API 설계 리드 기회 배정"
+  },
+  "signals": [
+    {
+      "title": "코드 리뷰 품질이 동료 평가에서 긍정적으로 언급됨",
+      "severity": "low",
+      "evidence": "지난 스프린트에서 리뷰 코멘트 품질에 대한 팀원 2명의 긍정 피드백"
+    },
+    {
+      "title": "독립적으로 완료한 태스크 비율이 60%→85%로 상승",
+      "severity": "low",
+      "evidence": "Q4 대비 시니어 도움 요청 빈도 감소"
+    }
+  ],
+  "risks": [
+    {
+      "title": "새로운 도전 과제 없으면 성장 정체 가능",
+      "severity": "medium",
+      "evidence": "본인이 현재 업무가 반복적으로 느껴진다고 표현"
+    }
+  ],
+  "timeline": [
+    {
+      "date": "2026-01-15",
+      "title": "Q1 목표 설정",
+      "type": "milestone",
+      "note": "코드 리뷰 + 독립 태스크 수행 목표"
+    },
+    {
+      "date": "2026-03-12",
+      "title": "Q1 1:1 면담",
+      "type": "meeting",
+      "note": "성과 리뷰 및 Q2 목표 논의"
+    },
+    {
+      "date": "2026-04-01",
+      "title": "Q2 목표 시작",
+      "type": "target",
+      "note": "API 설계 역량 강화"
+    }
+  ],
+  "actions": [
+    {
+      "title": "API 설계 학습 자료 공유",
+      "owner": "팀 리드",
+      "due_date": "2026-03-15",
+      "priority": "medium",
+      "status": "todo"
+    },
+    {
+      "title": "다음 프로젝트에서 API 설계 리드 기회 배정",
+      "owner": "팀 리드",
+      "due_date": "2026-04-01",
+      "priority": "high",
+      "status": "todo"
+    },
+    {
+      "title": "Q2 성장 목표 문서화",
+      "owner": "김주니어",
+      "due_date": "2026-03-19",
+      "priority": "medium",
+      "status": "todo"
+    }
+  ],
+  "feedback": {
+    "given": [
+      {
+        "topic": "코드 리뷰 품질",
+        "content": "리뷰 코멘트가 구체적이고 건설적으로 발전함. 특히 성능 관련 코멘트가 팀에 도움이 되고 있음.",
+        "tone": "긍정"
+      },
+      {
+        "topic": "커뮤니케이션",
+        "content": "기술적 설명을 비개발 직군에게 전달할 때 좀 더 쉬운 비유를 사용하면 좋겠음.",
+        "tone": "건설적"
+      }
+    ],
+    "received": [
+      {
+        "topic": "업무 환경",
+        "content": "현재 업무가 반복적으로 느껴지기 시작함. 새로운 도전 기회가 있으면 좋겠음.",
+        "tone": "솔직"
+      },
+      {
+        "topic": "팀 문화",
+        "content": "코드 리뷰 문화가 잘 정착되어 있어서 배우기 좋은 환경이라고 생각함.",
+        "tone": "긍정"
+      }
+    ],
+    "goals_progress": [
+      {
+        "goal": "코드 리뷰 참여율 주 3회 이상",
+        "status": "done",
+        "note": "평균 주 4.2회 달성"
+      },
+      {
+        "goal": "독립적 태스크 완료율 80% 이상",
+        "status": "done",
+        "note": "85% 달성 (Q4: 60%)"
+      },
+      {
+        "goal": "기술 공유 세션 1회 발표",
+        "status": "doing",
+        "note": "3월 말 발표 예정"
+      }
+    ]
+  }
+}

package/examples/product-team.json

@@ -0,0 +1,99 @@
+{
+  "meta": {
+    "title": "모바일 온보딩 개선 회의",
+    "subtitle": "활성화율 개선을 위한 실험안 정리",
+    "type": "team-sync",
+    "date": "2026-03-15",
+    "sources": ["onboarding-review.txt", "onboarding-summary.md"]
+  },
+  "summary": {
+    "conclusion": "신규 온보딩 플로우를 A/B 2가지 버전으로 실험하기로 합의",
+    "status": "planning",
+    "next_action": "QA 범위 확정 후 실험 시작"
+  },
+  "signals": [
+    {
+      "title": "첫 화면 복잡성이 이탈의 주요 원인으로 확인됨",
+      "severity": "high",
+      "evidence": "사용자 피드백과 회의 내 반복 발언이 일치"
+    },
+    {
+      "title": "실험 자체에는 전원 합의",
+      "severity": "low",
+      "evidence": "팀 전체가 A/B 테스트 방식에 동의"
+    }
+  ],
+  "risks": [
+    {
+      "title": "QA 일정 부족으로 실험 일정이 밀릴 수 있음",
+      "severity": "high",
+      "evidence": "QA 범위 확정이 모든 후속 일정의 선행 조건으로 언급됨"
+    }
+  ],
+  "timeline": [
+    {
+      "date": "2026-03-15",
+      "title": "온보딩 개선 회의",
+      "type": "meeting",
+      "note": "핵심 이탈 지점과 실험안 2개 도출"
+    },
+    {
+      "date": "2026-03-18",
+      "title": "QA 범위 확정",
+      "type": "milestone",
+      "note": "테스트 범위와 릴리즈 조건 정리"
+    },
+    {
+      "date": "2026-03-22",
+      "title": "A/B 테스트 시작",
+      "type": "target",
+      "note": "실험 배포 목표일"
+    }
+  ],
+  "actions": [
+    {
+      "title": "실험안 A/B 화면 확정",
+      "owner": "디자이너",
+      "due_date": "2026-03-17",
+      "priority": "high",
+      "status": "doing"
+    },
+    {
+      "title": "활성화 지표 정의",
+      "owner": "PM",
+      "due_date": "2026-03-18",
+      "priority": "high",
+      "status": "todo"
+    },
+    {
+      "title": "QA 범위 협의",
+      "owner": "QA",
+      "due_date": "2026-03-18",
+      "priority": "medium",
+      "status": "todo"
+    }
+  ],
+  "decisions": [
+    {
+      "topic": "실험 방식 결정",
+      "options": ["A/B 테스트", "단계적 롤아웃", "카나리 배포"],
+      "chosen": "A/B 테스트",
+      "rationale": "가장 빠르게 통계적 유의성 확보 가능"
+    }
+  ],
+  "unresolved": [
+    {
+      "title": "활성화 지표를 어디까지 제품 목표로 볼지 확정 필요",
+      "owner": "PM",
+      "status": "pending"
+    }
+  ],
+  "blockers": [
+    {
+      "title": "QA 슬롯 확정 전 릴리즈 날짜를 잠글 수 없음",
+      "owner": "QA",
+      "status": "active",
+      "note": "테스트 범위와 회귀 범위 확인 필요"
+    }
+  ]
+}

package/examples/retrospective.json

@@ -0,0 +1,112 @@
+{
+  "meta": {
+    "title": "Q1 스프린트 회고",
+    "subtitle": "지난 분기 스프린트 운영에 대한 팀 회고",
+    "type": "retrospective",
+    "date": "2026-03-14",
+    "sources": ["260314_Q1회고.txt", "260314_Q1회고_요약.md"]
+  },
+  "summary": {
+    "conclusion": "배포 프로세스와 코드 리뷰 품질은 개선되었으나, 스프린트 스코프 관리와 QA 리소스 배분에 지속적 개선이 필요",
+    "status": "회고 완료 → 개선 약속 확정",
+    "next_action": "스코프 관리 가이드라인 작성 및 다음 스프린트에서 시범 적용"
+  },
+  "signals": [
+    {
+      "title": "배포 프로세스 자동화로 배포 시간 40% 단축",
+      "severity": "low",
+      "evidence": "CI/CD 파이프라인 도입 후 배포 시간 평균 15분→9분"
+    },
+    {
+      "title": "코드 리뷰 문화가 정착되면서 프로덕션 버그 감소",
+      "severity": "low",
+      "evidence": "Q4 대비 프로덕션 핫픽스 30% 감소"
+    },
+    {
+      "title": "스프린트 후반부 스코프 변경이 반복됨",
+      "severity": "high",
+      "evidence": "3번의 스프린트 중 2번에서 후반부 스코프 추가 발생"
+    }
+  ],
+  "risks": [
+    {
+      "title": "QA 리소스 부족으로 테스트 커버리지가 낮아질 수 있음",
+      "severity": "high",
+      "evidence": "QA 1명이 3개 프로젝트를 동시에 담당 중"
+    },
+    {
+      "title": "스코프 관리 실패가 팀 번아웃으로 이어질 수 있음",
+      "severity": "medium",
+      "evidence": "스프린트 마지막 주에 야근이 집중됨"
+    }
+  ],
+  "timeline": [
+    {
+      "date": "2026-01-06",
+      "title": "Q1 스프린트 시작",
+      "type": "milestone",
+      "note": "3개 스프린트 계획"
+    },
+    {
+      "date": "2026-02-14",
+      "title": "CI/CD 파이프라인 도입",
+      "type": "milestone",
+      "note": "배포 자동화 완료"
+    },
+    {
+      "date": "2026-03-14",
+      "title": "Q1 회고",
+      "type": "meeting",
+      "note": "전체 팀 참여"
+    },
+    {
+      "date": "2026-03-17",
+      "title": "스코프 관리 가이드라인 작성",
+      "type": "follow-up",
+      "note": "PM 주도"
+    }
+  ],
+  "actions": [
+    {
+      "title": "스프린트 스코프 관리 가이드라인 작성",
+      "owner": "PM",
+      "due_date": "2026-03-17",
+      "priority": "high",
+      "status": "todo"
+    },
+    {
+      "title": "QA 리소스 추가 배정 요청",
+      "owner": "팀 리드",
+      "due_date": "2026-03-21",
+      "priority": "high",
+      "status": "todo"
+    },
+    {
+      "title": "스프린트 중간 체크포인트 도입",
+      "owner": "PM",
+      "due_date": "2026-03-24",
+      "priority": "medium",
+      "status": "todo"
+    }
+  ],
+  "retrospective": {
+    "went_well": [
+      "CI/CD 파이프라인 도입으로 배포 시간 40% 단축",
+      "코드 리뷰 참여율이 95%로 안정화",
+      "프로덕션 핫픽스가 Q4 대비 30% 감소",
+      "팀 내 기술 공유 세션이 주 1회로 정착"
+    ],
+    "to_improve": [
+      "스프린트 후반부 스코프 변경이 3번 중 2번 발생 — 스코프 확정 기준이 불명확",
+      "QA 리소스가 부족해 테스트가 병목이 됨 — 1명이 3개 프로젝트 동시 담당",
+      "기술 부채 해소 시간이 계획의 50%만 사용됨 — 기능 개발에 밀림",
+      "스프린트 마지막 주에 야근이 집중됨 — 추정 정확도 개선 필요"
+    ],
+    "commitments": [
+      "스프린트 스코프 확정 후 변경 시 팀 리드 승인 필수 (PM, 즉시 적용)",
+      "QA 리소스 1명 추가 배정 요청 (팀 리드, 3/21까지)",
+      "스프린트 중간 체크포인트 도입해서 진행률 점검 (PM, 3/24부터)",
+      "기술 부채 해소를 스프린트 목표에 명시적으로 포함 (전원, 다음 스프린트부터)"
+    ]
+  }
+}

package/examples/sales-partnership.json

@@ -0,0 +1,127 @@
+{
+  "meta": {
+    "title": "어수(ES) 파트너십 미팅",
+    "subtitle": "프랜차이즈 대회 티켓 및 운영 솔루션 제휴 논의",
+    "type": "sales",
+    "date": "2026-03-04",
+    "sources": ["260304_어수.txt", "260304_어수_요약.md"]
+  },
+  "summary": {
+    "conclusion": "10개 직영점 프랜차이즈와 대회 티켓 및 운영 솔루션 제휴를 논의. 본사 통합 관리에 높은 관심 확인.",
+    "status": "meeting 완료 → 내부 검토 중",
+    "next_action": "테스트 계정 제공 + 운영 계획서 초안 작성"
+  },
+  "signals": [
+    {
+      "title": "본사 통합 관리에 높은 관심",
+      "severity": "high",
+      "evidence": "본사/지점 관리, 비용 처리, 티켓 유통 방지 질문이 반복됨"
+    },
+    {
+      "title": "테스트 계정 적극 요청",
+      "severity": "medium",
+      "evidence": "운영 시스템 직접 확인 의향을 표현"
+    },
+    {
+      "title": "영상/사례 기반 실증 자료가 신뢰 확보에 효과적",
+      "severity": "medium",
+      "evidence": "기존 행사 영상과 설문 결과가 제안 설명의 신뢰를 보강함"
+    }
+  ],
+  "risks": [
+    {
+      "title": "비용 처리 방식이 내부 승인 과정에서 지연될 수 있음",
+      "severity": "high",
+      "evidence": "구독료 처리와 분할 비용 문의가 핵심 쟁점으로 반복됨"
+    },
+    {
+      "title": "매장별 운영 통제 방식 미확정",
+      "severity": "medium",
+      "evidence": "본사 통합 관리와 개별 매장 운영 비교 검토 필요"
+    }
+  ],
+  "timeline": [
+    {
+      "date": "2026-03-04",
+      "title": "파트너십 제안 미팅",
+      "type": "meeting",
+      "note": "프랜차이즈 운영과 티켓 구조 설명"
+    },
+    {
+      "date": "2026-03-10",
+      "title": "테스트 계정 제공 예정",
+      "type": "follow-up",
+      "note": "내부 검토 이후 진행"
+    },
+    {
+      "date": "2026-03-31",
+      "title": "티켓 수량 최종 결정",
+      "type": "deadline",
+      "note": "내부 의사결정 완료 목표"
+    }
+  ],
+  "actions": [
+    {
+      "title": "관리자용 테스트 계정 제공",
+      "owner": "루루",
+      "due_date": "2026-03-10",
+      "priority": "high",
+      "status": "todo"
+    },
+    {
+      "title": "티켓 구매 수량 내부 결정",
+      "owner": "어수",
+      "due_date": "2026-03-31",
+      "priority": "high",
+      "status": "todo"
+    },
+    {
+      "title": "운영 계획서 공동 작성",
+      "owner": "양측",
+      "due_date": "2026-03-31",
+      "priority": "medium",
+      "status": "todo"
+    }
+  ],
+  "pipeline": [
+    {
+      "id": "eosu",
+      "label": "어수(ES)",
+      "stage": "meeting",
+      "confidence": "high",
+      "key_issue": "비용 처리와 통합 운영 방식",
+      "owner": "루루",
+      "volume": "~40장"
+    }
+  ],
+  "profiles": [
+    {
+      "id": "eosu-profile",
+      "name": "어수(ES)",
+      "type": "company",
+      "status": "active",
+      "owner": "루루",
+      "summary": "10개 직영점을 운영하는 홀덤펍 프랜차이즈. 법률/기술 역량이 높고 통합 관리 니즈가 강함."
+    }
+  ],
+  "unresolved": [
+    {
+      "title": "초기 티켓 볼륨을 몇 장으로 시작할지 확정 필요",
+      "owner": "어수",
+      "status": "pending"
+    }
+  ],
+  "blockers": [
+    {
+      "title": "내부 의사결정 완료 전 운영 계획서 범위 확정 불가",
+      "owner": "양측",
+      "status": "active",
+      "note": "티켓 수량과 비용 처리 방식이 먼저 정리돼야 함"
+    }
+  ],
+  "follow_up": {
+    "channel": "message",
+    "subject": "어수 파트너십 후속 자료 전달",
+    "body": "테스트 계정, 운영 계획서 초안, 비용 처리 옵션을 함께 전달하고 내부 검토 일정 회신을 요청합니다."
+  }
+}