딸깍 출판 시스템 딸깍 구축 가이드 (ft. Antigravity IDE)

workspace/
├── GEMINI.md
├── _quarto.yml
├── TOC.json
├── workflow_manager.py
├── requirements.txt
├── index.qmd
├── chapters/
├── images/
├── docs/
└── logs/

# Role: AI-Assisted Non-fiction Book Factory
목표: AI의 초고 생산 속도를 활용하되, 사람이 품질을 통제하는 비문학 출판 공정을 만든다.
산출물: Quarto book 프로젝트(.qmd)로, HTML/PDF/EPUB까지 빌드 가능해야 한다.

# Team Structure

## agent-leader (System Architect)
- 사용자로부터 Topic/Target/Impact/Art Mode를 확정한다.
- 아래 "TOC.json 스펙"을 기준으로 TOC.json을 생성한다.
- 아래 "_quarto.yml 예시"를 기준으로 _quarto.yml을 생성/업데이트한다.
- workflow_manager.py의 실행 규칙을 정의한다(아래 기준을 코드로 구현).
	- 입력: TOC.json, chapters/ 폴더, (선택) 직전 챕터 파일
	- 목표: “다음에 처리할 챕터 1개”만 골라 초고/삽화를 생성하고 상태를 갱신한다.
	- 선택 규칙:
		1) status=todo 중 가장 앞(id가 가장 작은) 챕터 1개를 선택
		2) 해당 챕터를 drafted로 변경(잠금 역할: 한 번에 1개만 진행)
		3) agent-writer 호출 → chapters/<file> 초고 생성/업데이트
		4) 초고에 FIGURE: 가 있으면 agent-illustrator 호출(모드에 맞게)
		5) agent-illustrator가 새 패키지를 썼으면 requirements.txt 업데이트
		6) 결과 로그를 logs/Run_Log.md에 남김(선택된 챕터, 생성된 파일, VERIFY/FIGURE 카운트)
	- 종료 조건: todo 챕터가 없으면 “할 일 없음” 메시지 출력

## agent-writer (Content Engineer)
- 입력: TOC.json의 현재 챕터 브리프 + 직전 챕터 파일
- 출력: 해당 챕터 .qmd 초고
- 규칙:
  - 서술 프레임: 문제-해결-근거
  - 검증이 필요한 주장/수치/사례는 단정하지 말고 VERIFY: 로 표시
  - 삽화 필요 지점은 FIGURE: 한 줄 설명 플레이스홀더로 남김

## agent-illustrator (Visual Specialist)
- Rendered Code 모드: .qmd 내부에 Python 코드(그래프/도식) 삽입
- Rasterized Image 모드: 이미지 프롬프트를 만들고 images/에 PNG 저장
- 규칙: 삽화 1개는 주장 1개만 보강한다(과다 정보 금지)
- 추가 규칙(의존성 기록): Rendered Code 모드에서 새로운 Python 패키지를 import/사용했다면 requirements.txt에 즉시 반영한다.

## agent-auditor (Quality Controller)
- 전체 원고를 분할 검토하여 아래를 점검한다.
  - 논리 모순, 용어 불일치, 난이도 이탈, VERIFY: 미해결 항목
- 결과는 logs/Review_Log.md에 High/Medium/Low로 기록한다.

# Constraints
1. 한국어 중심, 핵심 용어 첫 등장 시 영어 병기
2. 수식은 LaTeX 문법 준수
3. 사실처럼 보일 수 있는 내용은 임의로 지어내지 않기
4. 각 챕터 말미에 요약/미검증/다음 장 연결을 3줄로 남기기

# TOC.json 스펙 (agent-leader가 이 구조로 생성)
- 상태는 3단계: todo → drafted → reviewed

TOC.json 예시:
{
  "project": {
    "topic": "경제학 원론",
    "target_reader": "고등학생 수준의 일반인",
    "impact": "경제학적 사고방식의 습득",
    "art_mode": "rasterized_image"
  },
  "chapters": [
    {"id": "01", "title": "왜 경제학을 배워야 하는가", "file": "chapters/01_intro.qmd", "status": "todo"},
    {"id": "02", "title": "희소성과 선택", "file": "chapters/02_scarcity.qmd", "status": "todo"}
  ]
}

# _quarto.yml 예시 (agent-leader가 이 형태로 생성/업데이트)
_quarto.yml 예시:
project:
  type: book
  output-dir: docs

book:
  title: "<YOUR TITLE>"
  author: "<YOUR NAME>"
  chapters:
    - index.qmd
    - part: "Main Content"
      chapters:
        - chapters/01_intro.qmd
        - chapters/02_scarcity.qmd

format:
  html:
    theme: cosmo
    code-fold: true
    toc: true
    number-sections: false
  pdf:
    number-sections: false
    pdf-engine: xelatex
    documentclass: scrreprt
    mainfont: "Noto Sans CJK KR"
    sansfont: "Noto Sans CJK KR"
    monofont: "Noto Sans Mono CJK KR"
  epub:
    cover-image: images/cover.png

pip install -r requirements.txt

주제: 경제학 원론
대상 독자: 고등학생 수준 일반인
기대 효과: 경제학적 사고방식 함양
삽화 방식: Rasterized Image

GEMINI.md 규칙을 준수해서 아래를 생성해줘.
- TOC.json(챕터 8개 내외)
- chapters/ 이하 파일명 목록
- _quarto.yml(빌드 설정)
- workflow_manager.py 뼈대
- requirements.txt(필요 시 agent-illustrator가 업데이트)

python3 workflow_manager.py

agent-auditor를 호출해서 전체 원고를 분할 검토해줘.
logs/Review_Log.md에 High/Medium/Low로 정리해줘.
특히 VERIFY: 항목을 최우선으로 모아줘.

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
quarto render

# 1. 빌드 결과물이 docs/ 폴더에 생성되도록 설정 (이미 _quarto.yml에서 수정됨)
# 2. GitHub Pages 엔진(Jekyll)이 파일을 건드리지 못하게 빈 파일 생성
touch docs/.nojekyll

cat <<EOF > .gitignore
# Quarto execution & cache
.quarto/
_freeze/

# Python environment
.venv/
__pycache__/
*.pyc

# IDE and OS files
.vscode/
.DS_Store
.ipynb_checkpoints/
EOF

# 1. Git 초기화 및 메인 브랜치 설정
git init
git checkout -b main

# 2. GitHub 로그인
gh auth login

# 3. GitHub 레포지토리 생성 (book-sample 이름)
gh repo create book-sample --public --source=. --remote=origin

# 4. 파일 업로드 (Commit & Push)
git add .
git commit -m "Build: GitHub Pages 배포를 위한 docs 폴더 포함 업로드"
git push -u origin main