@litfamily/litgravity 0.1.0 → 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.
- package/CHANGELOG.md +32 -0
- package/README.md +72 -17
- package/README_ko-KR.md +72 -17
- package/package.json +1 -1
- package/plugin/hooks/lib/lanes.mjs +65 -0
- package/plugin/hooks/lib/motion.mjs +34 -5
- package/plugin/hooks/lib/reentry.mjs +7 -0
- package/plugin/hooks/lib/rewind/brief.mjs +332 -0
- package/plugin/hooks/lib/rewind/collect.mjs +328 -0
- package/plugin/hooks/lib/rewind/gauge.mjs +55 -0
- package/plugin/hooks/lib/rewind/next-step.mjs +77 -0
- package/plugin/hooks/lib/rewind/redact.mjs +60 -0
- package/plugin/hooks/lib/rewind/transcripts.mjs +211 -0
- package/plugin/hooks/lib/routes.mjs +79 -5
- package/plugin/hooks/lib/workflow-stack.mjs +213 -0
- package/plugin/hooks/post-tool-use.mjs +37 -1
- package/plugin/hooks/pre-invocation.mjs +91 -2
- package/plugin/hooks/session-start.mjs +26 -3
- package/plugin/hooks/stop.mjs +22 -2
- package/plugin/hud/looks.mjs +29 -0
- package/plugin/hud/render.mjs +234 -12
- package/plugin/plugin.json +1 -1
- package/plugin/skills/frontend-ui-ux/SKILL.md +12 -1
- package/plugin/skills/frontend-ui-ux/kit/components.css +417 -0
- package/plugin/skills/frontend-ui-ux/kit/fonts.json +22 -0
- package/plugin/skills/frontend-ui-ux/kit/layouts/landing.html +164 -0
- package/plugin/skills/frontend-ui-ux/kit/layouts/settings.html +114 -0
- package/plugin/skills/frontend-ui-ux/kit/layouts/workspace.html +115 -0
- package/plugin/skills/frontend-ui-ux/kit/styles/computational-brutalism.json +227 -0
- package/plugin/skills/frontend-ui-ux/kit/styles/field-notes.json +205 -0
- package/plugin/skills/frontend-ui-ux/kit/styles/graphite.json +200 -0
- package/plugin/skills/frontend-ui-ux/kit/styles/meadow.json +199 -0
- package/plugin/skills/frontend-ui-ux/kit/styles/neo-brutalism.json +222 -0
- package/plugin/skills/frontend-ui-ux/kit/ui.js +226 -0
- package/plugin/skills/frontend-ui-ux/references/house-styles.md +234 -0
- package/plugin/skills/frontend-ui-ux/scripts/design-lock.mjs +400 -0
- package/plugin/skills/frontend-ui-ux/scripts/interface-probe-lock.mjs +196 -0
- package/plugin/skills/frontend-ui-ux/scripts/interface-probe-page.mjs +30 -9
- package/plugin/skills/frontend-ui-ux/scripts/interface-probe-rules.mjs +20 -8
- package/plugin/skills/frontend-ui-ux/scripts/interface-probe.mjs +42 -9
- package/plugin/skills/frontend-ui-ux/scripts/pixel-art.mjs +60 -0
- package/plugin/skills/lit-adhd/SKILL.md +157 -0
- package/plugin/skills/lit-adhd/references/card-examples.md +101 -0
- package/plugin/skills/lit-adhd/references/status-taxonomy.md +32 -0
- package/plugin/skills/lit-adhd/scripts/rewind.mjs +5 -0
- package/plugin/skills/lit-diagram-drawer/SKILL.md +5 -3
- package/plugin/skills/lit-diagram-drawer/references/drawing-rules.md +1 -1
- package/plugin/skills/lit-diagram-drawer/references/style-guide.md +21 -12
- package/plugin/skills/lit-diagram-drawer/references/type-architecture.md +3 -3
- package/plugin/skills/lit-diagram-drawer/references/type-dependency.md +1 -1
- package/plugin/skills/lit-diagram-drawer/references/type-tree.md +3 -3
- package/plugin/skills/lit-diagram-drawer/references/type-wardley.md +1 -1
- package/plugin/skills/lit-diagram-drawer/scripts/diagram-craft-rules.mjs +1 -2
- package/plugin/skills/lit-diagram-drawer/scripts/visual-quality.mjs +1 -2
- package/plugin/skills/lit-docx/SKILL.md +3 -3
- package/plugin/skills/lit-handoff/SKILL.md +1 -0
- package/plugin/skills/lit-hijack/SKILL.md +263 -0
- package/plugin/skills/lit-hijack/references/capture-and-provenance.md +100 -0
- package/plugin/skills/lit-hijack/references/clean-room-build.md +75 -0
- package/plugin/skills/lit-hijack/references/distil-and-licence.md +67 -0
- package/plugin/skills/lit-hijack/references/gap-and-port-design.md +100 -0
- package/plugin/skills/lit-hijack/references/parity-and-report.md +85 -0
- package/plugin/skills/lit-hijack/scripts/hijack.mjs +953 -0
- package/plugin/skills/lit-plan/SKILL.md +1 -1
- package/plugin/skills/lit-pptx/SKILL.md +8 -8
- package/plugin/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Bold.ttf +0 -0
- package/plugin/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Regular.ttf +0 -0
- package/plugin/skills/lit-pptx/fonts/jetbrains-mono/OFL.txt +93 -0
- package/plugin/skills/lit-pptx/fonts/provenance.json +32 -1
- package/plugin/skills/lit-pptx/references/agents/analyst.md +34 -56
- package/plugin/skills/lit-pptx/references/agents/antithesis.md +49 -67
- package/plugin/skills/lit-pptx/references/agents/architect.md +38 -51
- package/plugin/skills/lit-pptx/references/agents/critic.md +25 -41
- package/plugin/skills/lit-pptx/references/agents/synthesizer.md +37 -46
- package/plugin/skills/lit-pptx/references/agents/thesis.md +29 -49
- package/plugin/skills/lit-pptx/references/anti-slop-checklist.md +119 -145
- package/plugin/skills/lit-pptx/references/authoring-guide.md +187 -278
- package/plugin/skills/lit-pptx/references/consensus-protocol.md +99 -97
- package/plugin/skills/lit-pptx/references/data-display-cookbook.md +36 -137
- package/plugin/skills/lit-pptx/references/density-and-fill.md +147 -216
- package/plugin/skills/lit-pptx/references/design-system-azure.md +56 -85
- package/plugin/skills/lit-pptx/references/direction-step.md +134 -176
- package/plugin/skills/lit-pptx/references/examples/01-pitch-signal-ko.md +114 -115
- package/plugin/skills/lit-pptx/references/examples/02-pitch-studio-ko.md +66 -66
- package/plugin/skills/lit-pptx/references/examples/03-business-review-ledger-ko.md +63 -63
- package/plugin/skills/lit-pptx/references/examples/04-business-review-night-en.md +96 -96
- package/plugin/skills/lit-pptx/references/examples/05-research-talk-paper-en.md +81 -81
- package/plugin/skills/lit-pptx/references/examples/06-lecture-chalk-ko.md +103 -103
- package/plugin/skills/lit-pptx/references/examples/07-data-review-night-en.md +100 -98
- package/plugin/skills/lit-pptx/references/examples/08-image-led-atlas-ko.md +76 -76
- package/plugin/skills/lit-pptx/references/examples/09-briefing-gazette-ko.md +96 -96
- package/plugin/skills/lit-pptx/references/examples/10-status-update-ledger-ko.md +80 -80
- package/plugin/skills/lit-pptx/references/examples/11-portfolio-studio-en.md +72 -72
- package/plugin/skills/lit-pptx/references/examples/12-research-tutorial-chalk-en.md +95 -95
- package/plugin/skills/lit-pptx/references/examples/13-engineering-review-computational-brutalism-ko.md +173 -0
- package/plugin/skills/lit-pptx/references/examples/14-launch-pitch-neo-brutalism-ko.md +154 -0
- package/plugin/skills/lit-pptx/references/examples/15-design-lecture-bauhaus-ko.md +139 -0
- package/plugin/skills/lit-pptx/references/examples/16-community-programme-riso-ko.md +158 -0
- package/plugin/skills/lit-pptx/references/examples/17-public-data-briefing-newsroom-ko.md +179 -0
- package/plugin/skills/lit-pptx/references/interview-protocol.md +83 -102
- package/plugin/skills/lit-pptx/references/layout-families.md +161 -265
- package/plugin/skills/lit-pptx/references/stages/autopilot.md +30 -70
- package/plugin/skills/lit-pptx/references/stages/interview.md +36 -68
- package/plugin/skills/lit-pptx/references/stages/plan.md +26 -67
- package/plugin/skills/lit-pptx/references/title-treatments.md +93 -145
- package/plugin/skills/lit-pptx/references/tonalities/atlas.md +95 -108
- package/plugin/skills/lit-pptx/references/tonalities/bauhaus.md +140 -0
- package/plugin/skills/lit-pptx/references/tonalities/chalk.md +107 -122
- package/plugin/skills/lit-pptx/references/tonalities/computational-brutalism.md +150 -0
- package/plugin/skills/lit-pptx/references/tonalities/gazette.md +87 -111
- package/plugin/skills/lit-pptx/references/tonalities/ledger.md +96 -125
- package/plugin/skills/lit-pptx/references/tonalities/neo-brutalism.md +161 -0
- package/plugin/skills/lit-pptx/references/tonalities/newsroom.md +144 -0
- package/plugin/skills/lit-pptx/references/tonalities/night.md +104 -131
- package/plugin/skills/lit-pptx/references/tonalities/paper.md +114 -130
- package/plugin/skills/lit-pptx/references/tonalities/riso.md +137 -0
- package/plugin/skills/lit-pptx/references/tonalities/signal.md +96 -103
- package/plugin/skills/lit-pptx/references/tonalities/studio.md +81 -112
- package/plugin/skills/lit-pptx/scripts/compile-deck.js +4 -6
- package/plugin/skills/lit-pptx/scripts/craft_extras.py +135 -91
- package/plugin/skills/lit-pptx/scripts/deck_craft.py +1 -1
- package/plugin/skills/lit-pptx/scripts/embed_fonts.py +13 -1
- package/plugin/skills/lit-pptx/scripts/layout_inventory.py +1 -1
- package/plugin/skills/lit-pptx/scripts/learn_template.py +1 -1
- package/plugin/skills/lit-pptx/scripts/lib/grid-resolver.js +101 -110
- package/plugin/skills/lit-pptx/scripts/lib/layout-resolver.js +9 -15
- package/plugin/skills/lit-pptx/scripts/lib/render-pack.js +370 -563
- package/plugin/skills/lit-pptx/scripts/lib/slide-grid.js +104 -0
- package/plugin/skills/lit-pptx/scripts/lib/template-registry.js +57 -6
- package/plugin/skills/lit-pptx/scripts/qa_deck.py +6 -6
- package/plugin/skills/lit-pptx/scripts/render_pages.py +31 -0
- package/plugin/skills/lit-pptx/scripts/validate_pptx.py +1 -1
- package/plugin/skills/lit-pptx/specs/markdown-slide-spec-v1.md +167 -191
- package/plugin/skills/lit-pptx/specs/markdown-slide-spec-v2.md +117 -166
- package/plugin/skills/lit-pptx/specs/template-enrollment-contract.md +307 -330
- package/plugin/skills/lit-pptx/templates/tonalities/atlas/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/bauhaus/pack.yaml +98 -0
- package/plugin/skills/lit-pptx/templates/tonalities/chalk/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/computational-brutalism/pack.yaml +99 -0
- package/plugin/skills/lit-pptx/templates/tonalities/gazette/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/ledger/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/neo-brutalism/pack.yaml +107 -0
- package/plugin/skills/lit-pptx/templates/tonalities/newsroom/pack.yaml +99 -0
- package/plugin/skills/lit-pptx/templates/tonalities/night/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/paper/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/riso/pack.yaml +99 -0
- package/plugin/skills/lit-pptx/templates/tonalities/signal/pack.yaml +2 -2
- package/plugin/skills/lit-pptx/templates/tonalities/studio/pack.yaml +1 -1
- package/plugin/skills/lit-schematic/SKILL.md +114 -0
- package/plugin/skills/lit-schematic/examples/iso-heat-exchanger/build.mjs +38 -0
- package/plugin/skills/lit-schematic/examples/iso-heat-exchanger/scene.mjs +133 -0
- package/plugin/skills/lit-schematic/examples/journal-adsorption-rig/build.mjs +87 -0
- package/plugin/skills/lit-schematic/examples/pid-dosing-skid/build.mjs +85 -0
- package/plugin/skills/lit-schematic/references/cutaway-outputs.md +70 -0
- package/plugin/skills/lit-schematic/references/isometric-craft.md +101 -0
- package/plugin/skills/lit-schematic/references/journal-figures.md +72 -0
- package/plugin/skills/lit-schematic/references/kit-api.md +134 -0
- package/plugin/skills/lit-schematic/references/pfd-and-layout.md +53 -0
- package/plugin/skills/lit-schematic/references/pid-drafting.md +103 -0
- package/plugin/skills/lit-schematic/references/pid-symbols.md +163 -0
- package/plugin/skills/lit-schematic/references/verification.md +100 -0
- package/plugin/skills/lit-schematic/scripts/doctor.mjs +57 -0
- package/plugin/skills/lit-schematic/scripts/lib/figure.mjs +81 -0
- package/plugin/skills/lit-schematic/scripts/lib/fonts.mjs +27 -0
- package/plugin/skills/lit-schematic/scripts/lib/geom.mjs +113 -0
- package/plugin/skills/lit-schematic/scripts/lib/interactive.mjs +292 -0
- package/plugin/skills/lit-schematic/scripts/lib/isa.mjs +115 -0
- package/plugin/skills/lit-schematic/scripts/lib/iso.mjs +719 -0
- package/plugin/skills/lit-schematic/scripts/lib/legend-sheet.mjs +162 -0
- package/plugin/skills/lit-schematic/scripts/lib/pid.mjs +937 -0
- package/plugin/skills/lit-schematic/scripts/lib/png.mjs +132 -0
- package/plugin/skills/lit-schematic/scripts/lib/qa-core.mjs +658 -0
- package/plugin/skills/lit-schematic/scripts/lib/route.mjs +218 -0
- package/plugin/skills/lit-schematic/scripts/lib/sheet.mjs +890 -0
- package/plugin/skills/lit-schematic/scripts/lib/svg.mjs +82 -0
- package/plugin/skills/lit-schematic/scripts/lib/theme.mjs +115 -0
- package/plugin/skills/lit-schematic/scripts/motion.mjs +129 -0
- package/plugin/skills/lit-schematic/scripts/qa.mjs +92 -0
- package/plugin/skills/lit-schematic/scripts/render.mjs +233 -0
- package/plugin/skills/lit-schematic/scripts/scaffold.mjs +60 -0
- package/plugin/skills/lit-scientific-visualization/SKILL.md +17 -6
- package/plugin/skills/lit-typographic-motion/SKILL.md +58 -48
- package/plugin/skills/lit-typographic-motion/engine/THIRD_PARTY_NOTICES +13 -2
- package/plugin/skills/lit-typographic-motion/engine/blender/runner.py +218 -0
- package/plugin/skills/lit-typographic-motion/engine/core/presets.mjs +1 -1
- package/plugin/skills/lit-typographic-motion/engine/node/analysis.mjs +65 -1
- package/plugin/skills/lit-typographic-motion/engine/node/assets.mjs +298 -0
- package/plugin/skills/lit-typographic-motion/engine/node/blender.mjs +143 -0
- package/plugin/skills/lit-typographic-motion/engine/node/board.mjs +136 -0
- package/plugin/skills/lit-typographic-motion/engine/node/brief.mjs +7 -1
- package/plugin/skills/lit-typographic-motion/engine/node/chrome.mjs +9 -12
- package/plugin/skills/lit-typographic-motion/engine/node/cover-assets.mjs +5 -3
- package/plugin/skills/lit-typographic-motion/engine/node/cover-capture.mjs +7 -6
- package/plugin/skills/lit-typographic-motion/engine/node/cover-treatment.mjs +37 -4
- package/plugin/skills/lit-typographic-motion/engine/node/cover.mjs +19 -8
- package/plugin/skills/lit-typographic-motion/engine/node/done.mjs +45 -6
- package/plugin/skills/lit-typographic-motion/engine/node/frame-worker.mjs +7 -5
- package/plugin/skills/lit-typographic-motion/engine/node/gallery.mjs +121 -0
- package/plugin/skills/lit-typographic-motion/engine/node/host.mjs +34 -0
- package/plugin/skills/lit-typographic-motion/engine/node/house.mjs +44 -0
- package/plugin/skills/lit-typographic-motion/engine/node/look.mjs +34 -20
- package/plugin/skills/lit-typographic-motion/engine/node/pipeline.mjs +19 -9
- package/plugin/skills/lit-typographic-motion/engine/node/scaffold.mjs +210 -0
- package/plugin/skills/lit-typographic-motion/engine/node/score.mjs +639 -0
- package/plugin/skills/lit-typographic-motion/engine/node/sound-cli.mjs +21 -4
- package/plugin/skills/lit-typographic-motion/engine/node/sound.mjs +127 -29
- package/plugin/skills/lit-typographic-motion/engine/node/stage-capture.mjs +7 -6
- package/plugin/skills/lit-typographic-motion/engine/node/stage-gate.mjs +59 -5
- package/plugin/skills/lit-typographic-motion/engine/node/stage-qa.mjs +141 -9
- package/plugin/skills/lit-typographic-motion/engine/node/stage-serve.mjs +28 -5
- package/plugin/skills/lit-typographic-motion/engine/node/stage.mjs +82 -14
- package/plugin/skills/lit-typographic-motion/engine/node/styles.mjs +213 -0
- package/plugin/skills/lit-typographic-motion/engine/node/treatment.mjs +311 -10
- package/plugin/skills/lit-typographic-motion/engine/stage/cover-init.js +14 -2
- package/plugin/skills/lit-typographic-motion/engine/stage/init.js +11 -1
- package/plugin/skills/lit-typographic-motion/engine/stage/qa.js +6 -1
- package/plugin/skills/lit-typographic-motion/engine/stage/stage-kit.js +83 -0
- package/plugin/skills/lit-typographic-motion/engine/vendor/three/LICENSE +21 -0
- package/plugin/skills/lit-typographic-motion/engine/vendor/three/addons/environments/RoomEnvironment.js +144 -0
- package/plugin/skills/lit-typographic-motion/engine/vendor/three/addons/geometries/RoundedBoxGeometry.js +155 -0
- package/plugin/skills/lit-typographic-motion/engine/vendor/three/three.module.js +54571 -0
- package/plugin/skills/lit-typographic-motion/recipes/hero-3d/expected.json +69 -0
- package/plugin/skills/lit-typographic-motion/recipes/hero-3d/index.html +139 -0
- package/plugin/skills/lit-typographic-motion/recipes/orbit-loop/expected.json +6 -4
- package/plugin/skills/lit-typographic-motion/recipes/painted-light/expected.json +4 -2
- package/plugin/skills/lit-typographic-motion/recipes/weight-tide/expected.json +7 -5
- package/plugin/skills/lit-typographic-motion/references/cover.md +394 -443
- package/plugin/skills/lit-typographic-motion/references/craft-loop.md +57 -87
- package/plugin/skills/lit-typographic-motion/references/depth.md +122 -0
- package/plugin/skills/lit-typographic-motion/references/look.md +94 -129
- package/plugin/skills/lit-typographic-motion/references/runtime.md +58 -91
- package/plugin/skills/lit-typographic-motion/references/sound.md +130 -99
- package/plugin/skills/lit-typographic-motion/references/stage.md +190 -215
- package/plugin/skills/lit-typographic-motion/references/studio.md +245 -0
- package/plugin/skills/lit-typographic-motion/references/style-bibles.md +108 -97
- package/plugin/skills/lit-typographic-motion/references/treatment.md +191 -143
- package/plugin/skills/lit-typographic-motion/scripts/motion-doctor.mjs +17 -5
- package/plugin/skills/lit-typographic-motion/scripts/motion.mjs +47 -7
- package/plugin/skills/lit-typographic-motion/styles/paper.json +41 -0
- package/plugin/skills/lit-typographic-motion/styles/swiss-signal.json +41 -0
- package/plugin/skills/lit-typographic-motion/styles/terminalcore.json +42 -0
- package/plugin/skills/lit-typographic-motion/styles/tidal.json +41 -0
- package/plugin/skills/litresearch/SKILL.md +1 -0
- package/plugin/skills/readme-studio/SKILL.md +2 -0
- package/plugin/skills/readme-studio/templates/hyperframes-cover/package-lock.json +3 -3
- package/plugin/skills/readme-studio/templates/remotion-cover/package-lock.json +3 -3
- package/plugin/skills/review-work/SKILL.md +1 -1
- 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
|
+

|
|
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
|
|
5
|
-
and the definition or the
|
|
6
|
-
|
|
7
|
-
accent points at what is being taught. The rhythm is
|
|
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
|
|
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.
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
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
|
-
|
|
18
|
-
|
|
19
|
-
|
|
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 |
|
|
26
|
-
| ink / ink-muted
|
|
27
|
-
|
|
|
28
|
-
|
|
|
29
|
-
|
|
|
30
|
-
|
|
|
31
|
-
|
|
|
32
|
-
|
|
|
33
|
-
|
|
|
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 |
|
|
36
|
-
| table | header in accent
|
|
37
|
-
| chart | hairline gridlines, direct labels, accent on the
|
|
38
|
-
|
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
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
|
|
77
|
-
- `
|
|
78
|
-
- `
|
|
79
|
-
- `
|
|
80
|
-
- `
|
|
81
|
-
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
`
|
|
86
|
-
|
|
87
|
-
|
|
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
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
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
|
-
|
|
100
|
-
|
|
101
|
-
|
|
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
|
-
|
|
117
|
-
|
|
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. 평균 구하기**
|
|
126
|
-
- **2.
|
|
127
|
-
- **3.
|
|
128
|
-
- **4.
|
|
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
|
|
133
|
-
the
|
|
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:
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
(
|
|
145
|
-
|
|
146
|
-
(
|
|
147
|
-
(
|
|
148
|
-
|
|
149
|
-
:::
|
|
150
|
-
|
|
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
|
-
|
|
163
|
-
|
|
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`
|