@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
@@ -1,27 +1,33 @@
1
1
  # Gazette
2
2
 
3
- Gazette sets a Korean briefing paper as slides. A slate header band carries the title on most content
3
+ Gazette sets a Korean briefing paper as slides. A slate header band carries the title on most
4
+ content
4
5
  pages, a boxed one-line conclusion opens the argument, and 개조식 evidence runs in two columns at
5
- reading size. Tables have a slate header and a grid on every cell with the first column shaded; a deep
6
- red is kept for the key line alone. Nobody presents this deck: it is read at a desk, page by page,
7
- and the pack file says as much, calling it wrong for a live talk because the density that serves a
8
- reader overwhelms a listener.
6
+ reading size. Tables have a filled header and a light grid, the first column is shaded, and a deep
7
+ red is kept for the key line alone. The deck is meant to be read at a desk, page by page, with
8
+ nobody
9
+ presenting it.
9
10
 
10
- ## When to choose it
11
+ ## When to use it
11
12
 
12
- Choose Gazette for a 보고서형 deck: sent ahead of a meeting, circulated for approval, or filed as the
13
- record of a review. The brief says the deck is read rather than presented, the language is Korean, the
14
- pages carry long bodies and a fair share of tables. Of its ten families, `summary-box-list`,
15
- `text-two-column`, `text-column`, `ledger-table` and `agenda` serve text, and `timeline`,
16
- `matrix-2x2` and `comparison` serve decisions; the set follows the Korean briefing form (summary,
17
- background, evidence, schedule, decision).
13
+ Choose Gazette when the deck is a 보고서형 document: sent ahead of a meeting, circulated for
14
+ approval, or filed as the record of a review. The signals that move it up are a brief that says the
15
+ deck is read rather than presented, Korean as the language, long bodies (150 Korean glyphs per
16
+ content slide and more) and a fair share of tables. It is the first candidate for the Korean text
17
+ briefing and the second for business reviews and status updates that circulate in Korean.
18
18
 
19
- An English deck that is read rather than presented fits Ledger better, since the header band, the boxed
20
- summary and the itemised endings come from the Korean form. Image-led decks fit Atlas: pictures here
21
- stay small, with a hairline frame.
19
+ ## When it is the wrong choice
20
+
21
+ Gazette is wrong for a live talk. The density that serves a reader overwhelms a listener, and the
22
+ band titles make every page look equally important. It is also wrong for image-led decks: pictures
23
+ stay small and framed. English decks that are read rather than presented are better served by
24
+ Ledger, because Gazette's conventions (header band, boxed summary, itemised endings) come from the
25
+ Korean briefing form.
22
26
 
23
27
  ## Tokens
24
28
 
29
+ Read from the pack file; these are the values the engine draws.
30
+
25
31
  | Token | Value |
26
32
  |---|---|
27
33
  | ground / surface | #FFFFFF / #F1F4F8 |
@@ -30,74 +36,55 @@ stay small, with a hairline frame.
30
36
  | field / on-field | #233A4F / #FFFFFF |
31
37
  | positive / negative | #1E7A3F / #1A2230 |
32
38
  | series | #A61B1B, #233A4F, #4A5568, #7A6A2A |
33
- | faces | Pretendard Bold for display, title and numerals, Pretendard Regular for body and labels; `faces: a2z` moves display and numerals to A2Z Bold |
34
- | tracking (title / display) | -1 % / -1 % of the size |
35
- | density / variance | 10 / 4 (up to 3 title treatments) |
36
- | radius / edge | 0 / fill+border |
37
- | table | slate header with on-field text, a hairline grid on every cell, the first column shaded in the surface colour, bold totals |
39
+ | faces | Pretendard Bold for display, title and numerals, Pretendard Regular for body and labels; `faces: a2z` swaps display and numerals to A2Z Bold |
40
+ | 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 |
41
+ | density / variance | 10 / 4 |
42
+ | radius / edge | 0 / fill and border |
43
+ | table | header-fill style, field header with on-field text, a grid on every cell, the first column shaded, bold totals |
38
44
  | chart | hairline gridlines, direct labels, accent on the highlighted series |
39
- | image | hairline frame |
40
- | decoration | header-band, box-outline, hairline-rule, numeral |
41
- | fill-order | step-up, distribute, change-family, anchor-visual |
42
-
43
- Accent-deep equals the slate field, so the accent (the red) is the only warm colour on a page. A loss
44
- keeps the ink colour and its ▼ sign. Density 10 is the compact step: 24 pt margins, body 13 pt, table
45
- rows from 18 pt, up to 22 lines in a text column, titles close over the body. Variance 4 allows exactly
46
- three title treatments, which suits a briefing that repeats its page head; variety comes from the body
47
- families.
48
45
 
49
- ## Titles by family
46
+ Density 10 is the compact step every pack now starts from: 24 pt side margins, body 13 pt with no
47
+ step-up, table rows from 18 pt and up to 22 lines per text column, titles close over the body. Variance 4 allows exactly three title treatments in a deck. That is deliberate: a briefing repeats
48
+ its page head, and variety comes from the body families instead.
50
49
 
51
- Role defaults: content and statement slides `band`, data and references `top-rule`, data with a
52
- takeaway, images and definitions `side-rail`, sequences `kicker-numeral`. A `band` title sits inside a
53
- full-width slate band 108 pt tall (the pack lists `header-band`), one line of about 23 Korean glyphs at the
54
- presented ramp and two lines of about 61 glyphs at the compact one, with the body starting at y 120. The engine keeps the
55
- default while the body fills; `title: side-rail` after `layout:` pins one slide.
50
+ ## Treatments by slide role
56
51
 
57
- | Family | Default title | Then, in pack order |
58
- |---|---|---|
59
- | `summary-box-list` | `band` | `top-rule`, `kicker-numeral` |
60
- | `text-two-column` | `band` | `top-rule`, `kicker-numeral` |
61
- | `text-column` | `band` | `top-rule`, `kicker-numeral`, `side-rail` |
62
- | `ledger-table` | `top-rule` | `band`, `kicker-numeral` |
63
- | `table-insight` | `top-rule` | `band`, `side-rail` |
64
- | `comparison` | `top-rule` (numbers) / `band` (arguments) | `band`, `side-rail`, `top-rule` |
65
- | `timeline` | `band` | `top-rule` |
66
- | `matrix-2x2` | `top-rule` | `band`, `side-rail` |
67
- | `agenda` | `band` | `top-rule`, `kicker-numeral`, `side-rail` |
68
- | `references-appendix` | `top-rule` | `band` |
69
-
70
- The pack lists no `statement` family and no statement title. A `layout: statement` slide logs `note:
71
- slide N: gazette has no statement title, so the sentence is drawn as a band title` and sets the
72
- sentence in the band; a single claim belongs in the summary box instead.
52
+ Content and statement slides take `band`; data and reference slides take `top-rule`; data with a
53
+ takeaway, image and definition slides take `side-rail`; sequences take `kicker-numeral`. The engine
54
+ starts from that map and keeps the role default when the body fills; otherwise it lays out the other
55
+ treatments the family allows and keeps the one with the least empty band, within the three the
56
+ variance dial permits. To give one slide a side rail, write `title: side-rail` on the line after
57
+ `layout:`; example `09-briefing-gazette-ko.md` does this for its comparison of options.
73
58
 
74
59
  ## Families and variants
75
60
 
76
- - `summary-box-list`: a `::: key-message` block of one to three lines in an outlined box, then
77
- bold-headed groups with numbered points in two columns that the engine balances.
78
- - `text-two-column`, `text-column`: background and findings as itemised text.
61
+ - `summary-box-list` opens with the boxed conclusion (a `::: key-message` block) and the 개조식
62
+ evidence under it in two columns.
63
+ - `text-two-column` and `text-column` carry background and findings as itemised text.
79
64
  - `ledger-table` sets a table with its reading under it; `table-insight` sets the reading beside it.
80
- - `comparison` lays options across shared rows; `matrix-2x2` sorts measures by effect and difficulty.
81
- - `timeline` shows dated steps; give each row a third column holding owner and output.
82
- - `agenda` lists the parts; `references-appendix` is the 붙임 page of sources.
83
- - Covers `cover-band`, `cover-typographic`, `cover-index`; sections `section-band`, `section-rule`;
84
- closings `closing-decision-box` (건의 사항 with a decision table) and `closing-ask`.
85
-
86
- Display devices: the cover is a `band`, a 216 pt slate field with the title in at most two lines and
87
- the deck's parts (else its headline figures) across the page under it; a section band carries the
88
- deck's part index with this part marked, and the part title stands below as a statement over the titles
89
- of the slides it opens; a big number is a panel on the surface inside an ink outline (`outline`), two to
90
- four figures with their bases; a closing's rows are keyed by their deadlines and the next step sits in an
91
- outlined box on the body floor.
65
+ - `comparison` lays options side by side across shared rows.
66
+ - `timeline` shows dated steps with owner and output.
67
+ - `matrix-2x2` sorts measures by effect and difficulty.
68
+ - `agenda` lists the parts; `references-appendix` is the 붙임 page of sources and definitions.
69
+
70
+ Covers are `cover-band`, `cover-typographic` and `cover-index`; sections are `section-band` and
71
+ `section-rule`; closings are `closing-decision-box` (건의 사항 with a decision table) and
72
+ `closing-ask`.
73
+
74
+ Display slides. The typographic cover opens under the slate band. A big number is a data panel on the
75
+ surface inside an ink outline, the box language of a briefing paper: two to four figures, each with
76
+ its label and basis, never one figure alone. The section band carries the deck's
77
+ part index, this part marked, with the part title on the ground below. A closing's rows are keyed by
78
+ their deadlines, and the next step sits in an outlined box on the body floor.
92
79
 
93
80
  ## Do
94
81
 
95
82
  - Put the conclusion first, in the summary box, in one or two lines; the title stays a label
96
- ("핵심 요약: 재택근무 운영안 건의").
97
- - Give each figure its basis (전년 대비, 시범 전후, 목표) and each table a caption with period and source.
98
- - Keep 개조식 levels honest: level one states the claim, level two the evidence, at most five items per
99
- level, with consistent endings.
100
- - Give the timeline a third column with owner and output.
83
+ ("핵심 요약: 재택근무 운영안 건의"), never the conclusion itself.
84
+ - Give each figure its basis (전년 대비, 시범 전후, 목표) and the table a caption with period and source.
85
+ - Keep 개조식 levels honest: level one states the claim, level two the evidence, at most five items
86
+ per level, with consistent endings.
87
+ - Give the timeline a third column with owner and output, so each event fills three or four lines.
101
88
  - End with a decision table: what to decide, who decides, by when.
102
89
 
103
90
  ## Avoid
@@ -106,68 +93,57 @@ outlined box on the body floor.
106
93
  - Red for anything other than the key line.
107
94
  - A summary box longer than three lines.
108
95
  - More than three text families in a row; break them with a table, a timeline or a comparison.
109
-
110
- ## Failure patterns
111
-
112
- | Symptom | Cause | Fix |
113
- |---|---|---|
114
- | OF-114 on "핵심 요약: 재택근무를 주 2일로 정례화함" | the band title carries the conclusion in a nominalised ending (-함) | keep the label ("핵심 요약: 재택근무 운영안") and move the conclusion into the box |
115
- | OF-110 "4 title treatments, variance 4 allows 3" | pins (`title: kicker-numeral`) added a fourth title to a deck of eight or more slides | drop the pin; let the three treatments carry the deck |
116
- | OF-115 "100 % of the side rail under the title is empty" | `title: side-rail` on a `text-column` slide whose takeaways cannot move into the rail | use a visual family under a side rail, or remove the pin |
117
- | QA `sparse_slide` and OF-109 on a three-row `timeline` | three short events and one takeaway fill 30 % of the body | add the third column (owner, output) and two more takeaways, or merge slides |
118
- | `fill: slide 2 band 0.69 -> 0.69 (none: ...)` | a `summary-box-list` with two short groups | add the third group (예산) and a point under every group |
96
+ - The `statement` family; a single claim becomes the summary box.
119
97
 
120
98
  ## Two worked slides
121
99
 
122
100
  The summary page labels the topic in its band, states the recommendation in the box and lays the
123
- evidence under it in two columns.
101
+ evidence under it.
124
102
 
125
103
  ```markdown
126
104
  ---
127
105
  layout: summary-box-list
128
106
 
129
- ## 핵심 요약: 대여소 확충안 보고
107
+ ## 핵심 요약: 재택근무 주 2일 정례화 건의
130
108
 
131
109
  ::: key-message
132
- 대여소를 지하철역 반경 300m 안에 120곳 늘리고, 이용이 몰리는 대여소부터 순서대로 설치한다
110
+ 재택근무를 주 2일로 정례화하되, 팀마다 협업일 하루를 지정해 대면 회의를 그날에 모은다
133
111
  :::
134
112
 
135
- - **현황**
136
- (1) 대여소 480곳, 하루 평균 대여 2만 1천 건 (2026년 9월 기준)
137
- (2) 대여소의 12%에서 저녁 7시 전에 자전거가 동난다
138
- (3) 이용자 민원의 41%가 대여소 부족과 반납 자리 부족이다
139
- - **확충 방향**
140
- (1) 지하철역 반경 300m 안 미설치 구역 120곳에 신규 설치
141
- (2) 이용이 몰리는 대여소 30곳은 거치대를 10칸에서 16칸으로 확대
142
- (3) 설치 순서는 이용 밀집도와 민원 건수로 정한다
143
- - **소요 예산**
144
- (1) 신규 설치 120곳 36억 원, 거치대 확대 30곳 4억 원
145
- (2) 시비 60%, 국비 40%로 편성한다
113
+ - **시범 운영 결과**
114
+ (1) 월평균 이용률 78%, 본부 간 편차 최대 21%p
115
+ (2) 업무 만족도 3.4점에서 4.1점으로 상승 (5점 척도)
116
+ (3) 시범 기간 2026년 4-9월, 6개 본부 1,240명 (예시)
117
+ - **남은 불편**
118
+ (1) 불편 사항의 64%가 회의 일정 조율과 대면 협업 부족
119
+ (2) 주간 회의 시간 1인당 4.1시간에서 5.3시간으로 증가
120
+ (3) 협업일 지정 팀은 회의 시간 증가가 0.4시간에 그침
121
+ - **시행 조건**
122
+ (1) 협업일은 팀장이 분기마다 지정, 전사 공통 요일 없음
123
+ (2) 회의실 예약 체계 개편 후 2027년 1월 전면 시행
146
124
  ---
147
125
  ```
148
126
 
149
- A schedule whose third column names owner and output, so each event fills three or four lines, with
150
- the follow-up actions under the axis.
127
+ The closing labels the request, turns it into a decision table, and states the ask and the follow-up
128
+ above it.
151
129
 
152
130
  ```markdown
153
131
  ---
154
- layout: timeline
132
+ layout: closing-decision-box
155
133
 
156
- ## 대여소 확충 추진 일정
134
+ ## 건의 사항: 결정 요청 사항과 기한
157
135
 
158
- | 시점 | 할 일 | 담당과 산출물 |
136
+ - 아래 세 가지를 기한 안에 결정해 주시기 바랍니다
137
+ - 결정 후 인사기획팀이 11월 첫째 주까지 세부 시행 계획을 보고한다
138
+
139
+ | 결정 사항 | 담당 | 기한 |
159
140
  |---|---|---|
160
- | 2026년 11월 | 설치 대상지 120곳 확정, 지하철역별 현장 조사 | 교통정책과, 대상지 목록 |
161
- | 2027년 1월 | 1차 설치 40곳, 거치대 확대 30곳 착수 | 도로시설과, 준공 확인서 |
162
- | 2027년 4월 | 2차 설치 40곳, 이용 현황 중간 점검 | 도로시설과, 점검 보고서 |
163
- | 2027년 7월 | 3차 설치 40곳, 사업 결과 보고 | 교통정책과, 결과 보고서 |
164
-
165
- - 1차 설치 결과로 2차 설치 대상지의 순서를 다시 확인한다
166
- - 설치 후 3개월 이용 건수가 기준 미만인 곳은 이전을 검토한다
167
- - 예산은 1차분 14억 원을 12월 추경에 요청한다
141
+ | 안 2(주 2일 정례화 + 협업일 지정) 채택 여부 | 경영위원회 | 10월 넷째 주 |
142
+ | 회의실 예약 체계 개편 예산 4천만 원 | 재무팀 | 10월 말 |
143
+ | 노사협의회 심의 상정 시기 | 인사기획팀 | 11월 첫째 주 |
168
144
  ---
169
145
  ```
170
146
 
171
- Both slides compile under `tonality: gazette` after a generic cover (drawn as `cover-band`) and pass
172
- `qa_deck.py`, which still lists the empty band of the summary page (21 %) as an advisory. The city
173
- department, the programme and the figures are invented.
147
+ ## Examples
148
+
149
+ `09-briefing-gazette-ko.md`
@@ -1,25 +1,32 @@
1
1
  # Ledger
2
2
 
3
- Ledger is a set of accounts made readable. Small, exact type; figures aligned to the right; tables and
4
- KPI rows doing most of the talking; a deep green header as the one dark mass on a page; and a single
5
- teal accent that marks "this period" and the one figure a slide is about. Pages sit on the compact
6
- grid at reading size, so a deck reads like a well-kept report that also survives a meeting-room
7
- screen. The pack file says what it is for: dense, numbers-forward review decks that are read closely.
3
+ Ledger is built for numbers that a reader checks. Pages are dense and quiet, set at reading sizes
4
+ on the dense grid, with tables that carry a dark green header, hairline rules and right-aligned
5
+ figures. A teal-green accent marks the one value each slide is about, and section openers use a rule
6
+ or a real part numeral instead of colour fields. The deck reads like a well-kept report that also
7
+ works on a screen in a meeting room.
8
8
 
9
- ## When to choose it
9
+ ## When to use it
10
10
 
11
- Pick Ledger for business reviews, quarterly results, budget requests, status updates and data reviews
12
- where the audience reads before or during the meeting and asks about the figures. The pack carries
13
- fourteen families, and nine of them hold a table, a KPI row or a chart (`kpi-row`, `kpi-over-chart`,
14
- `dashboard-grid`, `ledger-table`, `table-insight`, `chart-insight`, `full-chart`, `big-number`,
15
- `matrix-2x2`), which is the best single signal for choosing it.
11
+ Choose Ledger for business reviews, quarterly results, budget requests, status updates and data
12
+ reviews where the audience reads before or during the meeting and asks about the figures. The
13
+ signals that move it up are a high share of slides with tables or charts (about 30% each), long
14
+ bodies (150 Korean glyphs or 300 Latin characters per content slide and more), and a brief that says
15
+ the deck is circulated. It is the first candidate for business reviews and status updates, the
16
+ second for data-heavy reviews and Korean briefings.
16
17
 
17
- Choose another direction for a live pitch with little data (Signal), for an image-led story (Atlas,
18
- Studio), or for a briefing read as prose (Gazette). Ledger has no `statement` treatment and no picture
19
- family; a picture that lands inside one of its families is drawn small with a hairline frame.
18
+ ## When it is the wrong choice
19
+
20
+ Ledger is wrong for a live pitch or a launch, where its density overwhelms a listener and its calm
21
+ palette undersells the moment; Signal fits there. It is also wrong for an image-led deck, because
22
+ its
23
+ pictures are framed small with a hairline and never bleed. Ledger has no statement treatment, so a
24
+ deck built on single sentences belongs elsewhere.
20
25
 
21
26
  ## Tokens
22
27
 
28
+ Read from the pack file; these are the values the engine draws.
29
+
23
30
  | Token | Value |
24
31
  |---|---|
25
32
  | ground / surface | #FFFFFF / #F2F4F6 |
@@ -28,151 +35,115 @@ family; a picture that lands inside one of its families is drawn small with a ha
28
35
  | field / on-field | #0A4438 / #FFFFFF |
29
36
  | positive / negative | #1E7A3F / #B3261E |
30
37
  | series | #0E6B5A, #4B5866, #9A6A12, #2F5F8A |
31
- | faces | Pretendard Bold for display, title and numerals, Pretendard Regular for body and labels; `faces: a2z` moves display and numerals to A2Z Bold |
32
- | tracking (title / display) | -1 % / -1 % of the size |
33
- | density / variance | 10 / 5 (up to 4 title treatments) |
38
+ | faces | Pretendard Bold for display, title and numerals, Pretendard Regular for body and labels; `faces: a2z` swaps display and numerals to A2Z Bold |
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 / 5 |
34
41
  | radius / edge | 0 / fill |
35
- | table | header in the field colour with on-field text, a hairline under the header and above a totals row, no banding, bold totals |
42
+ | table | ledger style, header in the field colour with on-field text, rules under the header and above totals, bold totals |
36
43
  | chart | hairline gridlines, direct labels, accent on the highlighted series over muted ones |
37
- | image | hairline frame |
38
- | decoration | accent-rule, hairline-rule, rail-fill, numeral |
39
44
 
40
- ## Type ramp
45
+ Density 10 puts the deck on the compact grid (24 pt side margins) and the compact ramp: body 13 pt,
46
+ table cells and captions 11 pt, sources 9 pt, rows from 18 pt, up to 22 lines in a text column, no
47
+ step-up. A deck shown to a room may lower it to 8 (dense grid, body 14 pt); both ledger examples keep
48
+ the default. No figure is set above the title size (26 pt).
41
49
 
42
- Density 10 selects the compact ramp: source 9 pt, label and table cells 11, body 13, lead 18, title
43
- 26, display 36, cover 44. The 24 pt margins and 18 pt minimum table rows serve a page that carries a
44
- dozen lines. Figures stay at title size or below; the hero step is off. Lowering density to 8 moves
45
- to the dense grid with body 14 and re-enables the one-step enlargement of short content.
50
+ ## Treatments by slide role
46
51
 
47
- ## Titles by family
48
-
49
- The pack's `role-defaults` give content, data and reference slides `top-rule`; data with a takeaway,
50
- definitions and statements `side-rail`; sequences `kicker-numeral`; images `bottom-anchor`. A family
51
- takes the first of those that it allows, and the table below lists what that gives in Ledger. The
52
- engine keeps the default while the body fills to the density cap and moves a slide to the title with
53
- the smallest empty band otherwise; a title that repeats the previous slide's title costs a little,
54
- which keeps `side-rail` data slides apart. Pin one slide with `title: bottom-anchor` after `layout:`.
55
- The `kicker-numeral` title needs a part number, so it can appear on `ledger-table` and
56
- `text-two-column` slides that follow a section slide; an agenda has no part number and never takes it.
57
-
58
- | Family | Default title | Then, in pack order |
59
- |---|---|---|
60
- | `kpi-row` | `top-rule` | `side-rail`, `bottom-anchor` |
61
- | `kpi-over-chart` | `top-rule` | none |
62
- | `dashboard-grid` | `top-rule` | `side-rail` |
63
- | `ledger-table` | `top-rule` | `kicker-numeral` |
64
- | `table-insight` | `top-rule` | `side-rail`, `bottom-anchor` |
65
- | `chart-insight` | `side-rail` | `top-rule`, `bottom-anchor` |
66
- | `full-chart` | `top-rule` | `bottom-anchor` |
67
- | `big-number` | `side-rail` | `top-rule`, `bottom-anchor` |
68
- | `comparison` | `top-rule` | `side-rail`, `bottom-anchor` |
69
- | `timeline` | `top-rule` | `bottom-anchor` |
70
- | `matrix-2x2` | `top-rule` | `side-rail` |
71
- | `agenda` | `top-rule` | `side-rail`, `kicker-numeral` |
72
- | `text-two-column` | `top-rule` | `kicker-numeral` |
73
- | `references-appendix` | `top-rule` | none |
52
+ Content, data and reference slides take `top-rule`; data with a takeaway, statements and definitions
53
+ take `side-rail`; sequences take `kicker-numeral` (it shows the part number when the deck has
54
+ sections); image slides take `bottom-anchor`. The engine starts from that map, lays out each
55
+ treatment the family allows, and keeps the role default when the body fills; otherwise it picks the
56
+ one with the smallest empty band while keeping any one treatment under about a third of the deck.
57
+ `title: bottom-anchor` after `layout:` overrides one slide.
74
58
 
75
59
  ## Families and variants
76
60
 
77
- - KPI and trend: `kpi-row` (two to six figures with a basis row), `kpi-over-chart`, `dashboard-grid`.
78
- - Tables: `ledger-table` (full width, takeaways under it), `table-insight` (takeaways beside it).
79
- - One chart or figure: `chart-insight`, `full-chart`, `big-number`.
80
- - Reading across: `comparison` for plan against actual, `timeline` for dated steps with owners,
81
- `matrix-2x2` for effect against effort.
82
- - Contents: `agenda`, `text-two-column`, `references-appendix`.
83
- - Covers `cover-figures` (the first KPI row under the title), `cover-typographic`, `cover-index`;
84
- sections `section-rule`, `section-numeral`; closings `closing-decision-box`, `closing-ask`.
85
-
86
- Display devices: the cover is `figures` (the deck's headline numbers under the title, at most title
87
- size, each with its label; a deck without a KPI row gets the plain cover), a big number is a data
88
- panel on the accent tint, and a closing's next step sits in a tinted box on the body floor. With
89
- `index: true` and an agenda, a section slide becomes an index page: the part numeral over the part
90
- title on the left, the agenda down the right columns with hairlines and this part in the accent.
61
+ - `kpi-row`, `kpi-over-chart` and `dashboard-grid` carry results and their trend on one page.
62
+ - `ledger-table` sets a full table with its takeaway lines under it; `table-insight` puts them
63
+ beside.
64
+ - `chart-insight`, `full-chart` and `big-number` carry one trend or one figure with its reading.
65
+ - `comparison` sets plan against actual, or two options, across shared rows.
66
+ - `timeline` shows dated steps with owners, `matrix-2x2` sorts options by effect and effort.
67
+ - `agenda`, `text-two-column` and `references-appendix` hold the contents, the itemised text and the
68
+ sources.
69
+
70
+ Covers are `cover-figures` (which lifts the first KPI row), `cover-typographic` and `cover-index`
71
+ (which needs an agenda or sections to list); sections are `section-rule` and `section-numeral`;
72
+ closings are `closing-decision-box` and `closing-ask`.
73
+
74
+ Display slides. The typographic cover sets the title over the deck's headline figures when the deck
75
+ has a KPI row, each figure at most title size with its label. A big number is a data panel on the
76
+ accent tint: two to four figures, one row each with value, label and basis, its evidence beside it. A section shows the deck's parts in one line under its rule, numbered as the agenda numbers
77
+ them, this part in the accent. A closing's table becomes action rows keyed by amount or date, and
78
+ the next step closes the page in a tinted box on the body floor.
91
79
 
92
80
  ## Do
93
81
 
94
- - Put the unit in the header and keep a repeated figure identical on every slide; a `data:` file in the
95
- frontmatter keeps the sources in one place.
96
- - Give every KPI a basis row (전년 대비, 계획 대비, 목표) and every table a caption with period and unit.
97
- - Write two to four takeaways under or beside each table; the first carries the claim.
98
- - Close on a decision box that names each item, its amount, its date and its owner.
99
- - Use `matrix-2x2` when every cell holds a full phrase.
82
+ - Put units in headers and keep every figure that appears twice identical, ideally from a data file.
83
+ - Give every KPI its basis row (전년 대비, 계획 대비, 목표) and a caption with period and source.
84
+ - Give each table two or three takeaway lines; a ledger table without them ends at mid-page.
85
+ - Close with a decision box that names each item, its amount, the date it is needed and the owner.
86
+ - Use a matrix only when each cell has a full phrase; one-word quadrants leave the page empty.
100
87
 
101
88
  ## Avoid
102
89
 
103
- - KPI cards for counts that are not results, such as meetings held.
90
+ - KPI values for counts that are not results, such as the number of meetings held.
104
91
  - More than one accent on a chart.
105
- - Tables stretched by empty rows or padded cells.
106
- - `side-rail` titles on two data slides in a row (the engine discourages it; a pin overrides).
107
- - A claim in the title; the title names subject, measure and period.
108
-
109
- ## Failure patterns
110
-
111
- | Symptom | Cause | Fix |
112
- |---|---|---|
113
- | `note: ledger has no statement title, so the sentence is drawn as a top-rule title`, a nearly empty slide | `layout: statement` in a pack without that family | turn the sentence into a `big-number` panel or a top-rule slide with its evidence |
114
- | `fill: slide 2 band 0.72 -> 0.72 (none: ...)`, QA reports `sparse_slide` and OF-109 | a `ledger-table` with two rows and no takeaways | add the takeaways, or draw the figures as `kpi-row` |
115
- | a literal `> ...` line under a chart | the caption was written after the closing `:::` | put the `>` caption inside the `::: chart` block |
116
- | OF-114 on a title such as "이번 분기 핵심은 현금 흐름이다" | the title is a sentence | name the topic ("분기별 현금 흐름") and move the claim to the first takeaway |
117
- | `note: slide 1: cover-figures cannot be drawn` | no KPI table with two or more values anywhere in the deck | add a KPI row or accept the typographic cover |
92
+ - Tables padded with empty rows or wide cells to fill the page.
93
+ - Two data slides in a row under a side rail.
94
+ - The `statement` family; turn a single claim into a big-number panel or a top-rule slide with its
95
+ evidence.
96
+ - Claims in titles; a title names the subject, measure and period, and the claim leads the body.
118
97
 
119
98
  ## Two worked slides
120
99
 
121
- A full table carries its reading under it, so the page ends near the floor. The title names the table;
122
- the first takeaway states the claim. The compile logs `fill: slide 2 band 0.17 -> 0.10 (distribute)`.
100
+ A ledger table carries its reading under it, so the page ends near the floor; the title names the
101
+ table, and the first takeaway carries the claim.
123
102
 
124
103
  ```markdown
125
104
  ---
126
105
  layout: ledger-table
127
106
 
128
- ## 권역별 2분기 매출·영업이익 실적
107
+ ## 사업부별 3분기 매출·영업이익 실적
129
108
 
130
- | 권역 | 매출 계획 | 매출 실적 | 영업이익 | 전분기 대비 |
109
+ | 사업부 | 매출 계획 | 매출 실적 | 영업이익 | 전년 대비 |
131
110
  |---|---|---|---|---|
132
- | 서울 | 410 | 436 | 52 | ▲ +9% |
133
- | 경기 | 365 | 371 | 38 | ▲ +4% |
134
- | 충청 | 190 | 181 | 14 | ▼ −3% |
135
- | 영남 | 240 | 252 | 21 | ▲ +6% |
136
- | 합계 | 1,205 | 1,240 | 125 | ▲ +5% |
137
-
138
- > 표 1. 권역별 2분기 실적, 억 원 (예시 데이터)
139
-
140
- - 서울·경기·영남은 매출 계획을 넘겼고 충청만 4.7% 못 미쳤다
141
- - 합계 매출은 계획보다 35억 원 많은 1,240억 원이다
142
- - 영업이익률은 10.1%로 전분기보다 0.4%p 높아졌다
143
- - 충청은 신규 매장 6곳의 개점 지연이 원인이다
144
- - 3분기 계획은 매출 1,290억 원, 영업이익 131억 원이다
111
+ | 소재 | 490 | 512 | 61 | ▲ +31% |
112
+ | 부품 | 425 | 438 | 37 | ▲ +12% |
113
+ | 서비스 | 225 | 234 | 12 | ▼ −4% |
114
+ | 합계 | 1,140 | 1,184 | 110 | ▲ +18% |
115
+
116
+ > 표 1. 사업부별 3분기 실적, 억 원 (예시 데이터)
117
+
118
+ - 세 사업부 모두 매출 계획을 달성했다 (합계 계획 대비 +3.9%)
119
+ - 서비스 사업부만 이익이 줄었고, 원인은 인건비 상승 8억 원이다
120
+ - 합계 영업이익률은 9.3%로 전년 동기보다 0.5%p 높아졌다
121
+ - 4분기 계획은 매출 1,210억 원, 영업이익 112억 원이다
145
122
  ---
146
123
  ```
147
124
 
148
- Headline figures over the trend that explains them: a KPI row with its basis row, then a native chart
149
- whose caption sits inside the block.
125
+ A status update sets the risk as a data panel: three related figures, each with its basis, and the
126
+ reading beside it.
150
127
 
151
128
  ```markdown
152
129
  ---
153
- layout: kpi-over-chart
154
-
155
- ## 2분기 가맹 매장 지표와 월별 매출
130
+ layout: big-number
156
131
 
157
- | 전체 매장 | 신규 개점 | 폐점 | 재방문율 |
158
- |---|---|---|---|
159
- | 842곳 | 17곳 | 5곳 | 63% |
160
- | 전분기 +12곳 | 계획 20곳 | 전분기 −2곳 | 목표 60% |
132
+ ## 결제 연동 재시험 일정과 영향
161
133
 
162
- ::: chart type=column unit="억 원"
163
- | 월 | 2025 | 2026 |
134
+ | 재시험 잔여 영업일 | 사전 공개 지연 위험 | 연동 시험 진척 |
164
135
  |---|---|---|
165
- | 4월 | 372 | 398 |
166
- | 5월 | 386 | 412 |
167
- | 6월 | 381 | 430 |
168
- > 월별 매출, 전년 동월과 비교 (예시 데이터)
169
- :::
170
-
171
- - 6월 매출이 전년 동월보다 12.9% 늘어 분기 증가분의 절반을 만들었다
172
- - 신규 개점은 계획보다 3곳 적었고 폐점은 전분기보다 2곳 줄었다
173
- - 재방문율은 목표를 3%p 넘었다
136
+ | 5일 | 1주 | 62% |
137
+ | 마감 10월 17일 기준 | 재시험 미완료 시 | 계획 85% 대비 |
138
+
139
+ > 결제 연동 일정 점검, 2026년 10월 10일 기준, 내부 일정표 (예시)
140
+
141
+ - 결제 연동 지연이 이번 분기 가장 큰 위험이다
142
+ - 외부 결제사가 시험 환경을 바꿔 연동 시험을 처음부터 다시 한다
143
+ - 결제사와 매일 오전 점검 회의로 진행을 확인한다
174
144
  ---
175
145
  ```
176
146
 
177
- Both slides compile and pass the gate in a deck under `tonality: ledger` (checked with
178
- `compile-deck.js` and `qa_deck.py`).
147
+ ## Examples
148
+
149
+ `03-business-review-ledger-ko.md`, `10-status-update-ledger-ko.md`