@litfamily/litopencode 1.0.15 → 1.0.17

package/skills/lit-pptx/references/title-treatments.md

@@ -0,0 +1,271 @@
+# Title treatments
+
+A title treatment answers four questions at once: where the title sits, how large it is set, what
+is drawn with it, and where the body starts. The engine knows eight treatments
+(`scripts/lib/grid-resolver.js`, `TREATMENTS`). Each pack allows four or five of them, maps every
+slide role to one default, and the renderer may pick another allowed one per slide when that slide
+fills better under it. A deck therefore mixes several title looks, but every slide that uses one
+treatment puts its title in exactly the same frame.
+
+This file covers the geometry of each treatment, which packs allow it, how a slide gets its
+treatment, the per-slide `title:` key, and what the gate checks.
+
+## Titles name a topic
+
+Before geometry: every title and the cover subtitle is a noun-phrase label, never a sentence.
+
+- Korean titles do not end in a sentence ending: no -다, -니다, -요, -죠, and no nominalised claim
+  in -함, -됨, -음 (for example -었음, 있음).
+- English titles carry no finite verb (is, are, was, has, will, grew, rose, fell, leads, beats,
+  shows ...) and no closing period.
+- A title ending in a question mark is not judged as a claim, and neither is a title that opens
+  with a quotation mark, which is how a quote slide stays legal (see `quote` below).
+- A trailing parenthesis is ignored when the gate reads the ending, so `(예시)` does not rescue a
+  sentence.
+
+| Sentence (fails OF-114) | Label (passes) |
+|---|---|
+| 김포 센터의 처리비가 가장 높다 | 거점별 건당 처리비 비교 |
+| 오출고율이 크게 개선됨 | 분기별 오출고율 추이 |
+| APAC latency fell by 100 ms | p99 latency by region, January to September |
+| Config changes cause most incidents. | Incidents by root cause |
+
+The claim moves into the slide: the first takeaway, a caption, or a `key-message` box. The gate
+reports a sentence title as OF-114 HIGH under a tonality pack.
+
+## The eight treatments
+
+Positions below are for the 16:9 canvas on the compact grid that density 10 uses: 24 pt side
+margins, 12 columns 54 pt wide with 24 pt gutters, so column *a* starts at 24 + 78(*a* − 1) pt and a
+span of *n* columns is 78*n* − 24 pt wide. The canvas is 960 x 540 pt; the content floor is y 486.
+On the 4:3 canvas the same column spans apply to its own grid. Sizes are steps of the compact ramp:
+title 26 pt, display 36 pt, cover 44 pt.
+
+### top-rule
+
+- **Geometry.** Title across columns 1-12 at y 36, set at title size, one or two lines; the frame is
+  exactly as tall as its lines. A rule sits 6 pt under the frame: a short accent bar one column wide
+  and 4 pt thick in packs that list `accent-rule`, otherwise a 0.75 pt hairline across the full
+  width. The body starts 18 pt under the rule, so a one-line title gives a body from about y 92.
+- **Budget.** Two lines at most. On 16:9 one line holds roughly 33 Hangul or 60 Latin characters.
+- **For.** The workhorse for content, data and reference slides that read top to bottom.
+- **Packs.** ledger, signal, chalk, paper, gazette.
+
+### top-plain-large
+
+- **Geometry.** Title across columns 1-10 at y 36, at display size, no rule. One line takes a 54 pt
+  frame, two lines 102 pt (each with a little extra for descenders). The body starts 18 pt under it.
+- **Budget.** Two lines; about 21 Hangul or 38 Latin characters per line.
+- **For.** Slides read at a distance: image splits, comparisons, KPI rows and timelines in packs
+  built for rooms.
+- **Packs.** signal, atlas, studio, night.
+
+### side-rail
+
+- **Geometry.** Title in columns 1-4 from y 36, at title size, up to four lines; the frame keeps one
+  spare line so a rebalanced break never clips. Packs with `rail-fill` paint the rail from the
+  canvas edge to half a gutter past column 4 (in chalk the rail is the dark field with a white
+  title; elsewhere the light surface colour). Packs without it but with `hairline-rule` draw a
+  0.75 pt line at the rail edge instead. The body is columns 5-12, starting level with the title.
+- **Budget.** Four lines of a narrow measure: about 10 Hangul or 18 Latin characters a line.
+- **For.** A data slide with its takeaway, a definition or method page, an editorial text page.
+- **The rail under the title.** The rail carries what belongs beside the title: a comparison's
+  criteria labels, level with their rows; a chart's, table's, figure's or picture's takeaways; the
+  source and note at the rail's foot. A slide that would leave more than 40 % of the rail empty
+  takes another treatment unless the source pins `title: side-rail`, and the gate reports a pinned
+  rail left empty (OF-115).
+- **Packs.** ledger, atlas, chalk, paper, gazette, studio, night.
+
+### band
+
+- **Geometry.** A field-coloured band across the whole canvas from y 0 to 108. The title sits in it
+  across columns 1-11 at y 36, in the on-field colour. The body starts at y 120 on the compact step.
+- **Budget.** Two lines, a little narrower than top-rule.
+- **For.** Pages read like a document: Korean briefing pages, agenda pages, reference pages, and the
+  data pages of a dark keynote.
+- **Packs.** gazette, night.
+
+### statement
+
+- **Geometry.** The sentence or label itself is the slide: display size across columns 1-10, set in
+  balanced lines and centred on the body's vertical middle. Studio frames it between two hairlines
+  on the open page (its `display.statement: rules`). One support line may follow 24 pt below, in the
+  muted ink. There is no body zone.
+- **Budget.** Three lines.
+- **When it can be drawn.** No table, chart or image on the slide, and at most one text block
+  besides the title. A slide that breaks this falls back to another treatment.
+- **For.** Pull quotes and the one framing line of a live pitch. Since the user's verdict on
+  density, a claim is not a slide title; most decks need no statement at all.
+- **Packs.** signal, atlas, chalk, paper, studio, night. In ledger and gazette a `statement` slide is
+  drawn as the largest top title the pack has, and the compile log notes it.
+
+### overlay
+
+- **Geometry.** A picture fills the canvas edge to edge, cropped to its own proportions. A dark
+  panel at 88 % opacity covers the lower left, from the canvas edge to just past column 7 and from
+  y 324 to 516; the title sits in it at y 348, columns 1-7, in the on-field colour. Contrast is
+  judged on the panel, never on the photograph.
+- **Budget.** Two lines; about 19 Hangul or 34 Latin characters per line.
+- **When it can be drawn.** Only on a slide with an image, and only in the `image-full` family,
+  which takes no other treatment. The image's alt text becomes the numbered caption.
+- **Packs.** atlas, studio.
+
+### kicker-numeral
+
+- **Geometry.** A real number at cover size in the accent colour sits in columns 1-2 at y 36; the
+  title runs beside it in columns 3-12 at y 48, at title size. The body starts at y 120.
+- **Budget.** One line only.
+- **Where the number comes from.** The engine supplies it; you never type it. On an `agenda` slide it
+  is never used: the rows are numbered, and a count beside the title read as a stray section number
+  (OF-119). On a content slide that follows a section slide it is that
+  section's part number (taken from the agenda position when the section title matches an agenda
+  entry, otherwise counted). Closings never take it. A slide with no such number cannot be drawn
+  under kicker-numeral, so slides before the first section never show it. A deck with an agenda and
+  no section therefore has one treatment fewer to mix; open a part when OF-110 asks for a third.
+- **For.** The opening slide of a numbered part.
+- **Packs.** ledger, chalk, gazette, night.
+
+### bottom-anchor
+
+- **Geometry.** The title closes the page from below: columns 1-9 at title size, up to two lines,
+  its last line standing on the body floor (y 486), so a one-line title starts lower than a
+  two-line one. The 0.75 pt hairline across the width sits 12 pt above the title in packs that draw
+  hairlines, and the visual zone runs from y 36 down to 24 pt above the title: what a short title
+  does not use goes to the visual. The three columns beside the title stay empty by design.
+- **Budget.** Two lines; about 25 Hangul or 45 Latin characters per line.
+- **When it can be drawn.** The upper part must be a visual (chart, table, image or KPI row), or the
+  slide must hold at most one text block. A text-only slide with several blocks cannot take it.
+- **For.** Chart-led, figure-led and photo-led slides where the picture comes first.
+- **Packs.** ledger, signal, atlas, paper, studio.
+
+## Which packs allow what
+
+| Treatment | ledger | signal | atlas | chalk | paper | gazette | studio | night |
+|---|---|---|---|---|---|---|---|---|
+| top-rule | yes | yes | | yes | yes | yes | | |
+| top-plain-large | | yes | yes | | | | yes | yes |
+| side-rail | yes | | yes | yes | yes | yes | yes | yes |
+| band | | | | | | yes | | yes |
+| statement | | yes | yes | yes | yes | | yes | yes |
+| overlay | | | yes | | | | yes | |
+| kicker-numeral | yes | | | yes | | yes | | yes |
+| bottom-anchor | yes | yes | yes | | yes | | yes | |
+
+## How a slide gets its treatment
+
+Each layout family has a slide role and a list of treatments its geometry can take
+(`FAMILIES` in `grid-resolver.js`). The roles are content, data, data-takeaway, sequence, image,
+statement, reference and definition. A `comparison` counts as data when its text is dense with
+figures (about one digit in 25 characters) and as content otherwise. A closing is a content slide
+whose title names the ask, so it takes only top-rule, band or top-plain-large; `closing-statement`
+takes only statement.
+
+The choice runs in three passes.
+
+1. **Resolver.** For every content slide the candidates are the pack's own title for the slide's
+   family when its `structure:` map names one (Paper draws a comparison as a ruled table under
+   `top-rule`, Chalk sets its criteria on the board rail under `side-rail`; that title holds even when
+   the deck already leans on it, so two tonalities of one source differ in structure and not only in
+   colour), else the pack's default for the slide's role; then the pack's other treatments that the family allows and that can be drawn on this
+   slide (title within budget, numeral available, image present, statement conditions met).
+2. **Renderer.** Each candidate is laid out and measured. The role default stays when its body fills
+   to the density band, it is not the previous slide's treatment, and it has not yet covered about a
+   third of the deck (at least three slides). Otherwise the candidate with the smallest empty band
+   wins, with small penalties for repeating the previous slide or a treatment the deck already leans
+   on. The variance dial stops new treatments once the deck reaches its maximum.
+3. **Variety pass.** On a deck of eight or more slides at variance 4 and up, the engine makes sure
+   at least three treatments appear, that no title zone (top, side, band, bottom) covers more than
+   40 % of the content slides, and that the deck carries enough distinct layouts for OF-111. Each
+   move is printed: `variety: slide 3 drawn under bottom-anchor so no title zone covers more than
+   40 % of the content slides`.
+
+The last compile line lists the outcome, for example
+`Treatments: 2:top-rule 3:top-rule 4:top-rule 5:top-rule 6:top-rule 8:side-rail 9:bottom-anchor`.
+Covers and sections are absent from it: they draw their variant's own title.
+
+## The per-slide `title:` key
+
+Put `title:` on the line after `layout:` to fix one slide's treatment:
+
+```text
+---
+layout: chart-insight
+title: bottom-anchor
+
+## 월별 출고 건수, 2025년과 2026년 비교
+```
+
+The key set after `layout:` is closed: only `variant` and `title` are read, and the run of keys ends
+at the first blank line or the first line that is not one of them. A mistyped key stays visible in
+the body instead of being swallowed. The value must pass four checks or the compile stops with a
+message naming the problem:
+
+- it is one of the eight treatments;
+- it is one of the pack's treatments;
+- the slide's family allows it;
+- it can be drawn on this slide (budget, numeral, image, statement conditions).
+
+A cover or section slide rejects `title:` because its variant owns the title, and a legacy template
+rejects it because it has a single title look.
+
+Use the key sparingly and for a reason you can state:
+
+- the gate reports OF-111 (too few layouts, or one layout over 40 % of the content slides) and a
+  different treatment on one repeated slide fixes it;
+- a comparison of two argued options reads better across the page under a top title than squeezed
+  beside a rail (under a top title its labelled rows form a criteria grid);
+- a table slide's takeaways are too short to sit beside it and you want the title below the table.
+
+The examples in `examples/` use the key where the first compile showed one of these problems.
+
+## Reading the compile log
+
+| Log line | Meaning | Action |
+|---|---|---|
+| `note: slide 7: the title is longer than the top-rule budget; shorten it` | No allowed treatment fits the title, so the first one is used anyway | Shorten the label; move detail into the first takeaway |
+| `note: slide 4: ledger has no statement title, so the sentence is drawn as a top-rule title` | A statement slide in a pack without the statement treatment | Accept it, or turn the slide into a content family |
+| `variety: slide 5 drawn under top-plain-large so the deck carries 5 layouts` | The variety pass moved a slide | None; check the slide visually |
+| `Slide 3: title "overlay" is not one of the ledger treatments (...)` | A `title:` value outside the pack | Pick one of the listed treatments |
+| `Slide 6: the comparison family does not take "statement"; it allows ...` | A `title:` value the family cannot draw | Pick from the listed ones |
+
+## What the gate checks
+
+`node <skill>/run.mjs qa deck.pptx` prints JSON; any HIGH finding fails the gate. Six of its
+deck-level checks concern titles:
+
+- **OF-110.** The treatment is read from the title frame's geometry and what is drawn around it,
+  then compared with the name the compiler wrote on the shape (`title@side-rail`). A mismatch is
+  HIGH. A deck of eight or more slides must use at least three treatments, and no more than the
+  variance allows.
+- **OF-111.** Content slides vary their composition: the title zone times the body's column
+  partition (one, two-even, two-asym, three, grid, full-bleed) must reach about 60 % of the
+  content-slide count in distinct values (capped at five), and no one layout may cover more than
+  40 % of the content slides.
+- **OF-113.** Every slide that uses a treatment keeps the same title frame (x, y, width, size).
+  A bottom title keeps its bottom edge instead of its top, which moves with the line count. Never
+  position a title by hand with `::: box`; the frame will drift and the check fails.
+- **OF-114.** Titles and the cover subtitle are labels, as described at the top of this file.
+- **OF-115.** A bottom title whose last line ends more than 12 pt above the body floor, and a side
+  rail more than 40 % empty under its title, fail. What stands in the rail under the title is the
+  rail's: it neither changes the side-rail reading nor counts as a column of the body (OF-111).
+  A text or picture column of a two-column body fails too when its tallest empty band, from the top
+  of the pair down to where the longer column ends, passes 40 % of the body; a source strip at its
+  foot counts as a block but does not hide the band above it.
+- **OF-116.** `node <skill>/run.mjs qa deck.pptx --sibling other.pptx` compares two tonalities of
+  one source: at least two content slides (one on a deck of fewer than four) must take another title
+  zone or column partition.
+- **OF-118.** A point that opens with a bold label and runs on in regular weight keeps a separator
+  after the label (`**요약:** …`). The compiler adds the colon when the source leaves it out, so this
+  fires on a label set by hand.
+- **OF-119.** An agenda title stands without a numeral beside it; the agenda's rows carry the numbers.
+
+## Choosing well
+
+- Let the roles do the work. A deck whose slides have real jobs (a table slide, a chart slide with a
+  takeaway, an agenda, a process) gets its variety from the pack's role map without any `title:`.
+- A short title in a side rail reads as a design choice; a long one reads as a squeezed column.
+  Keep rail titles to eight Korean words or fewer.
+- Use bottom-anchor when the visual is the evidence and the label names it after the reader has
+  looked: a big chart, a photo pair, a KPI row.
+- Do not chase five treatments. Three or four that each mean something are better than five that
+  vary for their own sake.

package/skills/lit-pptx/references/tonalities/atlas.md

@@ -0,0 +1,132 @@
+# Atlas
+
+Atlas is a picture book with captions. Photographs bleed to the edge, titles sit on dark panels
+over pictures or under large images, text stays short and calm, and the photographs bring the
+colour; the pack's own accent is a quiet navy. Pack file: `templates/tonalities/atlas/pack.yaml`.
+
+## Use it for
+
+- Field surveys and site reports where the photographs are the evidence (현장 조사, 시설 점검).
+- Product showcases, portfolios, exhibitions and places.
+- Any deck where 30 % or more of the slides hold a real photograph or screenshot.
+
+## Wrong for
+
+- Decks without real images: a look built around pictures turns into empty frames. Never ship grey
+  placeholder boxes; if there are no photographs, pick another pack.
+- Results tables and charts: Atlas lists no table, chart or references family. A survey with a
+  results table belongs to studio (charts) or ledger (tables).
+- Long reading text.
+
+## Palette roles
+
+| Role | Colour | Used for |
+|---|---|---|
+| ground / surface | white / pale grey `#F3F4F5` | background, rail |
+| ink / ink-muted | charcoal `#1A1D21` / grey `#555B63` | text |
+| line | light grey `#D6D9DD` | hairlines |
+| accent | muted navy `#2B4C7E` | the one marked figure or label |
+| accent-deep / accent-tint | dark navy `#1B2F4E` / pale blue-grey `#E6ECF4` | deep text / number tint |
+| field / on-field | charcoal / white | caption panels, cover plate, closing field |
+| positive / negative | green `#1E7A3F` / red `#B3261E` | signed deltas |
+| series | navy, grey, bronze, sage | charts, if any |
+
+## Type
+
+Pretendard throughout. Compact ramp at density 10. Titles at normal tracking, display slightly
+tight; figures proportional.
+
+## Dials
+
+Density 10, variance 7: up to five treatments, which is all of Atlas's five.
+
+## Title treatments by role
+
+| Role | Default treatment |
+|---|---|
+| content | side-rail |
+| data | top-plain-large |
+| data-takeaway | bottom-anchor |
+| sequence | top-plain-large |
+| image | overlay |
+| statement | statement |
+| reference | side-rail |
+| definition | side-rail |
+
+Treatments: overlay, bottom-anchor, side-rail, top-plain-large, statement. Overlay applies only to
+`image-full`. The cover is drawn on a `plate`, the dark field under the text, that hugs the title
+and its lines and bleeds off the page foot. A statement or quote stands on the whole-page field
+(`drench`): a plate under the lower half would leave the page above it open.
+
+## Families and variants
+
+Families: image-full, image-split, photo-grid, figure-pair, asymmetric-feature, kpi-row,
+comparison, timeline, text-column, statement.
+
+Covers: cover-full-image and cover-split-image (both take the first image in the deck; the cover
+slide itself holds only the title), cover-typographic. Sections: section-image (needs its own
+image), section-field. Closings: closing-contact-split, closing-ask.
+
+Display devices: cover `plate`, statement `drench`, big number on a tint, closing step in a `band`.
+
+## Tables and charts
+
+- Tables `light-grid`: no header fill, row rules, no banding, numbers right-aligned, totals bold.
+  A table can only appear inside a family that holds one (kpi-row, a closing).
+- Charts: hairline gridlines, direct labels, annotation off.
+- Images: bleed allowed, crop allowed, no frame; pictures are cropped to their box with their own
+  proportions, never stretched.
+
+## Decoration vocabulary
+
+caption-band, hairline-rule, colour-field. Text is never placed straight on a photograph; the
+panel carries it.
+
+## Fill behaviour
+
+`fill-order`: anchor-visual, change-family, distribute, step-up. The picture takes the room first.
+
+## Writing for Atlas
+
+- Every image line needs a caption that says what, where and when (`중류 31번 지점, 포장 들뜸과
+  배수구 막힘, 9월 15일`). The caption is numbered automatically.
+- Pair photographs with numbers on the next slide: a KPI row of survey counts, a timeline of works.
+- A figure pair needs one interpretation line with figures (`밤 조도 3 lx, 권장값의 3분의 1`).
+- In image paths use `assets/...` relative to the deck source; the skill ships no photographs.
+
+## Avoid
+
+- Text placed straight on photographs.
+- Images in card frames.
+- More than three images in one row.
+- Grey placeholder boxes in a delivered deck.
+
+## A sample fragment
+
+```text
+---
+tonality: atlas
+title: 해안 산책로 시설 점검
+date: 2026-10-06
+notice: 예시 데이터와 대체 사진
+---
+layout: image-full
+
+## 북측 구간 데크 침하 지점
+
+![북측 3번 데크, 침하 4cm와 난간 흔들림, 9월 22일](assets/example-a.png)
+---
+layout: figure-pair
+
+## 보수 전후의 남측 계단
+
+![보수 전, 디딤판 균열 7곳](assets/example-b.png)
+![보수 뒤, 미끄럼 방지 마감과 조명 2기](assets/example-c.png)
+
+- 보수 뒤 야간 이용자는 하루 평균 140명에서 230명으로 늘었고 미끄럼 신고는 0건
+- 출처: 예시 시설관리과 점검 기록(2026년 6~9월)
+```
+
+## Examples
+
+- `examples/03-field-survey-atlas-ko.md`: Korean riverside park field survey, 9 slides.

package/skills/lit-pptx/references/tonalities/chalk.md

@@ -0,0 +1,132 @@
+# Chalk
+
+Chalk is a good teacher's board, cleaned up. Numbered steps, one concept marked per slide, a fenced
+box for the definition or the common mistake, slightly rounded surfaces, a dark green-black rail and
+a warm rust accent for the thing being taught. Pack file: `templates/tonalities/chalk/pack.yaml`.
+
+## Use it for
+
+- Lectures, training sessions and tutorials (강의, 특강, 사내 교육).
+- Worked examples and how-to sequences with three or more steps.
+- Research tutorials where definitions and formulas carry the talk.
+
+## Wrong for
+
+- Decision decks: the step rhythm reads as padding to an executive.
+- Data reviews: Chalk lists only `table-insight` for numbers, no chart family.
+- Pitches.
+
+## Palette roles
+
+| Role | Colour | Used for |
+|---|---|---|
+| ground / surface | off-white `#FAFBFC` / pale blue-grey `#EEF2F5` | background, aside boxes |
+| ink / ink-muted | slate `#1F2933` / grey `#4E5A66` | text |
+| line | grey `#CBD3DA` | rules |
+| accent | rust `#9A3412` | the concept being taught, step numerals, formula |
+| accent-deep / accent-tint | dark rust `#6B2409` / pale apricot `#FCEBE0` | table header text / table header fill |
+| field / on-field | board green-black `#1F3B33` / white | the rail under a side title, cover rail |
+| positive / negative | green `#1E7A3F` / red `#B3261E` | signed values |
+| series | rust, board green, grey, blue | charts |
+
+## Type
+
+Pretendard throughout. Compact ramp at density 10. Surfaces take a 6 pt radius; chalk is the only light pack
+with rounded corners (night, on its dark ground, is the other).
+
+## Dials
+
+Density 10, variance 6: up to four of its four treatments.
+
+## Title treatments by role
+
+| Role | Default treatment |
+|---|---|
+| content | top-rule |
+| data | top-rule |
+| data-takeaway | side-rail |
+| sequence | kicker-numeral |
+| image | side-rail |
+| statement | statement |
+| reference | top-rule |
+| definition | side-rail |
+
+Treatments: kicker-numeral, top-rule, side-rail, statement. The side rail is the board itself
+(`rail: field`): a dark rail with the title in white. The statement is drawn `drench`, on the field
+over the whole page. Top-rule draws the short rust accent bar. A comparison sets its criteria on the
+board rail under a `side-rail` title (`structure: comparison: side-rail`), kept even when the deck
+already leans on the rail. The agenda draws no numeral (OF-119), so a chalk deck whose only kicker
+was its agenda needs a step or sidebar slide under `kicker-numeral` to keep three treatments
+(OF-110); a sidebar note set across the top adds a top-title grid slide that can push that
+composition past 40 % of the content slides (OF-111).
+
+## Families and variants
+
+Families: step-diagram, process, method, sidebar-note, comparison, image-split, quote, agenda,
+statement, text-column, table-insight.
+
+Covers: cover-rail, cover-typographic, cover-numeral. Sections: section-numeral, section-rail.
+Closings: closing-summary-list, closing-ask.
+
+Display devices: cover `rail`, statement `drench`, big number on a tint, closing step in a `box`.
+
+## Tables and charts
+
+- Tables `header-fill`: a pale apricot header with dark rust labels, row rules, no banding, numbers
+  right-aligned, totals bold.
+- Charts (if a chart appears in a table-insight): hairline gridlines, direct labels, annotation on.
+- Images bleed on one side only, no crop, no frame.
+
+## Decoration vocabulary
+
+accent-rule, mark-underline (listed; not drawn by the current engine), rail-fill, numeral.
+
+## Fill behaviour
+
+`fill-order`: distribute, step-up (off at density 10), change-family, anchor-visual. Teaching slides
+are text-led, so a short Chalk slide spreads its gaps; the gate then reports the empty band, which
+means the slide needs more worked detail.
+
+## Writing for Chalk
+
+- Put the definition or common mistake in `::: main-box` on a `sidebar-note` slide, never buried in
+  a bullet. Give the main column enough material (five groups with two sub-points is about right at
+  density 10).
+- A `method` slide wants the formula as one plain line, then four or five terms each with one or two
+  sub-points. Under side-rail the formula runs across the eight body columns and the terms in two
+  columns under it. Do not add a figure to the same slide; with a figure the formula line is not
+  drawn.
+- Number step heads in the text (`- **1. 목표 온도 강하**`) and give each step the value it produces.
+- A `closing-summary-list` reads as finished with five or six one-line conclusions.
+
+## Avoid
+
+- More than one marked term per slide.
+- Numerals on points that are not a sequence.
+- Definitions buried in bullets instead of the aside.
+
+## A sample fragment
+
+```text
+---
+tonality: chalk
+title: 회귀분석 입문 4주차
+date: 2026-10-06
+notice: 예시 강의 자료
+---
+layout: step-diagram
+
+## 단순 회귀 기울기 계산 순서
+
+- **1. 평균** x 평균 4.0, y 평균 12.6을 먼저 구함
+- **2. 편차곱 합** Σ(x−x̄)(y−ȳ) = 38.4
+- **3. 편차제곱 합** Σ(x−x̄)² = 16.0
+- **4. 기울기** b = 38.4 / 16.0 = 2.4, 절편 a = 12.6 − 2.4 × 4.0 = 3.0
+- 표본 5개의 손 계산 예시로, 스프레드시트 결과와 소수 둘째 자리까지 같음
+- 출처: 예시 교재 4장 예제 4.1
+```
+
+## Examples
+
+- `examples/04-lecture-chalk-ko.md`: Korean thermodynamics lecture on hydrate phase equilibria, 9
+  slides.

package/skills/lit-pptx/references/tonalities/gazette.md

@@ -0,0 +1,137 @@
+# Gazette
+
+Gazette is a Korean briefing paper set as slides. A slate header band carries the title on content
+pages, a boxed one-line conclusion sits on top, itemised evidence fills two columns at reading size,
+and a red key line is the only accent. It is built for decks that are read at a desk, not presented.
+Pack file: `templates/tonalities/gazette/pack.yaml`.
+
+## Use it for
+
+- 보고서형 덱: policy briefings, internal reports and proposals circulated before a meeting.
+- 경영 보고 decks that are read alone, with tables, schedules and a decision page.
+- Any Korean deck with long bodies (about 150 Hangul or more per content slide).
+
+## Wrong for
+
+- A live talk: the density that serves a reader overwhelms a listener. Use signal, night or ledger.
+- Chart-led content: Gazette lists no chart family. A chart-heavy report belongs to ledger.
+- Photo-led content.
+- English decks: it works, but its conventions (개조식, 붙임, 건의 사항) are Korean document habits.
+
+## Palette roles
+
+| Role | Colour | Used for |
+|---|---|---|
+| ground / surface | white / pale slate `#F1F4F8` | background, table banding |
+| ink / ink-muted | deep slate `#1A2230` / grey `#4A5568` | text |
+| line | grey-blue `#C8D0DA` | grid rules, box outline |
+| accent | key-line red `#A61B1B` | the key line only |
+| accent-deep / accent-tint | slate blue `#233A4F` / pale slate `#E8EEF4` | deep text / tint |
+| field / on-field | slate blue `#233A4F` / white | header band, table header, cover band |
+| positive / negative | green `#1E7A3F` / ink | gains; losses in ink with their sign |
+| series | red, slate blue, grey, olive | charts (rare here) |
+
+## Type
+
+Pretendard throughout. Compact ramp at density 10 (body 13 pt, tables 11 pt). Figures tabular.
+
+## Dials
+
+Density 10, variance 4: exactly three title treatments in a deck of eight or more slides. Gazette is
+the pack most likely to need a `title:` key to satisfy the variety checks, because its pages are
+meant to look alike.
+
+## Title treatments by role
+
+| Role | Default treatment |
+|---|---|
+| content | band |
+| data | top-rule |
+| data-takeaway | side-rail |
+| sequence | kicker-numeral |
+| image | side-rail |
+| statement | band (no statement treatment) |
+| reference | top-rule |
+| definition | side-rail |
+
+Treatments: band, top-rule, kicker-numeral, side-rail. Top-rule draws a hairline across the width.
+
+## Families and variants
+
+Families: summary-box-list, text-two-column, text-column, ledger-table, table-insight, comparison,
+timeline, matrix-2x2, agenda, references-appendix.
+
+Covers: cover-band, cover-typographic, cover-index. Sections: section-band, section-rule. Closings:
+closing-decision-box (건의 사항), closing-ask.
+
+Display devices: cover `band`, big number in an `outline`, closing decision in a `box` with an
+outline, and `index: true`: a section page repeats the agenda with the current part marked.
+
+## Tables and charts
+
+- Tables `header-fill`: slate blue header with white labels, a full grid of rules, pale slate
+  banding, numbers right-aligned, totals bold. The densest table style of the eight.
+- Charts: hairline gridlines, direct labels, annotation off.
+- Images: no bleed, no crop, hairline frame.
+
+## Decoration vocabulary
+
+header-band, box-outline, hairline-rule, numeral.
+
+## Fill behaviour
+
+`fill-order`: step-up (off at density 10), distribute, change-family, anchor-visual.
+
+## Writing for Gazette
+
+- Open with `summary-box-list`: a `::: key-message` of one to three lines that states the proposal
+  with its numbers, then four to six headed groups (현황, 원인, 방안, 재원, 운영, 일정) of one or two
+  sub-points each.
+- Keep 개조식 discipline: each level a real sub-point, five items or fewer per level, the same
+  endings throughout a list (noun endings or -함/-임 forms in bullets are fine; titles stay labels).
+- Tables are the evidence: seven rows with a totals row is normal here.
+- End with `closing-decision-box` (건의 사항) and a `references-appendix` titled 붙임.
+- No more than three text families in a row; break them with a table, a timeline or a matrix.
+
+## Avoid
+
+- English section kickers.
+- Red for anything but the key line.
+- A summary box longer than three lines.
+- More than three text families in a row.
+
+## A sample fragment
+
+```text
+---
+tonality: gazette
+title: 공공도서관 야간 개관 확대 방안
+date: 2026-10-06
+notice: 예시 데이터
+---
+layout: summary-box-list
+
+## 핵심 요약
+
+::: key-message
+2027년부터 구립도서관 12곳의 평일 개관을 22시까지 늘리고, 연 운영비 9.4억 원은 인력 재배치로 절반을 충당하는 안
+:::
+
+- **현황** 평일 18시 폐관 도서관 12곳, 18시 이후 이용 요청 연 3,100건
+  (1) 직장인 회원 비율 41%, 평일 이용률은 21%에 그침
+- **방안** 22시까지 연장, 열람실과 대출 창구만 운영
+  (1) 야간 인력 24명 중 12명은 주간 인력 재배치
+- **재원** 연 9.4억 원, 재배치로 4.6억 원 절감
+  (1) 순증 예산 4.8억 원
+- **효과** 평일 방문 연 18만 명 증가 예상
+  (1) 시범 운영 2곳의 야간 방문은 하루 평균 160명
+- **운영** 열람실 좌석 60%와 무인 반납기만 개방
+  (1) 야간 안전 요원 1명씩 배치, 경비 용역에 포함
+- **일정** 27년 1월 4곳, 7월 8곳으로 두 단계 확대
+  (1) 1단계 이용률 30% 미만이면 2단계 대상 조정
+- 출처: 예시구 도서관 이용 통계(2026년 1~8월), 시범 운영 결과
+```
+
+## Examples
+
+- `examples/06-policy-briefing-gazette-ko.md`: Korean public EV-charging policy briefing, 11 slides.