sns-auto-builder 1.0.0

package/knowledge/banned-words.json

@@ -0,0 +1,33 @@
+{
+  "_comment": "캐러셀 카피에서 자동 차단할 표현. quality-check.js가 사용.",
+  "hype_cliches": [
+    "미친 꿀팁",
+    "레전드",
+    "인생템",
+    "신세계",
+    "혁신적",
+    "게임 체인저",
+    "대박",
+    "무조건 해야 하는",
+    "1000% 성공"
+  ],
+  "filler_intros": [
+    "안녕하세요",
+    "오늘은",
+    "저번에 이어서",
+    "많은 분들이",
+    "여러분"
+  ],
+  "vague_promises": [
+    "엄청난 효과",
+    "놀라운 결과",
+    "기적의",
+    "비법 대공개"
+  ],
+  "ai_giveaways": [
+    "~에 대해 알아보겠습니다",
+    "결론적으로",
+    "요약하자면",
+    "다음과 같습니다"
+  ]
+}

package/knowledge/brand.schema.json

@@ -0,0 +1,62 @@
+{
+  "_comment": "브랜드 설정 폼의 항목 정의. 빌더 화면과 brand-facts.md 생성이 둘 다 이 파일을 읽는다. 항목을 추가하려면 여기만 고치면 화면과 문서가 같이 따라온다.",
+  "groups": [
+    {
+      "key": "basic",
+      "title": "기본",
+      "fields": [
+        { "key": "name", "label": "브랜드명", "placeholder": "오직", "required": true },
+        { "key": "positioning", "label": "한 줄 소개", "placeholder": "무엇을 하는 사람/회사인지" },
+        { "key": "mission", "label": "미션", "placeholder": "왜 이 일을 하는지" },
+        { "key": "target", "label": "타겟", "placeholder": "누구를 위한 콘텐츠인지" },
+        { "key": "handle", "label": "인스타 핸들", "placeholder": "@ohjic", "hint": "미리보기 목업과 캡션에 쓰입니다" }
+      ]
+    },
+    {
+      "key": "trust",
+      "title": "신뢰 지표",
+      "hint": "검증 가능한 숫자만. 빈칸은 아예 언급되지 않습니다",
+      "fields": [
+        { "key": "followers", "label": "인스타 팔로워", "placeholder": "1만+" },
+        { "key": "youtube", "label": "유튜브 구독자", "placeholder": "생략 가능" },
+        { "key": "community", "label": "카페/커뮤니티 회원", "placeholder": "생략 가능" },
+        { "key": "customers", "label": "누적 고객/수강생", "placeholder": "100+" },
+        { "key": "years", "label": "업력", "placeholder": "3년차 또는 2023년 시작" }
+      ]
+    },
+    {
+      "key": "content",
+      "title": "콘텐츠",
+      "fields": [
+        { "key": "products", "label": "제품/서비스", "type": "textarea", "placeholder": "한 줄에 하나씩" },
+        { "key": "tone", "label": "톤앤매너", "type": "textarea", "placeholder": "한 줄에 하나씩\n예) 친근한 과외 선생님\n예) 첫 3초 후킹, 지루한 인트로 금지" },
+        { "key": "address", "label": "독자 호칭·어미", "placeholder": "예) ~합니다체 / 독자는 '-님'" },
+        { "key": "hashtags", "label": "고정 해시태그", "placeholder": "#직장인 #신앙 (3~5개)", "hint": "캡션에 항상 들어갑니다" },
+        { "key": "avoid", "label": "피할 주제·표현", "type": "textarea", "placeholder": "한 줄에 하나씩\n예) 특정 교단·인물 지목 금지\n예) 의학적 효능 단정 금지" }
+      ]
+    },
+    {
+      "key": "cta",
+      "title": "전환",
+      "fields": [
+        { "key": "cta", "label": "기본 CTA", "placeholder": "저장", "hint": "마지막 장에 하나만 들어갑니다" },
+        { "key": "link", "label": "프로필 링크·무료 자료", "placeholder": "예) 프로필 링크의 무료 체크리스트" }
+      ]
+    },
+    {
+      "key": "design",
+      "title": "디자인",
+      "fields": [
+        { "key": "bg", "label": "배경색", "type": "color", "placeholder": "#131316" },
+        { "key": "accent", "label": "액센트색", "type": "color", "placeholder": "#CF5C3F" },
+        { "key": "font", "label": "폰트", "placeholder": "Pretendard" },
+        { "key": "layout", "label": "레이아웃 성향", "placeholder": "여백 크게, 좌측 정렬, 매거진 느낌" },
+        {
+          "key": "markPos", "label": "워드마크 위치", "type": "select",
+          "options": ["하단 중앙", "하단 좌측", "하단 우측", "상단 좌측", "넣지 않음"],
+          "hint": "한 장에 한 곳만. 중복되면 노트 한 장 느낌이 깨집니다"
+        }
+      ]
+    }
+  ]
+}

package/knowledge/patterns/carousel-output-format.md

@@ -0,0 +1,47 @@
+# carousel-output-format.md — 카드뉴스 **글** 출력 형식
+
+> 이 파일은 원본 레포에 없는 **추가분**입니다. 원본 `carousel-structure.md` 는 손대지 않았습니다.
+> 원본은 이미지 프롬프트(JSON)를 뽑는 용도라 텍스트 출력 형식이 필요 없었지만,
+> 웹 UI(`server.mjs`)는 글만 받아 조각으로 쪼개므로 형식이 필요합니다.
+>
+> 구조·역할·규칙은 전부 `carousel-structure.md` 를 따릅니다. 여기서는 **출력 모양만** 정합니다.
+
+---
+
+## 규칙
+
+- 이 형식만 출력한다. 앞뒤 설명·인사·코드펜스 금지.
+- `##` 로 시작하는 줄이 **장 구분자**다. 웹 UI가 이걸로 쪼갠다. 형식을 바꾸지 마라.
+- 이미지 프롬프트를 쓰지 마라. **한글 카피만** 쓴다.
+
+---
+
+## 형식
+
+```
+## 01 · Cover
+라벨: CLAUDE CODE GUIDE
+헤드라인: 코드 짜는 시간이
+          **절반**으로 줄었다
+서브카피: 저장해두고 하나씩 적용해보세요
+
+## 02 · TIP 01
+라벨: TIP 01
+헤드라인: 같은 설명을
+          **두 번** 하지 마라
+캡션: 프로젝트 규칙은 대화창이 아니라 파일에 적어두는 자리입니다.
+
+... (03 ~ 08 동일 형식)
+
+## 09 · Outro
+라벨: SAVE & SHARE
+헤드라인: 하나만 적용해도
+          **내일**이 편해집니다
+CTA: 저장해두고 내일 작업할 때 열어보세요
+
+## 캡션 (인스타 본문)
+<2~4줄 + 해시태그 8개>
+```
+
+- 라벨 형식은 `carousel-structure.md` 의 7가지 구조 중 고른 것에 맞춘다 (`TIP 01` / `STEP 3` / `MYTH 02` …).
+- 헤드라인은 2줄, 각 줄 20자 이내. 강조 키워드 1개만 `**` 로 감싼다.

package/knowledge/patterns/carousel-structure.md

@@ -0,0 +1,83 @@
+# carousel-structure.md — 9장 캐러셀 구조 공식
+
+> 한 캐러셀 = 1 Cover + 7 본문 + 1 Outro.
+> 주제가 바뀌어도 이 구조는 유지. 프롬프트 내용만 교체.
+
+---
+
+## 9장 역할 분배
+
+| # | 역할 | 목적 | 시간 비중 (사용자 체류) |
+|:---:|:---|:---|:---:|
+| 1 | **Cover** | 3초 내 스크롤 멈춤 | 1.5초 |
+| 2 | 본문 ① | 핵심 포인트 1 | 2.5초 |
+| 3 | 본문 ② | 핵심 포인트 2 | 2.5초 |
+| 4 | 본문 ③ | 핵심 포인트 3 (데이터/그래프) | 3.0초 |
+| 5 | 본문 ④ | 핵심 포인트 4 (반전/대조) | 3.0초 |
+| 6 | 본문 ⑤ | 핵심 포인트 5 | 2.5초 |
+| 7 | 본문 ⑥ | 핵심 포인트 6 | 2.5초 |
+| 8 | 본문 ⑦ | 핵심 포인트 7 (클라이맥스) | 3.0초 |
+| 9 | **Outro** | CTA (저장/공유/팔로우) | 2.0초 |
+
+**평균 체류 시간 합계**: 약 22.5초 (인스타 캐러셀 완독률 60%+ 목표치 기준)
+
+---
+
+## Cover 공식
+
+| 요소 | 규칙 |
+|:---|:---|
+| **카테고리 라벨** | 좌측 상단 또는 하단, orange 작은 대문자 (예: "CLAUDE CODE GUIDE") |
+| **메인 헤드라인** | 한글 bold 2줄 완결. 1줄은 white, 1줄은 orange (대조) |
+| **언더라인 바** | 헤드라인 아래 짧은 orange 직선 (시각적 앵커) |
+| **서브카피** | 회색, "저장 필수", "하나씩 적용해보세요" 류 행동 유도 |
+| **여백** | 캔버스 상단 40% 이상 비워두기 (premium breathing room) |
+
+**안티 패턴**:
+- ❌ 헤드라인 3줄 이상 (정보 과다 = 후킹 약화)
+- ❌ 여백 없이 꽉 찬 레이아웃 (AI 티 남)
+- ❌ 모든 글자 같은 색 (강약 없음)
+
+---
+
+## 본문 1장당 공식
+
+| 요소 | 규칙 |
+|:---|:---|
+| **넘버 라벨** | 좌측 상단 orange "TIP 01" 형식 |
+| **헤드라인** | 한글 2줄 이내. 핵심 키워드 1개를 orange 강조 |
+| **시각 요소** | 1개만 (트리 / 그리드 / 아이콘 행 / 다이어그램 / 프로그레스 바 등) |
+| **보조 캡션** | 회색, 1줄. 헤드라인을 풀어쓰는 게 아니라 **다른 각도** |
+| **CTA** | 본문에는 없음 (Outro로 몰아둠) |
+
+---
+
+## Outro 공식
+
+- 라벨: "SAVE & SHARE" 또는 "FOLLOW FOR MORE"
+- 헤드라인: "하나씩 적용하면 체감이 확 됩니다" 류 (결과 약속)
+- 여백 최대화 (캔버스 60% 이상 empty dark space)
+- CTA는 1개만 (저장/공유/팔로우 중 택 1)
+
+---
+
+## 7가지 본문 구조 (주제별 선택)
+
+| 구조 | 적합한 주제 예시 |
+|:---|:---|
+| **팁 나열** (TIP 01~07) | "Claude Code 7가지 꿀팁", "블로그 SEO 5원칙" |
+| **단계별** (STEP 1~7) | "AI 자동화 5단계", "브랜드 런칭 7단계" |
+| **Before/After** | "AI 쓰기 전후 비교 7가지" |
+| **질문-답변** (Q&A 7개) | "AI 초보 자주 묻는 질문" |
+| **비교** (A vs B ×7) | "ChatGPT vs Claude 실전 비교" |
+| **통념 깨기** (통념→사실 ×7) | "AI에 대한 착각 7가지" |
+| **체크리스트** (√ 7항목) | "런칭 전 점검해야 할 7가지" |
+
+---
+
+## 한글 렌더링 팁 (실측 기반)
+
+- Gemini 3.0 Pro Image는 한글 **짧은 단어** (2~4글자) 에서 99%+ 정확
+- **5글자 이상 전문용어** (예: "컨벤션") 또는 **받침 복잡한 단어** (예: "멍렁어") 에서 오타 위험
+- 대응: 해당 슬라이드에 한글이 많을 경우 → 프롬프트에 해당 단어를 명시적으로 따옴표로 묶고 spelling 강조
+- 오타 발생 시: 해당 슬라이드만 `--only slide-XX` 로 재생성 (미구현, 현재는 전체 재생성)

package/knowledge/patterns/thread-structure.md

@@ -0,0 +1,81 @@
+# thread-structure.md — Threads 스레드 구조 공식
+
+> 이 파일은 원본 레포에 없는 **추가분**입니다.
+> 원본(insta-carousel-builder)은 인스타 캐러셀 전용이라 쓰레드 모드가 아예 없습니다.
+> `carousel-structure.md` 와 같은 자리(구조 공식)를 쓰레드용으로 채운 것입니다. 원본은 손대지 않았습니다.
+
+한 스레드 = 훅 1글 + 이어지는 글 2~4개.
+
+---
+
+## 형식 제약
+
+| 항목 | 규칙 |
+|:--|:--|
+| **글자 수** | 1개 글 **500자 이내**. 넘으면 쪼개라 |
+| **글 개수** | 훅 1 + 이어지는 글 2~4 (총 3~5) |
+| **줄바꿈** | 아끼지 마라. 모바일에서 3줄 이상 붙어 있으면 안 읽는다 |
+| **해시태그** | 마지막 글 끝에 **1~2개만**. 인스타처럼 8개 달지 마라 |
+| **이모지** | 글당 최대 1개 |
+
+---
+
+## 첫 글(훅) 공식 — 하나만 골라라
+
+| 유형 | 예시 |
+|:--|:--|
+| **반대 주장** | "다들 X라고 하는데, 저는 반대입니다." |
+| **구체적 손실** | "이거 몰라서 3개월 날렸습니다." |
+| **숫자 대비** | "10분 걸리던 일이 40초가 됐습니다." |
+| **질문** | "왜 아무도 이 얘기를 안 하죠?" |
+
+첫 **2줄**에서 승부난다. Threads는 그 뒤가 접힌다.
+
+**금지**: 인사, 자기소개, "오늘은 ~에 대해", 배경 설명부터 시작
+
+---
+
+## 이어지는 글 공식
+
+- **한 글 = 한 주장.** 여러 개 욱여넣지 마라.
+- 근거는 **본인 경험 형태**로. 일반론("~하는 것이 중요합니다")은 스크롤당한다.
+- 중간 글에 CTA 넣지 마라.
+- 각 글이 단독으로도 말이 되게 써라 (인용 재공유 대비).
+
+---
+
+## 마지막 글 공식
+
+- CTA는 여기에만. 그것도 부드럽게 ("비슷한 경험 있으면 댓글 주세요").
+- 팔로우 요청은 하지 마라. Threads에서 가장 빨리 스크롤당하는 문장이다.
+- 해시태그 1~2개.
+
+---
+
+## 톤
+
+- **존댓말**, 단 딱딱하지 않게
+- 문장 짧게. 20자 넘으면 자를 곳을 찾아라.
+- 정답인 척하지 마라. "제 경우엔"을 붙여라.
+- 카드뉴스보다 **한 톤 더 낮게**. 캐러셀은 가르치는 톤, 스레드는 옆자리에서 말하는 톤.
+
+---
+
+## 출력 형식
+
+이 형식만 출력한다. 앞뒤 설명·인사·코드펜스 금지.
+`##` 로 시작하는 줄이 **글 구분자**다. 웹 UI가 이걸로 쪼갠다. 형식을 바꾸지 마라.
+
+```
+## 1 (훅)
+<본문>
+
+## 2
+<본문>
+
+## 3
+<본문>
+
+## 글자 수
+1번 NNN자 / 2번 NNN자 / 3번 NNN자
+```

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "sns-auto-builder",
+  "version": "1.0.0",
+  "description": "인스타 카드뉴스 자동 제작 빌더. Claude Code + ChatGPT 웹을 그대로 써서 API 키 없이 돌아갑니다.",
+  "type": "module",
+  "bin": {
+    "sns-auto-builder": "bin/sns-auto-builder.mjs"
+  },
+  "scripts": {
+    "start": "node bin/sns-auto-builder.mjs",
+    "serve": "node server.mjs",
+    "test": "node test.mjs",
+    "quality-check": "node scripts/quality-check.js"
+  },
+  "//files": "넣을 것만 적는다. 이렇게 해야 새 폴더가 생겨도 실수로 안 나간다. 올리기 전 npm pack --dry-run 으로 눈으로 확인할 것.",
+  "files": [
+    "bin/",
+    "scripts/",
+    "knowledge/",
+    "templates/",
+    ".claude/agents/",
+    ".claude/commands/",
+    "server.mjs",
+    "index.html",
+    "CLAUDE.md",
+    "!knowledge/brand.json",
+    "!knowledge/brand-facts.md",
+    "!knowledge/logo.svg",
+    "!templates/slides.*.json",
+    "!templates/backgrounds.*.json",
+    "templates/slides.example.json",
+    "templates/backgrounds.example.json"
+  ],
+  "dependencies": {
+    "puppeteer": "^23.0.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT",
+  "keywords": [
+    "instagram",
+    "carousel",
+    "card-news",
+    "claude-code",
+    "chatgpt",
+    "puppeteer",
+    "korean"
+  ]
+}