@litfamily/litopencode 1.0.31 → 1.0.33

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

@@ -1,13 +1,16 @@
 # 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
+A title treatment decides how a slide's title looks: 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
 (`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.
+fills better under it. None of them moves the title: every content title sits in the slide grid's one
+title zone (`scripts/lib/slide-grid.js`: columns 1-10, y 36, 72 pt tall) and its body starts at y 120,
+whichever treatment and whichever tonality draws it; a statement sits in the display title zone. The
+deck gets its variety from three to five treatments for different slide jobs, and a reader never has
+to look for the title.
 
-This file covers the geometry of each treatment, which packs allow it, how a slide gets its
+This file covers what each treatment draws, which packs allow it, how a slide gets its
 treatment, the per-slide `title:` key, and what the gate checks.
 
 ## Titles name a topic
@@ -35,121 +38,65 @@ 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.
+Geometry is in points on the 16:9 canvas (12 columns, 24 pt margins, 78 pt pitch); the 4:3 canvas keeps
+the same y values. The density dial changes type and spacing inside the zones, never the zones. Glyph
+budgets are for Korean at the presented ramp, with the reading ramp in brackets; Latin text takes about
+twice as many characters.
+
+| Treatment | Title | Comes with | Body | Fits | Budget |
+|---|---|---|---|---|---|
+| `top-rule` | the title zone, title size | a short accent rule or a full hairline 4 pt under the title's last line | y 120-486 | content and data pages that are read | two lines of about 23 glyphs (29) |
+| `top-plain-large` | the title zone, display size | nothing | y 120-486 | comparison, image-split, pages that open on one claim | one line of about 17 glyphs (two of 21) |
+| `side-rail` | the title zone, title size | a bar in the left margin: the page's full height in the rail colour when the pack fills its rail, else as tall as the title zone in the accent | y 120-486 | a chart or picture with its takeaways, a comparison with labelled criteria | as `top-rule` |
+| `band` | the title zone, title size, in the on-field colour | the field colour from the page's top edge to the title zone's foot (y 108) | y 120-486 | Korean briefing pages, data pages, a newspaper masthead | as `top-rule` |
+| `statement` | the display title zone (columns 1-9, y 132-348), display or hero size, centred | an optional support line in the support zone (y 372) | none: the text is the content | a pull quote, or a display-led deck the user asked for | three lines of about 15 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` | the title zone, title size | the numeral at cover size in the aside zone right of the title (columns 11-12), in the accent colour; the part number, never an agenda's row count | y 120-486 | steps, numbered recommendations | as `top-rule` |
+| `bottom-anchor` | the title zone, title size | a heavy rule (2 to 4 pt) across the columns at the zone's foot | y 120-486 | chart-led, figure-led and big-picture slides | as `top-rule` |
+
+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.
+
+Details that decide a choice:
+
+- **kicker-numeral.** The engine supplies the number; 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, and a slide with no such number cannot be drawn under it, 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.
+- **statement.** 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. A statement is a pull quote or the one
+  framing line of a live pitch; a claim is not a slide title, so most decks need none. In ledger and
+  gazette a `statement` slide is drawn as the largest top title the pack has, and the compile log
+  notes it. Studio frames it between two hairlines on the open page (`display.statement: rules`).
+- **overlay.** 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. Contrast is judged on the
+  panel, never on the photograph.
+- **bottom-anchor.** 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. The visual
+  gets the body's full height under the title.
+- **side-rail.** What belongs beside the title (a comparison's criteria labels, a chart's takeaways,
+  the source and note) is set in the body, level with its rows. A bar in the left margin marks the
+  title; it carries no text.
+
+Never move a title by hand with a free box: the zone is the slide grid's, and a nudged title breaks
+the one place every theme keeps.
 
 ## 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 | |
+| Treatment | ledger | signal | atlas | chalk | paper | gazette | studio | night | computational-brutalism | neo-brutalism | bauhaus | riso | newsroom |
+|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
+| top-rule | yes | yes | | yes | yes | yes | | | yes | | yes | | yes |
+| top-plain-large | | yes | yes | | | | yes | yes | yes | yes | | yes | |
+| side-rail | yes | | yes | yes | yes | yes | yes | yes | yes | | yes | yes | |
+| band | | | | | | yes | | yes | | yes | | yes | yes |
+| statement | | yes | yes | yes | yes | | yes | yes | yes | yes | yes | yes | yes |
+| overlay | | | yes | | | | yes | | | | | | |
+| kicker-numeral | yes | | | yes | | yes | | yes | | yes | yes | yes | yes |
+| bottom-anchor | yes | yes | yes | | yes | | yes | | yes | yes | yes | | yes |
 
 ## How a slide gets its treatment
 
@@ -164,7 +111,7 @@ 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
+   `top-rule`, Chalk sets its criteria as row heads in the body under a `side-rail` title; 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).
@@ -237,23 +184,23 @@ deck-level checks concern titles:
   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
+- **OF-111.** Content slides vary their composition: the title treatment 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-113.** Every content title keeps one frame and every statement keeps the display frame
+  (x, y, width, height within 1 pt), whatever its treatment. A title over a full-bleed picture keeps
+  its own panel. 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-115.** A text or picture column of a two-column body fails 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). A takeaway column that stops
+  short of the visual beside it, a title panel taller than its text and a plate under an empty page
+  fail too.
 - **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.
+  one source: every slide must place its title frame and its body's top-left corner in the same
+  spot. A tonality changes the look and never the place.
 - **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.
@@ -263,9 +210,11 @@ deck-level checks concern titles:
 
 - 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.
+- Keep titles inside the two-line budget of the title zone; a longer one moves the slide to another
+  treatment, and a pinned one stops the compile.
+- Use bottom-anchor when the visual is the evidence and the heavy rule closes the label: a big
+  chart, a photo pair, a KPI row. A data slide with a takeaway reads best under it or side-rail.
+- A claim is not a title. It opens the body under a label; `statement` stays for pull quotes. A
+  sequence wants kicker-numeral only when the number is real, and Korean briefing pages use band.
 - 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

@@ -1,7 +1,7 @@
 # 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
+over full-bleed pictures or in the slide grid's title zone above a large image, 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
@@ -34,7 +34,7 @@ colour; the pack's own accent is a quiet navy. Pack file: `templates/tonalities/
 ## Type
 
 Pretendard throughout. Compact ramp at density 10. Titles at normal tracking, display slightly
-tight.
+tight. Cover and statement titles take the hero step (60 pt) when their words fit; `hero: false` in the front matter turns it off. A figure is never larger than a title.
 
 ## Dials
 
@@ -53,7 +53,7 @@ Density 10, variance 7: up to five treatments, which is all of Atlas's five.
 | reference | side-rail |
 | definition | side-rail |
 
-Treatments: overlay, bottom-anchor, side-rail, top-plain-large, statement. Overlay applies only to
+Treatments: overlay, bottom-anchor (the title closed by a heavy rule over a visual that takes the body's full height), 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.

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

@@ -0,0 +1,140 @@
+# Bauhaus
+
+Bauhaus is the direction for a talk about making things: design, architecture, craft, art history,
+culture. Its display slides carry an elementary composition, a yellow square, a red circle, a black
+bar and a blue triangle set on the grid, beside a heavy title on an off-white ground. The content
+slides are quiet on purpose: black type, a short red rule under each title, open tables and one red
+accent. The geometry is the voice, so it appears where the deck speaks (the cover and the
+statements) and stays out of the pages where the audience reads.
+
+## When to use it
+
+Reach for Bauhaus for a design or architecture lecture, a museum or exhibition opener, a workshop on
+brand or product design, a culture programme, a portfolio review for a design school, or a talk on
+the history of a style. The content signals that point here are images and few numbers, a sequence
+of ideas or periods, quotations from makers, and words such as 디자인, 건축, 전시, 워크숍, 바우하우스,
+Bauhaus, modernism or "primary colours". It is the first candidate for a design or culture lecture,
+before Studio, and the second for a creative workshop.
+
+## When it is the wrong choice
+
+It fails for a data-heavy business review, finance, a public-sector report and any deck where tables
+make up a third of the slides: the display geometry has nothing to say about a ledger. It is wrong
+for grief, safety or financial-loss topics, where primary colours read as careless. For a deck that
+is mostly pictures, Atlas or Studio frames them better; for a pitch, Signal or Neo-Brutalism.
+
+## Tokens
+
+The values below come from the pack file and are what the engine draws.
+
+| Token | Value |
+|---|---|
+| ground / surface | #F4F1EA / #E8E3D6 |
+| ink / ink-muted / line | #141414 / #4A4740 / #141414 |
+| accent / accent-deep / accent-tint | #C8261C / #7A140E / #F2C230 (the yellow of the geometry) |
+| field / on-field | #1F3C99 / #FFFFFF |
+| positive / negative | #1E6B3A / #141414 |
+| series | #C8261C, #1F3C99, #141414, #9E7700 |
+| faces | Pretendard Bold for display, title, labels and numerals, Pretendard Regular for body; `faces: a2z` swaps to A2Z Black display, titles and numerals |
+| ramp / hero | compact (body 13 pt, labels 11, sources 9) / hero step (60 pt) on cover and statement titles that fit, off with `hero: false`; figures at most title size |
+| density / variance | 10 / 7 |
+| radius / edge | 0 / fill |
+| decoration | a short accent rule under top titles, kicker numerals, colour fields |
+| table | open, no header fill, a rule under the header, bold totals |
+| chart | no gridlines, direct labels, the accent on the highlighted series over muted ones |
+
+Density 10 sets the lecture on the compact grid (24 pt side margins), body 13 pt and no step-up, as
+every pack in the family. The fourth series colour
+is the geometry's yellow darkened to an ochre so a bar still holds 3:1 on the ground; the bright
+yellow itself is kept for fills (the square, the notice tag, a highlighted table row), never for text.
+A loss uses ink with a ▼ sign.
+
+## QA allowances
+
+Red, blue and yellow sit side by side on a cover, statement or content slide inside the default
+OF-101 limit (four hue families; a fifth fails), so this pack needs no `qa:` allowance.
+
+## Treatments by slide role
+
+Content, data and reference slides take `top-rule` (the title over a short red rule); data with a
+takeaway and definitions take `side-rail`; sequences `kicker-numeral`; image slides `bottom-anchor`;
+statements `statement`. The engine lays out every treatment the family allows, keeps the role's own
+when the body fills, and otherwise takes the one that leaves the least empty band. Force one with
+`title: <id>` on the line after `layout:`.
+
+## Families and variants
+
+- `asymmetric-feature` and `image-split` pair a work or a building with what to see in it.
+- `timeline` places periods, schools or projects in order.
+- `process` and `step-diagram` set a making process in three to five steps.
+- `comparison` and `text-two-column` read two works, two periods or two methods side by side.
+- `big-number`, `kpi-row`, `chart-insight` and `table-insight` carry the few figures such a talk has.
+- `quote` sets a maker's sentence; `statement` holds one idea at display size.
+- `agenda` opens a workshop with its sessions.
+
+Covers are `cover-typographic`, `cover-split-field` and `cover-numeral`; sections are
+`section-field` and `section-numeral`; closings are `closing-ask`, `closing-summary-list` and
+`closing-statement`.
+
+Display slides. The typographic cover sets the topic at display size on the left half and the
+composition on the right half: the yellow square and red circle above, the black bar and blue
+triangle below, each in its own grid cell. A statement sets its sentence on the left and a narrower
+composition from column 10 to the edge. A big number is a blue field panel. A closing's next step
+stands between two rules; a closing statement takes the statement's composition.
+
+## Do
+
+- Keep the geometry on the cover and the statements; content slides carry type, images and data.
+- Use one statement per section at most, so the composition stays an event.
+- Caption every work with maker, year and source.
+- Let red mark one word or one figure on a content slide.
+
+## Avoid
+
+- Circles, squares or triangles as bullets, icons or frames on content slides.
+- Yellow text on the off-white ground.
+- A fifth hue family beside the three primaries and the ink.
+- This direction for a ledger, a finance review or a sensitive topic.
+
+## Two worked slides
+
+A lecture slide pairs a building with what to see in it, and lets the caption carry the source.
+
+```markdown
+---
+layout: image-split
+
+## 데사우 교사(校舍)의 세 가지 설계 원칙
+
+![도 1. 데사우 교사 전경 | 출처: 예시 이미지](assets/example-a.png)
+
+- **기능별 동** 공방, 교실, 기숙사를 각각의 동으로 나눠 다리로 잇는다
+- **유리 커튼월** 공방 동의 외벽 전체가 유리라 작업이 밖에서 보인다
+- **비대칭 배치** 정면이 없어, 걸으며 돌아봐야 전체가 읽힌다
+- 출처: 예시 건축사 강의 자료, 2026년 (예시)
+---
+```
+
+A timeline places the school's three sites in order, with what changed at each.
+
+```markdown
+---
+layout: timeline
+
+## 학교의 세 시기, 1919-1933년
+
+| 시점 | 장소 | 무엇이 바뀌었나 |
+|---|---|---|
+| 1919년 | 바이마르 | 공방 중심 교육, 표현주의의 영향이 강하다 |
+| 1925년 | 데사우 | 산업 생산과의 협업, 표준화된 제품 디자인 |
+| 1932년 | 베를린 | 사립 학교로 축소, 이듬해 문을 닫는다 |
+
+> 표 1. 바우하우스의 세 시기 (예시 자료)
+
+- 출처: 예시 디자인사 강의 노트, 2026년 (예시)
+---
+```
+
+## Examples
+
+`15-design-lecture-bauhaus-ko.md`

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

@@ -32,7 +32,7 @@ a warm rust accent for the thing being taught. Pack file: `templates/tonalities/
 ## 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).
+with rounded corners (night, on its dark ground, is the other). Cover and statement titles take the hero step (60 pt) when their words fit; `hero: false` in the front matter turns it off. A figure is never larger than a title.
 
 ## Dials
 
@@ -51,10 +51,11 @@ Density 10, variance 6: up to four of its four treatments.
 | 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
+Treatments: kicker-numeral, top-rule, side-rail, statement. The side rail is the board colour
+(`rail: field`): a full-height bar in the left margin beside the title. The kicker numeral stands
+right of the title, in the accent. 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 as row
+heads in the body 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
@@ -93,7 +94,7 @@ means the slide needs more worked detail.
   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
+  sub-points. The formula runs across the body's 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.

package/skills/lit-pptx/references/tonalities/computational-brutalism.md

@@ -0,0 +1,150 @@
+# Computational Brutalism
+
+Computational Brutalism is the direction for a deck about a system, told to the people who build or
+run it. It borrows from terminals, plotter paper and engineering drawings: the twelve-column grid is
+marked in the top margin with numbered ticks, every content slide carries its index as `[03/08]`,
+titles, labels and figures are set in a monospaced face, tables are ruled on every edge, and one
+electric-blue signal colour marks the figure that matters. The structure is shown on purpose. What
+keeps it readable is that body text stays in Pretendard and every mark sits on the grid it shows.
+
+## When to use it
+
+Reach for Computational Brutalism for an architecture review, an infrastructure or reliability
+report, a developer-tool or AI-system launch given to engineers, a benchmark write-up, an incident
+retrospective or a hackathon demo. The content signals that point here are metrics with units
+(p99 latency, throughput, error budget, GPU hours), version numbers and identifiers, code or
+command names in the text, before-and-after measurements, and an audience that reads a table
+faster than a sentence. It is the first candidate for an engineering review or a developer launch,
+and the second for a data review that an engineering team will read.
+
+## When it is the wrong choice
+
+It fails for a board, an investor committee, finance or a public-sector report, where the grid marks
+read as unfinished work rather than as a style. It fails for a long Korean reading deck: the mono
+face sets only Latin and figures, so a page of Hangul titles loses most of the look while keeping
+its cost in width. It also fails for consumer marketing, for grief, safety or HR topics, and for a
+deck under a corporate brand guide. For a quiet data review choose Ledger or Night; for a pitch to
+investors, Signal or Neo-Brutalism.
+
+## Tokens
+
+The values below come from the pack file and are what the engine draws.
+
+| Token | Value |
+|---|---|
+| ground / surface | #EEEDE7 / #E2E1D9 |
+| ink / ink-muted / line | #111111 / #4D4C47 / #9A988F |
+| accent / accent-deep / accent-tint | #1F43E0 / #14267A / #D9DEF2 |
+| field / on-field | #111111 / #8CF5A6 (phosphor green on the terminal field) |
+| positive / negative | #1C6B35 / #B3261E |
+| series | #1F43E0, #111111, #7A786F |
+| faces | JetBrains Mono Bold for display, title and numerals, JetBrains Mono Regular for labels, Pretendard Regular for body; Hangul inside a mono run is set in Pretendard; there is no A2Z map, so `faces: a2z` keeps these faces |
+| ramp / hero | compact (body 13 pt, labels 11, sources 9) / hero step (60 pt) on cover and statement titles that fit, off with `hero: false`; figures at most title size |
+| density / variance | 10 / 7 |
+| radius / edge | 0 / border, 1 pt, in ink |
+| decoration | hairline rules, column hairlines, outlined boxes, grid marks, kicker numerals |
+| table | ruled grid on every cell edge, header in the label face, bold totals |
+| chart | hairline gridlines, direct labels, the accent on the highlighted series over muted ones |
+
+Density 10 sets the deck on the compact grid (24 pt side margins), body 13 pt and no step-up, as
+every pack in the family: an engineering review is read again after the meeting, so each slide keeps
+its basis and its source. The mono face is wider than Pretendard, so the engine measures
+every mono title at its own width before it chooses a treatment; a long Latin title moves to a
+treatment with a wider frame rather than shrinking.
+
+The fonts ship with the skill: JetBrains Mono is under the SIL Open Font License 1.1 with no Reserved
+Font Name, and the official Regular and Bold files are embedded unmodified with `--embed-fonts`.
+
+## Treatments by slide role
+
+Content, data, sequence and reference slides take `top-rule`; data with a takeaway takes
+`bottom-anchor`; image slides `bottom-anchor`; definitions `side-rail`; statements `statement`. The
+pack also pins a family's own title: `chart-insight` under `top-rule`, `table-insight` under
+`bottom-anchor`, `comparison` as a spec sheet under a `side-rail` title, and `step-diagram`
+under a large mono headline (`top-plain-large`). The engine lays out each allowed treatment, keeps
+the pinned or role treatment when the body fills, and otherwise takes the one that leaves the least
+empty band. Force one with `title: <id>` on the line after `layout:`.
+
+## Families and variants
+
+- `dashboard-grid` and `kpi-row` carry measured results: value, unit, label and basis in each cell.
+- `chart-insight` and `full-chart` show a measured series with one highlighted line or bar.
+- `table-insight` and `ledger-table` hold benchmark or capacity tables, ruled on every edge.
+- `method` sets a pipeline or procedure as numbered stages with their inputs and outputs.
+- `step-diagram` is a rollout or migration in three to five steps.
+- `matrix-2x2` places options on two measured axes.
+- `comparison` reads before and after, or two designs, across shared rows.
+- `text-two-column` and `references-appendix` carry specifications and links.
+- `quote` and `statement` hold one line an engineer said or one decision.
+
+Covers are `cover-typographic`, `cover-index` and `cover-figures`; sections are `section-numeral`
+and `section-rule`; closings are `closing-decision-box`, `closing-ask` and `closing-summary-list`.
+
+Display slides. The typographic cover is the terminal field from edge to edge: black, with the
+topic in phosphor green at display size, anchored low, and the date line above it. A statement sets
+its sentence in phosphor on the same black field. A big number is an outlined panel on the ground.
+A closing's decision sits in an outlined box. The grid marks and the slide index run on content
+slides only; a drenched statement goes without them.
+
+## Do
+
+- Give every figure its unit and its basis: `p99 182 ms`, `2026년 9월 기준`.
+- Keep identifiers, versions and commands in the text as they are written; the mono face is for them.
+- Put one blue figure on a slide; everything else stays ink.
+- Rule a table on every edge and right-align its numbers.
+- End on a decision box or an ask with the owner and the date.
+
+## Avoid
+
+- Body paragraphs in the mono face (the pack refuses a mono body).
+- Fake code, fake terminal prompts or decorative binary strings; show real identifiers or none.
+- Grid marks or the slide index in the accent colour.
+- A second accent colour; the phosphor green belongs to the black field only.
+- This direction for a board pack, a finance report or a sensitive topic.
+
+## Two worked slides
+
+A latency review shows the measured result with its basis, and lets the table carry the detail.
+
+```markdown
+---
+layout: kpi-row
+
+## API 게이트웨이 v3 전환 결과, 2026년 9월
+
+| p99 지연 | 처리량 | 오류율 | 노드 수 |
+|---|---|---|---|
+| 182 ms | 41k rps | 0.07% | 24 |
+| v2 410 ms | v2 18k rps | v2 0.31% | v2 40 |
+
+> 운영 클러스터 4주 평균, 2026년 9월 (예시)
+
+- 지연은 절반 아래로 줄었고, 노드는 40대에서 24대로 줄었다
+- 오류율 0.07%는 SLO 0.1% 안쪽이다
+- 출처: 예시 관측 대시보드, 2026년 9월 (예시)
+---
+```
+
+A migration plan reads as a sequence with the condition each step must meet.
+
+```markdown
+---
+layout: step-diagram
+
+## Cut-over plan for the v3 gateway
+
+- **1. Shadow** mirror 5% of traffic to v3 and compare responses
+  (1) Exit: 0 mismatches over 72 h
+- **2. Canary** route 10% of live traffic to v3 in one region
+  (1) Exit: p99 under 250 ms, error rate under 0.1%
+- **3. Ramp** move to 50%, then 100%, one region a day
+  (1) Exit: no rollback for 7 days
+- **4. Retire** drain v2 and remove its 40 nodes
+  (1) Owner: example platform team
+- Source: example rollout runbook, October 2026 (example)
+---
+```
+
+## Examples
+
+`13-engineering-review-computational-brutalism-ko.md`