@litfamily/litmuse 0.1.1 → 0.1.2

package/plugin/skills/lit-pptx/SKILL.md

@@ -5,7 +5,7 @@ description: "Make a .pptx slide deck with a consistent design, then render and
 
 # lit-pptx: a deck compiler with a design direction, a QA gate and a per-slide look
 
-This skill turns a request, notes or source files into a finished `.pptx`. It does not draw slides by hand. It chooses a design direction first, writes Markdown slide source, compiles it with the bundled deck engine (native editable charts and KPI rows, Pretendard fonts embedded), gates the result with a mechanical QA script, and then looks at every rendered page. The engine, the eight tonality packs, the templates, the fonts and the QA scripts all live inside this skill folder; the pinned third-party runtime lives in the shared office runtime of the plugin.
+This skill turns a request, notes or source files into a finished `.pptx`. It does not draw slides by hand. It chooses a design direction first, writes Markdown slide source, compiles it with the bundled deck engine (native editable charts and KPI rows, Pretendard fonts embedded), gates the result with a mechanical QA script, and then looks at every rendered page. The engine, the thirteen tonality packs, the templates, the fonts and the QA scripts all live inside this skill folder; the pinned third-party runtime lives in the shared office runtime of the plugin.
 
 ## When this applies
 
@@ -31,7 +31,7 @@ Code documentation, bug or test reports and quoted or fenced text stay inert: th
 | Mode | Trigger | Completion boundary |
 | --- | --- | --- |
 | lit-default | The activation context says "ask no style questions" (a bare `lit` request, or a headless run) | The direction step chooses the tonality with no questions of any kind and the reply names it and two alternatives; a complete `.pptx` plus the Markdown source even when facts are missing (see "Missing facts"); gate PASS; pages looked at |
-| style-gate | Explicit invocation without a named tonality or template, and the user is present | Run the direction step, then one short `request_user_input` round: the chosen tonality with its one-line reason as the first, one-click option, the two alternatives, and "compare them first"; "알아서 / just make it good" means the first option |
+| style-gate | Explicit invocation without a named tonality or template, and the user is present | Run the direction step, then one short `request_user_input` round: the chosen tonality with its one-line reason as the first, one-click option, recommended first, the two alternatives, and "compare them first"; "알아서 / just make it good" means the first option |
 | compare | The user asks to see options, or the brief leaves the look open on purpose | The compare strip: the first three slides under the chosen tonality and both alternatives, rendered and shown; build the rest under the user's pick |
 | guided | A vague or large brief and the user is present | `references/stages/interview.md` → `references/stages/plan.md` → `references/stages/autopilot.md` |
 | autopilot | A clear brief, or the user delegated the details | 정/반/합 (below), then the compile → gate → look loop |
@@ -82,7 +82,7 @@ renders/         page PNGs from the look step
    ```
    Inside Muse the sandbox network is proxy-only, so a failed first-use install (offline, no Python 3.10 to 3.14, no `node`) is `BLOCKED:`. Quote the error line and give the user the pre-warm command to run in a terminal outside Muse: `npx @litfamily/litmuse runtime install office`. Never `pip install` or `npm install -g` anything. `LITMUSE_OFFICE_PYTHON` names a different interpreter; the runtime needs 3.10 to 3.14 and otherwise picks the newest `python3.X` in that range.
 
-2. **Choose the direction first: the direction card.** Before any slide is written, decide how the deck should look and write that decision down. A look is a tonality: a pack of palette roles, faces, type ramp, title treatments, layout families, decoration and density that the engine reads as data. Eight ship with the skill, and the engine has no default: a deck compiles only under a tonality or a template that someone chose. Follow `references/direction-step.md`:
+2. **Choose the direction first: the direction card.** Before any slide is written, decide how the deck should look and write that decision down. A look is a tonality: a pack of palette roles, faces, type ramp, title treatments, layout families, decoration and density that the engine reads as data. Thirteen ship with the skill, and the engine has no default: a deck compiles only under a tonality or a template that someone chose. Follow `references/direction-step.md`:
    - Close the brief: deck type, reader, delivery (presented or read), language. Infer what the brief leaves out and write the inference on the card.
    - Draft the outline (step 3) far enough to count it, then rank the candidates. The deck type gives two or three; the content signals reorder them:
 
@@ -122,8 +122,13 @@ renders/         page PNGs from the look step
    | `gazette` | Korean briefing pages: header band, boxed summary, 개조식 evidence at reading size | `references/tonalities/gazette.md` |
    | `studio` | editorial grid, asymmetric splits, side titles, real part numbers | `references/tonalities/studio.md` |
    | `night` | dark ground and light type for data and technical keynotes | `references/tonalities/night.md` |
+   | `bauhaus` | primary colours and elementary geometry on display slides, for design and culture talks | `references/tonalities/bauhaus.md` |
+   | `computational-brutalism` | retro computing with the grid showing: mono Latin type, ruled tables, a terminal field | `references/tonalities/computational-brutalism.md` |
+   | `neo-brutalism` | loud pitch fills: black borders, hard offset shadows, yellow cards, pink accent | `references/tonalities/neo-brutalism.md` |
+   | `newsroom` | data journalism for a general reader: masthead titles, grey charts, one orange series | `references/tonalities/newsroom.md` |
+   | `riso` | two spot inks on warm paper for community, culture and education programmes | `references/tonalities/riso.md` |
 
-   `node scripts/compile-deck.js --list-tonalities` prints the eight and the legacy templates; `--list-layouts <tonality>` prints the pack's families with the title treatments each allows, and its cover, section and closing variants.
+   `node scripts/compile-deck.js --list-tonalities` prints the thirteen and the legacy templates; `--list-layouts <tonality>` prints the pack's families with the title treatments each allows, and its cover, section and closing variants.
 
 3. **Outline before prose.** One message per slide. The slide title is a specific topic label that names the subject, the measure and the period ("분기별 방문·대출 추이"; not a sentence such as "방문은 늘었고 대출은 제자리다", and not a bare "현황"); the message itself is the first line of the body. Cover titles are the topic or product name, never a slogan. Typical shape: cover · where things stand · evidence · options compared · recommendation · next steps · closing; each deck type has its own sequence in `references/direction-step.md`. Aim for the fewest slides that carry the argument; split a slide that needs more than four groups or about eight lines. Name one layout family per slide from the chosen pack, by the slide's job (`references/layout-families.md`), never by what the previous slide used. Rule of thumb for a presented deck: one content slide per one to two minutes of talk.
 
@@ -179,7 +184,13 @@ renders/         page PNGs from the look step
    - package integrity;
    - the deck-craft checks (`scripts/deck_craft.py`): a content slide whose content fills less than 45% of the area under its title, a deck that is mostly tables with no chart, a shape running off the canvas, an empty outlined box, an unfilled `[blank]`, and a long foreign-language source line on a Korean deck.
 
-   The craft-floor checks (`scripts/craft_extras.py`) add, per slide (OF-101 to OF-109): one accent colour, body lines at most 90 characters (38 for Korean), right-aligned numeric columns, concentric nested frames, cards spaced at least twice the gap between their contents (advisory for now), no gradient text, glow or emoji bullets, and no empty band over 35% of a slide or card. Over the whole deck (OF-110 to OF-113), read from the compiled file: at least three title treatments on a deck of eight or more slides, each title drawn as the treatment it is named; content slides that do not share one composition (title zone × body partition × dominant content) on more than 40% of them; a median empty band under the body of at most 0.20; one title frame per treatment. Then OF-114 titles and the cover subtitle written as labels, not sentences; OF-115 no region left empty (a bottom title that ends above the floor, a side rail under half used, a text or picture column whose largest empty band beside a longer column passes 40 % of the body even when a source strip closes it, a title panel taller than its text, a plate under an empty page); OF-117 no light figure card on a dark ground; OF-118 no bold run-in label running into its sentence without a separator (the engine sets the colon); OF-119 no count numeral beside an agenda title. When the user is shown two tonalities of one source, `--sibling other.pptx` adds OF-116: the two must differ in skeleton (title zone and partition) on at least two content slides. On a legacy template the variety checks and the median band are advisories. A MEDIUM finding is reported as advisory. Every failure reason carries a fix hint. Fix the Markdown, never the gate: change the family or the visual (step 4), add the takeaway the slide lacks, merge or split slides, shorten text.
+   The craft-floor checks (`scripts/craft_extras.py`) cover each slide (OF-101 to OF-109): the accent family count (a pack holds its own `qa:` allowance; four families pass everywhere), body line length (90 Latin characters, 38 Korean), right-aligned numeric columns, concentric nested frames, card spacing, flat fills, and empty bands over 35% of a slide or card.
+
+   Over the whole deck (OF-110 to OF-113), read from the compiled file: three or more title treatments on a deck of eight or more slides, each title drawn as the treatment it names; content slides sharing one composition (title zone × body partition × dominant content) on at most 40% of them; a median empty band under the body of at most 0.20; one shared title frame for content titles and one for display titles.
+
+   Then OF-114 titles and the cover subtitle written as labels, not sentences; OF-115 with no region left empty — a takeaway column as long as the visual beside it, a title panel as tall as its text, a plate under an empty page; OF-117 with figure cards on matching grounds; OF-118 with a separator between a bold run-in label and its sentence (the engine sets the colon); OF-119 with agenda titles free of count numerals; OF-120 with hard offset shadows only where the pack allows them. With two tonalities of one source, `--sibling other.pptx` adds OF-116: both place titles and bodies alike on the shared grid.
+
+   On a legacy template the variety checks and the median band are advisories. A MEDIUM finding is reported as advisory. Every failure reason carries a fix hint. Fix the Markdown, never the gate: change the family or the visual (step 4), add the takeaway the slide lacks, merge or split slides, shorten text.
 
 8. **Look at the pages.** Render with `python3 "$LITMUSE_LIB/render_pages.py" deck.pptx --out-dir renders --pages 99` (it needs `soffice`; PyMuPDF rasterises the PDF, so `pdftoppm` is not required), then open the PNGs with `read_file`. Read every slide at its real size: hierarchy, Korean glyphs, numbers against the source, anything the gate cannot see (a cramped card, an empty half-slide, a title that wraps into a widow, a title treatment that does not suit the slide's job). Check the deck against its direction card: if the card's "wrong if" line turned out true, rebuild under the alternative and update the card and the reply. Fix and recompile until the gate passes and the pages read well. This compile → gate → look loop is the 정/반/합 below in miniature (the gate and your look are the 반). Three full rounds is the budget; a defect that survives them is reported as a limitation with its slide number. When `soffice` is missing, the render step reports `BLOCKED: slide render check`; the deck is delivered as unverified visually and the reply says so (mode `renderer-missing`). Give the user the install command to run outside Muse (`brew install --cask libreoffice`, or `sudo apt install libreoffice-impress`).
 
@@ -188,7 +199,7 @@ renders/         page PNGs from the look step
 The whole loop, by absolute path:
 
 ```bash
-node    "$SKILL_ROOT/scripts/compile-deck.js" --list-tonalities                    # eight tonalities and the legacy templates
+node    "$SKILL_ROOT/scripts/compile-deck.js" --list-tonalities                    # thirteen tonalities and the legacy templates
 node    "$SKILL_ROOT/scripts/compile-deck.js" --list-layouts ledger                # families, allowed titles, variants of one pack
 node    "$SKILL_ROOT/scripts/compile-deck.js" --list-templates                     # legacy and learned templates
 python3 "$LITMUSE_LIB/office_data.py" check deck.md                                # when the frontmatter names data:
@@ -222,7 +233,7 @@ The full checklist is `references/anti-slop-checklist.md`; each tonality's token
 
 - **Direction.** One tonality per deck, chosen for the audience and the content and recorded on the card. Title treatments follow slide roles (three to five per deck, each in one fixed frame); layout families follow slide jobs; the pack's decoration list is the only decoration.
 - **Hierarchy and fill.** Exactly one primary element per slide, at least twice the size of the next level; two or three secondary; the rest muted. At most four items per group. Density follows the dial, evenly across the deck, and content slides use their body down toward the floor.
-- **Type.** Primary reading text at 12 pt or more (13 pt on the compact step every pack starts from), table cells and captions at 11 pt or more, sources at 9 pt or more with passing contrast. One size ramp (presented, reading or compact, set by the pack and the density dial), no near-equal sizes (14/15/16); display sizes only on cover, section and statement titles; no hero step, and every figure at title size at most, inside a structure that gives its label, unit, basis and source. Pretendard Regular and Bold by default; the A2Z faces only when the user or the source asks (`faces: a2z`). Weight builds hierarchy; at most four weights. Korean body line spacing at the loose end (1.3 to 1.45). No one-word widow on a title's last line.
+- **Type.** Primary reading text at 12 pt or more (13 pt on the compact step every pack starts from), table cells and captions at 11 pt or more, sources at 9 pt or more with passing contrast. One size ramp (presented, reading or compact, set by the pack and the density dial), no near-equal sizes (14/15/16); display sizes on cover, section and statement titles, and the hero step on cover and statement titles in hero packs; every figure at title size at most, inside a structure that gives its label, unit, basis and source. Pretendard Regular and Bold by default; the A2Z faces only when the user or the source asks (`faces: a2z`). Weight builds hierarchy; at most four weights. Korean body line spacing at the loose end (1.3 to 1.45). No one-word widow on a title's last line.
 - **Colour.** Every colour comes from the pack's roles. Tinted neutrals carry most of the surface, one accent of about 10% or less marks the single emphasised item. One colour, one meaning, across the deck. No per-slide one-off hex.
 - **Contrast floors.** Body and captions 4.5:1 on their actual fill, large text and structural lines 3:1. Push toward ink when close; no grey text on a coloured fill.
 - **Anti-slop bans.** No side-stripe accent bars, no border plus heavy shadow on one card, no card inside a card, no eyebrow or 01·02·03 ordinal on every slide, no identical icon-card grids as filler, no cream or beige reading ground, no hand-drawn decoration, no generic titles ("개요", "Overview"), no declarative titles or subtitles, no single exaggerated number as a slide, no padding bullets that restate the title, no placeholder or AI-tell wording.
@@ -233,11 +244,11 @@ The full checklist is `references/anti-slop-checklist.md`; each tonality's token
 | Need | Read |
 | --- | --- |
 | Choosing the direction, the card, the compare strip | `references/direction-step.md` |
-| One tonality's tokens, treatments, families, do and avoid, two worked slides | `references/tonalities/<id>.md` (ledger, signal, atlas, chalk, paper, gazette, studio, night) |
+| One tonality's tokens, treatments, families, do and avoid, two worked slides | `references/tonalities/<id>.md` (ledger, signal, atlas, chalk, paper, gazette, studio, night, bauhaus, computational-brutalism, neo-brutalism, newsroom, riso) |
 | Where titles sit and how the engine picks them | `references/title-treatments.md` |
 | Which family does which job, covers, sections and closings | `references/layout-families.md` |
 | The density and variance dials, fill policies, writing source that fills | `references/density-and-fill.md` |
-| Complete decks that compile and pass the gate | `references/examples/` (twelve, all eight tonalities and deck types) |
+| Complete decks that compile and pass the gate | `references/examples/` (seventeen, all thirteen tonalities and deck types) |
 | Authoring the Markdown dialect | `references/authoring-guide.md`, `specs/markdown-slide-spec-v1.md`, `specs/markdown-slide-spec-v2.md` |
 | AST shape for debugging a compile error | `specs/slide-ast-v1.schema.json`, `specs/slide-ast-v2.schema.json` |
 | The pack files the engine reads | `templates/tonalities/<id>/pack.yaml` |

package/plugin/skills/lit-pptx/fonts/jetbrains-mono/OFL.txt

@@ -0,0 +1,93 @@
+Copyright 2020 The JetBrains Mono Project Authors (https://github.com/JetBrains/JetBrainsMono)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/plugin/skills/lit-pptx/fonts/provenance.json

@@ -74,5 +74,36 @@
       }
     ]
   },
-  "totalBytes": 5246628
+  "jetbrains-mono": {
+    "family": "JetBrains Mono",
+    "release": "v2.304",
+    "repository": "https://github.com/JetBrains/JetBrainsMono",
+    "releaseAsset": "https://github.com/JetBrains/JetBrainsMono/releases/download/v2.304/JetBrainsMono-2.304.zip",
+    "releaseArchiveSha256": "6f6376c6ed2960ea8a963cd7387ec9d76e3f629125bc33d1fdcd7eb7012f7bbf",
+    "license": "SIL Open Font License 1.1 (no Reserved Font Name; files ship unmodified)",
+    "sourcePaths": [
+      "fonts/ttf/JetBrainsMono-Regular.ttf",
+      "fonts/ttf/JetBrainsMono-Bold.ttf",
+      "OFL.txt"
+    ],
+    "weightsUsed": "Regular 400 and Bold 700: Latin-only faces of the Computational Brutalism tonality; Hangul in their runs is set in Pretendard",
+    "files": [
+      {
+        "file": "jetbrains-mono/JetBrainsMono-Regular.ttf",
+        "bytes": 273900,
+        "sha256": "a0bf60ef0f83c5ed4d7a75d45838548b1f6873372dfac88f71804491898d138f"
+      },
+      {
+        "file": "jetbrains-mono/JetBrainsMono-Bold.ttf",
+        "bytes": 277828,
+        "sha256": "5590990c82e097397517f275f430af4546e1c45cff408bde4255dad142479dcb"
+      },
+      {
+        "file": "jetbrains-mono/OFL.txt",
+        "bytes": 4399,
+        "sha256": "30f0c136e3c88e422d0791acd97238870f9054a9729bc34cf2ff0d4ed8cac4ad"
+      }
+    ]
+  },
+  "totalBytes": 5802755
 }

package/plugin/skills/lit-pptx/references/direction-step.md

@@ -2,7 +2,7 @@
 
 Every deck starts by choosing how it should look, before a single slide is written. The choice is
 a tonality: a pack of colours, type sizes, title treatments, layout families and density that the
-engine reads as data. Eight tonalities ship with the skill, and four legacy templates remain for
+engine reads as data. Thirteen tonalities ship with the skill, and four legacy templates remain for
 users who name them. Without this step the engine would have nothing to draw with, and the skill
 would drift back to one look for every topic, which is the failure this whole design exists to end.
 
@@ -16,7 +16,7 @@ card in the build log. It asks the user nothing unless the brief leaves the look
 Name four facts before ranking anything. When the brief does not say them, infer them from the
 request and the sources, and write the inference on the card so the user can correct it.
 
-- **Deck type.** One of the eight below, or "other, nearest to …".
+- **Deck type.** One of the thirteen below, or "other, nearest to …".
 - **Reader.** Who sees it, where, and for how long: a board reading at a desk, a hall watching a
   stage screen, a class that will review the file later.
 - **Delivery.** Presented live, sent ahead and read alone, or both.
@@ -37,6 +37,11 @@ start from. The first one is the default when nothing else moves the order.
 | Image-led (product, site, portfolio) | Atlas (10, 7); Studio (10, 8); Signal (10, 6) for a launch |
 | Korean text briefing (보고서형 덱) | Gazette (10, 4); Ledger (10, 5) |
 | Status update (주간·월간 보고) | Ledger (10, 5); Gazette (10, 4); Night (10, 6) |
+| Launch, demo day or campaign (런칭·데모데이·캠페인) | Neo-Brutalism (10, 7); Signal (10, 6); Studio (10, 7) |
+| Engineering or developer review (아키텍처·인프라·장애 리뷰) | Computational Brutalism (10, 7); Night (10, 6) for a stage; Ledger (10, 5) when it is read alone |
+| Design or culture lecture (디자인·건축·전시·워크숍) | Bauhaus (10, 7); Studio (10, 8); Atlas (10, 7) when the works are the deck |
+| Community, culture or education programme (커뮤니티·문화·교육 프로그램) | Riso (10, 7); Studio (10, 7); Bauhaus (10, 7) for a design programme |
+| Data story for the public (주민·독자 대상 데이터 브리핑) | Newsroom (10, 6); Gazette (10, 4) when it is read alone; Ledger (10, 5) |
 
 ## 3. Measure the source and reorder
 
@@ -58,6 +63,13 @@ the deck-type order, so the same source always gives the same choice.
 | Equations, definitions, or a how-it-works sequence of three or more steps | present | Chalk or Paper up one place |
 | A dark room (keynote, stage, demo day) | stated in the brief | Night up one place |
 | A pack would leave a slide role with no family or title it allows | any slide | drop that pack |
+| The brief names a style rather than a pack id | 네오 브루탈리즘, neo-brutalism, neo-brutalist; 컴퓨테이셔널 브루탈리즘, computational brutalism, 레트로 퓨처, retro-futurist, terminal look; 바우하우스, Bauhaus; 리소, risograph, zine; 뉴스룸, data journalism, explainer | that pack, as if named; a bare 브루탈리즘 or brutalist takes Neo-Brutalism for a pitch or launch and Computational Brutalism for a technical deck, and the card says which reading it took |
+| Metrics with units, version numbers or identifiers (p99, rps, v3, endpoint names) | on a third of the content slides | Computational Brutalism up one place |
+| A young or consumer audience, a sign-up or launch ask | stated in the brief | Neo-Brutalism up one place |
+| Works, makers, periods or schools as the subject | on a third of the content slides | Bauhaus up one place |
+| Participants, sessions, dates and places for a community or a class | on a third of the content slides | Riso up one place |
+| Charts with one point each, for readers outside the field (residents, members, the press) | stated in the brief | Newsroom up one place |
+| A board, investor committee, finance or public-sector reader, or a sensitive topic (loss, safety, HR) | stated in the brief | Neo-Brutalism, Computational Brutalism, Bauhaus and Riso drop out |
 
 The last row matters more than it looks. Atlas, Ledger and Gazette have no statement title, Atlas
 has no table family at all, and Signal has neither a full ledger table nor a dashboard. A pack that cannot carry one
@@ -180,6 +192,11 @@ the job before writing a new deck.
 | `10-status-update-ledger-ko.md` | status update | Ledger | Gazette, Night |
 | `11-portfolio-studio-en.md` | image-led portfolio | Studio | Atlas, Signal |
 | `12-research-tutorial-chalk-en.md` | research tutorial | Chalk | Paper, Night |
+| `13-engineering-review-computational-brutalism-ko.md` | engineering review | Computational Brutalism | Night, Ledger |
+| `14-launch-pitch-neo-brutalism-ko.md` | launch pitch | Neo-Brutalism | Signal, Studio |
+| `15-design-lecture-bauhaus-ko.md` | design lecture | Bauhaus | Studio, Atlas |
+| `16-community-programme-riso-ko.md` | community programme | Riso | Studio, Bauhaus |
+| `17-public-data-briefing-newsroom-ko.md` | data story for residents | Newsroom | Gazette, Ledger |
 
 The examples that place pictures name `assets/example-a.png`, `assets/example-b.png` and
 `assets/example-c.png`; supply real images under those names (or change the paths) before

package/plugin/skills/lit-pptx/references/examples/13-engineering-review-computational-brutalism-ko.md

@@ -0,0 +1,173 @@
+---
+tonality: computational-brutalism
+title: API 게이트웨이 v3 전환 리뷰
+date: 2026-10-20
+department: 예시 기업 플랫폼팀
+presenter: 예시 발표자
+notice: 예시 데이터 — 실제 수치로 바꿔 주세요
+---
+
+---
+layout: cover-typographic
+
+# API 게이트웨이 v3 전환 리뷰
+---
+
+---
+layout: kpi-row
+
+## v3 전환 4주 운영 지표, 2026년 9-10월
+
+| p99 지연 | 처리량 | 오류율 | 노드 수 |
+|---|---|---|---|
+| 182 ms | 41k rps | 0.07% | 24 |
+| v2 410 ms | v2 18k rps | v2 0.31% | v2 40 |
+
+> 운영 클러스터 4주 평균, 2026년 9월 22일-10월 19일 (예시)
+
+- p99 지연은 절반 아래로 줄었고, 같은 트래픽을 노드 24대가 처리한다
+- 오류율 0.07%는 SLO 0.1% 안쪽이고, 월 비용은 2,100만 원 줄었다
+- 출처: 예시 관측 대시보드, 2026년 10월 (예시)
+---
+
+---
+layout: chart-insight
+
+## 주간 p99 지연 추이, v2와 v3
+
+::: chart type=line unit="ms"
+| 주 | v2 p99 (ms) | v3 p99 (ms) |
+|---|---|---|
+| 8월 4주 | 402 | 236 |
+| 9월 1주 | 415 | 221 |
+| 9월 2주 | 408 | 204 |
+| 9월 3주 | 421 | 193 |
+| 9월 4주 | 410 | 188 |
+| 10월 1주 | 412 | 184 |
+| 10월 2주 | 406 | 182 |
+> 주간 p99 지연, 같은 트래픽 미러링 기준 (예시 데이터)
+:::
+
+- v3는 7주 동안 236 ms에서 182 ms로 내려왔고, v2는 400 ms대에 머문다
+- 개선의 절반은 커넥션 풀 재사용, 나머지는 직렬화 경로 교체에서 나왔다
+- 출처: 예시 관측 대시보드, 2026년 8-10월 (예시)
+---
+
+---
+layout: table-insight
+title: bottom-anchor
+
+## 엔드포인트별 지연과 오류, 10월 2주
+
+| 엔드포인트 | 호출 비중 | p50 (ms) | p99 (ms) | 오류율 | v2 대비 p99 |
+|---|---|---|---|---|---|
+| GET /orders | 38% | 21 | 142 | 0.03% | ▼ −61% |
+| POST /orders | 17% | 48 | 231 | 0.11% | ▼ −52% |
+| GET /tracking | 29% | 18 | 120 | 0.02% | ▼ −64% |
+| POST /auth/token | 9% | 35 | 264 | 0.19% | ▼ −38% |
+| 기타 14개 | 7% | 30 | 198 | 0.08% | ▼ −49% |
+
+> 표 1. 엔드포인트별 지연과 오류율, 2026년 10월 2주, 예시 게이트웨이 접근 로그 (예시 데이터)
+
+- 토큰 발급만 오류율이 SLO 근처다: 외부 인증 서버 타임아웃이 원인이다
+- 인증 서버 증설 전까지 토큰 캐시 TTL을 5분에서 15분으로 늘린다
+- 호출의 67%를 차지하는 두 조회 경로는 p99가 150 ms 아래다
+- 주문 생성은 재고 서비스 호출 때문에 조회보다 p99가 1.6배 길다
+---
+
+---
+layout: method
+
+## v3 요청 처리 경로
+
+![도 2. v3 요청 처리 경로, 다섯 단계 | 출처: 예시 이미지](assets/example-b.png)
+
+- **1. 수신** TLS 종료와 요청 파싱, 커넥션 풀에서 업스트림 연결 재사용
+- **2. 인증** 토큰 검증 캐시 우선, 캐시 미스만 인증 서버 호출
+- **3. 라우팅** 경로 규칙 테이블을 메모리에 올려 조회, 규칙 312개
+- **4. 전달** 업스트림 호출과 재시도 1회, 서킷 브레이커 임계 5%
+- **5. 기록** 구조화 로그와 추적 스팬을 비동기로 내보냄
+- 출처: 예시 플랫폼팀 설계 문서 v3.2, 2026년 8월 (예시)
+---
+
+---
+layout: comparison
+
+## v2와 v3 구성 비교
+
+:::: columns 1fr 1fr
+::: col
+- **v2 (2023-2026)**
+  (1) 런타임: 요청마다 새 업스트림 연결
+  (2) 인증: 매 요청 인증 서버 호출
+  (3) 설정: 배포 때마다 규칙 파일 재적재
+  (4) 노드: 40대, 피크 CPU 71%
+  (5) 배포: 주 2회, 배포당 평균 38분
+:::
+::: col
+- **v3 (2026-)**
+  (1) 런타임: 커넥션 풀 재사용, 연결 수립 −92%
+  (2) 인증: 검증 캐시 적중률 94%
+  (3) 설정: 규칙 핫 리로드, 배포 없이 반영
+  (4) 노드: 24대, 피크 CPU 58%
+  (5) 배포: 하루 6회, 배포당 평균 7분
+:::
+::::
+
+- 출처: 예시 플랫폼팀 부하 시험 보고서, 2026년 9월 (예시)
+---
+
+---
+layout: step-diagram
+title: top-rule
+
+## 남은 전환 단계와 종료 조건
+
+- **1. 섀도** 트래픽 5%를 v3로 복제해 응답을 비교한다
+  (1) 종료 조건: 72시간 불일치 0건 · 완료
+- **2. 카나리** 한 리전에서 실트래픽 10%를 v3로 보낸다
+  (1) 종료 조건: p99 250 ms 미만, 오류율 0.1% 미만 · 완료
+- **3. 확대** 50%, 100% 순서로 하루에 한 리전씩 넓힌다
+  (1) 종료 조건: 7일간 롤백 0건 · 진행 중
+- **4. 폐기** v2를 드레인하고 노드 40대를 반납한다
+  (1) 담당: 예시 플랫폼팀, 11월 4주 · 예정
+- 출처: 예시 전환 런북 v1.4, 2026년 10월 (예시)
+---
+
+---
+layout: statement
+
+## 남은 오류는 어디에서 오는가?
+
+토큰 발급 오류의 92%는 v3가 아니라 외부 인증 서버의 2초 타임아웃에서 나온다.
+---
+
+---
+layout: closing-decision-box
+title: top-rule
+
+## v2 폐기와 인증 서버 증설 승인 안건
+
+- 결정할 것: 11월 4주 v2 폐기와 인증 서버 2대 증설을 함께 승인하면 월 2,100만 원을 줄인다
+
+| 안건 | 비용 | 결정 시점 | 담당 |
+|---|---|---|---|
+| v2 노드 40대 반납 | −2,100만 원/월 | 11월 2주 | 예시 플랫폼팀 |
+| 인증 서버 2대 증설 | +260만 원/월 | 11월 1주 | 예시 보안팀 |
+| 토큰 캐시 TTL 15분 | 비용 없음 | 즉시 | 예시 플랫폼팀 |
+| v3 운영 런북 이관 | 비용 없음 | 11월 4주 | 예시 SRE팀 |
+
+> 표 2. 승인 요청 안건 (예시)
+---
+
+---
+layout: references-appendix
+
+## 붙임: 지표 정의와 자료 출처
+
+- [1] p99 지연: 요청 99%가 이 시간 안에 끝나는 값, 1분 창 집계
+- [2] 처리량: 초당 요청 수(rps), 피크 1시간 평균
+- [3] 오류율: 5xx 응답과 타임아웃을 전체 요청으로 나눈 값
+- [4] 예시 관측 대시보드, 2026년 8-10월 (예시)
+- [5] 예시 플랫폼팀 설계 문서 v3.2와 전환 런북 v1.4 (예시)
+---

package/plugin/skills/lit-pptx/references/examples/14-launch-pitch-neo-brutalism-ko.md

@@ -0,0 +1,154 @@
+---
+tonality: neo-brutalism
+title: 동네 운동 모임 앱 시드 투자 제안
+date: 2026-10-21
+department: 예시 스타트업 사업팀
+presenter: 예시 대표
+notice: 예시 데이터 — 실제 수치로 바꿔 주세요
+---
+
+---
+layout: cover-typographic
+
+# 동네 운동 모임 앱 시드 투자 제안
+---
+
+---
+layout: statement
+
+## 왜 운동은 혼자 오래 못 하는가?
+
+헬스장 신규 회원의 63%가 석 달 안에 발길을 끊고, 그 이유 1위는 "같이 할 사람이 없어서"다.
+---
+
+---
+layout: big-number
+
+## 수도권 생활 체육 모임 시장
+
+| 정기 모임 참여자 | 모임 찾기 앱 이용 | 월 평균 회비 | 앱 이용 연 성장률 |
+|---|---|---|---|
+| 310만 명 | 9% | 3만 2천 원 | 37% |
+| 2025년 기준 | 2023년 4% | 1인 기준 | 2023-2025년 평균 |
+
+> 수도권 생활 체육 모임 추정, 예시 업계 통계 2025 (예시)
+
+- 모임은 대부분 단톡방과 지인 소개로 굴러간다: 앱으로 찾는 사람은 열 명 중 한 명
+- 앱 비중이 2028년 20%가 되면 모임 회비 시장은 연 2,400억 원이다
+- 출처: 예시 업계 통계 2025, 수도권 성인 2,000명 조사 (예시)
+---
+
+---
+layout: image-split
+
+## 앱에서 모임까지 세 번의 탭
+
+![도 1. 모임 찾기 화면 예시 | 출처: 예시 이미지](assets/example-a.png)
+
+- **찾기** 집에서 1.5 km 안의 러닝, 배드민턴, 클라이밍 모임을 지도로 본다
+- **참여** 첫 모임은 무료, 두 번째부터 회비를 앱에서 낸다
+- **기록** 출석과 운동량이 쌓이면 모임장이 레벨을 올려 준다
+- **안전** 모임장 본인 인증과 장소 공개로 처음 가는 모임도 안심한다
+- 출처: 예시 서비스 베타 화면, 2026년 9월 (예시)
+---
+
+---
+layout: kpi-row
+
+## 베타 8주 성과, 2026년 8-10월
+
+| 가입자 | 주간 재방문 | 추천 가입 | 유료 전환 |
+|---|---|---|---|
+| 1.2만 명 | 46% | 38% | 7.4% |
+| 목표 1만 명 | 업계 평균 25% | 광고비 0원 | 목표 5% |
+
+> 베타 운영 기록, 2026년 8-10월 (예시)
+
+- 광고 없이 가입자 목표를 넘겼다: 셋 중 하나 이상이 친구 추천으로 왔다
+- 유료 전환 7.4%는 목표 5%를 넘었고, 연 결제가 그중 60%다
+- 주간 재방문 46%는 운동 앱 업계 평균의 두 배 가까운 수치다
+- 베타 모임 318개 중 72%가 8주 차에도 매주 모였다
+- 모임장 1인당 회원은 평균 14명, 상위 10%는 40명을 넘는다
+- 출처: 예시 서비스 운영 대시보드, 2026년 10월 (예시)
+---
+
+---
+layout: chart-insight
+
+## 주간 활성 모임 수, 베타 8주
+
+::: chart type=column unit="개"
+| 주 | 활성 모임 (개) |
+|---|---|
+| 1주 | 42 |
+| 2주 | 61 |
+| 3주 | 88 |
+| 4주 | 117 |
+| 5주 | 160 |
+| 6주 | 204 |
+| 7주 | 251 |
+| 8주 | 318 |
+> 주간 활성 모임 수, 한 번 이상 모인 모임 기준 (예시 데이터)
+:::
+
+- 활성 모임은 8주 동안 매주 평균 34%씩 늘어 7.6배가 됐다
+- 모임장 한 명이 평균 1.4개의 모임을 열고, 둘째 모임은 첫 모임의 단골이 연다
+- 출처: 예시 서비스 운영 대시보드, 2026년 8-10월 (예시)
+---
+
+---
+layout: process
+
+## 모임장이 돈을 버는 구조
+
+- **1. 개설** 모임장이 장소와 시간을 정하고 회비를 1만-5만 원 사이로 정한다
+- **2. 모집** 앱이 반경 1.5 km 가입자에게 모임을 추천한다
+- **3. 정산** 회비의 85%는 모임장에게, 15%는 플랫폼 수수료로 남는다
+- **4. 재방문** 출석 4회를 넘긴 회원의 3개월 유지율은 71%다
+- 출처: 예시 서비스 정산 기준과 베타 기록, 2026년 10월 (예시)
+---
+
+---
+layout: comparison
+
+## 단톡방 모임과 앱 모임 비교
+
+:::: columns 1fr 1fr
+::: col
+- **단톡방 모임**
+  (1) 찾기: 지인 소개가 없으면 들어갈 길이 없다
+  (2) 회비: 계좌 이체와 독촉 메시지로 걷는다
+  (3) 안전: 모임장이 누군지 알 방법이 없다
+  (4) 기록: 출석은 모임장이 손으로 센다
+:::
+::: col
+- **앱 모임**
+  (1) 찾기: 지도에서 고르고 첫 모임은 무료다
+  (2) 회비: 앱 결제, 미납률 2% (단톡방 18%)
+  (3) 안전: 본인 인증 모임장, 장소 사전 공개
+  (4) 기록: 출석과 운동량이 자동으로 쌓인다
+:::
+::::
+
+- 출처: 베타 모임장 120명 인터뷰, 2026년 9월 (예시)
+---
+
+---
+layout: closing-ask
+
+## 시드 15억 원 사용 계획
+
+| 쓰임 | 금액 | 시점 |
+|---|---|---|
+| 앱 개발 인력 4명 | 7억 원 | 2027년 상반기 |
+| 모임장 모집 200명 | 4억 원 | 2027년 1분기 |
+| 마케팅 실험 | 3억 원 | 상시 |
+| 운영 예비비 | 1억 원 | 필요 시 |
+| 합계 | 15억 원 | 12개월 |
+
+> 표 1. 투자금 쓰임 (예시 데이터)
+
+- 요청: 시드 15억 원 투자 승인
+- 기대 성과: 12개월 뒤 가입자 10만 명, 월 거래액 6억 원
+- 다음 단계: 11월 첫째 주 후속 미팅, 담당 예시 대표
+---