@litfamily/litmuse 0.0.0-stage → 0.1.0

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

@@ -0,0 +1,109 @@
+# Title treatments
+
+A title treatment decides where a slide's title sits, how large it is, what colour it takes and what
+comes with it (a rule, a band, a rail, a numeral, a panel). The engine knows eight. Each one has a
+fixed frame, so every slide that uses a treatment puts its title in exactly the same place; the deck
+gets its variety from using three to five treatments for different slide jobs. A reader learns a
+handful of positions as quickly as one, provided each position always means the same kind of slide.
+
+Two rules hold for all eight. The title is a topic label, never a sentence: a noun phrase that names
+the subject, the measure and, where it matters, the period ("분기별 방문·대출 추이", "Loans per visit by
+branch, 2026"), with the claim in the body as the first takeaway. It never gets an eyebrow or kicker
+word above it. A numeral beside a title is a real part number, step or figure at title size at most,
+never decoration. The gate fails a declarative title or cover subtitle (OF-114): a Korean title that
+ends in -다, -니다, -요 or a nominalised claim (-음, -함, -됨), an English title with a finite verb or
+a final period.
+
+## How a slide gets its treatment
+
+The pack maps each slide role to a default treatment (`role-defaults` in the pack, listed in every
+tonality sheet). Roles come from the family: text families are `content`, tables and KPI rows are
+`data`, charts and big numbers are `data-takeaway`, processes and timelines are `sequence`, picture
+families are `image`, statements and quotes are `statement`, methods are `definition`, references
+are `reference`. A pack may also name a family's own title under `structure` (Paper draws a comparison
+under `top-rule`, Chalk on its board rail under `side-rail`): that title comes before the role default
+and is kept even when the deck already leans on it, so two tonalities of one source differ in
+structure, not only in colour. When the role default is a bottom title the slide may not take (a
+table), the pack's next treatment in order stands in for it.
+
+The engine then lays the slide out under every treatment the family and the pack both allow. It
+keeps the role default when the body fills to the density band; otherwise it takes the treatment
+that leaves the smallest empty band, with a cost for repeating the previous slide's treatment and a
+cap so that no fill-chosen treatment covers more than about a third of the deck. The variance dial
+caps how many distinct treatments one deck mixes. The compile log names every slide whose
+treatment moved away from the role default.
+
+To pin one slide, put a `title:` key on the line after `layout:`. It must name a treatment the pack
+and the family both allow, or the compile stops with the allowed list:
+
+```markdown
+---
+layout: chart-insight
+title: bottom-anchor
+
+## 피크 시간대 처리량은 오후 3시에 가장 낮다
+…
+---
+```
+
+Covers, sections and closings take their own variant's title and refuse a `title:` key.
+
+## The eight
+
+Geometry is for the standard 16:9 grid (48 pt margins, 74 pt column pitch); the dense and airy grids
+keep the same columns and y values. Glyph budgets are for Korean at the presented ramp; Latin text
+takes about twice as many characters.
+
+| Treatment | Where the title sits | Comes with | Body | Fits | Budget |
+|---|---|---|---|---|---|
+| `top-rule` | columns 1-12 at the top (y 36), title size | a short accent rule or a full hairline 6 pt under it | y 120-486 under it | content and data pages that are read | one line, about 27 glyphs |
+| `top-plain-large` | columns 1-10 at the top, display size | nothing | starts 24 pt under the title | comparison, image-split, pages that open on one claim | two lines of about 16 glyphs |
+| `side-rail` | columns 1-4 down the left, title size | an optional tinted rail or a hairline at column 4 | columns 5-12, top-aligned with the title; the rail under the title holds criteria labels, takeaways and the source | a chart or picture with its takeaways, a comparison with labelled criteria | four lines of about 8 glyphs |
+| `band` | inside a full-width band 108 pt tall | the band in the field colour, the title on it | y 132-486 | Korean briefing pages, data pages on a dark deck | one line, about 25 glyphs |
+| `statement` | columns 1-10, centred between y 120 and 486, display size | an optional support line under it | none: the text is the content | a pull quote, or a display-led deck the user asked for | three lines of about 16 glyphs |
+| `overlay` | a dark panel at the lower left over a full-bleed picture | the panel at 88 % opacity, a caption on it | none: the picture is the content | full-picture slides | two lines of about 15 glyphs |
+| `kicker-numeral` | columns 3-12 at the top, with a large numeral in columns 1-2 | the numeral in the accent colour (the part number; never an agenda's row count) | y 132-486 | steps, numbered recommendations | one line, about 23 glyphs |
+| `bottom-anchor` | columns 1-9, the title frame's bottom edge on the body floor (y 486), so no band is left under it | an optional hairline 12 pt above the title | y 36 to 24 pt above the title for the visual | chart-led, figure-led and big-picture slides | two lines of about 20 glyphs |
+
+Over budget, the engine moves the slide to another allowed treatment and says so in a `note:` line;
+a `title:` key that asks for an over-budget treatment stops the compile, because a pinned choice
+that cannot hold the title is an authoring error. Shorten the title or pick another treatment.
+
+## Choosing well
+
+- **Data with a takeaway** reads best under `side-rail` or `bottom-anchor`: the title sits beside or
+  under the chart and explains it, and the chart gets the full height.
+- **A claim** is not a title. It opens the body under a label: a boxed summary over its reasons, a
+  data panel of the figures behind it, or the first takeaway beside a table or chart. `statement`
+  stays for pull quotes and decks the user asks to be display-led; a lone sentence on a page holds
+  too little.
+- **A sequence** wants `kicker-numeral` when the number is real: the step, the part, the
+  recommendation. A numeral on a list that has no order is a defect.
+- **Korean briefing pages** use `band`: the strong repeated head tells a desk reader where each page
+  starts, and the body under it can be dense.
+- **Pictures** use `overlay` only on a full-bleed image, and `bottom-anchor` when a large picture
+  sits above its title.
+
+Keep within one treatment's frame. Never move a title by hand with a free box: the frame is the
+treatment, and a nudged title is a second, broken treatment.
+
+## How the gate reads it
+
+`qa_deck.py` classifies every title from the compiled file by geometry and companions, in this order:
+overlay, band, statement, bottom-anchor, side-rail, kicker-numeral, top-plain-large, top-rule. The
+engine also writes the intended treatment into the title shape's name, and the gate compares the
+two; the written name alone is never taken as evidence.
+
+- **OF-110** fails on a deck of eight or more slides when fewer than three treatments are used
+  (cover and section titles not counted) or more than the variance dial allows. On a deck of any
+  length it fails when a title fits none of the eight, or when a title is drawn as a different
+  treatment than its name says.
+- **OF-113** fails when two slides with the same treatment place their title frames more than 1 pt
+  apart (a statement only compares x and width, because it is centred on its own line count; a bottom
+  title compares x, width and its bottom edge, because it stands on the floor).
+- **OF-115** fails a bottom title that ends more than 12 pt above the body floor and a side rail more
+  than 40 % empty under its title. Text in the rail under the title is the rail's: it neither changes
+  the side-rail reading nor counts as a body column.
+
+On a legacy template the variety checks report as advisories, because the user asked for that
+template's single title position.

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

@@ -0,0 +1,139 @@
+# Atlas
+
+Atlas is a picture book with good captions. Photographs bleed to the edge or take most of the body,
+titles sit on a dark panel over the picture or under it, and the words stay calm but carry the
+facts each picture needs: what, where, when and how much. The
+palette is quiet on purpose, a near-black ink and one muted navy, because the photographs bring the
+colour. Every picture carries a numbered caption and its source, which keeps the deck honest about
+what the reader is looking at.
+
+## When to use it
+
+Use Atlas when the evidence is visual: product reports, portfolios, site and field visits,
+renovation or construction progress, exhibitions. It is the first candidate for the image-led deck
+type and moves up whenever a third or more of the slides hold an image or a screenshot. It works for
+a client or a review panel who judges by seeing, and it suits short narrative text between pictures.
+
+## When it is the wrong choice
+
+Atlas fails without real images. A pack built around pictures turns into grey boxes when the
+source has none, so for a text or number deck pick Ledger, Gazette or Signal. It keeps a
+statement for the one claim a picture deck needs, but a deck that lives on one-line claims belongs
+in Signal or Studio. Long tables also sit awkwardly here, because its table style is light and its
+families give
+the room to images.
+
+## Tokens
+
+These values are read from the pack file `pack.yaml` of the `atlas` tonality.
+
+| Token | Value |
+|---|---|
+| ground / surface | `#FFFFFF` / `#F3F4F5` |
+| ink / ink-muted | `#1A1D21` / `#555B63` |
+| line | `#D6D9DD` |
+| accent / accent-deep / accent-tint | `#2B4C7E` / `#1B2F4E` / `#E6ECF4` |
+| field / on-field | `#1A1D21` / `#FFFFFF` |
+| positive / negative | `#1E7A3F` / `#B3261E` |
+| series | `#2B4C7E`, `#555B63`, `#8A6A2E`, `#3E7A5A` |
+| faces | title Pretendard Bold, body, label, display and numerals Pretendard Regular; `faces: a2z` swaps display and numerals to A2Z Light |
+| ramp / hero | compact (body 13 pt, labels 11, sources 9) / no hero step, figures at most title size |
+| density / variance | 10 / 7 |
+| radius / edge | 0 / fill |
+| table | light grid: no header fill, bold ink header, hairline rows, no banding, numbers right-aligned, totals bold |
+| chart | hairline gridlines, direct labels, accent on the item that matters |
+| image | no frame |
+| decoration | caption band, hairline rule, colour field |
+
+## Treatments by slide role
+
+Image slides take `overlay`, where the title sits on a dark panel over a full-bleed photograph.
+Charts and figures with a takeaway take `bottom-anchor`, so the visual fills the top and the title
+explains it from below. Text, reference and definition slides take `side-rail`, data and
+sequences take `top-plain-large`, and a pull quote takes `statement` on the dark field over the
+whole page (a plate under half the page left its top half open). The
+engine starts from the role's treatment and, when
+the body would stay half empty, tries the others the family allows and keeps the one that fills,
+within the variance cap. A `title: <treatment>` line under `layout:` pins one slide, provided the
+family allows it; `image-full` only ever takes `overlay`.
+
+## Families and variants
+
+- `image-full`: one photograph across the whole slide with the title on its panel.
+- `image-split`: a large image beside three or four short facts about it.
+- `photo-grid`: up to three images in a row, with one line under them.
+- `figure-pair`: before and after, or two places, side by side with one line of evidence.
+- `asymmetric-feature`: one image or number given most of the width, with short evidence.
+- `kpi-row`: two to four numbers that prove the pictures, each with a basis row and a sourced caption.
+- `comparison`: two options or two problems, row by row.
+- `timeline`: dated next steps on one axis.
+- `text-column`: the short narrative that opens or links the picture sections.
+
+Covers are `cover-full-image` (it takes the first image in the deck; the title's panel is only as
+tall as the title and its meta line and stands on the foot of the page, so the picture keeps the rest), `cover-split-image` and
+`cover-typographic`. Sections are `section-image` and `section-field`. Closings are
+`closing-contact-split` and `closing-ask`. A cover takes no image block of its own; put the picture
+on a content slide and the cover finds it.
+
+Display slides. Without a picture, the typographic cover puts the title on a dark plate over the
+lower part of the page, like a caption under a photograph that is not there. A pull quote fills the
+page with the dark field, the quotation in the middle. A closing's rows carry their dates or amounts at title size, and the next step runs in a dark
+band above the footer.
+
+## Do
+
+Give every photograph a numbered caption with its source. Let one image dominate each slide, and
+write the facts about it next to it in short lines, with a number, a date or a place in each. Title
+each slide with a label (place, subject, period) and let the first fact carry the claim. Keep the
+narrative slides brief and use them to move from one group of pictures to the next. End with the ask
+and the dated next step.
+
+## Avoid
+
+Avoid text placed straight on a photograph without the panel, images in card frames, and more than
+three images in one row. Never deliver a deck with grey sample boxes in place of the real pictures.
+Keep the `statement` family for a pull quote; claims belong in the first fact or the caption of the
+picture that proves them, never in the title.
+
+## Two worked slides
+
+An image-split slide puts the picture first and five short facts beside it, the claim in the first,
+so the reader gets the evidence without a paragraph.
+
+```markdown
+---
+layout: image-split
+
+## 재개관 첫 주 창가 좌석 이용 현황
+
+![도 2. 오후 3시의 창가 좌석 | 출처: 예시 이미지](assets/example-b.png)
+
+- **요약** 창가 좌석은 개관부터 마감까지 하루 종일 차 있다
+- **좌석 수** 창가 좌석을 24석에서 56석으로 늘렸다
+- **점유율** 재개관 첫 주 오후 점유율이 92%였다
+- **조명** 창가에 차양을 달아 오후 눈부심 민원이 없었다
+- **동선** 서가를 벽 쪽으로 옮겨 통로 폭이 1.2m에서 1.8m가 됐다
+---
+```
+
+A figure pair shows the change, and the lines under both pictures state it with its basis.
+
+```markdown
+---
+layout: figure-pair
+
+## 공사 전후 어린이실 좌석 배치
+
+![도 3. 공사 전 어린이실 | 출처: 예시 이미지](assets/example-b.png)
+
+![도 4. 공사 후 어린이실 | 출처: 예시 이미지](assets/example-b.png)
+
+- 공사 전후의 어린이실은 같은 방으로 보이지 않는다
+- 낮은 서가와 계단식 좌석으로 동시 착석이 18명에서 40명으로 늘었다
+- 주말 어린이실 이용은 하루 평균 95명에서 160명이 됐다 (예시)
+---
+```
+
+## Examples
+
+`08-image-led-atlas-ko.md` uses the pack defaults (density 10, variance 7).

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

@@ -0,0 +1,148 @@
+# Chalk
+
+Chalk is a good teacher's board after someone has tidied it. Steps are numbered because they really
+happen in order, one idea per slide is marked as the thing to learn and worked through with its
+numbers, and the definition or the
+common mistake sits in its own fenced box at the side. Surfaces have soft corners, the ground is a
+cool near-white, and a warm rust accent always points at what is being taught. The rhythm is
+deliberate: explain, show, try, check.
+
+## When to use it
+
+Choose Chalk for lectures, tutorials, onboarding sessions and training, where the audience has to be
+able to do something afterwards. It is the first candidate for the lecture deck type and a good
+second for a research talk given as a tutorial. It climbs the list when the source contains
+equations, definitions or a "how it works" sequence of three or more steps, which are exactly the
+slides its numbered and sidebar families are built for.
+
+## When it is the wrong choice
+
+Chalk is wrong for decision decks. A board of numbered steps in front of executives reads as padding
+and slows the ask; Ledger or Signal fit that room. It is also a poor match for a dense data review,
+because its families favour a few explained items over many numbers on one page, and for
+image-led portfolios, where Atlas lets pictures carry the slides.
+
+## Tokens
+
+These values are read from the pack file `pack.yaml` of the `chalk` tonality.
+
+| Token | Value |
+|---|---|
+| ground / surface | `#FAFBFC` / `#EEF2F5` |
+| ink / ink-muted | `#1F2933` / `#4E5A66` |
+| line | `#CBD3DA` |
+| accent / accent-deep / accent-tint | `#9A3412` / `#6B2409` / `#FCEBE0` |
+| field / on-field | `#1F3B33` / `#FFFFFF` |
+| positive / negative | `#1E7A3F` / `#B3261E` |
+| series | `#9A3412`, `#1F3B33`, `#4E5A66`, `#2E6A8E` |
+| faces | Pretendard Bold for display, title and numerals, Pretendard Regular for body and labels; `faces: a2z` swaps to A2Z Bold display and titles, A2Z Black numerals |
+| ramp / hero | compact (body 13 pt, labels 11, sources 9) / no hero step, figures at most title size |
+| density / variance | 10 / 6 |
+| radius / edge | 6 / fill |
+| rail | the side rail is a field-coloured fill |
+| table | header row in the accent tint with deep-accent bold text, hairline rules between rows, no banding, numbers right-aligned, totals bold |
+| chart | hairline gridlines, direct labels, accent on the item that matters and muted colours on the rest |
+| decoration | accent rule, marked term underline, rail fill, numeral |
+
+The marked-term underline is listed in the pack but the engine does not draw it yet, so mark the
+term
+in the wording for now.
+
+## Treatments by slide role
+
+Sequences take `kicker-numeral`, where the step or part number stands left of the title at title size. Text
+and data slides take `top-rule` with its short accent bar, chart and image slides with a takeaway
+take `side-rail`, definitions take `side-rail`, a comparison sets its criteria on the board rail under a
+`side-rail` title (the pack's `structure`), and a pull quote takes `statement`. When a slide's own
+treatment would leave the body half empty, the engine tries the other treatments its family allows
+and keeps the one that fills best, within the number of treatments the variance dial allows. A
+`title: top-rule` line under `layout:` pins a slide to a treatment; the lecture example does that
+for
+a method slide whose definitions need the full width. An agenda carries 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), and a sidebar note set across the top adds one more top-title slide
+in a grid, which can carry top/grid past 40 % of the content slides (OF-111).
+
+## Families and variants
+
+- `step-diagram`: numbered steps across the body, each with its action and detail.
+- `process`: the same steps when they read as a flow rather than a procedure.
+- `method`: a formula with the meaning of each symbol under it.
+- `sidebar-note`: the explanation with a fenced box for the definition or the trap.
+- `comparison`: two ideas students confuse, side by side row by row.
+- `image-split`: a worked example with its figure.
+- `quote`: a line worth remembering, set as a statement.
+- `agenda`: what the session covers, numbered.
+- `statement`: a pull quote or the lesson's rule, kept for a display-led deck the user asks for.
+- `text-column`: an explanation at reading measure.
+- `table-insight`: a small table with the pattern spelled out beside it.
+
+Covers are `cover-rail`, `cover-typographic` and `cover-numeral`. Sections are `section-numeral` and
+`section-rail`. Closings are `closing-summary-list` (the recap plus the exercise) and `closing-ask`.
+
+Display slides. The typographic cover is the board-green rail with the topic name beside it. A
+statement is written on the board: the whole slide in the field green, the quoted line in white. A section
+numeral reads as the part of the whole ("03 / 04") when the deck has an agenda. A closing's rows are
+keyed by their dates, and the next step sits in a tinted box on the body floor.
+
+## Do
+
+Use numbers only for things that happen in order or for real parts of the session. Put every
+definition and every common mistake in a sidebar box, where students can find it again. Give each
+worked example the actual arithmetic, step by step, with a sample value at each step. Title each
+slide with what it teaches ("신뢰구간 계산 네 단계"), and put the rule in the first line of the body. End with what was learnt and what to practise,
+with a due date.
+
+## Avoid
+
+Avoid more than one marked term per slide; two underlines mean neither is the point. Avoid numerals
+on points that are not a sequence. Do not bury a definition inside a bullet list. Avoid a sentence
+as a title; the slide names the topic and the body states the rule.
+
+## Two worked slides
+
+A step slide spells out each action, its detail and a worked value, so the steps fill the body and
+can be followed without the speaker.
+
+```markdown
+---
+layout: step-diagram
+
+## 95% 신뢰구간 계산 네 단계
+
+- **1. 평균 구하기** 표본 값의 합을 n으로 나눈다 · 예: 키 표본 25명, 평균 168cm
+- **2. 표준편차 구하기** 편차 제곱의 평균에 제곱근을 씌운다 · 예: 10cm
+- **3. 표준오차 구하기** 표준편차를 √n으로 나눈다 · 예: 10 ÷ 5 = 2cm
+- **4. 구간 만들기** 평균 ± 1.96 × 표준오차 · 예: 164.1-171.9cm
+---
+```
+
+A sidebar slide names each wrong reading and why it fails, and keeps the right reading in the box;
+the title labels the topic.
+
+```markdown
+---
+layout: sidebar-note
+title: top-rule
+
+## 신뢰구간 해석의 흔한 오류 두 가지
+
+- **참값이 이 구간 안에 있을 확률이 95%라는 읽기**
+  (1) 참값은 정해진 하나의 수라서 확률로 말하지 않는다
+  (2) 확률은 구간을 만드는 방법에 붙는 말이다
+- **학생의 95%가 이 구간 안에 있다는 읽기**
+  (1) 구간은 평균에 대한 것이고 개인 값의 범위가 아니다
+  (2) 개인 값의 범위는 표준편차로 따로 말한다
+
+::: main-box
+같은 방법으로 구간을 100번 만들면 약 95개가 참값을 담는다고 읽는다
+:::
+
+- **확인 질문** 표본을 100명으로 늘리면 구간 폭은 어떻게 바뀌는가 (답: 절반)
+---
+```
+
+## Examples
+
+`06-lecture-chalk-ko.md` and `12-research-tutorial-chalk-en.md` both use the pack defaults (density
+10, variance 6).

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

@@ -0,0 +1,149 @@
+# Gazette
+
+Gazette sets a Korean briefing paper as slides. A slate header band carries the title on most
+content
+pages, a boxed one-line conclusion opens the argument, and 개조식 evidence runs in two columns at
+reading size. Tables have a filled header and a light grid, the first column is shaded, and a deep
+red is kept for the key line alone. The deck is meant to be read at a desk, page by page, with
+nobody
+presenting it.
+
+## When to use it
+
+Choose Gazette when the deck is a 보고서형 document: sent ahead of a meeting, circulated for
+approval, or filed as the record of a review. The signals that move it up are a brief that says the
+deck is read rather than presented, Korean as the language, long bodies (150 Korean glyphs per
+content slide and more) and a fair share of tables. It is the first candidate for the Korean text
+briefing and the second for business reviews and status updates that circulate in Korean.
+
+## When it is the wrong choice
+
+Gazette is wrong for a live talk. The density that serves a reader overwhelms a listener, and the
+band titles make every page look equally important. It is also wrong for image-led decks: pictures
+stay small and framed. English decks that are read rather than presented are better served by
+Ledger, because Gazette's conventions (header band, boxed summary, itemised endings) come from the
+Korean briefing form.
+
+## Tokens
+
+Read from the pack file; these are the values the engine draws.
+
+| Token | Value |
+|---|---|
+| ground / surface | #FFFFFF / #F1F4F8 |
+| ink / ink-muted / line | #1A2230 / #4A5568 / #C8D0DA |
+| accent / accent-deep / accent-tint | #A61B1B / #233A4F / #E8EEF4 |
+| field / on-field | #233A4F / #FFFFFF |
+| positive / negative | #1E7A3F / #1A2230 |
+| series | #A61B1B, #233A4F, #4A5568, #7A6A2A |
+| faces | Pretendard Bold for display, title and numerals, Pretendard Regular for body and labels; `faces: a2z` swaps display and numerals to A2Z Bold |
+| ramp / hero | compact (body 13 pt, labels 11, sources 9) / not allowed, figures at most title size |
+| density / variance | 10 / 4 |
+| radius / edge | 0 / fill and border |
+| table | header-fill style, field header with on-field text, a grid on every cell, the first column shaded, bold totals |
+| chart | hairline gridlines, direct labels, accent on the highlighted series |
+
+Density 10 is the compact step every pack now starts from: 24 pt side margins, body 13 pt with no
+step-up, table rows from 18 pt and up to 22 lines per text column, titles close over the body. Variance 4 allows exactly three title treatments in a deck. That is deliberate: a briefing repeats
+its page head, and variety comes from the body families instead.
+
+## Treatments by slide role
+
+Content and statement slides take `band`; data and reference slides take `top-rule`; data with a
+takeaway, image and definition slides take `side-rail`; sequences take `kicker-numeral`. The engine
+starts from that map and keeps the role default when the body fills; otherwise it lays out the other
+treatments the family allows and keeps the one with the least empty band, within the three the
+variance dial permits. To give one slide a side rail, write `title: side-rail` on the line after
+`layout:`; example `09-briefing-gazette-ko.md` does this for its comparison of options.
+
+## Families and variants
+
+- `summary-box-list` opens with the boxed conclusion (a `::: key-message` block) and the 개조식
+  evidence under it in two columns.
+- `text-two-column` and `text-column` carry background and findings as itemised text.
+- `ledger-table` sets a table with its reading under it; `table-insight` sets the reading beside it.
+- `comparison` lays options side by side across shared rows.
+- `timeline` shows dated steps with owner and output.
+- `matrix-2x2` sorts measures by effect and difficulty.
+- `agenda` lists the parts; `references-appendix` is the 붙임 page of sources and definitions.
+
+Covers are `cover-band`, `cover-typographic` and `cover-index`; sections are `section-band` and
+`section-rule`; closings are `closing-decision-box` (건의 사항 with a decision table) and
+`closing-ask`.
+
+Display slides. The typographic cover opens under the slate band. A big number is a data panel on the
+surface inside an ink outline, the box language of a briefing paper: two to four figures, each with
+its label and basis, never one figure alone. The section band carries the deck's
+part index, this part marked, with the part title on the ground below. A closing's rows are keyed by
+their deadlines, and the next step sits in an outlined box on the body floor.
+
+## Do
+
+- Put the conclusion first, in the summary box, in one or two lines; the title stays a label
+  ("핵심 요약: 재택근무 운영안 건의"), never the conclusion itself.
+- Give each figure its basis (전년 대비, 시범 전후, 목표) and the table a caption with period and source.
+- Keep 개조식 levels honest: level one states the claim, level two the evidence, at most five items
+  per level, with consistent endings.
+- Give the timeline a third column with owner and output, so each event fills three or four lines.
+- End with a decision table: what to decide, who decides, by when.
+
+## Avoid
+
+- English section kickers or labels on a Korean page.
+- Red for anything other than the key line.
+- A summary box longer than three lines.
+- More than three text families in a row; break them with a table, a timeline or a comparison.
+- The `statement` family; a single claim becomes the summary box.
+
+## Two worked slides
+
+The summary page labels the topic in its band, states the recommendation in the box and lays the
+evidence under it.
+
+```markdown
+---
+layout: summary-box-list
+
+## 핵심 요약: 재택근무 주 2일 정례화 건의
+
+::: key-message
+재택근무를 주 2일로 정례화하되, 팀마다 협업일 하루를 지정해 대면 회의를 그날에 모은다
+:::
+
+- **시범 운영 결과**
+  (1) 월평균 이용률 78%, 본부 간 편차 최대 21%p
+  (2) 업무 만족도 3.4점에서 4.1점으로 상승 (5점 척도)
+  (3) 시범 기간 2026년 4-9월, 6개 본부 1,240명 (예시)
+- **남은 불편**
+  (1) 불편 사항의 64%가 회의 일정 조율과 대면 협업 부족
+  (2) 주간 회의 시간 1인당 4.1시간에서 5.3시간으로 증가
+  (3) 협업일 지정 팀은 회의 시간 증가가 0.4시간에 그침
+- **시행 조건**
+  (1) 협업일은 팀장이 분기마다 지정, 전사 공통 요일 없음
+  (2) 회의실 예약 체계 개편 후 2027년 1월 전면 시행
+---
+```
+
+The closing labels the request, turns it into a decision table, and states the ask and the follow-up
+above it.
+
+```markdown
+---
+layout: closing-decision-box
+
+## 건의 사항: 결정 요청 사항과 기한
+
+- 아래 세 가지를 기한 안에 결정해 주시기 바랍니다
+- 결정 후 인사기획팀이 11월 첫째 주까지 세부 시행 계획을 보고한다
+
+| 결정 사항 | 담당 | 기한 |
+|---|---|---|
+| 안 2(주 2일 정례화 + 협업일 지정) 채택 여부 | 경영위원회 | 10월 넷째 주 |
+| 회의실 예약 체계 개편 예산 4천만 원 | 재무팀 | 10월 말 |
+| 노사협의회 심의 상정 시기 | 인사기획팀 | 11월 첫째 주 |
+---
+```
+
+## Examples
+
+`09-briefing-gazette-ko.md`