# 집필 방식·패턴 가이드라인 및 편집 전략 마스터 문서 (Writing Guidelines, Design Patterns & Editorial Strategy)

> **대상 프로젝트**: *Learn You Some Canton for Great Good!* — HTML 도서 사이트 (`book-site/`)  
> **사이트 이름**: Learn You Some Canton. 헤더와 브라우저 탭 접미에 쓴다. 표지 제목과 표지 탭만 정식 서명을 쓴다.
> **문서 성격**: 전 파트(제1부~제6부, 총 34장 + 에필로그 + 4막 특별 부록) 집필 시 일관되게 준수해야 할 **문체·구조·시각화·코드 대조·계약 주방 레시피·쌍(Twin) 문서 제작 표준 명세서**
>
> **화면 사본**: `design-system.html`. 탭은 토큰 · 컴포넌트 · 집필 · 패턴 · 금지 · 디버그. `#rule-5`, `#pattern-math`처럼 해시를 붙이면 그 섹션이 열린다. 규칙을 고칠 때는 이 파일과 그 페이지를 함께 고친다.

---

## 1. 핵심 편집 방향 (Core Editorial Direction)

본 도서는 **"초반에는 명쾌한 문제의식과 절제된 지적 유머로 독자를 끌어들이고, 뒤로 갈수록 수학적 논리·공식 알고리즘·SRE 노드 운영·HOCON 설정·CIP 거버넌스·대한민국 토큰증권(Security Token Offering, STO)·글로벌 금융 규제로 격상된 뒤, 에필로그 이후 제6부 계약 주방(Ch 27~34)에서 `sdk-version: 3.7.x` 기준 26개 실전 디자인 패턴 레시피를 조립하는 정통 엔터프라이즈 아키텍처 서적"**을 지향합니다.

### 1.1 6부작 점진적 심화 및 실전 주방 곡선 (Progressive Rigor & Cookbook Curve)

```
 [독자 몰입 및 공학적 엄밀성 상승 곡선]

  엄밀성/밀도 ▲                                                           ┌── Part 6: 계약 주방 요리책 (Ch 27~34)
             │                                                  ┌─────────┘   dpm 3.7 · 26개 실전 레시피 & STO 조립
             │                                       ┌──────────┘  Part 5: Splice 토크노믹스, CIP 의회,
             │                            ┌──────────┘             한국 STO(전자증권법 제21318호·자본시장법 제21324호) & 글로벌 규제 + 에필로그
             │                 ┌──────────┘  Part 4: PostgreSQL 내부 공학, 5단계 인덱서,
             │      ┌──────────┘             HOCON 설정, 3중 격리 복구 & 프루닝 수학
             │ ┌────┘  Part 3: 블라인드 머클 뷰(BMT), 7단계 합의 알고리즘, 3-카운터 락 & LtHash16Blake3
             ├─┘ Part 2: 실물 계약 법제사 ↔ Daml 구문 대수 ↔ TypeScript 대칭 학습 & Isabelle/HOL 증명
             │ Part 1: 시장 미시구조, O(n²) 대사 그래프, 결제 완결성과 Daml/Canton 탄생 필연성
             └──────────────────────────────────────────────────────────────────────────────────────► 진행도
               [절제된 위트 + 실물 계약 비유]                 [정밀 수식 + 운영/규제 실증 + 고쳐 쓰는 계약 레시피]
```

1. **역사 일화의 절제와 기술 정체성 전면화**:
   - 역사적 사건(1494년 베네치아 복식부기, 1968년 월스트리트 서류 위기, 1974년 헤르슈타트 파산 등)은 **왜 이 아키텍처와 Daml 문법이 탄생할 수밖에 없었는지 증명하는 도입부 장치(챕터당 15~20% 이내)**로만 압축합니다.
   - 모든 장의 제목과 본문 중심축(80% 이상)은 **Daml 언어 규칙, Canton 프로토콜 컴포넌트, 상태 전이 수식, 실물 계약 모델링**이 전면에 드러나야 합니다.
2. **절제된 엔지니어링 유머 ("Dry & Grounded Wit")**:
   - 허무맹랑한 판타지나 과장된 만담을 배제하고, 실제 금융 백오피스·컴파일러 검증·새벽 당직 엔지니어링 현장에서 공감할 수 있는 건조하고 날카로운 지적 유머(Dry Wit)를 유지합니다.

---

## 2. 7대 필수 집필 불변식 (The 7 Editorial Invariants)

### 규칙 1. 메커니즘 중심 표제화 (Mechanisms-First Headings)
- 챕터 제목과 섹션 소제목만 훑어보아도 다루는 기술 요소(예: `원장 API(Ledger API)`, `서명자(Signatory)`, `블라인드 머클 트리(Blinded Merkle Tree)`, `2단계 커밋(Two-Phase Commit, 2PC)`)가 즉시 파악되어야 합니다.

### 규칙 2. 최초 등장 외래 용어·고유명사 영문 병기 (`R7` Convention)
- 각 문서(파트 시작글 및 개별 챕터)에서 외래 기술 용어, 프로토콜 역할, 제도·기관명이 **처음 등장할 때 반드시 표준 영어 명칭을 괄호 안에 병기**합니다.
  - 올바른 예: `동기화기(Synchronizer)`, `활성 계약 세트(Active Contract Set, ACS)`, `서명자(Signatory)`, `관찰자(Observer)`, `예탁결제원(Korea Securities Depository, KSD)`
  - 이후 동일 문서 내 반복 등장 시에는 한국어 단독 또는 약어(`ACS`, `KSD`)를 자연스럽게 혼용하여 가독성을 높입니다.

### 규칙 3. 「실물 법적 계약 ↔ Daml 구문 대수 ↔ TypeScript 1:1 대조」 3단 연결 패턴
- Daml 문법은 독립된 암기 과목처럼 나열하지 않고 반드시 **3단 교량 패턴**으로 제시합니다:
  1. **실물 계약서 조항 (Physical Legal Clause)**: 현실의 어음, 신탁계약서, 매매계약서에서 누가 인감을 찍고 누가 열람하며 어떤 조건에서 권리가 소멸하는가?
  2. **TypeScript 개발자의 익숙한 사고 모델 (TypeScript Mental Model)**: 일반 백엔드 개발자가 `interface`, `class`, `async` 메서드로 이를 구현할 때 발생하는 가변 상태·권한 우회 문제점은 무엇인가?
  3. **Daml 불변 계약 구문 (Daml Syntax Algebra)**: `template`, `signatory`, `observer`, `controller`, `choice`, `ContractId<T>`가 이를 어떻게 컴파일 타임과 원장 런타임에서 수학적으로 강제하는가?

### 규칙 4. 버전 비종속성 및 소스 출처 비노출 원칙 (Timeless Systems Prose)
- **독자용 `.html` 본문 금지 사항**:
  - `.scala` 등 내부 구현 소스 파일명, 디렉터리 경로(`/Users/...`, `community/...`), 라인 번호 표기 절대 금지.
  - *"소스 코드를 열어보면"*, *"내부 리포지토리 분석 결과"* 등 역공학 출처를 암시하는 표현 절대 금지.
- **허용 범위**:
  - 영속적인 아키텍처 서브시스템 명칭(예: *충돌 감지기(Conflict Detector)*, *병렬 인덱서 파이프라인(Parallel Indexer Pipeline)*), 표준 SQL 쿼리 원리, 경로 없는 순수 Daml 모듈/파일명(예: `Amulet.daml`, `Splice.Amulet`) 및 재구성된 교육용 의사코드/패턴 코드.
- **내부 참조 보존**: 실제 검증에 참고한 정밀 아키텍처 근거와 커리큘럼 매핑은 오직 쌍으로 작성되는 **전략·참조 마크다운(`.strategy.md`)**에만 기록합니다.

### 규칙 5. 수식·알고리즘·불변식의 명시적 정식화 (Explicit Formalism)
- 모든 핵심 주장은 산문 설명에만 그치지 않고 **정식 수식 박스** 또는 **상태 전이 다이어그램**으로 못 박습니다.
- HTML에서는 `<figure class="math-figure">` 안에 `.math-card`(수식·해설) + 아래 `figcaption.math-card-caption`(INVARIANT/THEOREM 식별자) 구조를 사용합니다. **박스 안 상단 제목·좌측 컬러 바는 쓰지 않습니다.**
- 디스플레이 수식은 KaTeX로 조판합니다. `C(n, 2)`, `n(n-1)/2`처럼 기호를 본문 글자로 늘어놓지 않습니다. 이항계수는 `\binom`, 분수는 `\dfrac`로 씁니다. 두 식을 잇는 한국어는 `.math-bridge`에 두고 식 안에 넣지 않습니다.

### 규칙 6. 뉴트로 1960~80년대 미국 추상 스팟 만화 삽화 & 프롬프트 슬롯 (Illustration & Prompt Dual-Slot)
- **화풍 기준**:
  - 화려하거나 빽빽한 현대 그래픽노블풍 배제.
  - **1960~1970년대 미국 인디 스팟 카툰 / 벨 연구소(Bell Labs) 매뉴얼 두들 / 솔 스타인버그(Saul Steinberg) 풍의 추상 미니멀리즘**.
  - **75% 이상의 빈티지 웜그레이 신문지 여백**, 투박한 손그림 딥펜(Dip-pen) 흑색 잉크 선, 평면 기하학 도형, 살짝 어긋난 거친 회색 망점(`Zip-A-Tone` 스크린톤), 이미지 내 텍스트 제로(Zero Text).
- **HTML 구현 규격**:
  - `<figure class="spot-figure">` = ① `.spot-image-frame` 이미지 → ② `figcaption.spot-caption`(FIG 번호·설명, muted) → ③ 접이식 `<details class="prompt-drawer">`(연출 의도·영문 프롬프트). 삽화 자체는 유지하되 **카드형 중첩 배경·컬러 FIG 라벨·좌측 액센트는 사용하지 않습니다.**

### 규칙 7. `.html` 본문 + `.strategy.md` 전략 문서 1:1 쌍(Twin-File) 제작 프로토콜
- 파트 시작글이나 챕터를 1개 작성할 때마다 **반드시 두 개의 파일을 한 쌍으로 생성**합니다:
  1. `chapters/<slug>.html`: 독자가 웹 브라우저에서 읽는 완성형 고가독성 도서 페이지.
  2. `companion-notes/<slug>.strategy.md`: 해당 파트/챕터를 집필할 때 적용한 **서사 전략, 톤 조절 비율, 수식·코드 설계 의도, 참조한 마스터 문서 및 기술 검증 레퍼런스, 삽화 연출 의도**를 기록한 메타 엔지니어링 노트.

### 규칙 8. HTML 본문 내 마크다운 강조 기호(`**텍스트**`) 노출 절대 금지
- 독자용 `.html` 본문 작성 시 마크다운 문법(예: `**굵은글씨**`, `_기울임_`)을 그대로 방치하는 것은 치명적인 문법 오류입니다.
- HTML 파일에서는 반드시 `<strong>텍스트</strong>` 태그를 사용해야 하며, 문장 내에 원시 별표(`**`) 기호가 리터럴로 렌더링되어서는 안 됩니다.

### 규칙 9. 업계 표준 비즈니스·소프트웨어 공학 용어 준수 (No Literal Machine Translations)
- 고수준 언어가 코어 AST로 변환되는 과정을 서술할 때, 기계적이고 어색한 직역인 '탈설탕화'의 사용을 엄격히 금지합니다.
- 대신 업계 표준 및 비즈니스 현장에서 통용되는 **'구문 전개(디슈거링, Desugaring)'** 또는 **'문법 편의 구문 전개'**라는 정식 학술·산업 용어로 통일합니다.

### 규칙 10. 연결어미 뒤 쉼표 (Connective-Comma Calque)
영어 `For A, B`를 `~려면, ~한다`로 옮기면 번역투 쉼표가 됩니다. 앞으로 집필과 윤문은 이 규칙을 따릅니다. 화면 사본은 `design-system.html#rule-10`입니다.

- 쉼표는 나열, 호격, 삽입, 수식 범위가 헷갈릴 때 씁니다.
- 짧은 조건·이유 절 뒤에는 쉼표를 두지 않습니다. 금지 틀은 `~려면,` `~면,` `~므로,` `~서,` `~지만,` `~고,` `~며,` 바로 뒤에 본절이 오는 문장입니다.
- 절이 길거나 주어가 바뀌어 숨이 필요하면 쉼표를 남기거나 문장을 나눕니다.
- 이웃한 두 문장이 같은 연결어미로 시작하면 둘째 문장의 뼈대를 바꿉니다.
- 사실, 수치, 고유명사, `합니다`체, 첫 영어 병기는 유지합니다. 해요체로 낮추거나 영어 괄호를 지우지 않습니다.

나쁨: `계약의 효과가 강제력을 가지려면, 들어가는 일은 자발적이어야 한다. 의도대로 수행된다고 보장하려면, 정형 검증이 가능해야 한다.`

좋음: `계약의 효과가 강제력을 가지려면 그 계약에 들어서는 일이 자발적이어야 한다. 의도한 수행을 보장하는 길은 정형 검증이다.`

---

## 3. 표준 챕터 내부 구조 템플릿 (Canonical 6-Stage Chapter Anatomy)

모든 정규 챕터(`ch-XX-*.html`)는 독자의 인지 흐름을 최적화하기 위해 아래 **6단계 표준 골격**을 따릅니다:

| 단계 | 구성 요소 | 분량 비중 | 핵심 역할 |
| :--- | :--- | :---: | :--- |
| **Stage 1** | **Chapter Header & Reading Metadata** | 5% | `h1.chapter-title` + `p.chapter-subtitle` + 선택적 `.chapter-meta-bar`(companion 링크). **eyebrow·트랙 뱃지·저널 러닝헤드는 사용하지 않음** |
| **Stage 2** | **Opening Hook & Spot Illustration #1** | 15% | 실물 금융/역사의 결정적 균열 장면 + 절제된 위트 + `spot-figure` #1 |
| **Stage 3** | **Mathematical & Structural Problem Formulation** | 20% | 그래프·수식·복잡도 정식화 — `math-figure` (본문 박스 + 하단 캡션) |
| **Stage 4** | **Daml & Canton Core Mechanism (with TypeScript Bridge)** | 35% | 실물 계약 → TypeScript 한계 → Daml 구문 대조 + `spot-figure` #2 |
| **Stage 5** | **Institutional Reality** | 15% | 법·감독 원칙 인용은 `.statute`. 본문 위아래 헤어라인. 작은 캡션은 두지 않고 출처는 문장 안 |
| **Stage 6** | **Architectural Takeaways & Next Chapter Bridge** | 10% | 장이 남기는 명제는 `.recap`. companion 링크 + `.chapter-pager` 텍스트 Prev/Next |

### 3.1 제6부 「계약 주방 — 디자인 패턴 요리책」(Ch 27~34) 표준 레시피 골격
- 제6부의 모든 레시피는 기존 디자인 시스템 컴포넌트만 조합하여 **① 일상 장면 및 금융 업무명(`h2[id]`) → ② 당사자·권한 분해표(`div.table-wrap`) → ③ Daml 3.7 템플릿 및 테스트 스크립트(`div.code-compare` / `div.single-code`) → ④ 소비(`Archive`)·생성(`Create`) 전이 정식화(`figure.math-figure` / 전후 표) → ⑤ 실무 경계 조건(`section.faq` / `div.callout`) → ⑥ 다음 장 조립 재료 안내(`aside.chapter-note`)**의 고정 리듬을 유지합니다.
- 모든 요리책 코드는 `sdk-version: 3.7.x` (`dpm` CLI) 기준 정규 `choice Name : Ret with ... controller ... do` 구문만 사용하며, 폐기된 구형 `controller ... can` 문법과 스마트 계약 업그레이드(SCU) 호환성을 해치는 `DA.Exception` 사용을 금지합니다.

---

## 4. HTML 도서 사이트(`book-site/`) 디자인 및 디렉터리 규격

### 4.1 디렉터리 구조
```text
canton-book/book-site/
├── WRITING_STRATEGY_AND_STYLE_GUIDE.md      # 본 집필 가이드라인 및 편집 전략 마스터 문서
├── design-system.html                       # 화면용 디자인 시스템. 한글만. ko/en 밖. ?debug 로 목차에 노출
├── index.html                               # 언어 입구. 한국어(/ko/)와 English(/en/)
├── assets/                                  # css, js, images, vendor. ko와 en이 같이 씀
│   ├── css/
│   │   └── book.css                         # 고가독성 북 타이포그래피, 다크/세피아/뉴스프린트 테마, 반응형 레이아웃
│   ├── js/
│   │   └── book.js                          # 테마 전환, 글자 크기, 읽기 진행률, 프롬프트 복사, 코드 복사, ?debug
│   └── images/                              # 자체 생성된 뉴트로 추상 스팟 만화 일러스트 에셋 (.png, .jpg)
├── ko/                                      # 한글 본문
│   ├── index.html                           # 도서 표지, 전체 6부 34장 네비게이션 포털 & 학습 트랙(경로 A~E)
│   └── chapters/
│       ├── 00-writing-guide.html            # 집필 전략 가이드라인의 웹 리더 뷰. ?debug 에서만 노출
│       ├── part-01-opener.html              # 제1부 시작글 (Part 1 Opener)
│       └── ch-01-reconciliation-curse.html  # 제1장 본문 (Chapter 01)
├── en/                                      # 영문 자리. 번역 전까지 ko와 같은 한글. noindex, canonical은 /ko/
│   ├── index.html
│   └── chapters/
└── companion-notes/
    ├── index.strategy.md                    # 포털 및 표지 구성 전략·참조 문서
    ├── part-01-opener.strategy.md           # 제1부 시작글 집필 전략·참조 쌍 문서
    └── ch-01-reconciliation-curse.strategy.md # 제1장 집필 전략·참조 쌍 문서
```

### 4.2 Docs 톤 단일 컬럼 가독성 설계 원칙
1. **밝은 종이 시트 & 단일 컬럼 본문**:
   - 기본 배경은 **화이트**(시트 `#FFFFFF`). `Aa`에서 **세피아 · 그레이 · 다크**로 바꿉니다. **저널 여백 뷰 / 레이아웃 토글은 제공하지 않습니다.**
   - 본문 시트 `.chapter-article`은 단일 컬럼이다. 기본 `42rem`, 화면이 넓으면 `52rem`(1280px~)·`64rem`(1600px~)까지 늘어난다. float 여백으로 본문을 깎지 않습니다.
   - Apple Developer Documentation · Microsoft Learn 톤: **좌측 세로 컬러 바, 카드형 hover lift, 러닝헤드, eyebrow 소타이틀, 박스 안 상단 라벨 제목**을 쓰지 않습니다. 식별자·용어명은 **박스(또는 이미지) 아래 muted 캡션/주석**으로 둡니다.
2. **본문 읽기 설정 (`Aa`)**:
   - 기본값: **세리프 명조 · 18px · 줄간격 넉넉함(1.85) · 화이트**. 줄간격 선택은 보통(1.76) · 넉넉함(1.85) · 여유(2.05)다.
   - 세리프 스택은 획 대비가 선명한 명조를 앞에 둔다. `"AppleMyungjo", "KoPub Batang", "Nanum Myeongjo", "Batang", "Source Serif 4", "Noto Serif KR"`. 본문 잉크는 화이트에서 `#111`. 그레이스케일 안티앨리어싱은 쓰지 않는다.
   - 고딕은 Pretendard + Inter. 서체·줄간격은 본문(`p`, `li`, 부제, 용어 노트, 수식 해설)에 적용하고, 제목·헤더·목차는 고딕 고정이다. 소제목(`h3`) 크기는 본문 읽기 크기를 따른다.
   - 굵기는 장 제목·절 제목·소제목·강조·표 머리·코드 키워드·헤더까지 **500 한 가지**다. 장 제목은 1.86rem, 절 제목은 1.18rem이다. 소제목은 본문과 같은 크기이고, 고딕과 굵기 500으로 구분한다.
   - 배경 테마: 화이트 · 세피아 · 그레이 · 다크.
3. **전체 폭 코드 비교**: TypeScript와 Daml은 위아래로 이어 붙인다. 보기 전환 탭과 노트북 제목 줄은 두지 않는다. 언어 표식은 `.lang-tag` 한 가지이고, 복사는 아이콘 버튼이다. 코드 바탕은 `#F6F8FA`, 가로는 줄바꿈으로 넘기지 않는다.
4. **목차·진행**: 목차는 뷰포트 왼쪽 끝에 붙는 오버레이(`336px`)이며 **기본은 숨김**이다. 본문 폭을 밀어내는 고정(핀) 상태는 없다. 열기는 헤더 목차 버튼, 닫기는 배경 클릭·링크 이동. 상단 얇은 `#reading-progress` 바. 헤더에는 책 제목과 파트 배지를 두지 않고, 챕터 점퍼를 가운데 둔다. 헤더는 기본으로 숨기고, 화면을 누르거나 위로 스크롤하면 나타내며, 아래로 스크롤하면 다시 숨긴다. 목차·챕터 점퍼·Aa가 열려 있는 동안에는 숨기지 않는다. 너비가 부족하면 점퍼 글자는 `제4장`처럼 장 번호만 남긴다. 읽기 % 필·예상 분 러닝헤드는 본문에 넣지 않습니다.

### 4.3 화면 구성 컴포넌트 템플릿 (Canonical HTML Patterns)

새 챕터·포털을 작성할 때 아래 마크업만 사용합니다. 클래스명·캡션 위치는 임의로 바꾸지 않습니다.

#### A. 챕터 헤더 (eyebrow 없음)
```html
<article class="chapter-article">
  <h1 class="chapter-title">…</h1>
  <p class="chapter-subtitle">…</p>
  <div class="chapter-meta-bar">
    <span>…</span>
    <a class="companion-badge-link" href="../companion-notes/….strategy.md">…</a>
  </div>
  <!-- 본문 … -->
</article>
```

#### B. 용어는 본문에 흡수
용어 정의용 박스(`term-figure`, `margin-note`)는 쓰지 않습니다. 개념은 앞뒤 문단의 문장으로 풀고, 처음 나올 때 영어 이름을 괄호로 답니다. 본문 문단은 양쪽 정렬이고, 이어지는 문단은 첫 줄을 한 글자 들여 씁니다.

#### C. 수식·불변식 카드 (수식 박스 → 아래 주석)
수식이 있는 페이지는 `katex.min.css`와 `katex.min.js`를 불러옵니다(`assets/vendor/katex/`, KaTeX 0.16.22). `data-tex`가 조판 원본이고, 요소 안 텍스트는 스크립트가 없을 때의 대체 표기입니다.

```html
<link rel="stylesheet" href="../assets/vendor/katex/katex.min.css" />
<!-- body 끝, book.js 앞 -->
<script src="../assets/vendor/katex/katex.min.js"></script>

<figure class="math-figure">
  <div class="math-card">
    <div class="math-formula" data-tex="|E|=\binom{n}{2}=\dfrac{n(n-1)}{2}=\Theta(n^{2})">
      |E| = C(n, 2) = n(n − 1) / 2 = Θ(n²)
    </div>
    <p class="math-bridge">그러나 …에서는</p>
    <div class="math-note">…해설…</div>
  </div>
  <figcaption class="math-card-caption">INVARIANT 1.1 · …</figcaption>
</figure>
```

#### D. 스팟 삽화 (이미지 유지 · 크롬만 절제)
이미지는 본문 흐름의 핵심 시각 장치이므로 **유지**합니다. 카드 중첩·컬러 FIG 강조는 피하고, 캡션은 이미지 아래 muted 주석으로 둡니다.
```html
<figure class="spot-figure">
  <div class="spot-image-frame">
    <img src="../assets/images/….jpg" alt="…" />
  </div>
  <figcaption class="spot-caption">
    <strong>[FIG 1.2]</strong> …캡션…
  </figcaption>
  <details class="prompt-drawer">
    <summary>
      <span>삽화 구성 및 생성 프롬프트 보기</span>
      <span>열기 / 닫기</span>
    </summary>
    <div class="prompt-drawer-body">
      <div class="prompt-meta"><strong>연출 의도:</strong> …</div>
      <div class="prompt-box">…영문 프롬프트…</div>
      <button class="copy-prompt-btn" type="button">프롬프트 복사</button>
    </div>
  </details>
</figure>
```

#### E1. 에피그래프 (`epigraph`)
장이나 부의 앞에 두는 한 문장 질문입니다. 화면 견본은 `design-system.html#specimen-epigraph`입니다.
```html
<blockquote class="epigraph">
  "…"
  <cite>— …</cite>
</blockquote>
```

#### E2. 규정 (`statute`)
법·감독 원칙을 끌어오는 문단입니다. 채운 카드가 아닙니다. 본문은 위아래 선 사이에 둡니다. 출처용 작은 캡션은 두지 않고, 법령 이름은 문장 안에 적습니다.
```html
<figure class="statute">
  <p>…조문 이름과 그 함의…</p>
</figure>
```

#### E3. 장 요약 (`recap`)
장이 끝나는 명제 목록입니다. 제목은 다른 절과 같은 `h2`입니다. 항목 이름은 작은 줄이 아니라 문장 첫머리입니다.
```html
<section class="recap">
  <h2 id="chapter-takeaways">이 장에서 남는 것</h2>
  <ol class="recap-list">
    <li><strong>이름.</strong> …명제…</li>
  </ol>
</section>
```

#### E. 시그니처 콜아웃
상단 라벨(`callout-title`)은 두지 않습니다. 말할 내용은 문단의 첫 문장입니다. 좌측 컬러 바 없이 hairline과 subtle 배경만 사용합니다.
```html
<div class="callout architect"><!-- 또는 butler -->
  <p>…첫 문장이 요지…</p>
</div>
```

질문과 갈림은 `.faq`로 둡니다. 질문은 `.faq-q`, 답은 헤어라인으로 나뉜 `.faq-row`입니다. 왼쪽 칸은 구분 이름(TypeScript, Daml)만 둡니다.

```html
<section class="faq">
  <h3 class="faq-q">만약 …라면?</h3>
  <div class="faq-row">
    <div class="faq-label">TypeScript</div>
    <p>…</p>
  </div>
  <div class="faq-row">
    <div class="faq-label">Daml</div>
    <p>…</p>
  </div>
</section>
```

다음 장을 예고하는 문장은 콜아웃 카드로 두지 않습니다. `.chapter-note`는 고딕, 본문보다 살짝 작은 보조색 주석입니다.

```html
<aside class="chapter-note">
  <p>바로 이어지는 제1장에서는 …</p>
</aside>
```

#### F. 이전 / 다음 (텍스트 링크)
```html
<nav class="chapter-pager" aria-label="문서 이동">
  <a class="pager-link" href="…">
    <span class="pager-label">이전</span>
    <span class="pager-title">…</span>
  </a>
  <a class="pager-link next" href="…">
    <span class="pager-label">다음</span>
    <span class="pager-title">…</span>
  </a>
</nav>
```

#### G. 포털 part 목록
`.part-grid` > `.part-card`는 **hairline 구분 리스트**로만 렌더합니다. 좌측 세로 액센트 바·무거운 카드 배경을 넣지 않습니다.

#### H. 금지 패턴 (Do Not Use)
| 금지 | 이유 |
| :--- | :--- |
| `.chapter-eyebrow`, `.track-badge`, `.journal-running-head` | 읽히지 않는 데코 크롬 |
| 박스/카드 **좌측 컬러 바** | Docs 톤과 불일치 |
| 박스 **안쪽 상단** INVARIANT/HISTORY 제목 | 식별자는 하단 캡션으로 |
| `.pager-card` + hover lift | 카드형 네비 지양 → `.pager-link` |
| `data-layout="journal"` float 여백 | 본문 measure를 깎음 |
| 수식을 `C(n, 2)`, `n/2` 평문으로만 적기 | 분수·이항계수는 KaTeX `data-tex`로 조판 |
| HTML 본문 내 마크다운 기호(`**강조**`) 직접 노출 | 시맨틱 태그 `<strong>강조</strong>` 사용 (원시 별표 노출 절대 금지) |
| 어색한 기계적 번역어 '탈설탕화' | 표준 비즈니스·소프트웨어 공학 용어 '구문 전개(디슈거링, Desugaring)' 사용 |
