blog-posting-auto: Instructions file for Claude Code

blog-posting-auto

Claude Code 기반 한국어 블로그 글 자동화 파이프라인. Researcher → Fact-Checker → Planner → Writer → Reviewer → (Image Router → Image Generator, 선택) → Publisher 서브에이전트가 /blog-pipeline 스킬을 통해 직렬 실행, 최종 결과를 Notion DB에 발행. Fact-Checker가 환각·오인용을 격리해 downstream을 깨끗하게 유지.

실행 흐름

user: /blog-pipeline <주제 또는 키워드>
  └─ Opus Orchestrator (메인 세션)
      ├─ 1.  blog-researcher    → workspace/{run_id}/research.md
      ├─ 1.5 blog-fact-checker  → workspace/{run_id}/research.verified.md
      │                          + research.rejected.md  (탈락 audit)
      ├─ 2.  blog-planner       → workspace/{run_id}/plan.md
      ├─ 3.  blog-writer        → workspace/{run_id}/draft.md
      ├─ 4.  blog-reviewer      → workspace/{run_id}/final.md
      ├─ 4.5 blog-image-router  → workspace/{run_id}/image-prompts.json   (선택)
      ├─ 4.6 scripts/codex-images.sh generate
      │                          → workspace/{run_id}/images/*.png
      │                          + images.manifest.json  (codex exec, 선택)
      └─ 5.  blog-publisher     → Notion page URL (meta.json 저장)

디렉토리

• .claude/agents/ — 7개 서브에이전트 정의 (researcher / fact-checker / planner / writer / reviewer / image-router / publisher)
• scripts/codex-images.sh: 4.6단계 이미지 생성 (generate) + placeholder 교체 사본 (swap)
• .claude/skills/blog-pipeline/ — /blog-pipeline 슬래시 스킬 진입점
• .claude/style/ — 톤·금지표현·체크리스트 (모든 에이전트가 SessionStart hook으로 로드)
• .claude/hooks/ — SessionStart / UserPromptSubmit / PreToolUse / SubagentStop / Stop 자동 체크포인트 (날짜 주입 + 금지표현 차단)
• workspace/{run_id}/ — 실행별 산출물 (gitignored)
• examples/ — 참고 글 샘플 (스타일 학습용)

발행 타겟

/blog-pipeline publisher는 .env에 설정한 Notion DB로 발행한다. 사용자가 명시적으로 다른 곳을 지정하지 않는 한 .env 값을 사용.

• Parent page: .env의 NOTION_PARENT_PAGE_ID (Notion 페이지 URL 끝 32자 hex)
• DB: .env의 NOTION_DATABASE_ID (inline DB URL 끝 32자 hex)
• Title field: .env의 NOTION_DB_TITLE_FIELD (DB 스키마의 title 속성명, 기본 이름)

Notion DB ID 찾기: Notion에서 DB 우상단 ... → Copy link → URL의 마지막 32자 hex가 DB ID.