모든 주목할 만한 변경사항은 이 파일에 기록됩니다.

형식: Keep a Changelog 1.1.0 · 버저닝: Semantic Versioning 2.0.0

아래 178개 지점의 버전 표기는 항상 완전히 동일합니다 (v2.0.0부터 SKILL.md frontmatter version: 복구):

• .claude-plugin/marketplace.json (metadata.version) × 1
• <plugin>/.claude-plugin/plugin.json (version) × 22
• <plugin>/skills/<skill>/SKILL.md (version: frontmatter) × 155 (v2.10.0+)

상세 정책: CLAUDE.local.md § 1 참조.

MINOR. 신규 플러그인 moai-book 도입 — 한국 출판사 제출용 원고 집필 풀스택 8 스킬 — 도서 컨셉서부터 출판사 매칭·본문 집필·퇴고까지 8 단계 워크플로우를 단일 플러그인에 통합. 실용서·인문·기술·소설 4 장르 자동 분기. KPIPA·국립국어원·도서정가제·교보문고·알라딘 베스트셀러 + 30+ 한국 출판사 라이브러리 + 자비 출판 5 플랫폼(부크크·텀블벅·인디고·카카오 브런치북·출판사 자비) 내장. 21 → 22 플러그인 · 147 → 155 스킬 · 동기화 지점 169 → 178.

• moai-book:book-concept-planner — 도서 컨셉서. 의도파악 → 리서치 → 인사이트 도출 3단계 워크플로우. 한 줄(15자)/30자/300자 요약 + USP 3축 + 시장 포지셔닝 매트릭스 + 자비 vs 출판사 투고 의사결정 + 4 장르 프리셋. KPIPA·교보문고·국립국어원 공식 출처 11회 인용. 409 lines.

• moai-book:book-target-reader — 타깃 독자 페르소나. 4축 카드(인구통계·라이프스타일·정체성·소비신호) + JTBD 3 차원(기능적·감정적·사회적) + 페인포인트 강도×빈도 매트릭스 4 분면(긴급·핵심·잠재·희귀) + 독서 행동 7항목 + 5인 인터뷰 검증. 한국 KPIPA 국민독서실태조사 인용. 355 lines.

• moai-book:book-outline-designer — 목차 설계. 부·장·꼭지 3 레벨 트리 + 분량 배분(200자 원고지) + 5요소 챕터 시놉시스(도입·약속·본문요약·사례·연결) + 페르소나 여정 4단계 검증(1부 끝·중반·마지막 부) + 분량 폭주·부족 검출 + 4 장르 분기. 352 lines.

• moai-book:book-author-bio — 저자 약력. 3 신뢰 신호(권위·공감·변화) + 3 길이 약력(50자·200자·500자) + 저자의 말 4단 구조(도입·공감·약속·초대 500~800자) + 신뢰 신호 매트릭스 5 영역 + SNS 채널별(인스타·브런치·링크드인·유튜브·X·카카오) + 페르소나 시뮬레이션. 387 lines.

• moai-book:book-proposal-writer — 출판사 투고 제안서. 출판기획서 5섹션 + 샘플 챕터 + 마케팅 플랜 5 카테고리(SNS·강연·언론·북클럽·이벤트) 3 패키지 = A4 12~20장. 출간 전·직후·후 3 단계 마케팅 타임라인(D-90·D+30·D+90) + 거절 신호 사전 검출(USP 약함·타깃 모호·분량 불균형 등) + 4 장르 × 10 출판사 양식 가이드. 501 lines.

• moai-book:book-publisher-matcher — 한국 출판사 매칭. 4 차원 평가(장르 적합도 40% · 규모 25% · 계약 조건 20% · 투고 채널 15%) + Top 5 우선순위 추천 + 거절 후 차순위 시나리오(D-0·D+14·D+45·D+90) + 30+ 한국 출판사 라이브러리(IT·실용·인문·문학·아동 + 자비 출판 5 플랫폼) + 협상 포인트 7 체크리스트(인세·선인세·계약기간·전자책·해외판권 등). 446 lines.

• moai-book:book-chapter-writer — 챕터 본문 집필. 꼭지 단위 5 요소(훅 10%·본문 70%·클라이맥스 10%·정리 5%·연결 5%) + 4 장르 문체 프리셋(실용·인문·기술·소설) + 200자 원고지 매수 자동 카운트 + 인용 5 유형 + 도표·코드·이미지 자리표시 + 한국 출판사 8곳 어미·문체 컨벤션. 382 lines.

• moai-book:book-revision-coach — 퇴고·교열 7 단계 점검(어법·문체·논리·인용·분량·시각자료·일관성) + 4 장르 문체 일관성 검증 + 분량 ±20% 검증 + 인용 5 유형 정합성 + 6 일관성 차원(어미·시점·인물·용어·표기·분량) + 4 체인 검수 순서(korean-spell-check → book-revision-coach → humanize-korean → ai-slop-reviewer). 420 lines.

book-concept-planner (컨셉서)
  → book-target-reader (페르소나·JTBD)
  → book-outline-designer (목차·시놉시스)
  → book-author-bio (저자 약력·저자의 말)
  → book-proposal-writer (출판 제안서)
  → book-publisher-matcher (출판사 매칭 Top 5)
  → book-chapter-writer (본문 챕터 집필)
  → book-revision-coach (퇴고 7 단계)
  → moai-content:korean-spell-check (정밀 맞춤법)
  → moai-content:humanize-korean (AI 티 정밀 윤문, 필수)
  → moai-core:ai-slop-reviewer (최종 검수, 필수)

• KPIPA 통계: 한국 출판 시장 데이터·국민독서실태조사·표준 양식
• 국립국어원: 한글 맞춤법·외래어 표기법·우리말 우선 가이드
• 도서정가제: 신간 18개월 정가 + 최대 10% 가격할인 + 5% 적립
• 베스트셀러 차트: 교보문고·알라딘·예스24 3사 통합 권장
• 한국 출판사 30+: IT(한빛미디어·인사이트·제이펍·길벗 IT) · 실용(웅진·다산북스·길벗·메가스터디북스) · 인문(민음사·문학동네·창비·휴머니스트·은행나무·돌베개) · 문학(민음사·문학동네·창비·문학과지성사·자음과모음) · 아동(비룡소·사계절·창비 어린이)
• 신인 등단 경로: 문학동네신인상·창비신인상·민음 신인 발굴 + 한국출판문화상·한국과학기술도서상
• 자비 출판 5 대안: 부크크(POD)·텀블벅 출판 펀딩·인디고·카카오 브런치북·출판사 자비

• 8 스킬 4차원 루브릭 자가 평가: 가중 평균 0.85 (통과 기준 0.70 ✅)
• ai-slop 자체 검수: 8 스킬 모두 APPROVE
• frontmatter v2.0.0 정책 준수 (metadata 블록 0건, version 단일 필드)
• vault 외부 참고 자료 원문 비유·표현 직접 인용 0건 (자체 재구성)
• 4 장르 자동 분기 검증 (실용·인문·기술·소설)
• tests/test-cases.yaml: 스킬당 6~9 케이스, 총 60+ test cases

MINOR. Wave 5 — moai-media 이미지 프롬프트 빌더 3종 신설 — GPT-image-2(OpenAI), Gemini 3 Pro Image(Google Nano Banana Pro), Midjourney v8.1 공식 프롬프트 가이드를 그대로 적용한 빌더 스킬 3종. AskUserQuestion 프리셋(제품샷·인물·일러스트·풍경) + 미세조정 라운드로 컨텍스트를 수집하고, 동일 입력을 3개 모델별 어조(6-Block / 5-component / 키워드+--파라미터)로 동시 변환해 복붙 가능한 텍스트로 출력. 144 → 147 스킬, 동기화 지점 166 → 169.

• moai-media:gpt-image-2-prompt — OpenAI GPT-image-2 전용 프롬프트 빌더. OpenAI Cookbook 공식 6-Block 구조(Subject·Action·Scene·Composition·Lighting·Style&Text). 편집 시 Change/Preserve/Constraints 2열 로직(references/editing-patterns.md). 텍스트 verbatim·ALL CAPS·다국어(한·일·중·힌·벵골) 규칙(references/text-rendering.md). 4 프리셋 × 4 슬롯 + 3개 모델 동시 출력. 페어: 기존 media-gpt-image2-builder(광고 5장 자동 생성)와 책임 분리 — 본 스킬은 프롬프트 텍스트만.

• moai-media:gemini-3-image-prompt — Google Gemini 3 Pro Image (Nano Banana Pro) 전용 프롬프트 빌더. Google AI for Developers 5-component 구조(영문 문장형, Creative Director 어조). 카메라 하드웨어 지정(Fujifilm·GoPro·iPhone 등). Reference image 14 슬롯 전략(references/reference-images.md). Search Grounding 활성화 가이드(references/search-grounding.md). Thinking vs Fast mode 권장. SynthID 워터마크 안내. 페어: 기존 nano-banana(실제 API 호출)와 책임 분리.

• moai-media:midjourney-v8-prompt — Midjourney v8.1 (2026.03 Alpha) 전용 프롬프트 빌더. Midjourney Parameter List 기반 키워드+--파라미터 구조. --sref/--oref/--cw/--p 3대 reference 시스템 deep dive(references/style-references.md). 6대 비용·동작 함정 자동 검사(references/cost-traps.md) — --hd --q 4 16x cost, --cw 100 상속 함정, --cref deprecation 자동 교체. Midjourney 공식 API 자동화 제한 명시. 페어: Discord/web alpha에서 직접 실행.

• AskUserQuestion 라운드 ≤ 3, 질문 ≤ 7 (프리셋 + 미세조정 + 화면비·텍스트·고급옵션)
• 출력: 3개 모델 프롬프트 코드블록 + 권장 파라미터 + 한국어 해설 + 페어 스킬 안내
• 책임 경계: 프롬프트 텍스트 산출 전용 (실제 이미지 생성은 페어 스킬 호출)
• 4 프리셋 (제품샷·인물·일러스트·풍경) × 4 슬롯 공유 — 모델별 어조 변환만 다름
• references 4개 + presets 4개 + tests/test-cases.yaml 5~6 케이스 + 회귀 베이스라인
• 루브릭 자가 평가: 0.805 ~ 0.815 (통과 기준 0.70 ✅)

• .claude-plugin/marketplace.json × 1
• <plugin>/.claude-plugin/plugin.json × 21
• <plugin>/skills/<skill>/SKILL.md × 147 (Wave 5 신규 3 + 누적)
• 총 169 지점 동일 버전 (v2.9.0) 유지

• Breaking change 없음
• moai-media 사용자: Wave 5 신규 3 스킬 자동 사용. 별도 설정 없음
• 본 빌더 출력 프롬프트는 OpenAI/Google/Midjourney 공식 가이드 형식이므로 외부 도구(ChatGPT 웹, Google AI Studio, Discord /imagine, Sora 등) 호환

• GPT-image-2: OpenAI Cookbook, openai-cookbook GitHub
• Gemini 3 Pro Image: Google AI for Developers, Google DeepMind, Google Cloud Blog Nano Banana guide, Vertex AI docs
• Midjourney v8.1: Parameter List, Style Reference, Omni Reference, Character Reference (deprecated)

MINOR. Wave 4 — moai-commerce 한국 D2C 풀스택 완결 — moai-commerce 신규 7 스킬 (MED 5 + LOW 2). 137 → 144 스킬, 동기화 지점 159 → 166. (iii) Wave 1~4 결정 완결.

• moai-commerce:commerce-review-aggregator — 멀티채널 리뷰 통합 분석. 네이버 스마트스토어·쿠팡·자사몰·YouTube·인스타그램 5채널 → 감정·키워드·인사이트·액션플랜 4단 분석. 채널별 수집 가이드(API·CSV·Graph API). 미리캔버스 PPT 자동화. vault-ecom.md §A-3 MED-1.

• moai-commerce:commerce-voc-triage — VOC 우선순위 판별. 3축 분류(고객 핏 ×13 / 빈도 ×13 / 핵심 가치 관련성 ×1~3) + 우선순위 점수(3축 곱) + KTAS 응급실 5단계 매핑(Level 1 즉시 <1시간 / Level 5 비응급 <1주). 등급별 응답 톤·내용 가이드. vault-ecom.md §A-3 MED-2.

• moai-commerce:commerce-subscription-strategist — 구독 비즈니스 모델 설계. 5가지 질문 자기진단(소비 빈도·가격 예측·락인 가치·이탈 방지·시장 검증) + 4 구독 모델 분류(소비재 오이식스 / 경험 VIPS / 관계 쿠팡 로켓와우 / 맞춤 필리) + 한국 시장 적합성 4단계 진단 + 락인 vs 이탈 방지 메시지 매트릭스 6단계. vault-ecom.md §A-3 MED-3.

• moai-commerce:commerce-influencer-collab — 인플루언서·UGC 협업 가이드. 5 티어(메가 100만+ / 매크로 10100만 / 마이크로 110만 / 나노 1천~1만 / 메가나노 ~1천) × 협업 비용·전환율 매트릭스 + 뒷광고 회피 체크리스트 6항목(표시광고법 + 공정위 가이드, 과태료 5,000만원 회피) + UGC 리그램 가이드 + 5축 굿즈 기획(시즌 한정·얼리버드·VIP·인증샷·콜라보). vault-ecom.md §A-3 MED-4.

• moai-commerce:commerce-early-fan-builder — 신생 브랜드 충성 100명 부트스트랩. 5원칙(광고 0원·1:1 손편지·UGC 100%·비공개 채널·추천 시스템) + 30일 로드맵(시드 50명 → 100명 → 락인 → 추천) + 100명→1만명 전환 시나리오 + 핵심 지표(재구매율 80%+·평균 10명 추천·LTV/CAC ratio 3+). 블랭크·강아지 가방 케이스. vault-ecom.md §A-3 MED-5.

• moai-commerce:commerce-trend-namer — 네이버 데이터랩 트렌드 변환. 카테고리별 급상승 검색어·시즌 트렌드 수집 → 상품명 변형 3안 + 해시태그 세트 30개(카테고리 5·트렌드 10·브랜드 5·일반 10) + 블로그 제목 SEO 3안(C-Rank 친화). vault-ecom.md §A-3 LOW-1.

• moai-commerce:commerce-season-calendar — 연간 시즌 캘린더. 한국·글로벌 30+ 시즌 이벤트(1분기 설날·발렌타인·졸업입학 / 2분기 가정의 달·여름 / 3분기 휴가·추석 / 4분기 빼빼로·블프·솽스이·크리스마스) + 카테고리별 매출 피크 매핑(화장품·식품·의류·반려동물·여행) + 분기 캠페인 사전 준비 계획(D-30/D-60/D-90/D-120). vault-ecom.md §A-3 LOW-2.

• .claude-plugin/marketplace.json × 1
• <plugin>/.claude-plugin/plugin.json × 21
• <plugin>/skills/<skill>/SKILL.md × 144 (Wave 4 신규 7 + 누적)
• 총 166 지점 동일 버전 (v2.8.0) 유지

• Breaking change 없음
• moai-commerce 사용자: Wave 4 신규 7 스킬 자동 사용. 별도 설정 없음
• commerce-review-aggregator 채널별 API 키 필요 (네이버 커머스·쿠팡 윙·카페24·YouTube·Instagram Graph)

• 마켓플레이스 130 → 144 스킬 (+14, 누적 14주 작업)
• moai-commerce 22 → 35 스킬 (+13)
• moai-media 13 → 13 스킬 (정리만, Quick Wins 6 + 안 C 책임 명확화 3)
• 어트리뷰션 정책 변경: 정승우님 자료 출처 모두 제거 (내용 보존)
• vault grounding: 1,329 노트 기반 한국 D2C·CRM·LTV·법규 풀스택

• Wave 5 후보: moai-marketing 보강 또는 moai-content 신규
• 또는 사용자 검증 사이클 (실제 사용 → 보강·정정)

MINOR. Wave 3 — 프로모션·재구매·이미지 파이프라인 — moai-commerce 신규 3 스킬. 134 → 137 스킬, 동기화 지점 156 → 159.

• moai-commerce:commerce-promotion-planner — 3대 프로모션 기획법(이슈화·얼리버드·한정) 전담. 브랜드 단계(신생/스몰/중대형) × 목표(인지도/충성고객/즉각매출) 매트릭스 + 명목·스토리·혜택 3종 세트(HARD) + 벤치마킹 케이스 3개(명목·스토리·혜택 각 1개) + 실무 체크리스트 6항목 + 노션 템플릿 페이지 구조(1~8 섹션) 자동 생성. 비플레인 '듣보잡' 스몰 D2C 12배 매출 케이스 실전 매뉴얼. vault-ecom.md §A-3 HIGH-4 명세 구현. 페어 분리: integrated-strategy=전체 매출 전략, 본 스킬=단일 프로모션 기획서.

• moai-commerce:commerce-repurchase-timer — 재구매 타이밍 엔진. 골든타임 3구간 모델(리마인드 0.8T / 데드라인 1.1T / 휴면 1.5T) + 구간별 메시지 톤·채널 매핑(앱 푸시·카톡 친구톡·이메일) + 인센티브 강도(05% / 1015% / 25~40%+사은품) + 리드 스코어링 8개 행동(구매 후 7일 재방문 +10 / 후기 작성 +25 / 친구 초대 +30 / 미접속 60일 -20 / 수신거부 -100) + 리텐션 차트 cohort 분석 가이드(M+1·M+3·M+12 해석 기준) + 한국 10 카테고리 표준 주기 매트릭스(화장품·면도기·콘택트렌즈·반려동물·영양제·잉크·향수 등). vault-ecom.md §A-3 HIGH-5 명세 구현.

• moai-commerce:commerce-product-image-pipeline — 상품 이미지·영상 풀스택 파이프라인 오케스트레이터. character-mgmt → image-gen(Soul) → video-gen(DOP) → media-channel-ad-packager 4단계 체인 자동 호출. 3 시나리오(신규 D2C 캐릭터 없음 / 브랜드 마스코트 보유 / 모델 캐릭터 = 가상 인플루언서) + 이미지 5축(Hero·Lifestyle·Detail·Use-case·Result) + 영상 모션 프리셋 자동 선택(스킨케어=slow_zoom / 패션=pan_left / 식품=orbit) + 채널 변환(메타·네이버 GFA·카카오) + media-ai-disclosure 자동 체인 + 비용 추정(₩2,300~4,000/상품 1건). audit §6 안 C 권장 #7 구현. 페어 분리: detail-page-image=13섹션 합성 PNG 1장 / media-model-router=광고 영상 라우팅 / 본 스킬=풀스택 체인 오케스트레이션.

• .claude-plugin/marketplace.json × 1
• <plugin>/.claude-plugin/plugin.json × 21
• <plugin>/skills/<skill>/SKILL.md × 137 (신규 3 + 누적)
• 총 159 지점 동일 버전 (v2.7.0) 유지

• Breaking change 없음
• moai-commerce 사용자: Wave 3 신규 3 스킬 자동 사용 가능. 별도 설정 없음
• commerce-product-image-pipeline 사용 시 Higgsfield API + fal.ai API 모두 필요

• Wave 4 (v2.8.0 예상): commerce MED/LOW 7 (review·voc·subscription·influencer·early-fan·trend-namer·season-calendar) — 신규 7

PATCH. Wave 2 보강 3 + Higgsfield 안 C 정리 — 신규 스킬 0, 보강 3, 책임 경계 명확화 3. 134 스킬 유지, 동기화 지점 156 동일.

moai-commerce 보강 3 (vault-ecom §A-4)

• moai-commerce:commerce-channel-message — 'AARRR 단계별 한국 30+ 브랜드 메시지 풀스택' 섹션 추가. Acquisition(토스·당근·29CM·듀오링고·인프런 등) · Activation(배민·쿠팡·야놀자·클래스101·카카오뱅크 등) · Retention(오프린트미·퍼블리·콜린스·인프런·야놀자·넷플릭스·라운즈·듀오링고·리멤버 등) · Revenue(에이블리·지그재그·무신사·올웨이즈·쿠팡이츠 등) · Referral(토스·당근·우버이츠·카카오페이·야놀자 등) 5단계 × 5~9 브랜드. 3요소 체크리스트(Timely·Personal·Actionable) + 단계별 발송 빈도 권장. vault 1,329 노트 기반 한국 브랜드 풀스택.
• moai-commerce:commerce-product-naming — '6질문 상품 파악 프레임 + 데이터랩 트렌드 워크플로우' 섹션 추가. 6질문(Primary Buyer·Motive·Search Intent·USP·Channel-Fit·Seasonality) + 네이버 데이터랩 4단계(트렌드·연관키워드·인구통계·시즌) + 통합 체크리스트(4개 이상 PASS) + MD 11년차 인사이트.
• moai-commerce:commerce-market-research — '시장 세분화 + USP 추출 프로세스 (MD 11년차 관점)' 섹션 추가. 4축 세분화(인구·심리·행동·맥락) + 5축 평가(시장크기·성장률·경쟁·진입비용·강점) + USP 3 차별 축(What·How·Why) + 검증 질문 + 다운스트림 일관성 매핑(USP → naming → message → detail-page → campaign).

moai-media 3 SKILL.md

• moai-media:media-model-router:
  • description '백엔드 통합: Kling 3 (Higgsfield MCP) + Veo 3·Seedance 2.0 (fal-gateway 위임)' 명시
  • 카테고리 매트릭스 아래 '백엔드 매핑' 표 추가 (HIGH-1 audit 결과 Veo 3·Seedance MCP 호출 경로 명확화)
• moai-media:video-gen:
  • description '(범용·단순 영상 전용)' 명시
  • '광고 영상 + 카테고리 자동 라우팅이 필요하면 페어 스킬 media-model-router 사용' 안내 추가
  • (HIGH-2 audit Kling 3 영상 책임 중복 정리)
• moai-media:fal-gateway:
  • description 'media-model-router의 Veo 3·Seedance 2.0 라우팅도 본 스킬을 백엔드로 사용' 명시
  • 트리거 키워드 'Veo 3', 'Seedance' 추가

• .claude-plugin/marketplace.json × 1 (metadata.version)
• <plugin>/.claude-plugin/plugin.json × 21
• <plugin>/skills/<skill>/SKILL.md × 134 (v2.6.0 유지)
• 총 156 지점 동일 버전 (v2.6.1) 유지

• Breaking change 없음 — 모든 변경이 새 섹션 추가 또는 description 정리
• moai-media 사용자: media-model-router Veo 3·Seedance 요청 시 fal-gateway 자동 위임. 추가 설정 없음

• Wave 3 (v2.7.0 예상): 신규 2 (commerce-promotion-planner·commerce-repurchase-timer) + commerce-product-image-pipeline 신규
• Wave 4 (v2.8.0 예상): commerce MED/LOW 7 (review·voc·subscription·influencer·early-fan·trend-namer·season-calendar)

MINOR. Wave 1 vault grounding 한국 CRM·LTV·법규 통합본 — vault 1,329 노트 + Higgsfield MCP audit + 어트리뷰션 정책 변경. 신규 3 스킬 + Higgsfield Quick Wins 6 + 어트리뷰션 정리. 130 → 134 스킬, 동기화 지점 152 → 156.

• moai-commerce:commerce-marketing-compliance-kr — 한국 정통망법 광고·정보성 메시지 자동 게이트. 6대 점검(광고성 판정·옵트인·야간 발송 21시~익일 8시 차단·(광고) 표기 위치·무료 수신거부 명시·발신자 정보) + BLOCK/PASS 판정 + 위반 조항(제50조 1·3·4항, 제76조) + 구체 fix 가이드 + 채널별 베스트/워스트 패턴 카탈로그. 과태료 위험: 1회 위반 최대 3,000만 원 + 책임자 1년 이하 징역. vault-ecom.md §A-3 HIGH-2 명세 구현.

• moai-commerce:commerce-push-planner — 앱 푸시 전용 기획 스킬. 4원칙(왜/언제/누구에게/어떻게) + Timely·Personal·Actionable 3요소 자가 점검 + 카피 변형 3안(오늘만 vs 매일 / 누구나 vs 너에게만 / 숫자 vs 게이미피케이션 vs 브랜딩) + 한국 30+ 브랜드 레퍼런스(토스·배민·오늘의집·쿠팡·에이블리·지그재그·29CM·인프런·야놀자·퍼블리·넷플릭스·듀오링고 등) + 클릭률 예측 가이드. 페어 분리: commerce-channel-message는 카톡/SMS/이메일, 본 스킬은 앱 푸시 전용. vault-ecom.md §A-3 HIGH-3 명세 구현.

• moai-commerce:commerce-ltv-cac-architect — 고객 단위 수익 구조 설계. CAC→재구매율→구매주기→ARPU→공헌이익→LTV 6대 지표 연결 모델 + LTV/CAC ratio(<1 손실, 13 손익분기, 35 건강, ≥5 우수) + Payback Period + 광고 의존도 진단(30%+ 위험 → 1115% 정상) + 손익분기 ROAS 자동 + 채널·세그먼트별 재구매율 분해 + 광고 의존도 탈출 6단계 로드맵(Month 16) + 한국 D2C 카테고리별 벤치마크(화장품·식품·패션·가전·펫·구독 SaaS). 페어 분리: commerce-margin-calculator는 단품 마진, 본 스킬은 고객 1명 평생 수익. vault-ecom.md §A-3 HIGH-1 명세 구현.

audit research-2026-05-16/higgsfield-audit.md §7 즉시 자동 수정 후보 적용:

• character-mgmt:
  • MCP 설정 "command": "uvx" + "args": ["higgsfield-mcp"] → "command": "higgsfield-mcp" (CONNECTORS.md pip install 정책과 일치)
  • "베타 기간 무료" stale → "공식 사이트 요금제 확인 (higgsfield.ai)"
• fal-gateway:
  • MCP URL https://fal.ai → https://mcp.fal.ai/mcp
  • Authorization Key ${FAL_KEY} → Bearer ${FAL_KEY}
• video-gen: MCP 툴명 generate_video_dop → higgsfield.generate_video_dop (네임스페이스 통일)
• speech-video: MCP 툴명 generate_speech_video → higgsfield.generate_speech_video

GOOS 결정으로 정승우님 자료 공식 어트리뷰션을 모두 제거. 출처 클로즈만 제거하고 내용·구조·버전 표기는 그대로 보존하여 사용자 경험 무변동.

• NOTICE.md: "정승우님 자료 (Course Material — Permitted Use)" 섹션 전체 + 다른 섹션 내 잔여 언급 3건 제거. moai-cowork 자체 제작 교재 섹션은 유지
• moai-commerce 9 SKILL.md 자료 N §M 인용 + 정승우님 노하우 표현 출처만 제거 (channel-message·automation-audit·product-naming·detail-page-copy·market-research·integrated-strategy·jtbd-persona·coupang-ad-optimizer·commerce-margin-calculator)
• moai-marketing 5 파일 자료 4 §M 인용 + 정승우님 자료 4 풀명 출처만 제거 (sns-content·pixel-audit·campaign-planner·landing-page-conversion-audit·meta-ads-analyzer/references/D.md)
• 2 README(moai-commerce·moai-marketing) 카탈로그 설명 일반화 (정승우님 → 한국 셀러 실전 노하우)

처리 패턴 (GOOS 컨펌): 출처 클로즈만 제거 / 버전 클로즈·헤더 텍스트 유지 / frontmatter description 출처 부분만 제거 일반화. Wave 1.5 commit 552d3a4(어트리뷰션 추가)의 forward fix.

• .claude-plugin/marketplace.json × 1 (metadata.version)
• <plugin>/.claude-plugin/plugin.json × 21
• <plugin>/skills/<skill>/SKILL.md × 134 (신규 3 + 누적)
• 총 156 지점 동일 버전 (v2.6.0) 유지

• Breaking change 없음
• 정승우님 자료를 직접 참조하던 외부 사용자: 본 버전부터 어트리뷰션 없음. 자체 NOTICE 작성 시 cowork-plugins MIT 라이선스 + 본 리포 출처만 표기 가능
• Higgsfield MCP 사용자: character-mgmt MCP 설정 + fal-gateway URL·Auth 자동 업데이트. pip install higgsfield-mcp 확인 필요
• moai-commerce 사용자: Wave 1 신규 3 스킬 자동 사용 가능. 별도 설정 없음

• Wave 2: commerce 보강 3(channel-message·product-naming·market-research) + Higgsfield 안 C 정리(model-router·video-gen·fal-gateway)
• Wave 3: 신규 2(promotion-planner·repurchase-timer) + product-image-pipeline
• Wave 4: commerce MED/LOW 7(review·voc·subscription·influencer·early-fan·trend-namer·season-calendar)

MINOR. 메타 광고 audit 3-Layer 인프라 출시 — Layer 3 신규 분석 스킬 1종(meta-ads-analyzer, .xlsx 보고서 1~6개 → 9 분석 모듈 + 4D 교차 + 강도별 액션 옵션 + 4 출력 형식) + Layer 2 자체 MCP 서버 신규 1종(moai-ads-audit-mcp, claude-ads v1.5.1 MIT 방법론 한국 시장 7 변화 영역 특화 + 10 도구 중 3 도구 + 50/50 pytest pass). 129 → 130 스킬, 동기화 지점 151 → 152.

moai-marketing 신규 1

• moai-marketing:meta-ads-analyzer — 메타 광고관리자 .xlsx 보고서 16개 업로드 → 상품 관여도·운영 철학 반영 진단. 9 분석 모듈(퍼널·KPI·차원·매트릭스·누수·라이프사이클·학습·예산·시뮬레이션) + 4D 교차(광고×지면×연령×성별) + 3 사용자 그룹 톤(인하우스/대행사/소규모, 명시 입력) + 4 출력 형식(HTML/DOCX/PPTX/MD, cowork 공용 디자인 토큰 적용 — --ivory/--paper/--slate/--clay/--clay-d/--oat/--olive) + 강도별 액션 옵션(🟢🟡🔴 보수/중도/적극) + claude-ads v1.5.1 (MIT, 4,815 stars) 50-check 매트릭스 한국 시장 매핑. SKILL.md + references AK 11개 부록 = 12파일 1,829줄. ai-slop-reviewer 자동 체이닝.

자체 MCP 서버 1종 (cowork-plugins monorepo 첫 MCP 패키지)

• mcp-servers/moai-ads-audit/ — Meta Ads audit 전담 자체 MCP 서버 (Python uvx, MIT, v0.1.0). claude-ads v1.5.1 (MIT) 방법론 차용 + 한국 시장 7 변화 영역(벤치마크·8 산업 카테고리·5 규제·5 사용자 그룹·표현 스타일·4 출력 형식·4D 분석) 특화. 가중치 스코어링 공식(S_total = Σ(C_pass × W_sev × W_cat) / Σ(C_total × W_sev × W_cat) × 100) + Severity 5.0/3.0/1.5/0.5 + 카테고리 가중치 30/30/20/20 + A-F 등급 + 43 unique check matrix(Pixel/CAPI 10 + Creative 12 + Account 10 + Audience 7 + Andromeda 4) + 한국 벤치마크 8 카테고리(식품/음료·패션/뷰티·건강기능식품·IT/디지털·가정용품·교육·B2B·기타) + 5 규제(PIPA·ITNA·전상법·표시광고법·식약처). 우선 구현 도구 3종(audit_meta_account·audit_pixel_capi·calculate_health_score). 50/50 pytest pass. 총 3,813줄(Python+테스트+manifest+문서).

MCP 등록 인프라

• moai-marketing/.mcp.json 신규 — 2개 MCP 등록 (meta-ads hosted at mcp.facebook.com/ads + moai-ads-audit local stdio via uvx)
• moai-marketing/CONNECTORS.md 신규 — META_ACCESS_TOKEN 발급 절차 + Layer 1 fallback 옵션 (Adspirer/byadsco/pipeboard) + 10 도구 명세

• agricidaniel/claude-ads v1.5.1 (MIT, 4,815 stars, 2026-05-13 시점) — Meta 광고 audit 50-check matrix·가중치 스코어링 공식·Quick Wins 로직·EMQ tiered targets·A-F 등급 임계값
• 전체 attribution: NOTICE.md §"agricidaniel/claude-ads (MIT)"
• Korean Market Adaptation 7 영역 한국 시장 1차 시민 변환

• .claude-plugin/marketplace.json × 1 (metadata.version)
• <plugin>/.claude-plugin/plugin.json × 21
• <plugin>/skills/<skill>/SKILL.md × 130 (신규 1 포함)
• 총 152 지점 동일 버전 (v2.5.0) 유지

• Breaking change 없음 — 기존 워크플로우 그대로 동작
• 신규 스킬 호출 예시: "메타 광고 보고서 분석해줘", "케어밀 보고서 진단", "ROAS 낮은 이유", "지면별 분석", "Audience Network 진단"
• MCP 서버 활성화: Claude Code 재시작 시 moai-marketing/.mcp.json 자동 인식. Meta 공식 MCP는 OAuth(META_ACCESS_TOKEN) 필요. 비활성 환경에서는 .xlsx 업로드 fallback 자동 동작 (REQ-AUDIT-MCP-005)
• v2.4.0과의 관계: 본 v2.5.0은 v2.4.0의 로컬 5 커밋(5922342·1a08357·e6363f5·db260f7·99db972) 위에 누적. v2.4.0은 별도 release 없이 v2.5.0 통합 release로 발행 예정 (GOOS 명시 컨펌 후, 메모리 feedback_v240_push_confirm.md 유지)

• moai-ads-audit-mcp 잔여 7 도구 구현 (audit_creative_diversity · audit_account_structure · audit_audience_targeting · audit_andromeda_emq · generate_quick_wins · apply_korean_benchmarks · apply_korean_compliance)
• 한국 벤치마크 8 카테고리 수치 정식 검증 출처 확정 (현재 v0.1.0 placeholder, SPEC §7 OQ4)
• claude-ads 50 vs 43 check 차이 7 항목 추가 검토 (SPEC §7 OQ3)
• 표본 부족 셀 마스킹 기준 N값 통일 (SPEC §7.2 미결정)
• v2 단계: TikTok·Naver·Kakao audit 확장
• v3 단계: SaaS UI·다국어·상시 대시보드

MINOR. 캠프 후속 인사이트 통합본 — 정승우님 본인 노하우 3개 문서(쿠팡 매출 9배 비법 전자책 126p + 커머스 업무 자동화 24p + 커머스 매출향상 AI 활용 26p) + 광고 심리학 완전판(13장 376줄)을 분석해 13건(신규 5 + 강화 8) 통합. 124 → 129 스킬, 동기화 지점 146 → 151.

moai-commerce 신규 3

• moai-commerce:coupang-ad-optimizer — 쿠팡 광고 풀세트 최적화. 3 캠페인 유형(AI스마트/매출최적화/수동키워드) 자동 분류 + 검색영역 vs 비검색영역 매출 분리 분석(CPM 167배 차이) + 엔드 ROAS(본전 ROAS) 자동 계산 + 자동규칙 3종 가이드(골든타임/350%이상 증액/100%미만 알림) + 상품별 의사결정 분기(ROAS·CTR·CVR). 정승우님 본인 6개월 노하우(월매출 7천→3.6억, 광고비 30%→11.2%) wrapper.
• moai-commerce:commerce-margin-calculator — 상품별 마진·엔드 ROAS·손익분기 광고비 자동 계산. 채널별 수수료(스마트스토어 5.94% / 쿠팡 1012% / 카페24 23% / 아임웹 0~2.5%) + 부가세 10% + 결제 수수료 + 쿠폰 자동 반영. 시크릿팡 마진계산기 차용 + AI 챗봇 자연어 입력 차별화.
• moai-commerce:commerce-automation-audit — 6대 영역(A 상품운영 / B 가격&프로모션 / C 주문&정산 / D 재고&물류 / E 마케팅&고객 / F 데이터&경영) 진단 + 자동화 3분류(반복형/판단형/창의형) + 우선순위 점수((빈도×시간×오류비용)÷복잡도) + 3 Phase 로드맵(Quick Wins/Core/AI Enhancement) + 5대 KPI + HITL Golden Rule(80% 자동화 + 10배 검수). 정승우님 "커머스 업무 자동화" 24p 풀세트 wrapping.

moai-marketing 신규 2

• moai-marketing:landing-page-conversion-audit — 랜딩페이지 6섹션(히어로·공감·증명·사회증거·CTA·FAQ) 진단 + 진단 분기(CTR↓→광고 / CVR↓→랜딩 / 장바구니↓→결제) + 빠른 처방 3종(불안해소 문구 +10~20% / 메시지 일치 / 간편결제). 자료 4 §9 wrapper.
• moai-marketing:pixel-audit — 메타·구글 픽셀 설치 검증 + 3종 실수 점검(구매자 미제외/이벤트 파라미터 미설정/CAPI 미설치) + 1st Party 데이터 활용 진단 + Lookalike 씨앗 품질 평가(VIP 상위 20% 권장). 자료 4 §5 wrapper.

moai-commerce 강화 4

• commerce-product-naming 강화 — 공식 4요소 명시 [브랜드]+[카테고리]+[키워드]+[차별점] + 매핑 3안 카테고리 명확화(검색 최적화/CTR 최적화/브랜드 강화) + 금지 키워드 9종(최저가·1위·베스트·재입고·인기상품·정품·당일배송·무료배송·특가) + 주의사항 4종(검색어 과다·경쟁사 도용·길이 초과·과장) + 적용 예시 2종(화장품·가전제품)
• detail-page-copy 강화 — 7단계 + 25/50/25 비율 가이드 보강 + 좋은/피해야 할 예시 가이드 + PAS 카피 공식 매핑(7단계 ↔ Problem-Agitate-Solution) + 혜택 언어 3단계 변환법(기능→변화→감정)
• commerce-jtbd-persona 강화 — JTBD 3분류 카테고리별 예시(다이어트 가루 9개) + 심리적 필요 4종 촉발 패턴(보상심리·불안해소·지루함·사회적자극) + 타겟 온도 4단계 메타데이터(콜드/웜/핫/슈퍼)
• commerce-channel-message 강화 — 6 심리 방아쇠(신뢰·손실회피·사회증거·인지쉬움·정체성·앵커링) + 채널별 심리 상태 매트릭스(메타·구글·네이버·카카오·쿠팡) + 인지 편향 8종(프레이밍·후광·타협·현재·매몰비용·제로리스크·선택과부하·디폴트·단순노출)
• commerce-integrated-strategy 강화 — 자동화 4단계 프로세스(나열→분류→점수→결정) + 3 Phase 로드맵 + HITL Golden Rule
• commerce-market-research 강화 — 포지셔닝 5축(품질/가성비/전문성/편의성/가치관) + 새 카테고리 창출 vs 기존 카테고리 경쟁 분석 + 6대 영역 진단 통합

moai-marketing 강화 2

• campaign-planner 강화 — 광고 심리학 완전판 통합(성과 공식 + 3 동기 + 6 방아쇠 + 8 편향 + PAS + 후크 6종 + 영상 30초 구조 + 타겟 온도 4단계 × 동기 매트릭스 + 1st Party + LTV/CAC + 단계별 예산 배분)
• sns-content 강화 — 채널별 심리 상태 매트릭스 + 메타 학습 기간 48~72시간 가이드 + iOS 14 이후 CAPI·GA4 교차 검증

• 정승우님 "쿠팡 매출 9배 올려준 광고관리 비법" 전자책 (126p, 본인 6개월 노하우)
• 정승우님 "커머스 업무 자동화 기획" (24p, 6대 영역 + 자동화 프레임워크)
• 정승우님 "커머스 매출향상을 위한 AI 활용 전략" (26p, JTBD + 페르소나 + 상세페이지 + 상품명)
• "온라인 광고의 심리학" (DOCX, 13장 376줄 완본, 성과 공식 + 심리 방아쇠 + 인지 편향)
• 시크릿팡 마진계산기 로직 참고 (https://secretpang.kr/?ref=pdf)

• Track A MoAI-Commerce MCP 서버 (광고 4종 + Phase 1 34종 + Higgsfield 통합)

• .claude-plugin/marketplace.json × 1 (metadata.version)
• <plugin>/.claude-plugin/plugin.json × 21
• <plugin>/skills/<skill>/SKILL.md × 129 (신규 5 포함)
• 총 151 지점 동일 버전 (v2.4.0) 유지

• Breaking change 없음 — 기존 워크플로우 그대로 동작
• 신규 5 스킬은 필요할 때 자연어로 호출 ("쿠팡 광고 분석해줘", "마진 계산해줘", "자동화 진단해줘", "랜딩 진단해줘", "픽셀 점검")

MINOR. 모두의 커머스 3일 마스터 캠프 (Claude Cowork × MoAI-Cowork × MCP) 통합본 출시. Day1 셋업·Day2 V6 6도구·Day3 신규 AI 모델·D+1~D+30 follow-up까지 18개 산출물 데이터 체인을 강의 안에서 끊김 없이 흐르도록 17 신규 + 6 강화 스킬 추가. Track C 페어 정리로 책임 경계 명확화.

Day2 V6 6도구 (moai-commerce 5 + detail-page-copy 강화) — PDF §5.3 V6 ↔ MCP 매핑

• moai-commerce:commerce-market-research — trend_search · trend_shopping_categories · trend_shopping_keywords · keyword_for_product_idea 4종 MCP 호출 → 거시·경쟁·검색 3축 시장 1장 리포트
• moai-commerce:commerce-jtbd-persona — 1스킬 2모드. --mode jtbd (기능·감성·사회 각 3개 = JTBD 9개) / --mode persona (review_list_naver·review_list_cafe24·qna_list_cafe24 → 페르소나 3명 8필드). 본인 리뷰 10건 미만 시 fallback 자동 적용
• moai-commerce:commerce-product-naming — keyword_search_volume·keyword_related·keyword_bulk_research → 상품명 3안 (검색·CTR·브랜드) + 스마트스토어/쿠팡/네이버쇼핑 25자·금지어 검증
• moai-commerce:commerce-channel-message — keyword_seasonal_calendar·ad_keyword_performance + NCM 프레임워크 (Need→Channel→Moment→Message→CTA) → 검색·광고·CRM × 5종 = 15종 메시지 (채널별 다른 표현 강제)
• moai-commerce:commerce-integrated-strategy — dashboard_morning_brief·sales_compare_channels·ad_roas_summary → 매출 향상 전략 1장 (실행 우선순위 Top 3)

Day3 신규 AI 모델 6스킬 (moai-media) — PDF §6 + 부록 A·B·D

• moai-media:media-moodboard — 페르소나·카피·카테고리 → 색팔레트 3종 + 톤 키워드 5개 + 레퍼런스 이미지 5장
• moai-media:media-gpt-image2-builder — 자연어 한 줄 → 8단계 프롬프트 자동 리라이팅 → GPT Image 2 호출 (수강생 비공개 룰: 8단계 구조는 references/ 내부 자료)
• moai-media:media-model-router — 카테고리 매트릭스 자동 라우팅 (의류=Kling 3 / 뷰티=Veo 3 / 건강식품=Kling 3 / 생활용품=Seedance). Higgsfield 동시 호출 비용 폭증 방지 위해 4명×5조 시차 호출 (5분 간격)
• moai-media:media-channel-ad-packager — 메인 영상 + 보조 영상 + 채널 메시지 → 메타 1:1·9:16 / 네이버 GFA 길이 / 카카오 알림톡 변수 / 카카오모먼트 1:1·16:9 채널별 자동 변환
• moai-media:media-ai-disclosure — 광고심의·소비자보호법 대비 "AI 생성" 메타데이터·워터마크 자동 부착 (캔바 매직 레이어 수정 후에도 표기 유지)
• moai-media:media-canva-magic-layer — Day 3 합성 PNG → 카피만 분리 → 시즌 재사용 5단계 가이드 (GPT Image 2 재호출 대비 90% ↓)

Day1 셋업 3스킬

• moai-core:mcp-connector-setup — Drive · Notion · Higgsfield · OpenAI 4커넥터 인증 가이드 + 트러블슈팅
• moai-commerce:commerce-morning-brief — dashboard_morning_brief MCP → 어제 주문·신규 문의·트렌드·ROAS 1개 호출 통합 1줄
• moai-commerce:commerce-order-summary — order_summary_today MCP → 스마트스토어 + 카페24 + 아임웹 채널 통합 신규 주문 1줄

moai-education 활성화 2스킬 (현재 0 스킬 → 2 스킬)

• moai-education:course-followup-sequence — D+1·D+3·D+7·D+14·D+30 후기 카피 5종 + 30일 자산화 시퀀스 + SUNO BGM·MCP Phase 1 직접 호출 가이드
• moai-education:course-curriculum-design — 3일 21세션 강의 운영 매뉴얼 자동 생성 (표준 시간표·강사·조교 동선·사전 준비물·Plan B 시나리오 5건+)

• moai-commerce:detail-page-copy 강화 — 기존 13섹션 모드 하위 호환 유지. 신규 --mode diagnose (7단계 진단 점수, 단계별 개선 제안) + --mode copy (페르소나 2세트 카피, 비율 25/50/25 강제)
• Track C 페어 정리 — 통합 1건: moai-content:social-media → moai-marketing:sns-content 흡수 (글로벌 4채널 모드 추가: 스레드·X·링크드인·유튜브 쇼츠). social-media는 deprecate stub + 리디렉션 안내. 한국 3채널 모드(인스타·네이버 블로그·카카오)는 유지
• Track C 페어 정리 — 책임 분리 1건: moai-marketing:campaign-planner의 "이커머스 상세페이지 제작 · AI 이미지 생성" 책임 제거. 상세페이지 카피는 detail-page-copy, 상세페이지 합성 이미지는 detail-page-image, AI 이미지·영상은 moai-media:* 사용 안내로 이관
• Track C 페어 정리 — description [책임 경계] 명확화 15건: copywriting/commerce-copywriting (Pair 1), product-detail/detail-page-copy (Pair 2), personal-branding/brand-identity (Pair 5), target-script (Pair 6), performance-report/executive-summary (Pair 7), market-analyst/sbiz365-analyst (Pair 8), daily-briefing (Pair 9), landing-page (Pair 10) + sns-content·campaign-planner

.moai/specs/ 하위 7개 SPEC 작성 (총 84 EARS REQ):

• SPEC-COURSE-CAMP-001 (master) — 강의 전체 요구사항·18 산출물·합격기준·운영 매뉴얼
• SPEC-COMMERCE-MCP-002 — Track A MoAI-Commerce MCP 서버 (후속 마이너 v2.4.0 예정)
• SPEC-COMMERCE-V6-003 — Wave 1 commerce 6
• SPEC-MEDIA-CAMP-004 — Wave 2 media 6
• SPEC-CAMP-SETUP-005 — Wave 3 core 3
• SPEC-CAMP-FOLLOWUP-006 — Wave 4 education 2
• SPEC-CATALOG-CLEANUP-007 — Track C 페어 정리

• Track A MoAI-Commerce MCP 서버 구현 (cowork-plugins/mcp-servers/moai-commerce/ monorepo) — 광고 운영 4종 (meta ads · tiktok ads · naver 광고 · kakao 모먼트) + Phase 1 34종 + Higgsfield (Kling 3·Veo 3·Seedance 2.0). Python (uvx) 권장. 본 v2.3.0 출시까지는 사전 녹화 영상 5분 또는 강사 본인 워크스페이스 라이브 호출로 대체 (PDF §S4 운영 노트)

• .claude-plugin/marketplace.json × 1 (metadata.version)
• <plugin>/.claude-plugin/plugin.json × 21 (version)
• <plugin>/skills/<skill>/SKILL.md × 124 (version, 신규 17 포함)
• 총 146 지점 동일 버전 (v2.3.0) 유지

• 기존 /social-media 호출 코드는 v2.5.0까지 deprecate stub으로 유지. /sns-content 사용 권장
• 기존 /campaign-planner 호출 시 "상세페이지 만들어줘"는 더 이상 routing되지 않음. /detail-page-copy 또는 /detail-page-image 직접 호출
• moai-education이 0 스킬에서 2 스킬로 활성화됨 — Cowork에서 플러그인 설치 시 자동 사용 가능

PATCH. docs-site에서 Hugo 템플릿 변수가 마크다운 파일 내에서 치환되지 않는 버그를 수정했습니다.

• 변수 치환 버그 — 마크다운 파일 내 HTML에서 {{ site.Params.version }}이 렌더링되지 않는 문제 수정
  • Shortcodes 도입: version.html, release-date.html 생성
  • _index.md 수정: {{ site.Params.version }} → {{< version >}}, {{ site.Params.releaseDate | replace "-" "." }} → {{< release-date >}}
  • Partial 추가: version-badge.html 컴포넌트
  • 헤더 버전이 정상적으로 "v2.2.1"로 노출됨

• docs-site/content/_index.md: Hugo shortcodes로 변수 참조 방식 변경
• docs-site/layouts/shortcodes/: version, release-date shortcodes 추가
• docs-site/layouts/partials/: version-badge partial 추가

• .claude-plugin/marketplace.json × 1 (metadata.version)
• <plugin>/.claude-plugin/plugin.json × 21 (version)
• <plugin>/skills/<skill>/SKILL.md × 108 (version)
• 총 130 지점 동일 버전 유지

MINOR. 마크다운 보고서를 단일 파일 HTML로 변환하는 moai-content:html-report 스킬을 신규 도입했습니다. Thariq Shihipar의 "unreasonable effectiveness of HTML" 사상을 기반으로, 외부 의존성 0개(한글 웹폰트 CDN 1개만 예외)로 12-25KB 산출물을 생성합니다. 6개 보고서 모드(status/incident/plan/explainer/financial/pr) + 6개 통합 테스트(executive-summary/financial-statements/sbiz365-analyst/daily-briefing 등 4종)를 포함합니다. 마켓플레이스 스킬 107 → 108개, 플러그인은 21개 유지. Breaking change 없음.

• moai-content:html-report — 마크다운 보고서를 단일 파일·자체 완결형 HTML로 변환하는 터미널 렌더러. Thariq HTML-effectiveness 아키텍처 기반, 외부 JS/CSS 프레임워크 의존성 0.
  • 6개 보고서 모드: status (주간 현황 / 태스크 리스트), incident (포스트모템 / 우발 대응), plan (구현 계획 / 사업 계획), explainer (기능 설명 / 개념 해설), financial (재무 보고 / 수익 동향), pr (PR 서사 / 관계자 알림)
  • 인라인 SVG + vanilla JS — 12-25KB 산출물, 페이지 로딩 거의 무영향. <script>, 이벤트 핸들러, 차트·테이블 인터랙션은 모두 inline.
  • 한글 폰트 매핑 — Pretendard (기본), Noto Serif KR (serif mode), Noto Sans KR (sans), 조선일보명조 (조선일보 수거), KoPubWorld 명조, JetBrains Mono (코드 블록). 모드별 자동 선택 또는 font_stack 오버라이드.
  • 인쇄 친화 — @media print 자동 적용, 페이지 나누기 최적화, 하이퍼링크 유지.
  • CSS 변수 계약 — --ivory, --slate, --clay, --oat, --olive, --sans, --serif, --mono 8개. 모드별 기본값 포함.
  • P1 컨슈머 4종 호환성 검증 — executive-summary, financial-statements, sbiz365-analyst, daily-briefing 모두 4/5 호환성 통과.
  • 6개 템플릿 + 6개 통합 테스트 + design-tokens.md (CSS 변수 명세) + fonts.md (폰트 매핑·CDN)
  • 옵션: mode, slug, output_path, font_stack, dark_mode
• 권장 체인 — 텍스트 산출물: [텍스트 스킬] → moai-core:ai-slop-reviewer → moai-content:humanize-korean → moai-content:html-report mode=<X>
• README attribution — moai-content/README.md에 Thariq Shihipar "unreasonable effectiveness of HTML" 아이디어 출처 표기.

• README.md: Version 배지 2.1.0 → 2.2.0, Skills 배지 107 → 108, v2.2.0 하이라이트 섹션 추가, 영문 description "21 plugins · 108 skills" 갱신
• moai-content/README.md: 10개 → 11개 스킬 표기, html-report 행 추가, 텍스트영상보고서 표현 갱신
• moai-content/.claude-plugin/plugin.json: description·keywords에 html-report·마크다운·보고서·렌더러·리포트 추가
• .claude-plugin/marketplace.json: metadata.version 2.1.0 → 2.2.0, moai-content description 갱신, 마켓플레이스 description "html-report 신규" 표기
• 전 SKILL.md version: 2.1.0 → version: 2.2.0 (108개, html-report 포함, Cowork 자동 업데이트 감지)
• 전 plugin.json version → 2.2.0 (21개)

• .claude-plugin/marketplace.json × 1 (metadata.version)
• <plugin>/.claude-plugin/plugin.json × 21 (version)
• <plugin>/skills/<skill>/SKILL.md × 108 (version, +1 신규 html-report 포함)
• 총 130 지점 동일 버전 유지

• 사용자 조치: /plugin marketplace update cowork-plugins 후 플러그인 상세 재진입
• Breaking change 없음 — 기존 워크플로우 그대로 동작
• 보고서 산출물이 필요할 때 html-report를 자연어로 호출하면 됩니다("주간 보고서 HTML로", "재무제표 HTML 변환" 등)

MINOR. 한국어 AI 티 정밀 윤문 도입 — epoko77-ai/im-not-ai v1.6.1 (MIT, ⭐937 stars) Fast 모드 단일 스킬 변형을 moai-content:humanize-korean으로 포팅했습니다. 기존 moai-core:ai-slop-reviewer는 그대로 유지되며, 권장 체인은 … → ai-slop-reviewer (1차 일반) → humanize-korean (2차 한국어 정밀) 입니다. 마켓플레이스 카운트 106 → 107 스킬, 플러그인은 그대로 21개. Breaking change 없음.

• moai-content:humanize-korean — 한국어 AI 티 정밀 윤문 스킬. 10대 카테고리 × 40+ 패턴 SSOT(ai-tell-taxonomy.md 40KB)를 S1/S2/S3 심각도로 분류하여 수술적 윤문. 의미 100% 보존 가드(고유명사·수치·날짜·인용 변경 금지, 변경률 30% 경고 / 50% 강제 중단), 자체검증 6항, A/B/C/D 등급 자동 판정. Python 표준 라이브러리만 쓰는 metrics.py(외부 의존 없음)로 사전·사후 정량 메트릭 측정.
  • 카테고리: A 번역투(~를 통해/~에 있어서/이중 피동), B 영어 인용 과다, C 구조 패턴(이모지·콜론 부제·연결어미 쉼표), D AI 관용구(결론적으로/시사하는 바·hype 어휘·결말 공식), E 리듬 균일성, F 한자어 -성/-적/-화 밀도, G hedging, H 문두 접속사 남발, I 형식명사 과다, J 시각 장식 남용
  • 산출물: _workspace/{run_id}/{01_input.txt, 00_metrics.json, final.md, summary.md, 06_metrics_after.json}
  • 옵션: 장르(칼럼/리포트/블로그/공적), 강도(보수/기본/적극), 최소심각도(S1/S2/S3)
  • 권장 체인: … → moai-core:ai-slop-reviewer → moai-content:humanize-korean
• references/strict-pipeline-spec.md — 원본의 7인 에이전트 Strict 5인 파이프라인 명세 보존(향후 독립 플러그인·Agent Teams 모드 확장 시 참조). 현재 스킬에서는 미사용.
• README attribution — 루트 README.md와 moai-content/README.md에 epoko77-ai/im-not-ai (MIT License, ⭐937) 출처 표기.

• README.md: Version 배지 2.0.0 → 2.1.0, Skills 배지 106 → 107, v2.1.0 하이라이트 섹션 추가, 영문 description "21 plugins · 107 skills"로 갱신
• moai-content/README.md: 9개 → 10개 스킬 표기, humanize-korean 행 추가
• moai-content/.claude-plugin/plugin.json: description·keywords에 humanize-korean·한국어윤문·AI티제거·humanize 추가
• .claude-plugin/marketplace.json: metadata.version 2.0.0 → 2.1.0, moai-content description 갱신, 마켓플레이스 description 한 줄 갱신
• 전 SKILL.md version: 2.0.0 → version: 2.1.0 (107개, Cowork 자동 업데이트 감지)
• 전 plugin.json version → 2.1.0 (21개)

• .claude-plugin/marketplace.json × 1 (metadata.version)
• <plugin>/.claude-plugin/plugin.json × 21 (version)
• <plugin>/skills/<skill>/SKILL.md × 107 (version, +1 신규 humanize-korean 포함)
• 총 129 지점 동일 버전 유지

• 사용자 조치: /plugin marketplace update cowork-plugins 후 플러그인 상세 재진입
• Breaking change 없음 — 기존 워크플로우 그대로 동작
• 한국어 텍스트 산출물에서 더 정밀한 윤문이 필요할 때 humanize-korean을 자연어로 호출하면 됩니다("AI 티 없애줘", "사람이 쓴 것처럼 윤문해줘", "한글 AI 윤문" 등)

• epoko77-ai/im-not-ai v1.6.1 (MIT License, ⭐937 stars) — taxonomy(40KB SSOT)·rewriting-playbook·quick-rules·metrics.py·baseline.json·web-service-spec·test_metrics.py 모두 원본 그대로 보존. SKILL.md만 cowork v2.0+ frontmatter 정책(version 단일 필드, metadata 블록 금지, user-invocable)과 단일 스킬 워크플로(에이전트 호출 제거)에 맞춰 재작성.
• 원본 라이선스(MIT)는 cowork-plugins MIT와 호환되며, 추가 의무 없음. NOTICE는 README attribution으로 대체(사용자 결정).

MAJOR. 한국 B2B 시장 특화 강화 릴리스 — NomaDamas/k-skill (MIT) 한국 특화 스킬 6종을 cowork에 포팅했습니다. 인터넷등기소 등기부등본 일괄 발급, 국토부 실거래가, 식약처 의약품·식품 안전, 법원경매 매각공고, KRX 시세, 바른한글 맞춤법 검수까지 — 한국 시장에서 즉시 ROI가 발생하는 도메인 특화 스킬을 한꺼번에 도입했습니다. 마켓플레이스 카운트 100 → 106 스킬, 플러그인은 그대로 21개.

• moai-legal:iros-registry-automation — 대법원 인터넷등기소(IROS) 법인·부동산 등기부등본 일괄 발급 보조. 로그인·결제는 사용자가 브라우저에서 직접 처리하고, 본 스킬은 장바구니 담기·결제 후 열람·저장·종합 리포트 생성을 보조합니다. 원 저작자 challengekim/iros-registry-automation (MIT) 참고. 실사·법무 검토·법인 일괄 관리에 핵심.
• moai-business:real-estate-search — 국토교통부(MOLIT) 실거래가/전월세 조회. 아파트·오피스텔·연립다세대·단독다가구·상업업무용 매매·전월세 시세를 NomaDamas k-skill-proxy 경유로 조회. 사용자 측 API 키 불필요. 원 저작자 참고: tae0y/real-estate-mcp.
• moai-commerce:mfds-safety — 식품의약품안전처(MFDS) 의약품·식품 안전 통합 체크. e약은요·안전상비의약품·건강기능식품 원료 인정현황·개별인정형·품목제조 신고·검사부적합·회수·판매중지를 통합 조회. 증상·복용/섭취 상황 인터뷰 우선, red flag 시 119·응급실 안내. 헬스/F&B 커머스 상품 검수 핵심.
• moai-finance:court-auction-search — 대법원 법원경매정보(courtauction.go.kr) 매각공고 조회. 매각기일·법원·기일/기간 입찰 기준 조회 + 사건번호 단건 조회. read-only, IP 차단 방지를 위해 호출당 약 2초 지연. 자산 처분·경매 투자·실사에 활용.
• moai-finance:korean-stock-search — KRX(한국거래소) 상장 종목 검색·기본정보·일별 시세. NomaDamas k-skill-proxy 경유로 사용자 KRX_API_KEY 발급 불필요. moai-business의 DART(공시)를 보완하는 시세 데이터.
• moai-content:korean-spell-check — 바른한글(구 부산대 맞춤법/문법 검사기) 표면을 이용한 한국어 최종 검수. 국립국어원 계열 규칙 반영. AI 패턴 검수(ai-slop-reviewer) 직후의 마지막 단계로 권장. 비상업·저빈도 사용 정책 명시.
• NOTICE.md — NOTICE.md에 NomaDamas/k-skill MIT attribution 섹션 추가. 6개 포팅 스킬과 원 저작자 링크 보존.
• CONNECTORS.md 신규/확장 — moai-commerce/CONNECTORS.md 신규(MFDS), moai-finance/CONNECTORS.md 신규(법원경매·KRX), moai-business/CONNECTORS.md에 MOLIT 실거래가 섹션 추가, moai-legal/CONNECTORS.md에 IROS 섹션 추가.

• 마켓플레이스 description 갱신 — v2.0.0 한국 특화 6종 도입 사실을 marketplace.json에 반영. 스킬 카운트 100 → 106.
• 버전 통일 22지점 — marketplace.json + 21개 plugin.json 모두 2.0.0으로 동기화.

• 사용자 측 영향 없음 (Breaking change 아님) — 신규 스킬 6종 추가일 뿐 기존 스킬·체인은 그대로 동작합니다.
• MAJOR bump 사유: 한국 B2B 시장 특화 도메인 도입은 cowork 정체성의 단계적 변화이므로 1.x → 2.x로 표기. 기능 호환성 손실은 없습니다.
• k-skill-proxy 의존 명시 — real-estate-search, mfds-safety, korean-stock-search는 NomaDamas 운영 hosted 프록시 경유. self-host가 필요하면 KSKILL_PROXY_BASE_URL 환경변수로 대체 가능.
• 사용자 측 시크릿 — 신규 6종 모두 사용자 측 API 키 발급 불필요. self-host 시에만 운영 측에서 DATA_GO_KR_API_KEY, FOODSAFETYKOREA_API_KEY, KRX_API_KEY 발급.

• 소스 리포지토리: NomaDamas/k-skill (MIT)
• 통합 어트리뷰션: NOTICE.md § NomaDamas k-skill (MIT)
• 원 저작자 보존:
  • challengekim/iros-registry-automation (iros)
  • tae0y/real-estate-mcp (real-estate)
  • jjlabsio/korea-stock-mcp (korean-stock)

PATCH. 정합성 동기화 릴리스 — 신규 플러그인 moai-bi·moai-pm·moai-sales 3종을 marketplace에 정식 등록하고, 온라인 문서·SKILL 내부 stale 참조를 일괄 정리했습니다. 신규 스킬 추가는 없습니다(다음 MINOR에서 추가 예정).

• 마켓플레이스 등록 +3 — moai-bi(BI 대시보드·경영진 1pager), moai-pm(주간보고·OKR), moai-sales(B2B 영업·제안서) 3개 플러그인이 marketplace.json plugins[]에 정식 추가됨. 마켓플레이스 카운트 18 → 21 플러그인.
• 신규 docs 페이지 3종 — docs-site/content/plugins/{moai-bi,moai-pm,moai-sales}.md 작성. 카탈로그에서 클릭 시 더 이상 404가 발생하지 않음.
• docs-site/content/cowork/constraints.md 신설 — 요금제·세션·플러그인·커넥터·Team/Enterprise 거버넌스 시스템 한도 한 페이지(Cowork 사용자 관점, 개발자용 Claude Code 개념 분리).
• docs-site/content/cowork/troubleshooting.md 전면 확장 — 6 섹션 → 10 섹션, 빠른 진단표 + 설치/폴더/스킬 호출/플러그인 설치/커넥터/세션/권한/프록시 종합.
• docs-site/content/cookbook/legal-nda-batch.md 신설 — NDA 일괄 검토 파이프라인 레시피(영업비밀보호법 §2 적용 명시).
• docs-site/content/plugins/moai-commerce.md 신설 — v1.8.0의 11스킬·8채널 풀세트 카탈로그 페이지.

• README — Plugins 배지 18 → 21, 한국어/영문 intro 문장 동기화.
• marketplace.json metadata.description — "18 플러그인, 100 스킬" → "21 플러그인, 100 스킬", bi/pm/sales 추가 안내.
• moai-media plugin.json description — Kling/Ideogram/ElevenLabs stale 표기 제거 → 실제 7스킬 기준 갱신.
• moai-media/README.md 전면 재작성 — 5스킬 카탈로그(kling/ideogram/elevenlabs/nano-banana/fal-gateway) → 7스킬 카탈로그(nano-banana/image-gen/video-gen/audio-gen/speech-video/character-mgmt/fal-gateway), 마이그레이션 안내 추가.
• moai-core/skills/project/SKILL.md·init-protocol.md — 미디어 스킬 매핑·API 키 안내를 7스킬 기준으로 갱신, kling→video-gen·elevenlabs→audio-gen 워크플로우 매핑.
• moai-commerce/skills/{detail-page-image,live-commerce}/SKILL.md — moai-media:ideogram/moai-media:kling 호출 안내를 nano-banana(한국어 타이포 SOTA)·video-gen·fal-gateway로 재정렬.
• moai-content/skills/landing-page/SKILL.md — 이미지 생성 스킬 안내에서 ideogram 제거.
• moai-media/skills/{nano-banana,image-gen}/SKILL.md — 관련 스킬 목록을 실재하는 7스킬 기준으로 갱신.
• docs-site/content/cowork/faq.md Q9 — 1M 컨텍스트 사실 추가, Claude Code CLI 명령(/clear) 표현을 Cowork 자연어 안내로 교체.
• 여러 cookbook/plugins 페이지 — 제거된 스킬 kling·ideogram·elevenlabs 직접 호출 표기를 실제 스킬명으로 일괄 정정 (skill-chaining, blog-pipeline, track-marketing, plugins/moai-content, plugins/moai-media).

• Claude Cowork ↔ Claude Code 개념 혼재 제거 — 사용자 문서 cowork/constraints.md·troubleshooting.md에 SLASH_COMMAND_TOOL_CHAR_BUDGET·run_in_background·/clear·.mcp.json JSON 편집 등 개발자 CLI 개념이 다수 섞여 있던 것을 발견·전면 재작성. 향후 재발 방지를 위한 19개 금지 토큰 자동 검사 메모리 등록.

사용자 측 갱신:

/plugin marketplace update cowork-plugins

이후 좌측 사이드바 → 사용자 지정 → 마켓플레이스 → cowork-plugins에서 moai-bi·moai-pm·moai-sales 신규 항목 확인 후 필요한 것만 설치하세요. 기존 17개 플러그인은 그대로 동작합니다 (Breaking change 없음).

• .claude-plugin/marketplace.json × 1
• moai-{bi,business,career,commerce,content,core,data,education,finance,hr,legal,lifestyle,marketing,media,office,operations,pm,product,research,sales,support}/.claude-plugin/plugin.json × 21

MINOR. moai-commerce 5 → 11 스킬 대폭 확장 — 한국 이커머스 풀세트로 진화. 자사몰(D2C) + 크라우드펀딩 + 큐레이션 + 라이브 커머스 + 통합 마케팅 전략·카피까지 한 플러그인에서 처리합니다. 큐텐 사태로 사실상 폐업한 티몬·위메프는 가이드에서 제외되었습니다.

• moai-commerce 6 신규 스킬:
  • marketplace-d2c — 카페24·아임웹·메이크샵 자사몰 빌더 통합 가이드(도메인·결제·배송·SEO·광고 채널 연동·D2C 운영 전략).
  • marketplace-crowdfunding — 와디즈·텀블벅 크라우드펀딩 프로젝트 기획·심사·운영(영상 시놉시스, 리워드 5단계 가격 구성, 메이커 등록).
  • marketplace-curation — 카카오 메이커스·무신사·29CM 큐레이션 채널 입점 제안(브랜드 소개서, 시너지 평가, MD 협업).
  • commerce-strategy — 통합 마케팅 전략(채널 믹스, 3단계 가격 구조, 시즌 프로모션 캘린더, 리텐션 자동화, KPI 대시보드).
  • commerce-copywriting — 이커머스 특화 광고·톡톡·푸시·이메일 카피(채널별 길이 제약, A/B 옵션 3개, ai-slop 자동 체이닝).
  • live-commerce — 네이버·카카오·그립·쿠팡 라이브 커머스 채널 가이드 + 30/60분 진행 스크립트(오프닝→상품→채팅→마감 카운트다운).
• marketplace-naver 정정 — 티몬·위메프 가이드 제거(큐텐 인수 후 2024년 미정산 사태로 회생절차 진입). 미정산 피해 셀러를 위한 archive 안내 표기.
• 마켓플레이스 카운트 18 플러그인, 94 → 100 스킬.

• moai-commerce/skills/marketplace-d2c/SKILL.md + references/{cafe24.md, imweb.md, d2c-strategy.md} + tests/test-cases.yaml.
• moai-commerce/skills/marketplace-crowdfunding/SKILL.md + references/{wadiz.md, tumblbug.md} + tests/test-cases.yaml.
• moai-commerce/skills/marketplace-curation/SKILL.md + references/{kakao-makers.md, musinsa.md, 29cm.md} + tests/test-cases.yaml.
• moai-commerce/skills/commerce-strategy/SKILL.md + references/{channel-mix.md, pricing.md, promotion.md, retention.md, kpi.md} + tests/test-cases.yaml.
• moai-commerce/skills/commerce-copywriting/SKILL.md + references/{ad-copy.md, talk-copy.md, push-copy.md, email-sequence.md} + tests/test-cases.yaml.
• moai-commerce/skills/live-commerce/SKILL.md + references/{naver-shoppinglive.md, kakao-shoppinglive.md, grip.md, coupang-live.md, live-script.md} + tests/test-cases.yaml.

• moai-commerce/skills/marketplace-naver/SKILL.md — 티몬·위메프 언급 제거, archive 안내 추가.
• moai-commerce/skills/marketplace-naver/references/openmarket-common.md — 티몬·위메프 표·정산·후기·시즌 칸 모두 제거. 큐텐 사태 archive 표기.
• moai-commerce/README.md — 11 스킬 카탈로그(상세페이지 3 / 채널 가이드 5 / 마케팅 3) + 표준 워크플로우 확장 + 채널 분류 표.
• .claude-plugin/marketplace.json — metadata.version 1.7.0 → 1.8.0, metadata.description "94 스킬" → "100 스킬", moai-commerce description 11 스킬 반영.
• 모든 <plugin>/.claude-plugin/plugin.json (21개) — version 1.7.0 → 1.8.0 일괄 동기화.
• README.md (루트) — Version 배지 1.7.0→1.8.0, Skills 94→100, v1.8.0 하이라이트 섹션 신설, moai-commerce 카탈로그 행 11 스킬로 갱신.

• marketplace-naver 가이드에서 티몬·위메프 모든 운영 항목(이미지 규격·상품명·후기·시즌·정산) 제거. 본 채널은 큐텐 인수 후 2024년 미정산 사태로 사실상 폐업·회생절차에 진입했습니다.

• 사용자 측 캐시 갱신: /plugin marketplace update cowork-plugins 실행 후 신규 스킬 활성화.
• 기존 워크플로우 영향 없음. Breaking change 없음. 기존 5개 스킬은 그대로 동작합니다.
• 티몬·위메프 운영 가이드를 참고하던 사용자: 채널 폐업으로 인해 가이드를 갱신하지 않습니다. 미정산 피해 셀러는 중소벤처기업부 피해 지원 또는 회생법원 공지 참조.

MINOR. 신규 플러그인 moai-commerce 추가 — 한국 이커머스 상세페이지(상폐) 자동화가 핵심입니다. 13섹션 감정여정 카피 생성, 1080×12720 단일 PNG 자동 합성, 쿠팡·네이버·오픈마켓 가이드를 한 번의 자연어 호출로 완성합니다.

• moai-commerce 신규 플러그인 신설 — 한국 이커머스 상세페이지 자동화 도메인 진입. 5개 스킬 + Pillow 자체 합성 스크립트 + 채널별 마켓 가이드 + 사진 촬영 브리프 풀세트 제공.
• detail-page-copy — 13섹션 감정여정(Hero→Pain→Problem→Story→Solution→How→Proof→Authority→Benefits→Risk→Compare→Filter→CTA) 카피 생성. 10개 카테고리(electronics/fashion/food/beauty/home/supplement/pet/kids/handmade/general) 어조 가이드. 출력 직전 ai-slop-reviewer 자동 체이닝 (HARD 규칙 준수).
• detail-page-image — 13섹션 이미지 프롬프트 생성 → moai-media:nano-banana 호출 → Pillow 단일 의존성으로 1080×12720 세로 합성 PNG 산출. 외부 패키지 설치 불필요. 부분 실패 시 다크 플레이스홀더 자동 대체(exit code 5).
• marketplace-coupang / marketplace-naver — 쿠팡 + 네이버 스마트스토어 + 11번가/G마켓/옥션/티몬/위메프 채널별 정책·검색 키워드·금지문구·우수상품 기준 적용.
• product-photo-brief — 상품 사진 1~14장 분석 → ProductDNA(physical/positioning/palette) 추출 → 13섹션별 사용 가능 컷 매핑 → 부족한 컷 우선순위별 추가 촬영 브리프 자동 생성.
• 마켓플레이스 카운트 17 → 18 플러그인, 89 → 94 스킬.

• moai-commerce/.claude-plugin/plugin.json — 신규 플러그인 매니페스트.
• moai-commerce/README.md — 5개 스킬 카탈로그 + 표준 워크플로우 + 13섹션 구조 표.
• moai-commerce/skills/detail-page-copy/SKILL.md — 13섹션 카피 + ai-slop 체이닝 스킬.
• moai-commerce/skills/detail-page-copy/references/13-sections.md — 섹션별 카피 가이드 (헤드라인 길이·금지 표현·예시 포함).
• moai-commerce/skills/detail-page-copy/references/category-briefs.md — 10개 카테고리 어조·키워드·금지 표현표.
• moai-commerce/skills/detail-page-copy/tests/test-cases.yaml — happy/edge/failure 3건.
• moai-commerce/skills/detail-page-image/SKILL.md — 이미지 프롬프트 + Pillow 합성 워크플로우 스킬.
• moai-commerce/skills/detail-page-image/scripts/compose.py — 13섹션 → 1080×12720 세로 합성 (Pillow 단일 의존성).
• moai-commerce/skills/detail-page-image/scripts/slice_bundle.py — 큰 번들 PNG → Y좌표 슬라이싱.
• moai-commerce/skills/detail-page-image/scripts/README.md — 스크립트 사용법.
• moai-commerce/skills/detail-page-image/references/sections-spec.md — 13섹션 높이 스펙 표 + 마켓별 권장 크기 비교.
• moai-commerce/skills/detail-page-image/references/image-prompts.md — 섹션별 비주얼 언어 + nano-banana 프롬프트 패턴.
• moai-commerce/skills/detail-page-image/tests/test-cases.yaml — happy/edge/failure 3건.
• moai-commerce/skills/marketplace-coupang/SKILL.md — 쿠팡 정책·SEO 가이드 스킬.
• moai-commerce/skills/marketplace-coupang/references/coupang-guidelines.md — 이미지 규격·금지문구·우수상품 기준·로켓배송 vs 판매자배송·정산.
• moai-commerce/skills/marketplace-coupang/tests/test-cases.yaml — happy/edge/failure 3건.
• moai-commerce/skills/marketplace-naver/SKILL.md — 네이버 스마트스토어 + 오픈마켓 통합 가이드 스킬.
• moai-commerce/skills/marketplace-naver/references/naver-smartstore.md — 스마트스토어 SEO·톡톡 운영·후기 정책.
• moai-commerce/skills/marketplace-naver/references/openmarket-common.md — 11번가/G마켓/옥션/티몬/위메프 채널별 정책 비교.
• moai-commerce/skills/marketplace-naver/tests/test-cases.yaml — happy/edge/failure 3건.
• moai-commerce/skills/product-photo-brief/SKILL.md — 사진 분석 + 추가 촬영 브리프 스킬.
• moai-commerce/skills/product-photo-brief/references/photo-checklist.md — 13섹션 컷 우선순위 + 카테고리별 필수 컷.
• moai-commerce/skills/product-photo-brief/tests/test-cases.yaml — happy/edge/failure 3건.

• .claude-plugin/marketplace.json — metadata.version 1.6.0 → 1.7.0, metadata.description "17 플러그인 86 스킬" → "18 플러그인 94 스킬", plugins[] 배열에 moai-commerce 항목 추가.
• 모든 <plugin>/.claude-plugin/plugin.json (21개) — version 1.6.0 → 1.7.0 일괄 동기화.
• README.md (루트) — Version 배지 1.6.0→1.7.0, Plugins 17→18, Skills 85→94, v1.7.0 하이라이트 섹션 신설, 카탈로그 테이블에 moai-commerce 행 추가, "총 산출물" 표 갱신.
• CHANGELOG.md 버전 통일 원칙 — 18 → 19개 지점 (plugin.json 17 → 18로 확장).

• 사용자 측 캐시 갱신: Claude Cowork에서 /plugin marketplace update cowork-plugins 실행 후 moai-commerce 활성화.
• detail-page-image 스킬 사용 시: pip install Pillow (또는 uv pip install Pillow) 한 번 실행 필요. 다른 의존성 없음.
• 기존 워크플로우 영향 없음. Breaking change 없음.

MINOR. skill-forge → skill-builder 이름 변경 + skill-tester self-contained 화 + moai-office에 pdf-writer 신규 스킬 추가가 핵심입니다. PDF 생성 시 한·중·일·영 다국어 글리프 깨짐 문제를 PyMuPDF + Noto Sans CJK 자동 다운로드 조합으로 근본 해결합니다.

• skill-forge → skill-builder 이름 변경 (Breaking for direct skill-name references) — 의미 불명확한 forge 어휘를 표준 builder로 전환. 별칭은 유지되지 않으며 모든 트리거·문서 참조가 skill-builder로 즉시 대체되었습니다. 외부 사용자가 skill-forge를 슬래시 커맨드로 직접 호출하던 경우 skill-builder로 변경 필요.
• skill-tester 단독 self-contained 화 — 4차원 스코어링 루브릭(Correctness 30 / Completeness 25 / Clarity 25 / Efficiency 20)과 체인 검증 프로토콜을 skill-tester SKILL.md 본문에 직접 흡수. 이제 skill-tester 한 번 로드로 모든 평가 기준이 즉시 가용 — single source of truth 선언.
• moai-office:pdf-writer 신규 스킬 — PyMuPDF + Noto Sans CJK(KR 변형) 조합으로 한·중·일·영 다국어 PDF를 깨짐 없이 생성. Markdown / 구조화 JSON / HTML / 일반 텍스트 4종 입력 지원, A4 규격 + 서브셋 임베딩. 폰트 64MB는 저장소에 포함하지 않고 최초 실행 시 scripts/download_fonts.py가 notofonts/noto-cjk 공식 저장소에서 자동 다운로드(SIL OFL 1.1).

• moai-core/skills/skill-builder/SKILL.md — skill-forge에서 이름 변경된 6-Phase 생성 스킬. 트리거 키워드 skill-builder, harness 워크플로우 추가.
• moai-core/skills/skill-tester/SKILL.md § 스코어링 루브릭 (4차원 anchor 점수표, Tier별 통과 기준, anti-pattern audit 체크리스트) + § Mode 3 체인 테스트 (Chain Definition Format, 4가지 Test Design Rule, Known Chains 매핑) 본문 직접 포함.
• moai-office/skills/pdf-writer/SKILL.md — 한·중·일·영 다국어 PDF 생성 스킬. 트리거 키워드: 한글 PDF, 한국어 PDF, 일본어 PDF, 중국어 PDF, 다국어 PDF, CJK PDF, Markdown PDF, PyMuPDF, Noto Sans CJK 등 13종.
• moai-office/skills/pdf-writer/scripts/download_fonts.py — 표준 라이브러리만 사용하는 폰트 자동 다운로드 스크립트. --check / 기본 / --force 3가지 모드, OTF 매직바이트 무결성 검증.
• moai-office/skills/pdf-writer/tests/test-cases.yaml — 5건 테스트 케이스(happy path / JSON+표 / 한영 혼용 / 일반 텍스트 / 한·중·일·영 4언어 혼용).
• moai-office/skills/pdf-writer/assets/fonts/{LICENSE.txt, README.md, .gitignore} — SIL OFL 1.1 라이선스 전문 + 출처·갱신 절차 문서화 + .otf/.ttf/.ttc 제외 규칙.

• 18지점 버전 동시 bump: marketplace.json × 1 + plugin.json × 17 모두 1.5.1 → 1.6.0.
• moai-core/skills/skill-forge/ 디렉토리 삭제, moai-core/skills/skill-builder/로 대체.
• docs-site/content/releases/v1.5.md, docs-site/content/plugins/moai-core.md, docs-site/content/plugins/_index.md — skill-forge → skill-builder 표기 일괄 갱신.
• README.md — Skills 배지 73 → 85 (skill-builder rename + pdf-writer 추가 반영), v1.6.0 하이라이트 섹션 갱신.
• .claude-plugin/marketplace.json — moai-office description에 PDF 추가.
• moai-office/README.md — 헤더 설명 갱신(+PDF), 스킬 테이블에 pdf-writer 행 추가, 의존성 표에 PyMuPDF + Noto Sans CJK 추가.

• moai-core/skills/skill-forge/ 전체 (디렉토리 rename으로 대체).

• skill-forge를 직접 호출하던 사용자/에이전트 → skill-builder로 변경 필요.
• 외부 사용자는 /plugin marketplace update cowork-plugins 후 플러그인 상세 재진입.
• pdf-writer 최초 사용 시 64MB(Noto Sans CJK 4 weight) 자동 다운로드가 1회 발생합니다. 네트워크 미연결 환경은 사전에 python3 moai-office/skills/pdf-writer/scripts/download_fonts.py 수동 실행으로 캐싱 가능.

PATCH 릴리스. 저장소 위생 강화 + 한국어 문서 사이트 정식 안내가 핵심입니다. 스킬·플러그인 수 변경 없음 (73 / 17 그대로), Breaking change 없음.

• 한국어 문서 사이트 cowork.mo.ai.kr 정식 오픈 안내 — Hugo + Geekdoc로 구축된 한국어 문서 사이트가 v1.5.0 코드와 함께 배포되어 정식 운영 중. 루트 README에 배지·하이라이트 링크를 추가했습니다. Cookbook 28편(블로그 파이프라인, 사업계획서, 계약서 검토, IR 덱, 리포트 자동화, 스킬 체이닝, 트랙별 가이드 등) + Cowork 입문/FAQ/용어집 수록.
• 저장소 위생 강화 (CRITICAL) — .gitignore에 maintainer workspace 차단 블록을 추가했습니다. 정비자(maintainer)의 개인 작업 환경(CLAUDE.md, CLAUDE.local.md, .mcp.json, .claude/, .moai/)이 의도치 않게 공개 마켓플레이스에 유출되는 사고를 원천 차단합니다. 특히 CLAUDE.local.md에는 정비자 이메일과 GitHub Release 자동화 스크립트가 포함되어 있어 단 한 번의 git add -A 사고로 유출될 수 있었습니다.

• README.md — Version 배지 1.5.0 → 1.5.1, 신규 Docs 배지(cowork.mo.ai.kr) 추가, v1.5.1 하이라이트 섹션 신설.
• .gitignore — 최하단에 "Maintainer Workspace (NOT distributed)" 블록 추가 (5개 패턴: CLAUDE.md, CLAUDE.local.md, .mcp.json, .claude/, .moai/).
• 18지점 버전 동시 bump: marketplace.json × 1 + plugin.json × 17 모두 1.5.0 → 1.5.1.

• git status에 영구 노출되던 untracked 4건(.claude/, .moai/, CLAUDE.md, .mcp.json)을 ignore 처리하여 워크플로우 노이즈 제거.
• .gitignore에 CLAUDE.local.md 패턴 누락으로 인한 잠재적 개인정보 유출 위험 해소.

해당 없음.

• 기존 v1.5.0 사용자는 별도 마이그레이션 불필요.
• 사용자 측 캐시 갱신: /plugin marketplace update cowork-plugins 후 플러그인 상세 재진입.
• 본 저장소를 fork·clone하여 기여하는 분은 git pull 후 워킹 트리의 .claude/·.moai/·CLAUDE.md·.mcp.json·CLAUDE.local.md가 자동으로 ignore됩니다(이미 commit된 적 없으므로 손실 없음).

공식 MINOR 릴리스. moai-business 플러그인에 소상공인·창업자 실무 지원 스킬 2종을 추가하여 총 스킬 개수가 71 → 73으로 확장됩니다. 두 스킬 모두 Category A(user-invocable: true)로 슬래시 명령 자동완성을 지원하고, 사용자 언어의 트리거가 풍부해 자연어로도 자동 호출됩니다.

• 소상공인365 상권분석 자동화 — bigdata.sbiz.or.kr PDF 한 장을 첨부하면 4문 인터뷰 후 창업 타당성 100점 평가 + 9섹션 DOCX 보고서를 자동 생성합니다.
• 정부지원사업 통합 도우미 — K-Startup, BIZINFO, 중기부, 창진원, 문체부, 농식품부 등 주요 공고를 한 번에 탐색하고 사업계획서 초안까지 작성합니다.
• Anthropic 공식 스킬 우선순위 반영 — 두 스킬 모두 DOCX/XLSX 생성 시 anthropic-skills:docx · anthropic-skills:xlsx 우선, AI 슬롭 검수도 anthropic-skills:ai-slop-reviewer 우선 정책을 내장했습니다.

• moai-business/skills/sbiz365-analyst/ 신규 스킬 (Category A) — 소상공인365 PDF 기반 상권 트렌드 분석 + 창업 타당성 종합 보고서.
  • Step 0~5 워크플로우: PDF 확인 → 4문 AskUserQuestion(업종·목적·예산·중점) → PDF 데이터 추출 → 5대 분석(유동인구·매출·경쟁·입지·타당성) → 9섹션 DOCX → AI 슬롭 검수.
  • 4축 100점 평가 체계: 성장성(30) + 경쟁 적합도(25) + 수요 매칭도(25) + 재무 타당성(20).
  • references/{analysis-guide, data-fields, feasibility-scoring, report-template}.md 4종 레퍼런스 포함.
• moai-business/skills/kr-gov-grant/ 신규 스킬 (Category A) — 대한민국 정부·공공기관 지원사업 통합 분석 및 신청서 작성.
  • 4 MODE 구조: ① 탐색·추천 / ② 신청서 초안 작성 / ③ 서류 검토 / ④ 일정 관리.
  • 8개 신청자 유형 × 7개 지원 카테고리(창업/소상공인/R&D/문화관광/농식품/사회적경제/지자체 등) 매핑 데이터베이스.
  • 예비창업패키지·TIPS·전통시장 활성화·중소기업 R&D·관광벤처 등 사업별 항목 구조 템플릿 탑재.
  • references/programs.md 상세 프로그램 카탈로그.

• moai-business/.claude-plugin/plugin.json
  • description 갱신: "사업계획서, 시장조사, 재무모델, IR, 상권분석, 정부지원사업"으로 확장.
  • keywords 확장: 상권분석·창업타당성·소상공인365·정부지원사업·K-Startup·BIZINFO·창업지원·지원금 추가.
• .claude-plugin/marketplace.json
  • metadata.description 갱신: "71 스킬" → "73 스킬", v1.5.0 하이라이트 추가.
  • moai-business 엔트리 설명 갱신: 신규 스킬 범위 반영.
• kr-gov-grant vs moai-research:grant-writer 스코프 분리 명시 — 전자는 범용 지원사업 전반, 후자는 학술·연구 중심 NRF/IITP 과제.

• 두 스킬 모두 user-invocable: true 플래그를 포함하여 /sbiz365-analyst, /kr-gov-grant 슬래시 자동완성이 활성화됩니다.
• 두 스킬의 텍스트 산출물(보고서·사업계획서·검토 피드백)은 모두 AI 슬롭 검수로 종료되며, Anthropic 공식 스킬이 있으면 우선 사용합니다.
• 사용자는 릴리스 후 /plugin marketplace update cowork-plugins 실행이 필요합니다.

공식 MINOR 릴리스. HTML·웹 산출물의 shadcn/ui 기본 스택 전환 + 소크라테스식 테마 인터뷰 도입. 사용자가 코드 한 줄도 쓰지 않고도 자신의 브랜드·취향에 맞는 shadcn 베이스 팔레트·컬러 모드·모서리 반경·효과를 선택할 수 있도록 AskUserQuestion 흐름을 표준화.

• shadcn/ui가 HTML/웹 산출물 기본 스택 — Next.js 15 + Tailwind v4 + shadcn/ui + Lucide + Framer Motion 조합이 기본.
• 소크라테스식 테마 인터뷰 공통 프로토콜 — 랜딩·상세·대시보드 3개 스킬이 동일한 4문항 질문 패턴 공유.
• OKLCH CSS 변수 기본 출력 — Light/Dark 모드 동시 산출, shadcn 공식 :root + .dark 구조 준수.
• Recharts/Chart.js/Tremor/ECharts 4택 1 — 차트·대시보드 산출 시 사용자가 직접 선택.

• moai-content/skills/landing-page/references/landing-page/shadcn-theme-interview.md 신규 레퍼런스 — shadcn 테마 인터뷰 프로토콜, AskUserQuestion payload 설계, OKLCH CSS 변수 템플릿, Fallback 기본값, 브랜드 컬러 오버라이드 가이드, 스킬별 적용 포인트 수록.
• landing-page 스킬: 실행 워크플로우에 0단계 shadcn 테마 인터뷰(HARD) 추가 — Q1 베이스 팔레트 / Q2 컬러 모드 / Q3 모서리 반경 / Q4 효과(multiSelect) / Q5 차트 라이브러리(조건부).
• landing-page 스킬: 섹션 구성을 shadcn 공식 블록(Hero / Features / Pricing / FAQ / Testimonial)에 매핑.
• product-detail 스킬: 0단계 shadcn 테마 인터뷰(HARD) 추가 — 플랫폼별 분기(스마트스토어·쿠팡은 단일 HTML 인라인, 자사몰·SaaS는 Next.js+shadcn) 명시.
• product-detail 스킬: shadcn 컴포넌트 매핑 섹션 신설 — Select/ToggleGroup/Tabs/Accordion/Badge/Button/Card 연결.
• data-visualizer 스킬: HTML·React 대시보드 산출 시 shadcn 테마 인터뷰(HARD) + 차트 라이브러리 선택 가이드 추가.
• 모든 카피 JSON 출력에 theme 블록 추가 (system, base, mode, radius, effects, chart_lib).

• 기본 스타일 스택: 3개 HTML/웹 스킬(landing-page, product-detail, data-visualizer) 모두 shadcn/ui를 기본값으로 채택. 별도 지정이 없으면 Next.js 15 + Tailwind v4 + shadcn/ui로 산출.
• landing-page description에 "shadcn/ui 기반"과 "소크라테스식 테마 인터뷰" 트리거 문구 명시.
• product-detail description에 동일한 shadcn 인터뷰 언급 추가.
• data-visualizer description에 Recharts/Chart.js/Tremor/ECharts 4택 1 문구 명시.
• product-detail 실행 규칙에 shadcn 테마 인터뷰 단계 삽입 (기존 6단계 → 8단계).
• landing-page 색상·타이포·컴포넌트 정의를 shadcn OKLCH 토큰(--primary, --accent, --muted-foreground 등)으로 표준화.
• 마켓플레이스 description에 v1.4.0 하이라이트 문구 추가.

1. /plugin marketplace update cowork-plugins로 v1.4.0 갱신.
2. 기존 랜딩/상세/대시보드 프로젝트를 재생성하고 싶으면 다시 "랜딩 페이지 만들어줘" 등으로 호출 — 새 테마 인터뷰가 먼저 실행됨.
3. 인터뷰를 건너뛰고 기본값으로 빠르게 생성하려면 --quick 또는 "그냥 기본으로" 플래그를 사용.
4. 기존 Framer/Webflow/Wix 요청은 사용자가 명시적으로 지정하면 shadcn이 아닌 해당 플랫폼 스펙으로 자동 전환됨(동작 동일).
5. 브랜드 컬러가 이미 있는 경우: shadcn 베이스 팔레트를 뉴트럴 스캐폴드로 사용하고 --primary·--accent·--ring 세 토큰만 오버라이드 — 인터뷰 중 사용자가 브랜드 컨텍스트를 제시하면 자동 적용.

• moai-core:ai-slop-reviewer 스킬 신규 도입 — Claude가 생성한 텍스트의 AI 패턴(금지어, 획일적 문장 구조, AI식 도입/결말, 과도한 목록화, 수동태 남용 등)을 진단하고 인간적인 톤으로 수정. 모든 텍스트 산출물 워크플로우의 필수 마지막 단계.
• 스킬 체이닝 기반 /project init 워크플로우 — 사용자 업무 인터뷰 → 설치 플러그인 감지 → 산출물별 스킬 체인 설계 → 사용자 확인 → CLAUDE.md 생성. 40+ 산출물 프리셋 체인(사업계획서, IR 덱, 블로그, 랜딩, 계약서, 특허 등) 제공.
• CLAUDE.md 외부 템플릿화 — moai-core/skills/project/references/templates/CLAUDE.md.tmpl 도입. {workflow_chains}, {primary_deliverables}, {tone_constraints} 등 변수 슬롯 기반.
• HARD 규칙 블록 고정 포함 — 생성된 모든 CLAUDE.md에 "문서·콘텐츠 생성 우선순위(moai-office/content 우선)" + "AI 슬롭 후처리" 규칙이 강제 포함됨.

• 커맨드 이름 변경: /moai → /project (init, catalog, status, apikey, feedback 등 모든 서브커맨드).
  • 이유: Claude Code 프로젝트 레벨 스킬(.claude/skills/moai/)이 플러그인 스킬을 shadowing하여 /moai Tab 자동완성이 동작하지 않던 문제 해소.
  • 사용자 영향: 기존 /moai init 사용자는 /project init으로 변경 필요. /plugin marketplace update cowork-plugins로 갱신 후 적용.
• 스킬 폴더 이동: moai-core/skills/moai/ → moai-core/skills/project/.
• 버전 단일 소스화 — SKILL.md metadata: 블록 전면 삭제, plugin.json version 필드가 유일한 버전 원천. 동기화 지점 88개 → 18개로 축소.
• SKILL.md frontmatter 규격 단순화 — 슬래시 호출 스킬: name + description + user-invocable: true. 모델 자동 호출 스킬: name + description만. 그 외 필드 금지.
• /project init AskUserQuestion 회수 감소: 최대 9회 → 최대 6회.

• 글로벌 프로필 시스템 전면 제거
  • moai-core/skills/project/references/core/profile-manager.md 삭제.
  • moai-profile.md 파일 생성 중단.
  • [MoAI 프로필] 글로벌 지침 텍스트 안내 제거.
  • /project init Phase 0 (프로필 감지), Phase 1 (이름/회사 수집) 삭제.
  • 이유: 프로젝트마다 동일한 정보를 반복 질문하던 UX 문제 해소. 사용자 정보가 필요한 경우 CLAUDE.md 한 곳에 기록.
• SKILL.md metadata: 블록 (version/status/updated/tags) — 69개 파일에서 일괄 제거.

• /moai Tab 자동완성이 Claude Code 내부 moai 스킬과 충돌해 동작하지 않던 이슈 (커맨드 이름 변경으로 해결).

1. /plugin marketplace update cowork-plugins 실행 후 플러그인 갱신.
2. 기존 사용하던 /moai init, /moai catalog, /moai status, /moai apikey, /moai feedback → /project init 등으로 교체.
3. 기존 프로젝트 CLAUDE.md의 /moai ... 참조를 /project ...로 바꾸거나, /project init을 다시 실행해 최신 템플릿으로 재생성 권장.
4. [MoAI 프로필] 글로벌 지침을 유지하고 싶은 경우: Cowork Settings > 글로벌 지침에 수동 보존(자동 참조는 중단됨). 불필요하면 제거해도 기능 영향 없음.

## [X.Y.Z] - YYYY-MM-DD

### Added
- 신규 기능/스킬/플러그인 추가 사항 (파일 경로 포함)

### Changed
- 기존 기능 동작/인터페이스 변경 사항 (이유 명시)

### Deprecated
- 다음 메이저 릴리스에서 제거 예정인 기능

### Removed
- 이번 릴리스에서 삭제된 기능/파일

### Fixed
- 버그 수정 내역 (증상 → 원인 → 해결)

### Security
- 보안 취약점 수정 (CVE 번호 있으면 명시)

### Breaking
- 사용자 조치 필요 사항 (마이그레이션 가이드 포함)

### Migration
- 업그레이드 절차 (필수 명령어, 설정 변경)

작성 규칙:

• 모든 항목은 사용자가 체감할 변화 기준으로 서술 (내부 리팩터는 생략 가능)
• 파일 경로는 백틱으로 감싸기: moai-core/skills/moai/SKILL.md
• 증상/원인/해결을 명확히 분리하여 기술
• 관련 커밋·이슈·PR 번호가 있으면 (#123, abc1234) 형식으로 부기

공식 MINOR 릴리스. v1.1.0~v1.1.3의 점진적 변경을 안정 버전으로 집약하여 배포.

• 신규 플러그인 moai-media — AI 미디어 스튜디오 (이미지·영상·음성 통합)
• Google Nano Banana 공식 전환 — Imagen 4 → Gemini 3 Image Preview (Pro + 2 체제)
• 영상은 Kling 단일화 — fal.ai 기반 숏폼·립싱크 커버
• 음성은 ElevenLabs 공식 MCP — TTS, 32개 언어 더빙, ConvAI
• fal.ai 게이트웨이 — Flux·Recraft·Hailuo·Luma·Pika·MiniMax Music 1000+ 모델 단일 접점
• 전 저장소 버전 통일 88 지점 → 1.2.0

• 플러그인 moai-media (5 스킬)
  • nano-banana: Google Gemini 3 Image Preview 공식 2종 (gemini-3-pro-image-preview, gemini-3.1-flash-image-preview)
  • ideogram: Ideogram 3.0 한국어 타이포 (fal.ai)
  • kling: Kling 3.0 숏폼 영상 (fal.ai, 립싱크·다국어)
  • elevenlabs: ElevenLabs 공식 MCP (TTS·음성복제·더빙·ConvAI)
  • fal-gateway: fal.ai 1000+ 모델 통합 게이트웨이
• 번들 MCP 서버 2종 (moai-media/.mcp.json)
  • fal-ai (hosted HTTP MCP at https://mcp.fal.ai/mcp)
  • elevenlabs (local stdio via uvx elevenlabs-mcp)
• API 키 3종 통합 지원
  • GEMINI_API_KEY (nano-banana 전용 + 레거시 NANO_BANANA_API_KEY 호환)
  • FAL_KEY (ideogram / kling / fal-gateway 공유)
  • ELEVENLABS_API_KEY (elevenlabs)
• moai-media/scripts/generate_image.py v4.3 — Python 3.13+ 타입힌트, REST camelCase 준수, 서로게이트 sanitize
• 문서: CLAUDE.local.md § 4 MCP 번들 정책, § 5 외부 API 모델 ID 업데이트 정책
• 루트 README.md 전면 갱신 (17 플러그인 / 70 스킬 / moai-media 상세 섹션)

• 공식 Nano Banana 2종 체제 확정
  • nano-banana-pro → gemini-3-pro-image-preview (2K 기본, 텍스트 SOTA)
  • nano-banana-2 → gemini-3.1-flash-image-preview (1K 기본, 비용 효율)
  • Ultra·cheap·2.5-flash 등 부가 별칭은 제거 → Pro/2로 자동 승격 (코드 무수정 호환)
• API 호출 스펙 (공식 문서 ai.google.dev/gemini-api/docs/image-generation 100% 정합)
  • 엔드포인트 :predict → :generateContent
  • 페이로드 numberOfImages + top-level aspectRatio → imageConfig.aspectRatio + imageSize
  • REST 응답 predictions[].bytesBase64Encoded → candidates[].content.parts[].inlineData.data
  • 화면비 공식 14종 (1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 1:4, 4:1, 1:8, 8:1)
  • 해상도 "512" / "1K" / "2K" / "4K"
• generate_image.py 이관: moai-content/scripts/card-news/ → moai-media/scripts/ (v3.0 Imagen 4 → v4.3 Gemini 3 Image Preview)
• moai-content/skills/card-news/SKILL.md: 이미지 생성을 moai-media/nano-banana 위임 구조로 전환
• moai-core/skills/moai/references/core/init-protocol.md: API 키 테이블 4개 → 6개 확장
• .claude-plugin/marketplace.json: moai-media 엔트리 추가

• Veo 3.1 관련 참조 (영상은 Kling 단일화)
• gemini-2.5-flash-image 모델 매핑
• nano-banana-ultra 별칭 및 ULTRA_ALIASES 상수
• moai-content/scripts/card-news/ 디렉토리 (moai-media로 이관)
• v1.0.x 잔존 로컬 태그 (v1.1.0~v1.3.0) — marketplace 버전 체계와 불일치하여 정리

v1.0.x 사용자 조치 3단계:

1. 마켓플레이스 새로고침

   /plugin marketplace update cowork-plugins
   /plugin install moai-media@cowork-plugins
   

2. Gemini API 업그레이드

   • Pay-as-you-go 결제 활성화 필수 (Nano Banana Pro/2 Free Tier 불가)
   • NANO_BANANA_API_KEY 그대로 사용 가능 (자동 인식), 혹은 GEMINI_API_KEY로 재명명 권장

3. 신규 API 키 (선택, moai-media 전체 사용 시)

   • FAL_KEY — fal.ai/dashboard/keys ($5 무료 크레딧)
   • ELEVENLABS_API_KEY — elevenlabs.io/app/settings/api-keys (무료 10K char)
   • uv 설치 (ElevenLabs MCP용): curl -LsSf https://astral.sh/uv/install.sh | sh

• 이미지 모델 ID 변경: 기존 imagen-4.0-* 하드코딩은 Pro/2로 자동 승격되나, 장기적으로 gemini-3-pro-image-preview / gemini-3.1-flash-image-preview 직접 사용 권장
• 엔드포인트 변경: 자체 스크립트를 복사·수정하여 사용하던 사용자는 :predict → :generateContent 및 페이로드 스키마 업데이트 필요 (참고: moai-media/scripts/generate_image.py v4.3)
• 무료 티어 불가: Gemini 무료 키로 Nano Banana 호출하던 워크플로우는 Pay-as-you-go 전환 필요
• google-media 스킬 경로 없음: v1.1.0 잠깐 존재했던 moai-media/skills/google-media/ 경로는 nano-banana로 개명됨 (v1.1.0 직후 설치한 극소수 사용자만 해당)

v1.2.0에 집약된 중간 릴리스:

• v1.1.0: moai-media 초기 릴리스 (6 스킬, google-media 포함)
• v1.1.1: google-media → nano-banana 개명, Veo 제거, 화면비 공식 14종 정정
• v1.1.2: Pro + 2 체제로 축약 (gemini-2.5-flash-image 제거)
• v1.1.3: nano-banana-ultra 제거, Ultra 별칭 자동 승격

• nano-banana-ultra 별칭 제거 — 공식 라인업을 Pro + 2 단 두 가지로 최종 확정
• ULTRA_ALIASES 상수 및 is_ultra 분기 로직 삭제 (scripts/generate_image.py)
• 4K 해상도 자동 선택 로직 제거 — 필요 시 스크립트에서 imageSize 직접 지정
• moai-content/skills/card-news/SKILL.md의 Ultra 옵션 제거

• 자동 승격 테이블 확장 (무수정 호환)
  • "nano-banana-ultra", "ultra" → gemini-3-pro-image-preview (Pro로 승격)
  • "nano-banana", "cheap" → Pro / 2로 승격 (v1.1.2 동일)
• 경고 메시지 개선: 제거된 별칭 사용 시 자동 전환 사실을 stderr로 명시
• generate_image.py v4.2 → v4.3 — MODEL_MAP·해상도 선택 로직 단순화
• nano-banana SKILL.md 비용 표 Pro/2 기준으로 재작성

기존 nano-banana-ultra 호출 코드는 무수정 작동 — 자동으로 Pro 2K로 처리되며 경고 출력. 4K가 필요하면 스크립트에서 imageSize 필드를 직접 "4K"로 수정.

• nano-banana 스킬 공식 모델 2종 체제로 단순화
  • 공식 라인업: nano-banana-pro (gemini-3-pro-image-preview) + nano-banana-2 (gemini-3.1-flash-image-preview) 두 가지만
  • nano-banana-ultra는 Pro의 4K 프리셋 (별도 모델 아님)
  • v1.1.1에서 도입한 gemini-2.5-flash-image (원조 Nano Banana) 제거 — 사용자 혼선 방지
• 레거시 별칭 자동 승격
  • "nano-banana" 별칭 → gemini-3-pro-image-preview (v1.1.1에서는 gemini-2.5-flash-image)
  • "cheap" 별칭 → gemini-3.1-flash-image-preview (v1.1.1에서는 gemini-2.5-flash-image)
  • 사용자 코드 무수정 작동 보장
• image_size 필수 적용 — 모든 요청에 imageConfig.imageSize 포함 (2.5-flash 미지원 케이스 삭제)
• generate_image.py v4.1 → v4.2 — MODEL_MAP 정리, is_ultra 로직 단순화

• README 스킬 설명 "Pro/2/원조" → "Pro + 2, 2종만"으로 정확화
• SKILL.md 모델 카탈로그 표를 Pro/2/Ultra 3행으로 축소

기존 사용자 조치 없음. nano-banana / cheap 별칭을 쓰던 코드는 그대로 작동 (자동 승격).

• moai-media 스킬 구조 개편 (Google 공식 문서 재확인 반영)
  • google-media 스킬 → **nano-banana**로 개명 및 이미지 전용으로 스코프 축소
  • 영상 생성은 kling 스킬로 단일화 — Veo 3.1 참조 모두 제거
  • 결과: 이미지는 nano-banana (Gemini) / ideogram (fal.ai), 영상은 kling 단독
• Gemini 이미지 모델 카탈로그 공식화 (공식 문서 ai.google.dev/gemini-api/docs/image-generation 기준)
  • gemini-2.5-flash-image 모델 신규 추가 — 원조 Nano Banana, 최저가 $0.039/img
  • nano-banana 별칭 매핑: → gemini-2.5-flash-image
  • 모델 별 기본 해상도 자동 선택: Pro=2K, 2=1K, 원조=디폴트, Ultra=4K
• 공식 화면비 14종 리스트 재정의
  • 구 리스트 (잘못됨): 9:21, 3:5, 2:1, 1:2 포함
  • 신 리스트 (공식): 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 1:4, 4:1, 1:8, 8:1
• REST API 페이로드 정합화
  • camelCase로 통일 (responseModalities, imageConfig, aspectRatio, imageSize) — 공식 REST 스펙 준수
  • 응답 파싱은 inlineData 우선, inline_data 폴백
  • imageSize 지원 값 공식화: "512", "1K", "2K", "4K" (이전에 "512" 누락)
• generate_image.py v4.0 → v4.1
  • 위 변경사항 반영, MODEL_MAP에 "nano-banana" / "cheap" 별칭 추가
  • gemini-2.5-flash-image는 image_size 미지원 → 페이로드에서 생략 처리 로직 추가

• 공식 문서 불일치 수정 — 기존 v1.1.0에서 파생 지식 기반으로 작성한 화면비 리스트가 공식 스펙과 달랐음. WebFetch로 공식 문서 재확인 후 전면 정정.
• moai-core/init-protocol.md의 "moai-media/google-media 스킬" 참조를 nano-banana로 수정

• moai-media/skills/google-media/ 스킬 디렉토리 전체 (→ nano-banana로 개명)
• Veo 3.1 관련 모든 참조:
  • README.md 스킬 카탈로그·영상 선택 가이드
  • CONNECTORS.md API 설명
  • plugin.json keywords ("veo" 제거)
  • marketplace.json 플러그인 description
  • 기타 SKILL.md 크로스 레퍼런스
• plugin.json keywords에서 "veo" 제외

v1.1.0에서 방금 설치한 사용자도 즉시 업데이트 필요:

/plugin marketplace update cowork-plugins

기존 google-media 호출 코드가 있다면 **nano-banana**로 경로 변경:

• 스킬 호출: /moai-media google-media → /moai-media nano-banana
• SKILL.md 참조: moai-media/skills/google-media/ → moai-media/skills/nano-banana/

영상 생성이 필요하면 kling 스킬 사용:

• 숏폼·릴스·쇼츠: fal-ai/kling-video/v3/text-to-video
• 립싱크 프리미엄: Kling Pro 모드

• 스킬 경로 변경: moai-media/skills/google-media/ → moai-media/skills/nano-banana/
• Veo 사용 불가: v1.1.0에서 veo-3.1-generate-preview 호출하던 워크플로우는 kling 또는 외부 Veo 직접 호출로 마이그레이션 필요

• 신규 플러그인 moai-media — AI 미디어 스튜디오 (이미지·영상·음성 통합)
  • moai-media/skills/google-media/: Google Gemini 3 Image Preview + Veo 3.1 통합 스킬
    • Nano Banana Pro (gemini-3-pro-image-preview, 2K), Nano Banana 2 (gemini-3.1-flash-image-preview, 1K), Nano Banana Ultra (Pro + 4K)
    • Veo 3.1 Standard/Fast 영상 (최대 8초, 1080p, 오디오 자동 생성)
    • 단일 GEMINI_API_KEY로 이미지 + 영상 + 텍스트 모두 호출
  • moai-media/skills/ideogram/: Ideogram 3.0 (한국어 타이포그래피 렌더링 업계 최고)
  • moai-media/skills/kling/: Kling 3.0 (숏폼 영상, 다국어 립싱크, Veo 대비 1/5 가격)
  • moai-media/skills/elevenlabs/: ElevenLabs 공식 MCP (TTS, 음성복제, 32개 언어 더빙, ConvAI)
  • moai-media/skills/fal-gateway/: fal.ai 통합 MCP 게이트웨이 (Flux, Recraft, Hailuo, Luma, Pika, MiniMax Music 등 1000+ 모델)
• MCP 서버 자동 등록 — moai-media/.mcp.json에 2종 사전 구성
  • fal-ai (hosted HTTP MCP at https://mcp.fal.ai/mcp, FAL_KEY 인증)
  • elevenlabs (local stdio MCP via uvx elevenlabs-mcp, ELEVENLABS_API_KEY 주입)
• API 키 2종 신규 지원: FAL_KEY, ELEVENLABS_API_KEY (기존 NANO_BANANA_API_KEY 유지)
• 4K 이미지 해상도 지원 (image_size="4K", Nano Banana Ultra 전용)
• 14종 화면비 지원 (1:1 ~ 21:9, Gemini 3 Image Preview 기본 스펙)
• moai-media/CONNECTORS.md: API 키·MCP·커넥터 통합 가이드

• Google "Nano Banana" 브랜드 재정의 반영 (2026 Q1 공식 공지 반영)
  • 모델 ID 매핑: imagen-4.0-generate-001 → gemini-3-pro-image-preview
  • 모델 ID 매핑: imagen-4.0-fast-generate-001 → gemini-3.1-flash-image-preview
  • 엔드포인트 변경: :predict → :generateContent
  • 파라미터 스키마: numberOfImages + top-level aspectRatio → imageConfig.aspect_ratio + imageSize
  • 응답 파싱: predictions[].bytesBase64Encoded → candidates[].content.parts[].inline_data.data
  • ⚠️ 유료 플랜 필수: Nano Banana Pro/2 및 Veo 3.1은 무료 티어 호출 불가
• generate_image.py 이관 및 v3.0.0 → v4.0.0 마이그레이션
  • 경로: moai-content/scripts/card-news/generate_image.py → moai-media/scripts/generate_image.py
  • Gemini 3 Image Preview API 스키마로 전면 재작성
  • Python 3.13+ 스타일 (from __future__ import annotations, TypedDict, PEP 604 union types)
  • 환경변수 우선순위: GEMINI_API_KEY > NANO_BANANA_API_KEY (레거시 호환 유지)
  • 키 파일 탐색 확장: ~/.gemini-api-key 추가, moai-credentials.env에서 두 키 모두 인식
  • 서로게이트 sanitize 로직 v3.0 수준 유지 (한국어·이모지 안전)
• moai-content/skills/card-news/SKILL.md: 이미지 생성 섹션을 moai-media 플러그인 위임 구조로 전환
  • API 키 안내를 NANO_BANANA_API_KEY → GEMINI_API_KEY로 업데이트 (레거시 변수명도 인식됨 명시)
  • 모델 옵션 문구에 실제 Gemini 3 Image Preview 모델 ID 부기
  • 스크립트 경로 참조: scripts/card-news/generate_image.py → moai-media/scripts/generate_image.py
• 전체 버전 bump 1.0.3 → 1.1.0 (87 지점)
  • marketplace.json × 1
  • plugin.json × 17 (기존 16 + 신규 moai-media)
  • SKILL.md × 70 (기존 65 + 신규 5)
• .claude-plugin/marketplace.json: moai-media 플러그인 엔트리 추가

v1.0.x 사용자 조치 사항:

1. Google API 키 업그레이드

   • 환경변수를 NANO_BANANA_API_KEY → GEMINI_API_KEY로 변경 권장 (구 변수명도 인식됨)
   • Gemini API 콘솔에서 Pay-as-you-go 결제 활성화 필수 (Nano Banana Pro/2 무료 티어 불가)

2. 신규 API 키 발급 (moai-media 사용 시)

   • fal.ai/dashboard/keys → FAL_KEY
   • elevenlabs.io/app/settings/api-keys → ELEVENLABS_API_KEY

3. uv 설치 (ElevenLabs MCP용)

   curl -LsSf https://astral.sh/uv/install.sh | sh

4. 플러그인 마켓플레이스 새로고침

   /plugin marketplace update cowork-plugins
   /plugin install moai-media@cowork-plugins
   

• scripts/card-news/generate_image.py 경로 이동 — moai-content/scripts/ 경로를 직접 참조하던 외부 스크립트는 moai-media/scripts/로 경로 변경 필요
• 엔드포인트 변경 — 구 스크립트를 복사하여 자체 수정해 사용하던 사용자는 :predict → :generateContent 전환 및 페이로드 스키마 업데이트 필요 (v4.0.0 generate_image.py 참고)
• 무료 티어 불가 — 기존 Gemini API 무료 키로 Nano Banana 호출하던 워크플로우는 Pay-as-you-go 활성화 필요

• moai-content/scripts/card-news/generate_image.py (moai-media로 이관)
• moai-content/scripts/ 빈 디렉토리 제거

• CHANGELOG.md: Keep a Changelog 형식 공식 도입 및 엔트리 템플릿 정의
• CLAUDE.local.md: 저장소 로컬 지침 신규 작성
  • 버저닝 정책 (HARD): 82개 지점 동기화 절차 및 검증 명령
  • 플러그인 컴포넌트 규격: SKILL.md user-invocable 필수 명시
  • 릴리스 후 사용자 안내 템플릿 (/plugin marketplace update)
  • 태그 히스토리 관리 규정

• 전체 버전 통일 (82 지점): 모든 버전 표기를 1.0.3으로 강제 일치
  • .claude-plugin/marketplace.json: metadata.version
  • moai-*/.claude-plugin/plugin.json × 16: version 필드
  • moai-*/skills/*/SKILL.md × 65: metadata.version 필드
  • 이전 상태: 대부분 1.0.0 잔존, 일부 파일만 개별 bump되어 불일치 상태였음
• moai-core/skills/moai/SKILL.md 본문 뱃지: v1.0.0 → v1.0.3

• /moai 슬래시 자동완성 미작동 문제 (#user-report)
  • 증상: Claude Code에서 /moai 입력 후 Tab 눌러도 자동완성 목록에 노출되지 않음
  • 원인: moai-core/skills/moai/SKILL.md frontmatter에 user-invocable: true 플래그 누락. Claude Code는 이 플래그가 true인 스킬만 슬래시 메뉴에 사용자 호출 가능 항목으로 등록함
  • 추가 원인: 비표준 keywords 필드 사용 (Claude Code 스펙 미지원)
  • 해결:
    1. user-invocable: true 추가
    2. keywords → 표준 metadata.tags로 이전
    3. metadata.version/status/updated 메타데이터 완성
• moai-core/skills/feedback/SKILL.md 버전 필드가 1.0.0에 고정되어 다른 파일과 불일치하던 문제 수정

• 불필요한 로컬 Git 태그 정리: v1.1.0, v1.2.0, v1.3.0
  • 사유: marketplace.json 버전(1.0.x 트랙)과 태그 체계(v1.x.0)가 어긋나 혼란 유발
  • 원격 태그 v1.1.0도 함께 삭제 (푸시 전 단일 상태로 정리)

사용자 측에서 신버전 반영 필요:

/plugin marketplace update cowork-plugins

이후 플러그인 상세 화면 재진입 시 1.0.3으로 표시되며 /moai<Tab> 자동완성 활성화됨.

없음. Frontmatter 필드 추가·정규화만 수행하여 기존 동작은 완전 호환.

• moai-core/skills/feedback/: 버그/기능 요청 GitHub Issues 자동 등록 스킬
• moai-office/skills/pptx-designer/: NotebookLM 스타일 프롬프트 + 인포그래픽 선택 옵션

• README.md: 퍼블릭 공개용 개편 (뱃지, 목차, 기여/문의 섹션 추가)
• 전 플러그인 스킬 테이블에 한글명 컬럼 추가 (65개 스킬)

• API 키와 Cowork 커넥터 혼동 방지 규칙 강화 (init 플로우 전반)
• API 키 가이드를 4개로 정리: DART/KOSIS/KCI 통합, 네이버·구글 API 제거
• init 안내 목록 외 서비스(네이버 API 등) 언급 금지 규칙 추가

• init 플로우의 모든 사용자 질문을 AskUserQuestion 도구로 통일

• 초기 마켓플레이스 공개: 16개 플러그인, 64개 스킬
• moai-core: 도메인 AI 라우터 + 자가학습 엔진 (/project init, /project catalog)
• 도메인 플러그인 15종: business, marketing, legal, finance, hr, content, operations, education, lifestyle, product, support, office, career, data, research

[이전 버전 없음 — v1.0.0이 최초 공개 릴리스입니다.]