@litfamily/litmuse 0.1.1 → 0.1.3

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

@@ -0,0 +1,112 @@
+# Bauhaus
+
+Bauhaus is the direction for a talk about making things: design, architecture, craft, art history and culture. Its display slides carry an elementary composition set on the grid beside a heavy title on an off-white ground: a yellow square, a red circle, a black bar and a blue triangle. The content slides stay quiet by design: black type, a short red rule beneath each title, open tables and a single red accent. The geometry is the voice, so it shows where the deck speaks (the cover and the statements) and stays off 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 design-school portfolio review, or a talk on the history of a style. The content signals that point here are images with 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, ahead of 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 fill 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 puts 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 reserved 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, a statement or a 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 keeps 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` sets periods, schools or projects in order.
+- `process` and `step-diagram` lay a making process out 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: 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 with a narrower composition from column 10 to the edge. A big number sits on 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 at most one statement per section, 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 sets 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/plugin/skills/lit-pptx/references/tonalities/computational-brutalism.md

@@ -0,0 +1,118 @@
+# 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 runs 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 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`

package/plugin/skills/lit-pptx/references/tonalities/neo-brutalism.md

@@ -0,0 +1,125 @@
+# Neo-Brutalism
+
+Neo-Brutalism is the loud direction, and it is loud on purpose. Every card is a flat yellow block with a thick black border and a hard black shadow offset down and to the right, with no blur at all. Titles are heavy and tight, the topic band is saturated blue, one pink-red accent marks the figure the slide is for, and the ground is a warm cream. Nothing is soft: no gradients, no rounded corners, no glow. It reads like a poster or a product sticker, so it suits a room that should feel energy, and it stays legible because every colour pair still meets the contrast floor.
+
+## When to use it
+
+Reach for Neo-Brutalism for a startup pitch at a demo day, a consumer product launch, a campaign kick-off, a creator or community event, a hackathon final or an education deck for a young audience. The content signals that point here are a short body (one claim and two or three facts per slide), three or four headline numbers, a launch or sign-up ask, and words such as 런칭, 출시, 데모데이, 캠페인, 크리에이터, or the user asking for something bold, punchy or "brutalist". It is the second candidate for the pitch deck type, after Signal, and the first when the user asks for a bold or playful look.
+
+## When it is the wrong choice
+
+It fails for a formal report, an academic talk, a board or finance review and any deck read alone later: the blocks take space a reader needs for detail, and a slide of long paragraphs between thick borders reads as noise. It is wrong for grief, safety, HR or financial-loss topics, and for a deck under a corporate brand guide. When the brief says "clean" or "minimal", Signal or Studio fits; when it says "report", Ledger or Gazette.
+
+## Tokens
+
+The values below come from the pack file and are what the engine draws.
+
+| Token | Value |
+|---|---|
+| ground / surface | #FFF5E1 / #FFD43B (the yellow card) |
+| ink / ink-muted / line | #111111 / #3A3A3A / #111111 |
+| accent / accent-deep / accent-tint | #D81B5C / #6B0F2E / #FFC9DA |
+| field / on-field | #2F4BFF / #FFFFFF |
+| positive / negative | #137A43 / #111111 |
+| series | #D81B5C, #2F4BFF, #111111, #137A43 |
+| faces | Pretendard Bold for display, title, labels and numerals, Pretendard Regular for body; `faces: a2z` swaps to A2Z Black display, titles and numerals |
+| register / ramp / hero | bold / presented (body 18 pt, labels 14, sources 12, titles 32, display 44) / allowed: a statement and a big figure may take the 72 pt hero step |
+| density / variance | 10 / 7 |
+| radius / edge | 0 / fill and border, 2.5 pt in ink |
+| shadow | 6 pt offset at 45°, ink, fully opaque, no blur |
+| table | yellow header, ruled grid, protagonist row in pink tint, bold totals |
+| chart | no gridlines, direct labels, series in order (pink, blue, black) |
+
+This is the family's bold register (`register: bold`): it sets presented type and the 72 pt hero step, so titles, figures and statements run large, but they fill the same slide-grid zones as every other pack. A title still sits in the one title zone and the body still starts at y 120; the register changes the size inside a zone, never the zone. The registry refuses presented type in a pack without `register: bold`, so a report pack cannot drift into this size by accident; every pack takes its own hero step on the cover and statements. A KPI row keeps its bordered cards, because the card is this direction's figure. The pink accent was darkened until a pink figure on a yellow card still holds 3:1 at title size. Losses use ink with a ▼ sign, because pink already means "look here".
+
+The shadow is written into the file as a real outer shadow with a blur of zero, so PowerPoint, Keynote and LibreOffice all draw the same hard edge. Every block of the blue field (a band, a section page, a cover plate) carries the black border too.
+
+## QA allowances
+
+The yellow card, the blue band and the pink accent share a content slide inside the default OF-101 limit (four hue families; a fifth fails). The gate reads this pack's `qa:` block: `offset-shadow: true` lets OF-120 pass the hard shadow; a shadow with any blur still fails, and the same shadow in any pack without this allowance fails. Contrast floors are unchanged.
+
+## Treatments by slide role
+
+Content slides and data with a takeaway take `top-plain-large`; data, sequence, reference and definition slides take `band` (the title in white on the blue band); image slides `bottom-anchor`; statements `statement`. `kicker-numeral` is the third option for a sequence. 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
+
+- `kpi-row` sets two to four results as yellow cards, each with value, label and basis.
+- `big-number` is a blue panel of related figures beside the facts that explain them.
+- `comparison` reads before and after across shared rows.
+- `process` and `step-diagram` show three to five steps with a numeral in the accent.
+- `chart-insight` carries one growth chart with its takeaway beside it.
+- `table-insight` holds the one table a pitch needs, usually unit economics.
+- `image-split` pairs a product shot with three short points.
+- `summary-box-list` sets two to four bordered boxes of one claim each.
+- `agenda`, `quote` and `statement` keep the type loud and the page open.
+
+Covers are `cover-typographic`, `cover-split-field` and `cover-numeral`; sections are `section-field` and `section-numeral`; closings are `closing-ask`, `closing-decision-box` and `closing-statement`.
+
+Display slides. The typographic cover sets the topic in white on a blue plate across the lower half, bordered in black. A statement drenches the page in blue with the sentence in white. A big number is a blue field panel. A closing's next step sits in a bordered box with its shadow.
+
+## Do
+
+- Keep one claim per slide and write it in the first body line, in plain words.
+- Give every figure its label and its basis in the card.
+- Let the yellow cards carry figures and short labels, never paragraphs.
+- End on `closing-ask` with the amount, its uses and the next meeting.
+
+## Avoid
+
+- Blurred or soft shadows, rounded corners and gradients; the look is flat and hard.
+- Thin hairlines beside the 2.5 pt borders.
+- More than three fill colours on one slide.
+- Muted grey text on the yellow surface.
+- This direction for formal reports or sensitive topics.
+
+## Two worked slides
+
+A launch deck opens its traction slide with four results as cards and two facts under them.
+
+```markdown
+---
+layout: kpi-row
+
+## 베타 8주 성과, 2026년 10월
+
+| 가입자 | 주간 재방문 | 추천 가입 | 유료 전환 |
+|---|---|---|---|
+| 1만 2천 명 | 46% | 38% | 7.4% |
+| 목표 1만 명 | 업계 평균 25% | 광고비 0원 | 목표 5% |
+
+> 베타 운영 기록, 2026년 8-10월 (예시)
+
+- 광고 없이 가입자 목표를 넘겼다: 셋 중 하나 이상이 친구 추천으로 왔다
+- 유료 전환 7.4%는 목표 5%를 넘었고, 연 결제가 그중 60%다
+- 출처: 예시 서비스 운영 대시보드, 2026년 10월 (예시)
+---
+```
+
+The closing states the ask, shows where the money goes and names the next step.
+
+```markdown
+---
+layout: closing-ask
+
+## 시드 15억 원 사용 계획
+
+| 쓰임 | 금액 | 시점 |
+|---|---|---|
+| 앱 개발 인력 4명 | 7억 원 | 2027년 상반기 |
+| 크리에이터 제휴 200곳 | 4억 원 | 2027년 1분기 |
+| 마케팅 실험 | 3억 원 | 상시 |
+| 운영 예비비 | 1억 원 | 필요 시 |
+| 합계 | 15억 원 | 12개월 |
+
+> 투자금 쓰임 (예시 데이터)
+
+- 요청: 시드 15억 원 투자 승인
+- 기대 성과: 12개월 뒤 가입자 10만 명, 월 매출 2억 원
+- 다음 단계: 11월 첫째 주 후속 미팅, 담당 예시 대표
+---
+```
+
+## Examples
+
+`14-launch-pitch-neo-brutalism-ko.md`

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

@@ -0,0 +1,115 @@
+# Newsroom
+
+Newsroom is the direction for a data story told to people who do not read tables: a public briefing, an explainer, a newsletter's deck, a talk that walks a general audience through a few numbers. It looks like a newspaper's graphics desk: a black masthead band behind the title of a data page and the cover, a heavy black rule under the other titles, grey charts with one orange series, labels on the lines, and a source and period under every figure. The title names the topic and its period; the finding leads the body, in the first line under the chart.
+
+## When to use it
+
+Reach for Newsroom when the deck is a handful of charts with one point each, written for readers outside the field: a city or school data briefing to residents, a survey result for members, a newsletter's "what the numbers say", a research explainer for the press, a public talk on prices, housing, climate or health figures. The content signals that point here are one or two charts per idea, a finding per chart, sources and periods on every figure and words such as 브리핑, 설명, 주민, 시민, 독자, 뉴스레터, 데이터로 본, explainer, briefing or "what the data says". It is the first candidate for a data story for the public, ahead of Gazette and Ledger.
+
+## When it is the wrong choice
+
+It fails for an internal, dense review where people read tables line by line (Ledger), for a pitch (Signal or Neo-Brutalism), for a lecture that builds an argument step by step (Chalk) and for a written report that happens to be a deck (Paper or Gazette). It is wrong when there are no figures: the grey-and-orange charts are the voice.
+
+## Tokens
+
+The values below come from the pack file and are what the engine draws.
+
+| Token | Value |
+|---|---|
+| ground / surface | #FBFAF7 / #EEEDEA |
+| ink / ink-muted / line | #111111 / #55534D / #CCCAC5 |
+| accent / accent-deep / accent-tint | #C2410C / #7C2A08 / #FBE3D3 |
+| field / on-field | #111111 / #FFFFFF |
+| positive / negative | #1F6B3A / #111111 |
+| series | #C2410C, #77746C, #2F5D8A, #111111 |
+| faces | Pretendard Bold for display, title, labels and numerals, Pretendard Regular for body; `faces: a2z` swaps to A2Z Bold 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 / 6 |
+| radius / edge | 0 / fill |
+| decoration | hairline rules, column hairlines, kicker numerals; the masthead band is the `band` title |
+| table | open, no header fill, a rule under the header, bold totals |
+| chart | horizontal gridlines, direct labels, the accent on the story's series over greys |
+
+The orange holds 5.2:1 on the paper, so it can set a kicker word or a figure. The second series is a warm grey, the third a quiet blue for the one line a story compares against. Rules and surfaces are neutral greys: a warm-tinted rule reads as a second hue family beside the orange. A loss uses ink with a ▼ sign.
+
+## QA allowances
+
+None beyond the default craft floor. The source line under every figure is the house rule here, and the gate's source checks already ask for it.
+
+## Treatments by slide role
+
+Data slides take `band` (the title in white on the black masthead band across the top); data-with-takeaway and image slides take `bottom-anchor` (the title over a heavy black rule); content, reference and definition slides take `top-rule`; sequences `kicker-numeral`; statements `statement`. Every treatment draws in the slide grid's one title zone, so a band, a bottom-anchor and a top-rule title sit at the same place and only their surface or rule differs. Force one with `title: <id>` on the line after `layout:`.
+
+## Families and variants
+
+- `full-chart` gives one chart the whole body; `chart-insight` sets it beside two or three lines.
+- `kpi-over-chart` puts the headline figures over the chart they come from.
+- `big-number` and `kpi-row` carry a single figure or three.
+- `figure-pair` sets two charts side by side for a before and after.
+- `table-insight`, `comparison` and `timeline` hold the few tables and dates a story needs.
+- `image-split`, `text-two-column` and `sidebar-note` explain a method or a term.
+- `references-appendix` lists the sources at the end; `quote` and `statement` hold a resident's sentence or the story's one finding.
+
+Covers are `cover-typographic`, `cover-figures` and `cover-index`; sections are `section-rule` and `section-numeral`; closings are `closing-summary-list`, `closing-statement` and `closing-ask`.
+
+Display slides. The typographic cover sets the deck title in white on the black masthead band, with the meta line on the band and the deck's parts on the paper under it. A statement stands between two rules. A big number sits on the orange tint. A closing's next step stands under a rule. A deck index runs along the top of the display slides.
+
+## Do
+
+- Name the topic and its period in the title; put the finding (what changed, by how much, since when) in the first line of the body, where the gate expects a claim.
+- Colour one series orange and leave the rest grey.
+- Put the source and the period under every chart and table.
+- Label lines and bars directly; a legend is for a chart that cannot take labels.
+
+## Avoid
+
+- More than one highlighted series on a chart.
+- A chart without its source and period.
+- 3D, gradients or pictograms standing in for numbers.
+- This direction for a pitch, a lecture or an internal dense review.
+
+## Two worked slides
+
+A full chart names its topic in the title, keeps one orange line and states the finding under it.
+
+```markdown
+---
+layout: full-chart
+
+## 매매가 대비 전셋값 비율, 2023-2026년
+
+::: chart type=line unit="%"
+| 연도 | 우리 구 (%) | 시 평균 (%) |
+|---|---|---|
+| 2023년 | 55.2 | 56.0 |
+| 2024년 | 57.1 | 56.8 |
+| 2025년 | 59.4 | 57.9 |
+| 2026년 | 61.3 | 58.6 |
+> 매매가 대비 전셋값 비율, 해마다 6월 (예시 자료)
+:::
+
+- 우리 구의 전셋값이 처음으로 매매가의 60%를 넘었다
+- 출처: 예시 구청 주택 통계, 2026년 (예시)
+---
+```
+
+A KPI row carries three figures over what each means.
+
+```markdown
+---
+layout: kpi-row
+
+## 주민 설문 결과, 2026년 9월
+
+| 응답자 | 이사 계획 | 첫째 이유 |
+|---|---|---|
+| 1,204명 | 31% | 주거비 |
+| 9월 1-20일, 온라인·방문 | 2년 안에 이사할 생각 | 이사 계획자의 47% |
+
+- 출처: 예시 구 주거 실태 설문, 2026년 (예시)
+---
+```
+
+## Examples
+
+`17-public-data-briefing-newsroom-ko.md`

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

@@ -0,0 +1,109 @@
+# Riso
+
+Riso is the direction for a community, culture or education programme: a workshop, a festival, a library or museum programme, a student club, a nonprofit's year in review. It prints in two spot inks on warm paper, the look of a risograph poster. Teal fills the cover, the section openers and the statements edge to edge and runs as a band behind the title of a data page; pink marks the one word or figure that matters on a content page. Everything else is dark-blue type, grey cards and grey rules, so the two inks are the only colours on the paper.
+
+## When to use it
+
+Reach for Riso when the audience is the public or a community rather than a board: a workshop or class opener, a festival or exhibition programme, a library, museum or youth-centre season, a volunteer briefing, a club's recruiting talk, a nonprofit's annual gathering. The content signals that point here are a programme with dates and places, a few counts (participants, sessions, volunteers), steps for taking part and words such as 워크숍, 프로그램, 축제, 동아리, 도서관, 주민, 참여, 자원봉사, community, programme or zine. It is the first candidate for a community, culture or education programme, ahead of Studio and Bauhaus.
+
+## When it is the wrong choice
+
+It fails for a board, finance or public-sector report, where two bright inks read as unserious, and for a dense data review (Ledger) or a data story for the general public that lives on its charts (Newsroom). It is wrong for grief, safety or financial-loss topics. For a design-history lecture, Bauhaus; 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 | #F5F0E6 / #E4E2DE |
+| ink / ink-muted / line | #1C2433 / #4E5361 / #C4C1BB |
+| accent / accent-deep / accent-tint | #D1206B / #8A1043 / #F8D5E3 |
+| field / on-field | #00727A / #FFFFFF |
+| positive / negative | #1D6B45 / #1C2433 |
+| series | #D1206B, #00727A, #1C2433, #8A6A00 |
+| faces | Pretendard Bold for display, title, labels and numerals, Pretendard Regular for body; `faces: a2z` swaps to A2Z Bold 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 | 6 / fill |
+| decoration | a pink underline under top titles, teal colour fields, kicker numerals |
+| table | a pink-tint header, a rule under it, grey banding, bold totals |
+| chart | no gridlines, direct labels, the accent on the highlighted series over muted ones |
+
+The pink is the fluorescent ink darkened until it holds 4.5:1 on the paper, so it can set a word; the teal holds white type at 5.6:1. A loss uses ink with a ▼ sign, since pink is the accent. The fourth series colour is an ochre that holds 3:1 on the paper.
+
+## QA allowances
+
+Teal and pink share a content slide inside the default OF-101 limit, since a band title in teal over a pink figure is the two-ink print this pack imitates; the two inks are the register, not a gate limit. The surface and the rules are grey on purpose: a warm beige card would read as a third hue family and fail.
+
+## Treatments by slide role
+
+Content, image and data-with-takeaway slides take `top-plain-large` (a large title over a pink underline); data and reference slides take `band` (the title in white on a teal band across the top); sequences `kicker-numeral`; definitions `side-rail`; statements `statement`. Every treatment draws in the slide grid's one title zone, so a band and a plain title sit at the same place and only their surface differs. Force one with `title: <id>` on the line after `layout:`.
+
+## Families and variants
+
+- `agenda` opens a programme with its sessions; `timeline` sets the season by date.
+- `process` and `step-diagram` show how to take part, in three to five steps.
+- `kpi-row` and `big-number` carry the few counts such a deck has (people, sessions, books).
+- `summary-box-list`, `sidebar-note` and `text-two-column` explain what each session gives.
+- `comparison` reads two tracks or two age groups side by side.
+- `image-split` and `photo-grid` show last year's sessions; `chart-insight` and `table-insight` hold a small result.
+- `quote` sets a participant's sentence; `statement` holds the programme's one idea.
+
+Covers are `cover-typographic`, `cover-numeral` and `cover-split-field`; sections are `section-field` and `section-numeral`; closings are `closing-ask`, `closing-summary-list` and `closing-statement`.
+
+Display slides. The typographic cover drenches the page in teal and sets the title in white on the cover's title zone, with the meta line above and the parts across the strip. A statement and a section opener take the same teal drench. A big number sits on a teal panel. A closing's next step stands on a teal band across the body floor.
+
+## Do
+
+- Keep full teal fields on display slides; on a content page teal is the title band and nothing more.
+- Let pink mark one word or one figure on a content slide.
+- Give every session a date, a place and who it is for.
+- Write the way the organisers talk to participants: short, plain and inviting.
+
+## Avoid
+
+- A third ink beside pink and teal (black is the type, not an ink).
+- The fluorescent pink as text; the darkened accent is the type colour.
+- Gradients, grain or halftone painted to fake the print.
+- This direction for a board, finance, public-sector or sensitive topic.
+
+## Two worked slides
+
+A process slide shows how to take part, one step per row.
+
+```markdown
+---
+layout: process
+
+## 참여는 이렇게: 신청부터 첫 모임까지
+
+- **1. 신청** 10월 31일까지 도서관 누리집에서 한 사람씩 신청한다
+- **2. 안내 문자** 모임 사흘 전 장소와 준비물을 문자로 받는다
+- **3. 첫 모임** 11월 7일 저녁 7시, 3층 다목적실에서 만난다
+- **4. 소모임 배정** 첫 모임에서 관심사별로 다섯 명씩 나눈다
+- 출처: 예시 도서관 운영 계획, 2026년 (예시)
+---
+```
+
+A KPI row carries last season's counts, with what they mean under each.
+
+```markdown
+---
+layout: kpi-row
+
+## 지난 시즌, 숫자로 본 우리 모임
+
+| 참가자 | 모임 | 만든 책자 |
+|---|---|---|
+| 148명 | 24회 | 6권 |
+| 2025년 가을·겨울 | 주 1회, 12주씩 두 번 | 소모임별 1권 |
+
+- 참가자의 절반이 처음 온 주민이었다
+- 출처: 예시 도서관 운영 보고, 2026년 (예시)
+---
+```
+
+## Examples
+
+`16-community-programme-riso-ko.md`

package/plugin/skills/lit-pptx/scripts/compile-deck.js

@@ -148,7 +148,7 @@ async function resolveAndRender(ast, templateName, outputs, options = {}) {
   const meta = (ast.deck && ast.deck.metadata) || {};
   const tonality = options.tonality || meta.tonality || null;
   const templateObj = tonality
-    ? templateRegistry.loadTonality(tonality, { density: meta.density, variance: meta.variance, canvas: meta.canvas, faces: options.faces || meta.faces })
+    ? templateRegistry.loadTonality(tonality, { density: meta.density, variance: meta.variance, canvas: meta.canvas, faces: options.faces || meta.faces, hero: meta.hero, decoration: meta.decoration })
     : templateRegistry.loadTemplate(templateName);
   if (tonality) {
     const d = templateObj.pack.dials;