Skip to content

YOUNG-153/Writingbook-AgenticWorkflow

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

78 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AI Autobiography Generator

인터뷰에서 출판 품질 자서전까지 — 8종 AI 에이전트가 12단계 파이프라인으로 한 사람의 인생 이야기를 책으로 만듭니다.

"시작하자" 한마디로 AI 인터뷰 → 스토리 바이블 → 챕터 산문 → PDF/EPUB 자동 생산

이 시스템이 하는 일

입력 처리 출력
인물의 인생 경험 AI 인터뷰 12회 → 서사 구조 설계 → 문학적 산문 작성 → 적대적 리뷰 → 교차 일관성 감사 PDF + EPUB (영/한 동시)
인터뷰(대화) ──→ 스토리 바이블(구조) ──→ 챕터 산문(문학) ──→ 완성 도서(PDF/EPUB)
     │                  │                    │                     │
 @interviewer     @story-architect     @chapter-writer         build_book.py
 McAdams+Kvale    한-흥-정 아크          보이스 블렌딩            XeLaTeX+Pandoc
                  기승전결 구조          Appendix A 11종          영한 병렬

빠른 시작

사전 준비

npm install -g @anthropic-ai/claude-code    # Claude Code CLI
pip install pyyaml jsonschema               # Python 의존성

실행

cd Writingbook-AgenticWorkflow
claude                  # Claude Code 실행
> 시작하자

이것이 전부입니다. 시작하자를 입력하면:

  1. 실행 모드를 선택합니다 (Manual / Autopilot / Autopilot+ULW)
  2. 인물 이름을 입력합니다
  3. 프로젝트가 자동 초기화됩니다 (projects/20260318-이름/)
  4. Step 1부터 12까지 자동으로 진행됩니다
> 시작하자

━━━ 실행 모드 선택 ━━━
  [1] Manual     — 모든 단계에서 사용자 확인
  [2] Autopilot  — (human) 단계 자동 승인, 4계층 QA가 품질 보장
  [3] Autopilot + ULW — 최고 품질 추구 (Sisyphus Persistence)

> 2

주인공 이름을 입력하세요: 최윤식

✅ 프로젝트 초기화 완료
   ID: 20260318-최윤식
   Step 1: Interview Planning 시작...

트리거 패턴: "시작", "시작하자", "시작하라", "시작해", "start", "begin", "let's start" 모두 동작합니다.


12단계 파이프라인

Research (Steps 1-4) — 재료 수집

Step 이름 에이전트 사용자 개입 산출물
1 인터뷰 계획 Orchestrator interview_plan.md
2 인터뷰 수행 @interviewer 매 세션 후 3개 질문 INT-{NNN}.json
3 (human) 인터뷰 검토 사용자 승인/추가 /review-interview
4 (human) 블루프린트 공동 창작 @story-architect + 사용자 구조 선택 /review-blueprint

Planning (Steps 5-8) — 설계 확정

Step 이름 에이전트 사용자 개입 산출물
5 스토리 바이블 구축 @story-architect story_bible.json
6 스토리 바이블 리뷰 @reviewer RV-story-bible.json
7 (human) 스토리 바이블 승인 사용자 승인/수정 /review-story-bible
8 (human) 글쓰기 스타일 선택 @chapter-writer + 사용자 10종 중 선택 /select-style

Implementation (Steps 9-12) — 제작

Step 이름 에이전트 사용자 개입 산출물
9 챕터 작성 루프 @chapter-writer + @voice-calibrator + @reviewer ch{NN}_draft.md
10 교차 챕터 일관성 @reviewer + @reviewer-deep consistency-report.json
11 (human) 원고 최종 검토 사용자 최종 승인 /review-manuscript
12 책 빌드 Orchestrator book_latest.pdf + .epub

Autopilot 모드: Step 3, 7, 11의 (human) 단계가 자동 승인됩니다. 4계층 QA가 품질을 보장합니다.


핵심 특징

8종 전문 에이전트

에이전트 모델 역할
@interviewer opus McAdams+Kvale+Tulving+Rubin 4중 방법론 인터뷰
@story-architect opus 한-흥-정 감정 아크 + 기승전결 구조 설계
@chapter-writer opus 보이스 블렌딩 + Appendix A 11종 문학 지시문 + 4계층 Self-Refine
@voice-calibrator sonnet 8차원 정량 메트릭 측정 (문장 길이, 대화 비율, 수동태 등)
@reviewer opus 7차원 적대적 평가 + CoVe 사실 검증
@reviewer-deep opus DC-1~DC-7 동질화 방지 심층 스캔
@translator opus 영→한 7단계 번역 (glossary.yaml 용어 일관성)
Orchestrator opus 워크플로우 조율 + SOT 관리

보이스 & 스타일 시스템

인터뷰에서 12-파라미터 보이스 지문을 Python으로 추출하고, 10종 작가 스타일과 수학적으로 블렌딩합니다:

스타일 핵심 스타일 핵심
Hemingway 빙산 이론, 감정 절제 Austen 사회적 관찰, 아이러니
Marquez 마법적 사실주의, 감각 Kant 체계적 논증, 정밀성
Dostoevsky 내면 독백, 심리 갈등 Hesse 영적 탐구, 자기 발견
Orwell 명료한 산문, 진실 Shakespeare 극적 구조, 언어유희
Murakami 일상 속 초현실, 리듬 Woolf 의식의 흐름, 시간
블렌딩 공식: blended = style × ratio + voice × (1 - ratio)
기본값: 30% 스타일 / 70% 화자 보이스

한국 문학 품질 시스템 (Appendix A)

11개의 비협상적 문학 지시문이 "기록"이 아닌 **"문학"**을 보장합니다:

지시문 핵심 규칙
한/흥/정 (A-6) 감정을 장면으로 체화, 단어 라벨 금지
기승전결 (A-5) 전(轉) = 관점 전환 (클라이맥스 아님)
여운 (A-3) 교훈/도덕/요약 없는 엔딩
침묵 (A-4) 침묵을 서사 콘텐츠로 (챕터당 ≥1)
장면 6단계 (A-9) 핫스팟→장소→감각→대화→신체화→의미
번역체 9패턴 (A-10) 피동 되다, ~적 남발 등 원천 차단
이중 의식 (A-7) 체험:서술 비율을 인생 시기별 조절
[INFERRED] (A-11) 윤색 투명 태깅 (날조 금지)

4계층 품질 보장

L0 Anti-Skip Guard ──→ L1 Python 검증 (30종+) ──→ L1.5 pACS 자기평가 ──→ L2 @reviewer 적대적 리뷰

프로젝트 구조

Writingbook-AgenticWorkflow/
├── autobiography-generator/         ← 자서전 작성 워크플로우 (본체)
│   ├── workflow.md                  (12단계 파이프라인 정의)
│   ├── scripts/                     (검증·빌드 스크립트 36종)
│   ├── schemas/                     (JSON Schema 6종)
│   ├── webapp/                      (Next.js 대시보드)
│   ├── config/                      (감정 키워드, 한자 사전)
│   ├── templates/                   (LaTeX 조판, EPUB CSS)
│   ├── tests/                       (테스트 스위트)
│   └── projects/                    (프로젝트별 격리 산출물)
├── .claude/
│   ├── agents/                      (8종 전문 에이전트 정의)
│   ├── commands/                    (6종 워크플로우 커맨드)
│   ├── skills/writing-styles/       (10종 작가 스타일)
│   ├── hooks/scripts/               (22종 Hook 스크립트 + 테스트 131개)
│   └── state.yaml                   (워크플로우 SOT)
├── translations/glossary.yaml       (번역 용어 사전)
├── AUTOBIOGRAPHY-README.md          (자서전 시스템 상세 개요)
├── AUTOBIOGRAPHY-ARCHITECTURE-AND-PHILOSOPHY.md  (설계 철학·아키텍처)
├── AUTOBIOGRAPHY-USER-MANUAL.md     (사용 가이드)
└── docs/protocols/                  (상세 프로토콜 5종)

커맨드 레퍼런스

커맨드 역할 트리거
/start 워크플로우 시작 → 모드 선택 → 프로젝트 초기화 "시작하자"
/review-interview Step 3 — 인터뷰 완성도 검토 Step 2 완료
/review-blueprint Step 4 — 서사 구조 공동 창작 Step 3 승인
/review-story-bible Step 7 — 스토리 바이블 승인 Step 6 완료
/select-style Step 8 — 10종 스타일 선택·캘리브레이션 Step 7 승인
/review-manuscript Step 11 — 전체 원고 최종 검토 Step 10 완료

DNA 유전 (부모 게놈)

이 시스템은 AgenticWorkflow 만능줄기세포로부터 분화된 자식 유기체입니다.

DNA 유전된 형태
3단계 구조 Research(1-4) → Planning(5-8) → Implementation(9-12)
SOT 패턴 state.yaml — 단일 작성자 (Orchestrator)
4계층 QA L0 Anti-Skip → L1 Verification → L1.5 pACS → L2 Review
P1 봉쇄 30종+ Python 결정론적 검증 스크립트
Safety Hooks 위험 명령 차단, 시크릿 탐지, TDD Guard
Context Preservation 세션 자동 저장·복원 (Hook 기반)

상세: soul.md


문서 안내

자식 문서 (이 프로젝트 — AI Autobiography Generator)

문서 대상
AUTOBIOGRAPHY-README.md 시스템 상세 개요 — 9가지 핵심 특징, 에이전트 생태계, 검증 스크립트, 산출물 구조
AUTOBIOGRAPHY-ARCHITECTURE-AND-PHILOSOPHY.md 설계 철학 — 에이전트 아키텍처, 보이스 시스템, 한국 문학 품질, 인터뷰 방법론, 12개 ADR
AUTOBIOGRAPHY-USER-MANUAL.md 사용 가이드 — 단계별 실행, 커맨드, 품질 관리, 트러블슈팅, 용어 사전

부모 문서 (AgenticWorkflow 프레임워크 — 방법론)

문서 대상
AGENTICWORKFLOW-ARCHITECTURE-AND-PHILOSOPHY.md 만능줄기세포 프레임워크의 설계 철학
AGENTICWORKFLOW-USER-MANUAL.md 프레임워크 사용법 — 워크플로우 설계·구현

부모 문서는 **방법론(게놈)**을, 자식 문서는 **이 프로젝트의 도메인 고유 구현(표현형)**을 기술합니다.


저작권

COPYRIGHT.md

About

AI Autobiography Generator — 인터뷰에서 출판 품질 자서전까지, AgenticWorkflow DNA 기반 다중 에이전트 파이프라인

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Python 87.5%
  • Shell 7.2%
  • TypeScript 4.2%
  • Other 1.1%