genetics-mcp 2.12.0 → 2.15.0

package/skills/gazette-report/template/README.md

@@ -0,0 +1,89 @@
+# template — 관보 문서 뼈대
+
+`gazette-report` 스킬로 새 문서를 시작할 때 여기서 출발한다.
+**추출 원본은 `FI-soft/report-v2`** — 8종 검사를 통과하고 A4 21쪽으로 인쇄되는 구현이다.
+문서 고유 요소(숫자 롤 · 경과일 배지 · 진입 모션)만 빼고 골격은 그대로다.
+
+**`gazette.css` 를 손으로 고치지 마라.** 이건 추출물이다. 조판 규칙이 바뀌면 레퍼런스를 고치고
+`../scripts/extract.sh <레퍼런스.css> gazette.css` 를 다시 돌린다. 손으로 따라 고쳤다가
+레퍼런스에서 폐기한 12px 등급이 여기 47곳 남아 있던 적이 있다.
+
+## 파일
+
+| 파일 | 무엇 |
+|---|---|
+| `gazette.css` | 조판 3체계(활자·간격·괘선) · 가구 · 두 단 본문 · 표 4괘선 · 확인 강도 표식 · 인쇄 페이지 문법. **문서 무관** — 그대로 링크해 쓴다 |
+| `skeleton.html` | 가구 9요소의 최소 골격. 절 2개(PART 2개) · 표 2종 · 흐름도 1개를 예시로 담았다 |
+
+## 시작하기
+
+```bash
+cp -r template 새문서 && cd 새문서
+python3 -m http.server 8781      # http://localhost:8781/skeleton.html
+```
+
+## 글을 채울 때 — 한 문장 한 줄
+
+한글은 마침표에서 줄을 바꾼다. 산문을 새로 써 넣었으면 마지막에 한 번 돌린다:
+
+```bash
+python3 ../scripts/sentbreak.py skeleton.html --apply   # 문장마다 <span class="sn">
+node    ../scripts/tone.mjs     skeleton.html           # 「이어 붙인 블록 0개」 확인
+```
+
+낱말은 바뀌지 않는다(`contentdiff.sh` 로 확인). 멱등이라 여러 번 돌려도 안전하다.
+
+## 반드시 고쳐야 하는 것 — 셋
+
+| # | 어디 | 무엇 |
+|---|---|---|
+| 1 | `gazette.css` 의 `[data-chapter]` · `[data-part-no]` | **장 색 · PART 색.** 팔레트를 베끼지 말고 **그 문서가 이미 쓰는 상태색**에서 뽑아라 — 「완료」 절이 초록인 이유는 완료 태그가 이미 초록이라서다 |
+| 2 | `gazette.css` 의 `--wide` · `--marg` | 문서 폭 · 여백 주석 단 폭 |
+| 3 | `gazette.css` 의 `@page` 마진 박스 `content` | 러닝 푸터 문구(`문서 제목 · 발행처`) |
+
+## 절을 늘리려면
+
+`skeleton.html` 의 `<!-- ══ 절 — 여기서부터 복제한다 ══ -->` 블록을 복제하고 넷을 함께 고친다:
+
+1. `<section class="part" id="sec-N" data-chapter="0N" data-part-no="M">`
+2. 차례의 `.toc__row[data-chapter]` 행
+3. 측면 색인 `.rail__tab[data-chapter]`
+4. 머리띠 `.crumb__row--ch` 의 칸
+
+**PART 를 늘릴 때**는 `.pt[data-part-no]` 간지 · 차례의 `.toc__part` 밴드 ·
+머리띠 `.crumb__row--part` 의 칸을 함께 넣는다.
+
+## 채울 때 지켜야 하는 것
+
+- **여백 주석 단(`? Why` / `! Key Point` / `i Advice`)** 은 **독자가 실제로 던질 질문**이어야 한다.
+  채우려고 넣으면 안 넣느니만 못하다.
+- **톤은 개조식** — `~함 / ~했음 / ~필요 / ~한 상황`. `~합니다 / ~주세요` 아님.
+- **표는 맨 아래 굵은 줄로 닫는다** (`--rule-edge`). 없으면 표가 목록으로 읽힌다.
+- **상자를 두르지 마라.** 구조는 괘선·여백·활자로 만든다.
+- **본문 상호참조 링크를 굵게 하지 마라.** 밑줄이 이미 신호다.
+- **시각 장치는 내용에서 도출된 것만.** 장식은 금지.
+
+## 스크립트
+
+상호작용(처리 표시 · 머리띠 위치 추적 · 진입 모션)은 문서마다 다르므로 뼈대에 없다.
+붙일 때 지켜야 할 계약은 `skeleton.html` 머리의 주석에 있다.
+
+## 검증
+
+뼈대 자체가 8종 검사를 통과한 상태로 배포된다. 채운 뒤에도 그대로 통과해야 한다.
+
+```bash
+cd ../scripts
+node kcheck.mjs    http://localhost:8781/skeleton.html
+node read.mjs      http://localhost:8781/skeleton.html 1440
+node read.mjs      http://localhost:8781/skeleton.html 390
+node fontchk.mjs   http://localhost:8781/skeleton.html 12,14,17,20,24,29,35,42,51,61
+node flexcheck.mjs http://localhost:8781/skeleton.html
+node tone.mjs      ../template/skeleton.html
+./cssaudit.sh      ../template/gazette.css
+./pdfcheck.sh      http://localhost:8781/skeleton.html
+```
+
+기준선(뼈대 상태, 2026-08-24 실측):
+대비 표본 116 · 미달 0 / 가독성 지적 0 / 활자 스케일 밖 0 · 굵은 글자 29% /
+경어체 0 · 밀도 초과 0 / route light / 인쇄 A4 12쪽.