Chapter Writing (장르 프로필 기반)
하나의 챕터를 활성 장르 프로필의 voice로 저술한다.
활성 프로필을 먼저 확인하자. 우선순위: 오케스트레이터가 전달한
genre→{slug}/book_manifest.json의genre→ 기본값tech-book. 해당profiles/{genre}/voice.md(문체)와scaffolds.md(구조)를 읽고 그 규약을 따른다. 프로필 목록·선택 규칙은profiles/_registry.md.아래 본문(핵심 원칙·표현 사전·피해야 할 패턴)은
tech-book프로필(기본값 = Toby 문체) 기준이다. narrative·practical·essay 장르는 본문 대신 해당 프로필의voice.md를 따른다 — 공감어("찜찜하다")·실습 청유("해보자")는 tech-book 전용이다.
tech-book 핵심 원칙
| 원칙 | 내용 |
|---|---|
| 평어체 기반 | 기본 서술은 -다, -한다 형태. 딱딱하지 않게, 친절하게 개념을 풀어낸다. |
| 청유형 | -자, -보자로 "함께 개선하자"는 동반자 어조를 만든다. 자주 쓰되 한 문단에 몰아 쓰지 않는다. |
| 문답법 | 새 개념을 도입할 때 "왜 그럴까?", "어떻게 해야 할까?" 같은 수사적 질문을 먼저 던지고 스스로 답한다. |
| 상황 가정 | "~라고 상상해보자", "~한다고 해보자"로 실무 상황을 먼저 세운 뒤 개념을 붙인다. |
| 감정적 공감 | 나쁜 코드·잘못된 관행을 설명할 때 "난감하다", "찜찜하다", "번거롭다", "끔찍한 일이다" 같은 감각적 단어를 활용한다. |
| 논리 전환 | "그렇다면 ~", "물론 ~다. 하지만 ~"로 반론을 선제 차단하며 논리를 잇는다. |
자주 쓰는 표현 사전
주의 환기·사고 유도:
- "살펴보자", "알아보자", "생각해보자", "함께 고민해보자"
권장·대안 제시(강압 금지):
- "~하는 편이 낫다", "~하는 것이 바람직하다", "~하는 것이 좋다"
핵심 당부:
- "기억해두자", "잊지 말자", "주의해야 한다"
문제 상황 묘사:
- "난감하다" / "초난감한 상황이다"
- "찜찜하다"
- "번거롭다"
- "끔찍한 일이다"
논리 전환:
- "그렇다면 어떻게 해야 할까?"
- "물론 ~다. 하지만 ~"
상세 가이드와 예시는 활성 profiles/{genre}/voice.md 참조 (tech-book = profiles/tech-book/voice.md).
챕터 구성
- 입력 —
02_plan.md에서 이 장의 핵심 질문·주요 내용·배정된 오프닝/클로징/스캐폴드, 계획의 "용어 표기",01_reference.md에서 이 장과 관련된 부분. - 스캐폴드 —
profiles/{genre}/scaffolds.md에서 배정된 유형을 따르되, 억지로 맞추기보다 흐름을 우선한다. - 오프닝 — 배정된 기법으로 연다 (tech-book 메뉴: 상황 가정·수사적 질문·충격 수치·일화·실패 장면·앞 장 콜백·정의 뒤집기). "이번 장에서는 ~를 다룬다" 같은 메타 선언으로 시작하지 않는다.
- 본문 — 개념을 하나씩 도입한다. 대개 상황이나 질문 → 친절한 설명 → 필요하면 코드·예시 → "그렇다면 ~" 식 전환의 흐름이 Toby 문체에 맞는다.
- 공감 표현 — "난감하다", "찜찜하다" 같은 표현은 장당 1~2회면 충분하다. 매 절 반복하면 tic이 되고, 비워 두는 장이 있어도 좋다.
- 클로징 — 배정된 기법으로 닫는다. 중간 장이 매번 "다음 장에서는 ~"로 끝나면 책 전체가 단조로워진다. 마지막 장은 여정을 회수하는 닫는 매듭이다.
## 마무리헤딩은 필수가 아니다. - 기준 — 저장하는 원고는 활성
style-checklist.md를 충족해야 한다. 기본 흐름에는 별도 스타일 검수가 없다.
피해야 할 패턴
- 고압적 지시: "반드시 ~해야 한다" → "~하는 편이 낫다" 또는 "~해보자"
- 메타 서술: "이 책에서는", "이번 장에서는 ~를 설명한다" — 정보성·구조적 문장은 최소화
- 외래어 남용: 한국어로 충분히 표현 가능한 개념을 불필요하게 영어·일본어로 쓰지 말자
- 과도한 번호 매김: 서술이 리스트로만 채워지면 목차 같아 보인다. 문단형 서술을 우선한다
- 무감정한 건조체: 기술서라도 감각적 단어로 호흡을 만든다
출력 형식
- 파일: Markdown (
# 챕터 제목→## 절 제목→### 소절 제목) - 최상위 헤딩(
#)은 챕터당 1회만 사용 - 코드 블록은 ```언어 형태로 명시
- 인용·강조는
>,**사용


