@litfamily/litgravity 0.1.1 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (246) hide show
  1. package/CHANGELOG.md +27 -0
  2. package/README.md +17 -3
  3. package/README_ko-KR.md +17 -3
  4. package/package.json +1 -1
  5. package/plugin/hooks/lib/lanes.mjs +65 -0
  6. package/plugin/hooks/lib/motion.mjs +34 -5
  7. package/plugin/hooks/lib/reentry.mjs +7 -0
  8. package/plugin/hooks/lib/rewind/brief.mjs +332 -0
  9. package/plugin/hooks/lib/rewind/collect.mjs +328 -0
  10. package/plugin/hooks/lib/rewind/gauge.mjs +55 -0
  11. package/plugin/hooks/lib/rewind/next-step.mjs +77 -0
  12. package/plugin/hooks/lib/rewind/redact.mjs +60 -0
  13. package/plugin/hooks/lib/rewind/transcripts.mjs +211 -0
  14. package/plugin/hooks/lib/routes.mjs +79 -5
  15. package/plugin/hooks/lib/workflow-stack.mjs +213 -0
  16. package/plugin/hooks/post-tool-use.mjs +37 -1
  17. package/plugin/hooks/pre-invocation.mjs +91 -2
  18. package/plugin/hooks/session-start.mjs +26 -3
  19. package/plugin/hooks/stop.mjs +22 -2
  20. package/plugin/hud/looks.mjs +29 -0
  21. package/plugin/hud/render.mjs +234 -12
  22. package/plugin/plugin.json +1 -1
  23. package/plugin/skills/frontend-ui-ux/SKILL.md +12 -1
  24. package/plugin/skills/frontend-ui-ux/kit/components.css +417 -0
  25. package/plugin/skills/frontend-ui-ux/kit/fonts.json +22 -0
  26. package/plugin/skills/frontend-ui-ux/kit/layouts/landing.html +164 -0
  27. package/plugin/skills/frontend-ui-ux/kit/layouts/settings.html +114 -0
  28. package/plugin/skills/frontend-ui-ux/kit/layouts/workspace.html +115 -0
  29. package/plugin/skills/frontend-ui-ux/kit/styles/computational-brutalism.json +227 -0
  30. package/plugin/skills/frontend-ui-ux/kit/styles/field-notes.json +205 -0
  31. package/plugin/skills/frontend-ui-ux/kit/styles/graphite.json +200 -0
  32. package/plugin/skills/frontend-ui-ux/kit/styles/meadow.json +199 -0
  33. package/plugin/skills/frontend-ui-ux/kit/styles/neo-brutalism.json +222 -0
  34. package/plugin/skills/frontend-ui-ux/kit/ui.js +226 -0
  35. package/plugin/skills/frontend-ui-ux/references/house-styles.md +234 -0
  36. package/plugin/skills/frontend-ui-ux/scripts/design-lock.mjs +400 -0
  37. package/plugin/skills/frontend-ui-ux/scripts/interface-probe-lock.mjs +196 -0
  38. package/plugin/skills/frontend-ui-ux/scripts/interface-probe-page.mjs +30 -9
  39. package/plugin/skills/frontend-ui-ux/scripts/interface-probe-rules.mjs +20 -8
  40. package/plugin/skills/frontend-ui-ux/scripts/interface-probe.mjs +42 -9
  41. package/plugin/skills/frontend-ui-ux/scripts/pixel-art.mjs +60 -0
  42. package/plugin/skills/lit-adhd/SKILL.md +157 -0
  43. package/plugin/skills/lit-adhd/references/card-examples.md +101 -0
  44. package/plugin/skills/lit-adhd/references/status-taxonomy.md +32 -0
  45. package/plugin/skills/lit-adhd/scripts/rewind.mjs +5 -0
  46. package/plugin/skills/lit-diagram-drawer/SKILL.md +5 -3
  47. package/plugin/skills/lit-diagram-drawer/references/drawing-rules.md +1 -1
  48. package/plugin/skills/lit-diagram-drawer/references/style-guide.md +21 -12
  49. package/plugin/skills/lit-diagram-drawer/references/type-architecture.md +3 -3
  50. package/plugin/skills/lit-diagram-drawer/references/type-dependency.md +1 -1
  51. package/plugin/skills/lit-diagram-drawer/references/type-tree.md +3 -3
  52. package/plugin/skills/lit-diagram-drawer/references/type-wardley.md +1 -1
  53. package/plugin/skills/lit-diagram-drawer/scripts/diagram-craft-rules.mjs +1 -2
  54. package/plugin/skills/lit-diagram-drawer/scripts/visual-quality.mjs +1 -2
  55. package/plugin/skills/lit-docx/SKILL.md +3 -3
  56. package/plugin/skills/lit-handoff/SKILL.md +1 -0
  57. package/plugin/skills/lit-hijack/SKILL.md +263 -0
  58. package/plugin/skills/lit-hijack/references/capture-and-provenance.md +100 -0
  59. package/plugin/skills/lit-hijack/references/clean-room-build.md +75 -0
  60. package/plugin/skills/lit-hijack/references/distil-and-licence.md +67 -0
  61. package/plugin/skills/lit-hijack/references/gap-and-port-design.md +100 -0
  62. package/plugin/skills/lit-hijack/references/parity-and-report.md +85 -0
  63. package/plugin/skills/lit-hijack/scripts/hijack.mjs +953 -0
  64. package/plugin/skills/lit-plan/SKILL.md +1 -1
  65. package/plugin/skills/lit-pptx/SKILL.md +8 -8
  66. package/plugin/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Bold.ttf +0 -0
  67. package/plugin/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Regular.ttf +0 -0
  68. package/plugin/skills/lit-pptx/fonts/jetbrains-mono/OFL.txt +93 -0
  69. package/plugin/skills/lit-pptx/fonts/provenance.json +32 -1
  70. package/plugin/skills/lit-pptx/references/agents/analyst.md +34 -56
  71. package/plugin/skills/lit-pptx/references/agents/antithesis.md +49 -67
  72. package/plugin/skills/lit-pptx/references/agents/architect.md +38 -51
  73. package/plugin/skills/lit-pptx/references/agents/critic.md +25 -41
  74. package/plugin/skills/lit-pptx/references/agents/synthesizer.md +37 -46
  75. package/plugin/skills/lit-pptx/references/agents/thesis.md +29 -49
  76. package/plugin/skills/lit-pptx/references/anti-slop-checklist.md +119 -145
  77. package/plugin/skills/lit-pptx/references/authoring-guide.md +187 -278
  78. package/plugin/skills/lit-pptx/references/consensus-protocol.md +99 -97
  79. package/plugin/skills/lit-pptx/references/data-display-cookbook.md +36 -137
  80. package/plugin/skills/lit-pptx/references/density-and-fill.md +147 -216
  81. package/plugin/skills/lit-pptx/references/design-system-azure.md +56 -85
  82. package/plugin/skills/lit-pptx/references/direction-step.md +134 -176
  83. package/plugin/skills/lit-pptx/references/examples/01-pitch-signal-ko.md +114 -115
  84. package/plugin/skills/lit-pptx/references/examples/02-pitch-studio-ko.md +66 -66
  85. package/plugin/skills/lit-pptx/references/examples/03-business-review-ledger-ko.md +63 -63
  86. package/plugin/skills/lit-pptx/references/examples/04-business-review-night-en.md +96 -96
  87. package/plugin/skills/lit-pptx/references/examples/05-research-talk-paper-en.md +81 -81
  88. package/plugin/skills/lit-pptx/references/examples/06-lecture-chalk-ko.md +103 -103
  89. package/plugin/skills/lit-pptx/references/examples/07-data-review-night-en.md +100 -98
  90. package/plugin/skills/lit-pptx/references/examples/08-image-led-atlas-ko.md +76 -76
  91. package/plugin/skills/lit-pptx/references/examples/09-briefing-gazette-ko.md +96 -96
  92. package/plugin/skills/lit-pptx/references/examples/10-status-update-ledger-ko.md +80 -80
  93. package/plugin/skills/lit-pptx/references/examples/11-portfolio-studio-en.md +72 -72
  94. package/plugin/skills/lit-pptx/references/examples/12-research-tutorial-chalk-en.md +95 -95
  95. package/plugin/skills/lit-pptx/references/examples/13-engineering-review-computational-brutalism-ko.md +173 -0
  96. package/plugin/skills/lit-pptx/references/examples/14-launch-pitch-neo-brutalism-ko.md +154 -0
  97. package/plugin/skills/lit-pptx/references/examples/15-design-lecture-bauhaus-ko.md +139 -0
  98. package/plugin/skills/lit-pptx/references/examples/16-community-programme-riso-ko.md +158 -0
  99. package/plugin/skills/lit-pptx/references/examples/17-public-data-briefing-newsroom-ko.md +179 -0
  100. package/plugin/skills/lit-pptx/references/interview-protocol.md +83 -102
  101. package/plugin/skills/lit-pptx/references/layout-families.md +161 -265
  102. package/plugin/skills/lit-pptx/references/stages/autopilot.md +30 -70
  103. package/plugin/skills/lit-pptx/references/stages/interview.md +36 -68
  104. package/plugin/skills/lit-pptx/references/stages/plan.md +26 -67
  105. package/plugin/skills/lit-pptx/references/title-treatments.md +93 -145
  106. package/plugin/skills/lit-pptx/references/tonalities/atlas.md +95 -108
  107. package/plugin/skills/lit-pptx/references/tonalities/bauhaus.md +140 -0
  108. package/plugin/skills/lit-pptx/references/tonalities/chalk.md +107 -122
  109. package/plugin/skills/lit-pptx/references/tonalities/computational-brutalism.md +150 -0
  110. package/plugin/skills/lit-pptx/references/tonalities/gazette.md +87 -111
  111. package/plugin/skills/lit-pptx/references/tonalities/ledger.md +96 -125
  112. package/plugin/skills/lit-pptx/references/tonalities/neo-brutalism.md +161 -0
  113. package/plugin/skills/lit-pptx/references/tonalities/newsroom.md +144 -0
  114. package/plugin/skills/lit-pptx/references/tonalities/night.md +104 -131
  115. package/plugin/skills/lit-pptx/references/tonalities/paper.md +114 -130
  116. package/plugin/skills/lit-pptx/references/tonalities/riso.md +137 -0
  117. package/plugin/skills/lit-pptx/references/tonalities/signal.md +96 -103
  118. package/plugin/skills/lit-pptx/references/tonalities/studio.md +81 -112
  119. package/plugin/skills/lit-pptx/scripts/compile-deck.js +4 -6
  120. package/plugin/skills/lit-pptx/scripts/craft_extras.py +135 -91
  121. package/plugin/skills/lit-pptx/scripts/deck_craft.py +1 -1
  122. package/plugin/skills/lit-pptx/scripts/embed_fonts.py +13 -1
  123. package/plugin/skills/lit-pptx/scripts/layout_inventory.py +1 -1
  124. package/plugin/skills/lit-pptx/scripts/learn_template.py +1 -1
  125. package/plugin/skills/lit-pptx/scripts/lib/grid-resolver.js +101 -110
  126. package/plugin/skills/lit-pptx/scripts/lib/layout-resolver.js +9 -15
  127. package/plugin/skills/lit-pptx/scripts/lib/render-pack.js +370 -563
  128. package/plugin/skills/lit-pptx/scripts/lib/slide-grid.js +104 -0
  129. package/plugin/skills/lit-pptx/scripts/lib/template-registry.js +57 -6
  130. package/plugin/skills/lit-pptx/scripts/qa_deck.py +6 -6
  131. package/plugin/skills/lit-pptx/scripts/render_pages.py +31 -0
  132. package/plugin/skills/lit-pptx/scripts/validate_pptx.py +1 -1
  133. package/plugin/skills/lit-pptx/specs/markdown-slide-spec-v1.md +167 -191
  134. package/plugin/skills/lit-pptx/specs/markdown-slide-spec-v2.md +117 -166
  135. package/plugin/skills/lit-pptx/specs/template-enrollment-contract.md +307 -330
  136. package/plugin/skills/lit-pptx/templates/tonalities/atlas/pack.yaml +1 -1
  137. package/plugin/skills/lit-pptx/templates/tonalities/bauhaus/pack.yaml +98 -0
  138. package/plugin/skills/lit-pptx/templates/tonalities/chalk/pack.yaml +1 -1
  139. package/plugin/skills/lit-pptx/templates/tonalities/computational-brutalism/pack.yaml +99 -0
  140. package/plugin/skills/lit-pptx/templates/tonalities/gazette/pack.yaml +1 -1
  141. package/plugin/skills/lit-pptx/templates/tonalities/ledger/pack.yaml +1 -1
  142. package/plugin/skills/lit-pptx/templates/tonalities/neo-brutalism/pack.yaml +107 -0
  143. package/plugin/skills/lit-pptx/templates/tonalities/newsroom/pack.yaml +99 -0
  144. package/plugin/skills/lit-pptx/templates/tonalities/night/pack.yaml +1 -1
  145. package/plugin/skills/lit-pptx/templates/tonalities/paper/pack.yaml +1 -1
  146. package/plugin/skills/lit-pptx/templates/tonalities/riso/pack.yaml +99 -0
  147. package/plugin/skills/lit-pptx/templates/tonalities/signal/pack.yaml +2 -2
  148. package/plugin/skills/lit-pptx/templates/tonalities/studio/pack.yaml +1 -1
  149. package/plugin/skills/lit-schematic/SKILL.md +114 -0
  150. package/plugin/skills/lit-schematic/examples/iso-heat-exchanger/build.mjs +38 -0
  151. package/plugin/skills/lit-schematic/examples/iso-heat-exchanger/scene.mjs +133 -0
  152. package/plugin/skills/lit-schematic/examples/journal-adsorption-rig/build.mjs +87 -0
  153. package/plugin/skills/lit-schematic/examples/pid-dosing-skid/build.mjs +85 -0
  154. package/plugin/skills/lit-schematic/references/cutaway-outputs.md +70 -0
  155. package/plugin/skills/lit-schematic/references/isometric-craft.md +101 -0
  156. package/plugin/skills/lit-schematic/references/journal-figures.md +72 -0
  157. package/plugin/skills/lit-schematic/references/kit-api.md +134 -0
  158. package/plugin/skills/lit-schematic/references/pfd-and-layout.md +53 -0
  159. package/plugin/skills/lit-schematic/references/pid-drafting.md +103 -0
  160. package/plugin/skills/lit-schematic/references/pid-symbols.md +163 -0
  161. package/plugin/skills/lit-schematic/references/verification.md +100 -0
  162. package/plugin/skills/lit-schematic/scripts/doctor.mjs +57 -0
  163. package/plugin/skills/lit-schematic/scripts/lib/figure.mjs +81 -0
  164. package/plugin/skills/lit-schematic/scripts/lib/fonts.mjs +27 -0
  165. package/plugin/skills/lit-schematic/scripts/lib/geom.mjs +113 -0
  166. package/plugin/skills/lit-schematic/scripts/lib/interactive.mjs +292 -0
  167. package/plugin/skills/lit-schematic/scripts/lib/isa.mjs +115 -0
  168. package/plugin/skills/lit-schematic/scripts/lib/iso.mjs +719 -0
  169. package/plugin/skills/lit-schematic/scripts/lib/legend-sheet.mjs +162 -0
  170. package/plugin/skills/lit-schematic/scripts/lib/pid.mjs +937 -0
  171. package/plugin/skills/lit-schematic/scripts/lib/png.mjs +132 -0
  172. package/plugin/skills/lit-schematic/scripts/lib/qa-core.mjs +658 -0
  173. package/plugin/skills/lit-schematic/scripts/lib/route.mjs +218 -0
  174. package/plugin/skills/lit-schematic/scripts/lib/sheet.mjs +890 -0
  175. package/plugin/skills/lit-schematic/scripts/lib/svg.mjs +82 -0
  176. package/plugin/skills/lit-schematic/scripts/lib/theme.mjs +115 -0
  177. package/plugin/skills/lit-schematic/scripts/motion.mjs +129 -0
  178. package/plugin/skills/lit-schematic/scripts/qa.mjs +92 -0
  179. package/plugin/skills/lit-schematic/scripts/render.mjs +233 -0
  180. package/plugin/skills/lit-schematic/scripts/scaffold.mjs +60 -0
  181. package/plugin/skills/lit-scientific-visualization/SKILL.md +17 -6
  182. package/plugin/skills/lit-typographic-motion/SKILL.md +58 -48
  183. package/plugin/skills/lit-typographic-motion/engine/THIRD_PARTY_NOTICES +13 -2
  184. package/plugin/skills/lit-typographic-motion/engine/blender/runner.py +218 -0
  185. package/plugin/skills/lit-typographic-motion/engine/core/presets.mjs +1 -1
  186. package/plugin/skills/lit-typographic-motion/engine/node/analysis.mjs +65 -1
  187. package/plugin/skills/lit-typographic-motion/engine/node/assets.mjs +298 -0
  188. package/plugin/skills/lit-typographic-motion/engine/node/blender.mjs +143 -0
  189. package/plugin/skills/lit-typographic-motion/engine/node/board.mjs +136 -0
  190. package/plugin/skills/lit-typographic-motion/engine/node/brief.mjs +7 -1
  191. package/plugin/skills/lit-typographic-motion/engine/node/chrome.mjs +9 -12
  192. package/plugin/skills/lit-typographic-motion/engine/node/cover-assets.mjs +5 -3
  193. package/plugin/skills/lit-typographic-motion/engine/node/cover-capture.mjs +7 -6
  194. package/plugin/skills/lit-typographic-motion/engine/node/cover-treatment.mjs +37 -4
  195. package/plugin/skills/lit-typographic-motion/engine/node/cover.mjs +19 -8
  196. package/plugin/skills/lit-typographic-motion/engine/node/done.mjs +45 -6
  197. package/plugin/skills/lit-typographic-motion/engine/node/frame-worker.mjs +7 -5
  198. package/plugin/skills/lit-typographic-motion/engine/node/gallery.mjs +121 -0
  199. package/plugin/skills/lit-typographic-motion/engine/node/host.mjs +34 -0
  200. package/plugin/skills/lit-typographic-motion/engine/node/house.mjs +44 -0
  201. package/plugin/skills/lit-typographic-motion/engine/node/look.mjs +34 -20
  202. package/plugin/skills/lit-typographic-motion/engine/node/pipeline.mjs +19 -9
  203. package/plugin/skills/lit-typographic-motion/engine/node/scaffold.mjs +210 -0
  204. package/plugin/skills/lit-typographic-motion/engine/node/score.mjs +639 -0
  205. package/plugin/skills/lit-typographic-motion/engine/node/sound-cli.mjs +21 -4
  206. package/plugin/skills/lit-typographic-motion/engine/node/sound.mjs +127 -29
  207. package/plugin/skills/lit-typographic-motion/engine/node/stage-capture.mjs +7 -6
  208. package/plugin/skills/lit-typographic-motion/engine/node/stage-gate.mjs +59 -5
  209. package/plugin/skills/lit-typographic-motion/engine/node/stage-qa.mjs +141 -9
  210. package/plugin/skills/lit-typographic-motion/engine/node/stage-serve.mjs +28 -5
  211. package/plugin/skills/lit-typographic-motion/engine/node/stage.mjs +82 -14
  212. package/plugin/skills/lit-typographic-motion/engine/node/styles.mjs +213 -0
  213. package/plugin/skills/lit-typographic-motion/engine/node/treatment.mjs +311 -10
  214. package/plugin/skills/lit-typographic-motion/engine/stage/cover-init.js +14 -2
  215. package/plugin/skills/lit-typographic-motion/engine/stage/init.js +11 -1
  216. package/plugin/skills/lit-typographic-motion/engine/stage/qa.js +6 -1
  217. package/plugin/skills/lit-typographic-motion/engine/stage/stage-kit.js +83 -0
  218. package/plugin/skills/lit-typographic-motion/engine/vendor/three/LICENSE +21 -0
  219. package/plugin/skills/lit-typographic-motion/engine/vendor/three/addons/environments/RoomEnvironment.js +144 -0
  220. package/plugin/skills/lit-typographic-motion/engine/vendor/three/addons/geometries/RoundedBoxGeometry.js +155 -0
  221. package/plugin/skills/lit-typographic-motion/engine/vendor/three/three.module.js +54571 -0
  222. package/plugin/skills/lit-typographic-motion/recipes/hero-3d/expected.json +69 -0
  223. package/plugin/skills/lit-typographic-motion/recipes/hero-3d/index.html +139 -0
  224. package/plugin/skills/lit-typographic-motion/recipes/orbit-loop/expected.json +6 -4
  225. package/plugin/skills/lit-typographic-motion/recipes/painted-light/expected.json +4 -2
  226. package/plugin/skills/lit-typographic-motion/recipes/weight-tide/expected.json +7 -5
  227. package/plugin/skills/lit-typographic-motion/references/cover.md +394 -443
  228. package/plugin/skills/lit-typographic-motion/references/craft-loop.md +57 -87
  229. package/plugin/skills/lit-typographic-motion/references/depth.md +122 -0
  230. package/plugin/skills/lit-typographic-motion/references/look.md +94 -129
  231. package/plugin/skills/lit-typographic-motion/references/runtime.md +58 -91
  232. package/plugin/skills/lit-typographic-motion/references/sound.md +130 -99
  233. package/plugin/skills/lit-typographic-motion/references/stage.md +190 -215
  234. package/plugin/skills/lit-typographic-motion/references/studio.md +245 -0
  235. package/plugin/skills/lit-typographic-motion/references/style-bibles.md +108 -97
  236. package/plugin/skills/lit-typographic-motion/references/treatment.md +191 -143
  237. package/plugin/skills/lit-typographic-motion/scripts/motion-doctor.mjs +17 -5
  238. package/plugin/skills/lit-typographic-motion/scripts/motion.mjs +47 -7
  239. package/plugin/skills/lit-typographic-motion/styles/paper.json +41 -0
  240. package/plugin/skills/lit-typographic-motion/styles/swiss-signal.json +41 -0
  241. package/plugin/skills/lit-typographic-motion/styles/terminalcore.json +42 -0
  242. package/plugin/skills/lit-typographic-motion/styles/tidal.json +41 -0
  243. package/plugin/skills/litresearch/SKILL.md +1 -0
  244. package/plugin/skills/readme-studio/SKILL.md +2 -0
  245. package/plugin/skills/review-work/SKILL.md +1 -1
  246. package/plugin/skills/start-work/SKILL.md +1 -1
@@ -0,0 +1,140 @@
1
+ # Bauhaus
2
+
3
+ Bauhaus is the direction for a talk about making things: design, architecture, craft, art history,
4
+ culture. Its display slides carry an elementary composition, a yellow square, a red circle, a black
5
+ bar and a blue triangle set on the grid, beside a heavy title on an off-white ground. The content
6
+ slides are quiet on purpose: black type, a short red rule under each title, open tables and one red
7
+ accent. The geometry is the voice, so it appears where the deck speaks (the cover and the
8
+ statements) and stays out of the pages where the audience reads.
9
+
10
+ ## When to use it
11
+
12
+ Reach for Bauhaus for a design or architecture lecture, a museum or exhibition opener, a workshop on
13
+ brand or product design, a culture programme, a portfolio review for a design school, or a talk on
14
+ the history of a style. The content signals that point here are images and few numbers, a sequence
15
+ of ideas or periods, quotations from makers, and words such as 디자인, 건축, 전시, 워크숍, 바우하우스,
16
+ Bauhaus, modernism or "primary colours". It is the first candidate for a design or culture lecture,
17
+ before Studio, and the second for a creative workshop.
18
+
19
+ ## When it is the wrong choice
20
+
21
+ It fails for a data-heavy business review, finance, a public-sector report and any deck where tables
22
+ make up a third of the slides: the display geometry has nothing to say about a ledger. It is wrong
23
+ for grief, safety or financial-loss topics, where primary colours read as careless. For a deck that
24
+ is mostly pictures, Atlas or Studio frames them better; for a pitch, Signal or Neo-Brutalism.
25
+
26
+ ## Tokens
27
+
28
+ The values below come from the pack file and are what the engine draws.
29
+
30
+ | Token | Value |
31
+ |---|---|
32
+ | ground / surface | #F4F1EA / #E8E3D6 |
33
+ | ink / ink-muted / line | #141414 / #4A4740 / #141414 |
34
+ | accent / accent-deep / accent-tint | #C8261C / #7A140E / #F2C230 (the yellow of the geometry) |
35
+ | field / on-field | #1F3C99 / #FFFFFF |
36
+ | positive / negative | #1E6B3A / #141414 |
37
+ | series | #C8261C, #1F3C99, #141414, #9E7700 |
38
+ | faces | Pretendard Bold for display, title, labels and numerals, Pretendard Regular for body; `faces: a2z` swaps to A2Z Black display, titles and numerals |
39
+ | 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 |
40
+ | density / variance | 10 / 7 |
41
+ | radius / edge | 0 / fill |
42
+ | decoration | a short accent rule under top titles, kicker numerals, colour fields |
43
+ | table | open, no header fill, a rule under the header, bold totals |
44
+ | chart | no gridlines, direct labels, the accent on the highlighted series over muted ones |
45
+
46
+ Density 10 sets the lecture on the compact grid (24 pt side margins), body 13 pt and no step-up, as
47
+ every pack in the family. The fourth series colour
48
+ is the geometry's yellow darkened to an ochre so a bar still holds 3:1 on the ground; the bright
49
+ yellow itself is kept for fills (the square, the notice tag, a highlighted table row), never for text.
50
+ A loss uses ink with a ▼ sign.
51
+
52
+ ## QA allowances
53
+
54
+ Red, blue and yellow sit side by side on a cover, statement or content slide inside the default
55
+ OF-101 limit (four hue families; a fifth fails), so this pack needs no `qa:` allowance.
56
+
57
+ ## Treatments by slide role
58
+
59
+ Content, data and reference slides take `top-rule` (the title over a short red rule); data with a
60
+ takeaway and definitions take `side-rail`; sequences `kicker-numeral`; image slides `bottom-anchor`;
61
+ statements `statement`. The engine lays out every treatment the family allows, keeps the role's own
62
+ when the body fills, and otherwise takes the one that leaves the least empty band. Force one with
63
+ `title: <id>` on the line after `layout:`.
64
+
65
+ ## Families and variants
66
+
67
+ - `asymmetric-feature` and `image-split` pair a work or a building with what to see in it.
68
+ - `timeline` places periods, schools or projects in order.
69
+ - `process` and `step-diagram` set a making process in three to five steps.
70
+ - `comparison` and `text-two-column` read two works, two periods or two methods side by side.
71
+ - `big-number`, `kpi-row`, `chart-insight` and `table-insight` carry the few figures such a talk has.
72
+ - `quote` sets a maker's sentence; `statement` holds one idea at display size.
73
+ - `agenda` opens a workshop with its sessions.
74
+
75
+ Covers are `cover-typographic`, `cover-split-field` and `cover-numeral`; sections are
76
+ `section-field` and `section-numeral`; closings are `closing-ask`, `closing-summary-list` and
77
+ `closing-statement`.
78
+
79
+ Display slides. The typographic cover sets the topic at display size on the left half and the
80
+ composition on the right half: the yellow square and red circle above, the black bar and blue
81
+ triangle below, each in its own grid cell. A statement sets its sentence on the left and a narrower
82
+ composition from column 10 to the edge. A big number is a blue field panel. A closing's next step
83
+ stands between two rules; a closing statement takes the statement's composition.
84
+
85
+ ## Do
86
+
87
+ - Keep the geometry on the cover and the statements; content slides carry type, images and data.
88
+ - Use one statement per section at most, so the composition stays an event.
89
+ - Caption every work with maker, year and source.
90
+ - Let red mark one word or one figure on a content slide.
91
+
92
+ ## Avoid
93
+
94
+ - Circles, squares or triangles as bullets, icons or frames on content slides.
95
+ - Yellow text on the off-white ground.
96
+ - A fifth hue family beside the three primaries and the ink.
97
+ - This direction for a ledger, a finance review or a sensitive topic.
98
+
99
+ ## Two worked slides
100
+
101
+ A lecture slide pairs a building with what to see in it, and lets the caption carry the source.
102
+
103
+ ```markdown
104
+ ---
105
+ layout: image-split
106
+
107
+ ## 데사우 교사(校舍)의 세 가지 설계 원칙
108
+
109
+ ![도 1. 데사우 교사 전경 | 출처: 예시 이미지](assets/example-a.png)
110
+
111
+ - **기능별 동** 공방, 교실, 기숙사를 각각의 동으로 나눠 다리로 잇는다
112
+ - **유리 커튼월** 공방 동의 외벽 전체가 유리라 작업이 밖에서 보인다
113
+ - **비대칭 배치** 정면이 없어, 걸으며 돌아봐야 전체가 읽힌다
114
+ - 출처: 예시 건축사 강의 자료, 2026년 (예시)
115
+ ---
116
+ ```
117
+
118
+ A timeline places the school's three sites in order, with what changed at each.
119
+
120
+ ```markdown
121
+ ---
122
+ layout: timeline
123
+
124
+ ## 학교의 세 시기, 1919-1933년
125
+
126
+ | 시점 | 장소 | 무엇이 바뀌었나 |
127
+ |---|---|---|
128
+ | 1919년 | 바이마르 | 공방 중심 교육, 표현주의의 영향이 강하다 |
129
+ | 1925년 | 데사우 | 산업 생산과의 협업, 표준화된 제품 디자인 |
130
+ | 1932년 | 베를린 | 사립 학교로 축소, 이듬해 문을 닫는다 |
131
+
132
+ > 표 1. 바우하우스의 세 시기 (예시 자료)
133
+
134
+ - 출처: 예시 디자인사 강의 노트, 2026년 (예시)
135
+ ---
136
+ ```
137
+
138
+ ## Examples
139
+
140
+ `15-design-lecture-bauhaus-ko.md`
@@ -1,163 +1,148 @@
1
1
  # Chalk
2
2
 
3
3
  Chalk is a good teacher's board after someone has tidied it. Steps are numbered because they really
4
- happen in order, one idea per slide is marked as the thing to learn and worked through with numbers,
5
- and the definition or the common mistake stands in its own fenced box at the side. Corners are soft
6
- (radius 6), the ground is a cool near-white, the board itself is a deep green rail, and a warm rust
7
- accent points at what is being taught. The rhythm is deliberate: explain, show, try, check.
4
+ happen in order, one idea per slide is marked as the thing to learn and worked through with its
5
+ numbers, and the definition or the
6
+ common mistake sits in its own fenced box at the side. Surfaces have soft corners, the ground is a
7
+ cool near-white, and a warm rust accent always points at what is being taught. The rhythm is
8
+ deliberate: explain, show, try, check.
8
9
 
9
- ## When to choose it
10
+ ## When to use it
10
11
 
11
12
  Choose Chalk for lectures, tutorials, onboarding sessions and training, where the audience has to be
12
- able to do something afterwards. The pack carries eleven families, four of them built for teaching:
13
- `step-diagram` and `process` for sequences, `method` for a formula with its symbols, and
14
- `sidebar-note` for the definition or the trap. It climbs the list when the source holds equations,
15
- definitions or a "how it works" sequence of three or more steps.
13
+ able to do something afterwards. It is the first candidate for the lecture deck type and a good
14
+ second for a research talk given as a tutorial. It climbs the list when the source contains
15
+ equations, definitions or a "how it works" sequence of three or more steps, which are exactly the
16
+ slides its numbered and sidebar families are built for.
16
17
 
17
- The pack file names the mismatch: decision decks. A board of numbered steps in front of executives
18
- reads as padding and slows the ask; Ledger or Signal fit that room. Dense data reviews also fit
19
- badly, because the families favour a few explained items over many numbers on one page.
18
+ ## When it is the wrong choice
19
+
20
+ Chalk is wrong for decision decks. A board of numbered steps in front of executives reads as padding
21
+ and slows the ask; Ledger or Signal fit that room. It is also a poor match for a dense data review,
22
+ because its families favour a few explained items over many numbers on one page, and for
23
+ image-led portfolios, where Atlas lets pictures carry the slides.
20
24
 
21
25
  ## Tokens
22
26
 
27
+ These values are read from the pack file `pack.yaml` of the `chalk` tonality.
28
+
23
29
  | Token | Value |
24
30
  |---|---|
25
- | ground / surface | #FAFBFC / #EEF2F5 |
26
- | ink / ink-muted / line | #1F2933 / #4E5A66 / #CBD3DA |
27
- | accent / accent-deep / accent-tint | #9A3412 / #6B2409 / #FCEBE0 |
28
- | field / on-field | #1F3B33 / #FFFFFF |
29
- | positive / negative | #1E7A3F / #B3261E |
30
- | series | #9A3412, #1F3B33, #4E5A66, #2E6A8E |
31
- | faces | Pretendard Bold for display, title and numerals, Pretendard Regular for body and labels; `faces: a2z` moves display and titles to A2Z Bold and numerals to A2Z Black |
32
- | tracking (title / display) | -1 % / -1 % of the size |
33
- | density / variance | 10 / 6 (up to 4 title treatments, all four of the pack) |
31
+ | ground / surface | `#FAFBFC` / `#EEF2F5` |
32
+ | ink / ink-muted | `#1F2933` / `#4E5A66` |
33
+ | line | `#CBD3DA` |
34
+ | accent / accent-deep / accent-tint | `#9A3412` / `#6B2409` / `#FCEBE0` |
35
+ | field / on-field | `#1F3B33` / `#FFFFFF` |
36
+ | positive / negative | `#1E7A3F` / `#B3261E` |
37
+ | series | `#9A3412`, `#1F3B33`, `#4E5A66`, `#2E6A8E` |
38
+ | faces | Pretendard Bold for display, title and numerals, Pretendard Regular for body and labels; `faces: a2z` swaps to A2Z Bold display and titles, A2Z Black numerals |
39
+ | 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 |
40
+ | density / variance | 10 / 6 |
34
41
  | radius / edge | 6 / fill |
35
- | rail | `field`: the side rail is a filled board in the field colour with the title in white |
36
- | table | header in accent-tint with accent-deep bold text, hairline row rules, no banding, bold totals |
37
- | chart | hairline gridlines, direct labels, accent on the highlighted series |
38
- | image | no frame |
39
- | decoration | accent-rule, mark-underline, rail-fill, numeral |
40
- | fill-order | distribute, step-up, change-family, anchor-visual |
41
-
42
- Of the four decoration entries, `accent-rule` (the short bar under a `top-rule` title), `rail-fill`
43
- (the green board) and the numerals are drawn. The marked term is set by writing the word between
44
- double asterisks in the title: `## 표준편차를 **읽는** 두 가지 방법` colours that word in the accent
45
- (`mark-underline` is accepted by the pack validator and draws nothing of its own).
46
-
47
- ## Titles by family
48
-
49
- The role defaults: sequences `kicker-numeral`, content, data and references `top-rule`, data with a
50
- takeaway, images and definitions `side-rail`, statements `statement`. The pack's `structure` entry draws
51
- a `comparison` under `side-rail`, so the criteria stand on the board; that choice survives the deck's
52
- share limit for one title. Each family narrows the role default to what it allows:
53
-
54
- | Family | Default title | Then, in pack order |
55
- |---|---|---|
56
- | `step-diagram` | `top-rule` | none |
57
- | `process` | `top-rule` | `side-rail` |
58
- | `method` | `side-rail` | `top-rule` |
59
- | `sidebar-note` | `top-rule` | `kicker-numeral`, `side-rail` |
60
- | `comparison` | `side-rail` | `top-rule` |
61
- | `image-split` | `side-rail` | `top-rule` |
62
- | `quote` | `statement` | `top-rule` |
63
- | `agenda` | `top-rule` | `kicker-numeral`, `side-rail` |
64
- | `statement` | `statement` | none |
65
- | `text-column` | `top-rule` | `kicker-numeral`, `side-rail` |
66
- | `table-insight` | `top-rule` | `side-rail` |
67
-
68
- `kicker-numeral` needs a part number from a section slide and stays out of `step-diagram`, `process` and
69
- `agenda`, which have numerals of their own; it appears on `sidebar-note` and `text-column` pages that
70
- follow a section. A `title: top-rule` pin after `layout:` gives a `method` slide the full width its
71
- definitions need. A deck of eight slides or more needs three treatments (OF-110), so plan one
72
- `comparison` or `method` slide for the rail, step slides for the top rule and a quote for the statement.
42
+ | rail | the side rail is a field-coloured fill |
43
+ | table | header row in the accent tint with deep-accent bold text, hairline rules between rows, no banding, numbers right-aligned, totals bold |
44
+ | chart | hairline gridlines, direct labels, accent on the item that matters and muted colours on the rest |
45
+ | decoration | accent rule, marked term underline, rail fill, numeral |
46
+
47
+ The marked-term underline is listed in the pack but the engine does not draw it yet, so mark the
48
+ term
49
+ in the wording for now.
50
+
51
+ ## Treatments by slide role
52
+
53
+ Sequences take `kicker-numeral`, where the step or part number stands right of the title, in the accent. Text
54
+ and data slides take `top-rule` with its short accent bar, chart and image slides with a takeaway
55
+ take `side-rail`, definitions take `side-rail`, a comparison sets its criteria as row heads in the body under a
56
+ `side-rail` title (the pack's `structure`), and a pull quote takes `statement`. When a slide's own
57
+ treatment would leave the body half empty, the engine tries the other treatments its family allows
58
+ and keeps the one that fills best, within the number of treatments the variance dial allows. A
59
+ `title: top-rule` line under `layout:` pins a slide to a treatment; the lecture example does that
60
+ for
61
+ a method slide whose definitions need the full width. An agenda carries no numeral (OF-119), so a
62
+ chalk deck whose only kicker was its agenda needs a step or sidebar slide under `kicker-numeral` to
63
+ keep three treatments (OF-110), and a sidebar note set across the top adds one more top-title slide
64
+ in a grid, which can carry top/grid past 40 % of the content slides (OF-111).
73
65
 
74
66
  ## Families and variants
75
67
 
76
- - `step-diagram`: numbered steps, each with its action and a worked value; `process` for a flow.
77
- - `method`: a formula at title size in accent-deep, with the meaning of each symbol below it.
78
- - `sidebar-note`: the explanation with a fenced `::: main-box` for the definition or the trap.
79
- - `comparison`: two ideas students confuse; criteria labels (`대상:`, `기호:`) move to the board rail.
80
- - `image-split`, `quote`, `agenda`, `statement`, `text-column`, `table-insight` as listed above.
81
- - Covers `cover-rail`, `cover-typographic`, `cover-numeral`; sections `section-numeral`,
82
- `section-rail`; closings `closing-summary-list` (recap and exercise) and `closing-ask`.
83
-
84
- Display devices: the cover is a `rail`, the board-green rail with the topic beside it; a statement is
85
- `drench`, written on the board with the whole slide in the field green; a section numeral reads as a
86
- part of the whole ("03 / 04") when the deck has an agenda, and becomes the index page; a big number sits
87
- on the accent tint; a closing's rows are keyed by their dates and the next step sits in a tinted box.
68
+ - `step-diagram`: numbered steps across the body, each with its action and detail.
69
+ - `process`: the same steps when they read as a flow rather than a procedure.
70
+ - `method`: a formula with the meaning of each symbol under it.
71
+ - `sidebar-note`: the explanation with a fenced box for the definition or the trap.
72
+ - `comparison`: two ideas students confuse, side by side row by row.
73
+ - `image-split`: a worked example with its figure.
74
+ - `quote`: a line worth remembering, set as a statement.
75
+ - `agenda`: what the session covers, numbered.
76
+ - `statement`: a pull quote or the lesson's rule, kept for a display-led deck the user asks for.
77
+ - `text-column`: an explanation at reading measure.
78
+ - `table-insight`: a small table with the pattern spelled out beside it.
79
+
80
+ Covers are `cover-rail`, `cover-typographic` and `cover-numeral`. Sections are `section-numeral` and
81
+ `section-rail`. Closings are `closing-summary-list` (the recap plus the exercise) and `closing-ask`.
82
+
83
+ Display slides. The typographic cover is the board-green rail with the topic name beside it. A
84
+ statement is written on the board: the whole slide in the field green, the quoted line in white. A section
85
+ numeral reads as the part of the whole ("03 / 04") when the deck has an agenda. A closing's rows are
86
+ keyed by their dates, and the next step sits in a tinted box on the body floor.
88
87
 
89
88
  ## Do
90
89
 
91
- - Number only what happens in order or what is a real part of the session.
92
- - Put every definition and every common mistake in a sidebar box, where students find it again.
93
- - Give each worked example the actual arithmetic with a sample value at each step.
94
- - Title each slide with what it teaches ("신뢰구간 계산 네 단계") and put the rule in the first body line.
95
- - End with what was learnt and what to practise, with a due date.
90
+ Use numbers only for things that happen in order or for real parts of the session. Put every
91
+ definition and every common mistake in a sidebar box, where students can find it again. Give each
92
+ worked example the actual arithmetic, step by step, with a sample value at each step. Title each
93
+ slide with what it teaches ("신뢰구간 계산 네 단계"), and put the rule in the first line of the body. End with what was learnt and what to practise,
94
+ with a due date.
96
95
 
97
96
  ## Avoid
98
97
 
99
- - More than one marked term per slide.
100
- - Numerals on points that are not a sequence.
101
- - Definitions buried in bullet lists instead of the sidebar.
102
- - A sentence as a title.
103
-
104
- ## Failure patterns
105
-
106
- | Symptom | Cause | Fix |
107
- |---|---|---|
108
- | `fill: slide 2 band 0.51 -> 0.42 (distribute)`; QA reports OF-109 (45 % empty) | a `sidebar-note` with two short groups and a one-line note | give each group three points and the note two lines, or choose `step-diagram` |
109
- | a comparison drawn under `top-rule`, 41 % of the page empty | the points carry no `label:` prefix, so the board rail has nothing to hold | prefix every point on both sides with a short label of at most three words |
110
- | step slides stay under `top-rule` after a section slide | `step-diagram` and `process` do not allow `kicker-numeral` | accept it; the step numerals are the markers |
111
- | median empty band 0.21 over 2 slides (limit 0.20) | a comparison with four short rows | add a fifth row with a full phrase on each side |
112
- | OF-114 on "평균은 중요하다" | the title states a rule | title it "평균의 의미" and open the body with the rule |
98
+ Avoid more than one marked term per slide; two underlines mean neither is the point. Avoid numerals
99
+ on points that are not a sequence. Do not bury a definition inside a bullet list. Avoid a sentence
100
+ as a title; the slide names the topic and the body states the rule.
113
101
 
114
102
  ## Two worked slides
115
103
 
116
- Four steps, each with an action and a sample value, so the slide can be followed without the speaker.
117
- A step that begins with `1.` takes that number; `·` separates the action from its example.
104
+ A step slide spells out each action, its detail and a worked value, so the steps fill the body and
105
+ can be followed without the speaker.
118
106
 
119
107
  ```markdown
120
108
  ---
121
109
  layout: step-diagram
122
110
 
123
- ## 표준편차 계산 네 단계
111
+ ## 95% 신뢰구간 계산 네 단계
124
112
 
125
- - **1. 평균 구하기** 모든 값을 더해 개수로 나눈다 · 예: 점수 60, 70, 70, 80, 90의 평균은 74점
126
- - **2. 편차 구하기** 각 값에서 평균을 뺀다 · 예: −14, −4, −4, 6, 16
127
- - **3. 분산 구하기** 편차를 제곱해 더하고 개수로 나눈다 · 예: (196 + 16 + 16 + 36 + 256) ÷ 5 = 104
128
- - **4. 제곱근 취하기** 분산의 제곱근이 표준편차다 · 예: √104 ≈ 10.2점
113
+ - **1. 평균 구하기** 표본 값의 합을 n으로 나눈다 · 예: 키 표본 25명, 평균 168cm
114
+ - **2. 표준편차 구하기** 편차 제곱의 평균에 제곱근을 씌운다 · 예: 10cm
115
+ - **3. 표준오차 구하기** 표준편차를 √n으로 나눈다 · 예: 10 ÷ 5 = 2cm
116
+ - **4. 구간 만들기** 평균 ± 1.96 × 표준오차 · 예: 164.1-171.9cm
129
117
  ---
130
118
  ```
131
119
 
132
- A comparison whose five labelled rows stand on the board rail; both sides keep the same labels, so
133
- the rail names each row once.
120
+ A sidebar slide names each wrong reading and why it fails, and keeps the right reading in the box;
121
+ the title labels the topic.
134
122
 
135
123
  ```markdown
136
124
  ---
137
- layout: comparison
138
-
139
- ## 모분산과 표본분산 비교
140
-
141
- :::: columns 1fr 1fr
142
- ::: col
143
- - **모분산**
144
- (1) 대상: 모집단 전체의 값을 알 때 쓴다
145
- (2) 나누는 수: 자료의 개수 n
146
- (3) 기호: σ²
147
- (4) 예: 한 학년 전체 240명의 키
148
- (5) 읽는 법: 집단의 실제 흩어짐이다
149
- :::
150
- ::: col
151
- - **표본분산**
152
- (1) 대상: 표본으로 모집단을 추정할 때 쓴다
153
- (2) 나누는 수: 자료의 개수보다 하나 작은 n − 1
154
- (3) 기호: s²
155
- (4) 예: 그 학년에서 뽑은 30명의 키
156
- (5) 읽는 법: 모집단 값의 추정치다
125
+ layout: sidebar-note
126
+ title: top-rule
127
+
128
+ ## 신뢰구간 해석의 흔한 오류 두 가지
129
+
130
+ - **참값이 이 구간 안에 있을 확률이 95%라는 읽기**
131
+ (1) 참값은 정해진 하나의 수라서 확률로 말하지 않는다
132
+ (2) 확률은 구간을 만드는 방법에 붙는 말이다
133
+ - **학생의 95%가 이 구간 안에 있다는 읽기**
134
+ (1) 구간은 평균에 대한 것이고 개인 값의 범위가 아니다
135
+ (2) 개인 값의 범위는 표준편차로 따로 말한다
136
+
137
+ ::: main-box
138
+ 같은 방법으로 구간을 100번 만들면 약 95개가 참값을 담는다고 읽는다
157
139
  :::
158
- ::::
140
+
141
+ - **확인 질문** 표본을 100명으로 늘리면 구간 폭은 어떻게 바뀌는가 (답: 절반)
159
142
  ---
160
143
  ```
161
144
 
162
- Both slides compile under `tonality: chalk` after a generic cover (drawn as `cover-rail`) and pass
163
- `qa_deck.py`. The class, the scores and the figures are invented.
145
+ ## Examples
146
+
147
+ `06-lecture-chalk-ko.md` and `12-research-tutorial-chalk-en.md` both use the pack defaults (density
148
+ 10, variance 6).
@@ -0,0 +1,150 @@
1
+ # Computational Brutalism
2
+
3
+ Computational Brutalism is the direction for a deck about a system, told to the people who build or
4
+ run it. It borrows from terminals, plotter paper and engineering drawings: the twelve-column grid is
5
+ marked in the top margin with numbered ticks, every content slide carries its index as `[03/08]`,
6
+ titles, labels and figures are set in a monospaced face, tables are ruled on every edge, and one
7
+ electric-blue signal colour marks the figure that matters. The structure is shown on purpose. What
8
+ keeps it readable is that body text stays in Pretendard and every mark sits on the grid it shows.
9
+
10
+ ## When to use it
11
+
12
+ Reach for Computational Brutalism for an architecture review, an infrastructure or reliability
13
+ report, a developer-tool or AI-system launch given to engineers, a benchmark write-up, an incident
14
+ retrospective or a hackathon demo. The content signals that point here are metrics with units
15
+ (p99 latency, throughput, error budget, GPU hours), version numbers and identifiers, code or
16
+ command names in the text, before-and-after measurements, and an audience that reads a table
17
+ faster than a sentence. It is the first candidate for an engineering review or a developer launch,
18
+ and the second for a data review that an engineering team will read.
19
+
20
+ ## When it is the wrong choice
21
+
22
+ It fails for a board, an investor committee, finance or a public-sector report, where the grid marks
23
+ read as unfinished work rather than as a style. It fails for a long Korean reading deck: the mono
24
+ face sets only Latin and figures, so a page of Hangul titles loses most of the look while keeping
25
+ its cost in width. It also fails for consumer marketing, for grief, safety or HR topics, and for a
26
+ deck under a corporate brand guide. For a quiet data review choose Ledger or Night; for a pitch to
27
+ investors, Signal or Neo-Brutalism.
28
+
29
+ ## Tokens
30
+
31
+ The values below come from the pack file and are what the engine draws.
32
+
33
+ | Token | Value |
34
+ |---|---|
35
+ | ground / surface | #EEEDE7 / #E2E1D9 |
36
+ | ink / ink-muted / line | #111111 / #4D4C47 / #9A988F |
37
+ | accent / accent-deep / accent-tint | #1F43E0 / #14267A / #D9DEF2 |
38
+ | field / on-field | #111111 / #8CF5A6 (phosphor green on the terminal field) |
39
+ | positive / negative | #1C6B35 / #B3261E |
40
+ | series | #1F43E0, #111111, #7A786F |
41
+ | 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 |
42
+ | 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 |
43
+ | density / variance | 10 / 7 |
44
+ | radius / edge | 0 / border, 1 pt, in ink |
45
+ | decoration | hairline rules, column hairlines, outlined boxes, grid marks, kicker numerals |
46
+ | table | ruled grid on every cell edge, header in the label face, bold totals |
47
+ | chart | hairline gridlines, direct labels, the accent on the highlighted series over muted ones |
48
+
49
+ Density 10 sets the deck on the compact grid (24 pt side margins), body 13 pt and no step-up, as
50
+ every pack in the family: an engineering review is read again after the meeting, so each slide keeps
51
+ its basis and its source. The mono face is wider than Pretendard, so the engine measures
52
+ every mono title at its own width before it chooses a treatment; a long Latin title moves to a
53
+ treatment with a wider frame rather than shrinking.
54
+
55
+ The fonts ship with the skill: JetBrains Mono is under the SIL Open Font License 1.1 with no Reserved
56
+ Font Name, and the official Regular and Bold files are embedded unmodified with `--embed-fonts`.
57
+
58
+ ## Treatments by slide role
59
+
60
+ Content, data, sequence and reference slides take `top-rule`; data with a takeaway takes
61
+ `bottom-anchor`; image slides `bottom-anchor`; definitions `side-rail`; statements `statement`. The
62
+ pack also pins a family's own title: `chart-insight` under `top-rule`, `table-insight` under
63
+ `bottom-anchor`, `comparison` as a spec sheet under a `side-rail` title, and `step-diagram`
64
+ under a large mono headline (`top-plain-large`). The engine lays out each allowed treatment, keeps
65
+ the pinned or role treatment when the body fills, and otherwise takes the one that leaves the least
66
+ empty band. Force one with `title: <id>` on the line after `layout:`.
67
+
68
+ ## Families and variants
69
+
70
+ - `dashboard-grid` and `kpi-row` carry measured results: value, unit, label and basis in each cell.
71
+ - `chart-insight` and `full-chart` show a measured series with one highlighted line or bar.
72
+ - `table-insight` and `ledger-table` hold benchmark or capacity tables, ruled on every edge.
73
+ - `method` sets a pipeline or procedure as numbered stages with their inputs and outputs.
74
+ - `step-diagram` is a rollout or migration in three to five steps.
75
+ - `matrix-2x2` places options on two measured axes.
76
+ - `comparison` reads before and after, or two designs, across shared rows.
77
+ - `text-two-column` and `references-appendix` carry specifications and links.
78
+ - `quote` and `statement` hold one line an engineer said or one decision.
79
+
80
+ Covers are `cover-typographic`, `cover-index` and `cover-figures`; sections are `section-numeral`
81
+ and `section-rule`; closings are `closing-decision-box`, `closing-ask` and `closing-summary-list`.
82
+
83
+ Display slides. The typographic cover is the terminal field from edge to edge: black, with the
84
+ topic in phosphor green at display size, anchored low, and the date line above it. A statement sets
85
+ its sentence in phosphor on the same black field. A big number is an outlined panel on the ground.
86
+ A closing's decision sits in an outlined box. The grid marks and the slide index run on content
87
+ slides only; a drenched statement goes without them.
88
+
89
+ ## Do
90
+
91
+ - Give every figure its unit and its basis: `p99 182 ms`, `2026년 9월 기준`.
92
+ - Keep identifiers, versions and commands in the text as they are written; the mono face is for them.
93
+ - Put one blue figure on a slide; everything else stays ink.
94
+ - Rule a table on every edge and right-align its numbers.
95
+ - End on a decision box or an ask with the owner and the date.
96
+
97
+ ## Avoid
98
+
99
+ - Body paragraphs in the mono face (the pack refuses a mono body).
100
+ - Fake code, fake terminal prompts or decorative binary strings; show real identifiers or none.
101
+ - Grid marks or the slide index in the accent colour.
102
+ - A second accent colour; the phosphor green belongs to the black field only.
103
+ - This direction for a board pack, a finance report or a sensitive topic.
104
+
105
+ ## Two worked slides
106
+
107
+ A latency review shows the measured result with its basis, and lets the table carry the detail.
108
+
109
+ ```markdown
110
+ ---
111
+ layout: kpi-row
112
+
113
+ ## API 게이트웨이 v3 전환 결과, 2026년 9월
114
+
115
+ | p99 지연 | 처리량 | 오류율 | 노드 수 |
116
+ |---|---|---|---|
117
+ | 182 ms | 41k rps | 0.07% | 24 |
118
+ | v2 410 ms | v2 18k rps | v2 0.31% | v2 40 |
119
+
120
+ > 운영 클러스터 4주 평균, 2026년 9월 (예시)
121
+
122
+ - 지연은 절반 아래로 줄었고, 노드는 40대에서 24대로 줄었다
123
+ - 오류율 0.07%는 SLO 0.1% 안쪽이다
124
+ - 출처: 예시 관측 대시보드, 2026년 9월 (예시)
125
+ ---
126
+ ```
127
+
128
+ A migration plan reads as a sequence with the condition each step must meet.
129
+
130
+ ```markdown
131
+ ---
132
+ layout: step-diagram
133
+
134
+ ## Cut-over plan for the v3 gateway
135
+
136
+ - **1. Shadow** mirror 5% of traffic to v3 and compare responses
137
+ (1) Exit: 0 mismatches over 72 h
138
+ - **2. Canary** route 10% of live traffic to v3 in one region
139
+ (1) Exit: p99 under 250 ms, error rate under 0.1%
140
+ - **3. Ramp** move to 50%, then 100%, one region a day
141
+ (1) Exit: no rollback for 7 days
142
+ - **4. Retire** drain v2 and remove its 40 nodes
143
+ (1) Owner: example platform team
144
+ - Source: example rollout runbook, October 2026 (example)
145
+ ---
146
+ ```
147
+
148
+ ## Examples
149
+
150
+ `13-engineering-review-computational-brutalism-ko.md`