@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.
Files changed (248) hide show
  1. package/CHANGELOG.md +32 -0
  2. package/README.md +72 -17
  3. package/README_ko-KR.md +72 -17
  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/readme-studio/templates/hyperframes-cover/package-lock.json +3 -3
  246. package/plugin/skills/readme-studio/templates/remotion-cover/package-lock.json +3 -3
  247. package/plugin/skills/review-work/SKILL.md +1 -1
  248. package/plugin/skills/start-work/SKILL.md +1 -1
@@ -1,148 +1,131 @@
1
1
  # The direction step
2
2
 
3
- A deck gets its look before its first slide is written. The look is a **tonality**: a pack of palette
4
- roles, type ramp, title treatments, layout families and density that the engine reads as data. Eight
5
- tonalities ship with the skill (`ledger`, `signal`, `atlas`, `chalk`, `paper`, `gazette`, `studio`,
6
- `night`) and four legacy templates remain for users who name one. Without this step the compiler has
7
- nothing to draw with, and every topic would drift back to one house style, which is the failure the pack
8
- design exists to end.
9
-
10
- The step is short. Read the brief and the source, close four facts, rank the candidate tonalities for the
11
- deck type, reorder them by what the outline holds, write a direction card, say the choice with two
12
- alternatives in the reply, and keep the card in the build log. The step interrupts the user only when
13
- the brief leaves the look open on purpose (render a compare strip) or a dial has to move further than
14
- the skill may move it alone.
3
+ Every deck starts by choosing how it should look, before a single slide is written. The choice is
4
+ a tonality: a pack of colours, type sizes, title treatments, layout families and density that the
5
+ engine reads as data. Thirteen tonalities ship with the skill, and four legacy templates remain for
6
+ users who name them. Without this step the engine would have nothing to draw with, and the skill
7
+ would drift back to one look for every topic, which is the failure this whole design exists to end.
8
+
9
+ The step is short. It reads the brief and the source, ranks the candidate tonalities for the deck
10
+ type, writes a direction card, says the choice and two alternatives in the reply, and records the
11
+ card in the build log. It asks the user nothing unless the brief leaves the look open on purpose
12
+ (then it renders a compare strip) or a dial has to move further than the skill may move it alone.
15
13
 
16
14
  ## 1. Close the brief
17
15
 
18
- Name four facts before ranking anything. When the brief is silent, infer each from the request and the
19
- sources and write the inference on the card, where the user can overrule it.
16
+ Name four facts before ranking anything. When the brief does not say them, infer them from the
17
+ request and the sources, and write the inference on the card so the user can correct it.
20
18
 
21
- | Fact | Question it answers | Where it lands |
22
- |---|---|---|
23
- | Deck type | one row of the table in section 2, or "other, nearest to ..." | candidate order |
24
- | Reader | who opens it, where, for how long: a board at a desk, a hall watching a stage, a class reviewing the file later | density and tonality |
25
- | Delivery | presented live, sent ahead and read alone, or both | read-alone decks lean to `gazette` or `ledger` |
26
- | Language | Korean, English or mixed | glyph budgets of titles, the reading ramp |
27
-
28
- When one open fact changes the direction (a stage room versus a file sent ahead moves `night` and
29
- `gazette` apart), call `ask_question` with that single question, offer the inferred choice as the
30
- recommended default, and continue with the default if no answer arrives. A headless run cannot be
31
- answered; it appends a `decision` line to `.litgravity/ledger/<conversation-id>.jsonl` (the fields are
32
- `ts`, `kind`, `text` and `path`) and proceeds. A bare `lit` request asks nothing and decides with the
33
- same ranking. For a brief too thin to rank at all, run `deep-interview` first and return here with its
34
- answers.
19
+ - **Deck type.** One of the thirteen below, or "other, nearest to …".
20
+ - **Reader.** Who sees it, where, and for how long: a board reading at a desk, a hall watching a
21
+ stage screen, a class that will review the file later.
22
+ - **Delivery.** Presented live, sent ahead and read alone, or both.
23
+ - **Language.** Korean, English or mixed; it changes glyph budgets and the reading ramp.
35
24
 
36
25
  ## 2. Start from the deck type
37
26
 
38
- Each deck type holds an ordered list of candidates. The pair after each name is the pack's own
39
- density and variance. The first candidate is the choice when no signal moves it.
27
+ Each deck type has an ordered list of two or three candidates, with the density and variance they
28
+ start from. The first one is the default when nothing else moves the order.
40
29
 
41
30
  | Deck type | Candidates in order (density, variance) |
42
31
  |---|---|
43
- | Pitch (투자·제안 피치) | `signal` (10, 6); `studio` (10, 8); `atlas` (10, 7) when the product is something to look at |
44
- | Business review (경영 실적 보고) | `ledger` (10, 5); `gazette` (10, 4) when circulated in Korean and read alone; `night` (10, 6) for a stage review |
45
- | Research talk (연구 발표) | `paper` (10, 5); `night` (10, 6) for a keynote room; `chalk` (10, 6) for a tutorial |
46
- | Lecture or teaching (강의) | `chalk` (10, 6); `paper` (10, 5); `studio` (10, 8) for a public lecture |
47
- | Data-heavy review (데이터 리뷰) | `night` (10, 6); `ledger` (10, 5); `paper` (10, 5) for a written analysis |
48
- | Image-led (product, site, portfolio) | `atlas` (10, 7); `studio` (10, 8); `signal` (10, 6) for a launch |
49
- | Korean text briefing (보고서형 덱) | `gazette` (10, 4); `ledger` (10, 5) |
50
- | Status update (주간·월간 보고) | `ledger` (10, 5); `gazette` (10, 4); `night` (10, 6) |
32
+ | Pitch (투자·제안 피치) | Signal (10, 6); Studio (10, 7); Atlas (10, 7) when the product is something to look at |
33
+ | Launch, demo day or campaign (런칭·데모데이·캠페인) | Neo-Brutalism (10, 7); Signal (10, 6); Studio (10, 7) |
34
+ | Engineering or developer review (아키텍처·인프라·장애 리뷰) | Computational Brutalism (10, 7); Night (10, 6) for a stage; Ledger (10, 5) when it is read alone |
35
+ | Business review (경영 실적 보고) | Ledger (10, 5); Gazette (10, 4) when it is circulated in Korean and read alone; Night (10, 6) for a stage review |
36
+ | Research talk (연구 발표) | Paper (10, 5); Night (10, 5) for a keynote room; Chalk (10, 6) for a tutorial |
37
+ | Lecture or teaching (강의) | Chalk (10, 6); Paper (10, 5); Studio (10, 7) for a public lecture |
38
+ | Design or culture lecture (디자인·건축·전시·워크숍) | Bauhaus (10, 7); Studio (10, 8); Atlas (10, 7) when the works are the deck |
39
+ | Data-heavy review (데이터 리뷰) | Night (10, 6); Ledger (10, 5); Paper (10, 5) for a written analysis |
40
+ | Image-led (product, site, portfolio) | Atlas (10, 7); Studio (10, 8); Signal (10, 6) for a launch |
41
+ | Korean text briefing (보고서형 덱) | Gazette (10, 4); Ledger (10, 5) |
42
+ | Status update (주간·월간 보고) | Ledger (10, 5); Gazette (10, 4); Night (10, 6) |
43
+ | Community, culture or education programme (커뮤니티·문화·교육 프로그램) | Riso (10, 7); Studio (10, 7); Bauhaus (10, 7) for a design programme |
44
+ | Data story for the public (주민·독자 대상 데이터 브리핑) | Newsroom (10, 6); Gazette (10, 4) when it is read alone; Ledger (10, 5) |
51
45
 
52
46
  ## 3. Measure the source and reorder
53
47
 
54
- Draft the outline first (one message per slide, and the visual each message needs), then count on that
55
- outline. Apply the signals in the order listed; ties keep the deck-type order, so the same source always
56
- gives the same choice.
48
+ Draft the outline first (one message per slide, the visual each message needs), then count on that
49
+ outline. The signals below move candidates up or down. Apply them in the order listed; ties keep
50
+ the deck-type order, so the same source always gives the same choice.
57
51
 
58
- | Order | Signal | Fires when | Effect |
59
- |---|---|---|---|
60
- | 1 | a tonality is named | the brief or an earlier turn says it | use it and still write the card |
61
- | 2 | a legacy template is named | `AZURE-PRO`, `AZURE-A2Z`, `BOILERPLATE-PRETENDARD`, `BOILERPLATE-A2Z` or a learned one | use it as named; offer two tonalities as alternatives |
62
- | 3 | read rather than presented | stated in the brief, or "보고서" | `gazette` (Korean) or `ledger` to the front |
63
- | 4 | table share | tables on 30 % or more of the slides | `ledger` or `gazette` up one place |
64
- | 5 | chart share | charts on 30 % or more | `ledger`, `night` or `paper` up one place |
65
- | 6 | picture share | images on 30 % or more | `atlas` or `studio` up one place, `gazette` down |
66
- | 7 | heavy text | 150 Korean glyphs or 300 Latin characters per content slide | `gazette` or `ledger` up, `signal` down |
67
- | 8 | light text | 40 Korean glyphs or 80 Latin characters or fewer | `signal` or `studio` up; density stays 10 because the source strip and basis rows fill short slides |
68
- | 9 | citations | numbered references, DOIs or a references slide | `paper` up one place |
69
- | 10 | teaching structure | equations, definitions, or a how-it-works sequence of three steps or more | `chalk` or `paper` up |
70
- | 11 | dark room | keynote, stage, demo day | `night` up one place |
71
- | 12 | capability gap | a slide's job has no family in the pack | drop that pack |
72
-
73
- ### The capability gap
74
-
75
- Row 12 weighs more than it looks. A pack that cannot draw one of the outline's slides is the wrong pack
76
- however well the rest fits; the compiler would log `note: slide N: <family> is not a <pack> layout family`
77
- and draw that slide with its own geometry, which reads as a seam. Check the outline against what each
78
- pack carries (read from the `layout-families` list in each `pack.yaml`):
79
-
80
- | Pack | Table | Chart | Figure row | Picture | Sequence | Definition | Reference list | Statement or quote | Agenda |
81
- |---|---|---|---|---|---|---|---|---|---|
82
- | `ledger` | yes | yes | yes | - | timeline | - | yes | - | yes |
83
- | `signal` | yes | yes | yes | yes | process | - | - | yes | - |
84
- | `atlas` | - | - | yes | yes | timeline | - | - | yes | - |
85
- | `chalk` | yes | - | - | yes | process, steps | yes | - | yes | yes |
86
- | `paper` | yes | yes | - | figure | - | yes | yes | yes | - |
87
- | `gazette` | yes | - | - | - | timeline | - | yes | - | yes |
88
- | `studio` | - | yes | yes | yes | timeline | - | - | yes | - |
89
- | `night` | - | yes | yes | - | timeline | yes | - | yes | - |
90
-
91
- Worked case: a ten-slide Korean quarterly review built from a spreadsheet. The type gives `ledger`,
92
- `gazette`, `night`. Four of nine content slides hold a chart (44 %) and three a table (33 %), so rows 4
93
- and 5 both fire and both favour `ledger`. Bodies average 90 glyphs, so rows 7 and 8 stay quiet, and
94
- nothing says the file goes round beforehand. Row 12 then checks the outline against the matrix: it holds
95
- charts and a ledger table, `gazette` has no chart family and `night` has no table family. `ledger`
96
- carries both and is the choice. The other two stay on the card as alternatives with the change each
97
- needs: `gazette` if the series become tables and the file circulates before the meeting, `night` if the
98
- table moves into a comparison and the review runs on a stage screen.
52
+ | Signal | When it fires | Effect |
53
+ |---|---|---|
54
+ | The brief names a tonality, or the user chose one earlier | always wins | use it; still write the card |
55
+ | The brief names a legacy template (AZURE-PRO, AZURE-A2Z, BOILERPLATE-PRETENDARD, BOILERPLATE-A2Z) | always wins | use it as named; offer two tonalities as alternatives |
56
+ | The brief names a style rather than a pack id | 네오 브루탈리즘, neo-brutalism, neo-brutalist; 컴퓨테이셔널 브루탈리즘, computational brutalism, 레트로 퓨처, retro-futurist, terminal look; 바우하우스, Bauhaus; 리소, risograph, zine; 뉴스룸, data journalism, explainer | that pack, as if named; a bare 브루탈리즘 or brutalist takes Neo-Brutalism for a pitch or launch and Computational Brutalism for a technical deck, and the card says which reading it took |
57
+ | The deck is read rather than presented (sent ahead, circulated, "보고서") | stated in the brief | Gazette (Korean) or Ledger (other languages) to the front, density 10 |
58
+ | Slides with a table | 30 % or more | Ledger or Gazette up one place |
59
+ | Slides with a chart | 30 % or more | Ledger, Night or Paper up one place |
60
+ | Slides with an image or screenshot | 30 % or more | Atlas or Studio up one place, Gazette down |
61
+ | Body text per content slide | 150 Korean glyphs or 300 Latin characters and more | Gazette or Ledger up, Signal down |
62
+ | Body text per content slide | 40 Korean glyphs or 80 Latin characters and less | Signal or Studio up; density 10 still (the strip and the basis rows fill short slides) |
63
+ | Numbered citations, DOIs or a references slide | present | Paper up one place |
64
+ | Equations, definitions, or a how-it-works sequence of three or more steps | present | Chalk or Paper up one place |
65
+ | A dark room (keynote, stage, demo day) | stated in the brief | Night up one place |
66
+ | Metrics with units, version numbers or identifiers (p99, rps, v3, endpoint names) | on a third of the content slides | Computational Brutalism up one place |
67
+ | A young or consumer audience, a sign-up or launch ask | stated in the brief | Neo-Brutalism up one place |
68
+ | Works, makers, periods or schools as the subject | on a third of the content slides | Bauhaus up one place |
69
+ | Participants, sessions, dates and places for a community or a class | on a third of the content slides | Riso up one place |
70
+ | Charts with one point each, for readers outside the field (residents, members, the press) | stated in the brief | Newsroom up one place |
71
+ | A board, investor committee, finance or public-sector reader, or a sensitive topic (loss, safety, HR) | stated in the brief | Neo-Brutalism, Computational Brutalism, Bauhaus and Riso drop out |
72
+ | A pack would leave a slide role with no family or title it allows | any slide | drop that pack |
73
+
74
+ The last row matters more than it looks. Atlas, Ledger and Gazette have no statement title, Atlas
75
+ has no table family at all, and Signal has neither a full ledger table nor a dashboard. A pack that cannot carry one
76
+ of the outline's slides is the wrong pack, however well the rest fits.
77
+
78
+ Worked case: a ten-slide Korean quarterly review from a spreadsheet. The type gives Ledger, Gazette,
79
+ Night. Four of nine content slides hold a chart (44 %), three a table (33 %): both fire, and both
80
+ favour Ledger. Bodies average 90 glyphs, so neither text row fires. Nothing says the deck is sent
81
+ ahead. Ledger stays first; Gazette and Night are the alternatives, and the card says Gazette would
82
+ fit better if the file goes round before the meeting.
99
83
 
100
84
  ## 4. Write the direction card
101
85
 
102
- The card records the choice. Keep it in the build log, and summarise it in two or three sentences in the
103
- reply: the chosen tonality, why, the two alternatives, and what would change the choice.
86
+ The card is the record of the choice. Keep it in the build log (below) and summarise it in two or
87
+ three sentences in the reply: the chosen tonality, why, the two alternatives, and what would change
88
+ the choice.
104
89
 
105
90
  ```text
106
91
  Direction card
107
92
  Deck type business review (경영 실적 보고)
108
93
  Reader division heads reading on screen in the monthly meeting, about 15 minutes
109
- Delivery presented, with the file circulated afterwards
110
- Language Korean
111
94
  Tonality ledger alternatives: gazette, night
112
- Reason numbers-first review: 44 % chart slides, 33 % table slides; read on screen
95
+ Reason numbers-first review: 44 % chart slides, 33 % table slides; read during the meeting
113
96
  Signals fired chart share, table share
114
97
  Dials density 10, variance 5 (pack defaults)
115
- Treatments content top-rule, data top-rule, data-takeaway side-rail, sequence kicker-numeral
98
+ Treatments content top-rule · data top-rule · data-takeaway side-rail · sequence kicker-numeral
116
99
  Families planned cover-figures, agenda, kpi-over-chart, chart-insight, ledger-table, comparison,
117
100
  section-rule, dashboard-grid, timeline, closing-decision-box, references-appendix
118
- Wrong if the file is sent ahead and read alone; gazette's band pages and boxed summary fit that better
101
+ Wrong if the file is sent ahead and read alone; Gazette's band pages and boxed summary fit that better
119
102
  ```
120
103
 
121
- Fill every field. A build that cannot name the tonality and the reason stops and asks through
122
- `ask_question` (or, headless, records its best default as a `decision` line); the engine ships no silent
123
- default look. The "Wrong if" line is the one a reviewer checks first: if it turns out true, the
124
- direction was mis-chosen and the deck is rebuilt under the alternative.
104
+ Fill every field. A build that cannot write the tonality and the reason stops and asks; there is no
105
+ silent default look. The "wrong if" line is the one a reviewer checks first: if it turns out true,
106
+ the direction was mis-chosen and the deck is rebuilt under the alternative.
125
107
 
126
- **Dials.** Density (1-10) sets margins, gaps, body size and how much empty band a slide may leave.
127
- Variance (1-10) sets how many title treatments and compositions one deck mixes. Each pack has defaults.
128
- Move either dial by up to 2 without asking and say so on the card; a larger move needs the user's word.
129
- Variance below 4 is for a user who asked for a uniform deck, and the gate then records the lowered
130
- variety. `density-and-fill.md` lists what each step changes.
108
+ **Dials.** Density (1-10) sets margins, gaps, body size and how much empty band a slide may leave;
109
+ variance (1-10) sets how many title treatments and layout families one deck mixes. Each pack has
110
+ defaults. The skill may move either dial by up to 2 without asking, and says so on the card;
111
+ a bigger move needs the user's word. Variance below 4 is only for a user who asks for a uniform
112
+ deck, and the gate then records the lowered variety instead of passing it silently. See
113
+ `density-and-fill.md` for what each step changes.
131
114
 
132
- **Treatments and families.** Copy the role map from the tonality sheet in `references/tonalities/` and
133
- name one family per slide from the pack's list. The engine may draw a slide under another allowed
134
- treatment when that slide fills better, and the compile log names each such choice.
115
+ **Treatments and families.** Copy the role map from the tonality sheet and name one family per
116
+ slide from the pack's list. The engine may still pick a different allowed treatment for a slide
117
+ when that slide's body fills better under it; the compile log names every such choice.
135
118
 
136
119
  ## 5. Say it and record it
137
120
 
138
- In the reply, say which direction was chosen and why, and name the two alternatives. For example:
139
- "Ledger로 만들었습니다. 표와 차트가 슬라이드의 절반을 넘고 회의에서 화면으로 읽는 자료라서입니다.
140
- 미리 돌려 읽는 자료라면 Gazette, 큰 화면 발표라면 Night도 맞습니다."
121
+ In the reply, before or with the delivered files, say in plain words which direction was chosen
122
+ and why, and name the two alternatives. For example: "Ledger로 만들었습니다. 표와 차트가 슬라이드의
123
+ 절반을 넘고 회의에서 화면으로 읽는 자료라서입니다. 미리 돌려 읽는 자료라면 Gazette, 큰 화면 발표라면
124
+ Night도 맞습니다."
141
125
 
142
- Write the build log beside the deck source. It holds the card, then the compile output's `note:`,
143
- `variety:` and `fill:` lines, then the gate result. It is working evidence: it stays out of the slides and
144
- goes to the user only when they want the audit trail. When the deck belongs to a tracked goal, copy the
145
- log into `.litgravity/evidence/<slug>/`.
126
+ Write the build log beside the deck source. It holds the card, then the compile output's `note:`
127
+ and `fill:` lines, then the gate result. It is working evidence: it stays out of the slides and is
128
+ delivered only when the user wants the audit trail.
146
129
 
147
130
  ```text
148
131
  <deck>.md the source, with tonality: in its frontmatter
@@ -152,15 +135,13 @@ log into `.litgravity/evidence/<slug>/`.
152
135
 
153
136
  ## 6. The compare strip
154
137
 
155
- When the user asks to compare looks, or the brief leaves the look open ("어떤 느낌이 좋을지 모르겠다",
156
- "show me a few options"), build the same first three slides under the chosen tonality and the two
157
- alternatives, render them, and show the three rows before writing the rest. Content and order are
158
- identical in every row; only the tonality changes. Pick three slides that exercise different jobs (a
159
- cover, a figure row or table, a comparison) and prefer families all three packs carry; a family a pack
160
- lacks logs a `note:` and draws with its own geometry, which belongs on the strip as evidence of a poor
161
- fit.
138
+ When the user asks to compare looks, or the brief leaves the look open on purpose ("어떤 느낌이
139
+ 좋을지 모르겠다", "show me a few options"), build the same first three slides under the chosen
140
+ tonality and the two alternatives, render them, and show the three rows before writing the rest.
141
+ Same content and order in every row; only the tonality changes. The strip is evidence, and the
142
+ user's pick is the decision.
162
143
 
163
- ```sh
144
+ ```bash
164
145
  # strip.md holds the deck's frontmatter and its first three slides
165
146
  for t in ledger gazette night; do
166
147
  sed "s/^tonality: .*/tonality: $t/" strip.md > "strip-$t.md"
@@ -169,77 +150,54 @@ for t in ledger gazette night; do
169
150
  done
170
151
  ```
171
152
 
172
- Run the renders one at a time. Each loop pass writes `strip-<t>/page-01.png` to `page-03.png`. Show the
173
- nine pages as three labelled rows and let the pages carry the difference; the message adds only the
174
- card's reason. When `soffice` is missing, `render_pages.py` prints `SKIP` with the reason and the strip
175
- cannot be shown, so say so. When the user picks, update the card (the reason becomes "chosen by the user
176
- from the strip") and build the deck.
153
+ Show the nine pages as three labelled rows. Do not argue for one row in the message beyond the
154
+ card's reason; let the pages carry the difference. When the user picks, update the card (the
155
+ reason becomes "chosen by the user from the strip") and build the deck.
177
156
 
178
157
  ## 7. Legacy templates
179
158
 
180
- `AZURE-PRO`, `AZURE-A2Z`, `BOILERPLATE-PRETENDARD` and `BOILERPLATE-A2Z` keep their names and their single
181
- look. They apply when the user names one, when a learned template exists for the user's brand, or when an
182
- existing source already says `template:`. The compile needs `--template <NAME>`. The card names the
183
- template, the reply still offers two tonalities as alternatives, and the gate reports the variety checks
184
- (OF-110, OF-111 and the OF-112 median) and OF-114 as advisories, because a named template is a request for
185
- that one look. A `title:` pin needs a tonality.
186
-
187
- ## 8. Outline sequences by deck type
159
+ AZURE-PRO, AZURE-A2Z, BOILERPLATE-PRETENDARD and BOILERPLATE-A2Z keep their names and their single
160
+ look. They are used only when the user names one or when an existing deck source already says
161
+ `template:`. They are never chosen silently. When one is used, the card names it, the reply still
162
+ offers two tonalities as alternatives, and the gate reports the variety and median-band checks as
163
+ advisories, because a named template is a request for that one look.
188
164
 
189
- These sequences come from the twelve decks in `references/examples/`, each compiled and gated. Take the one
190
- nearest the job as the first draft of the outline, then replace slides whose message differs. Each slide
191
- carries one message and the family that draws it.
165
+ ## 8. Failure patterns
192
166
 
193
- | Deck type and pack | Sequence of families |
194
- |---|---|
195
- | Pitch, `signal` | cover-typographic, asymmetric-feature (the problem), big-number (its size), image-split (the product), process (how it works), kpi-row (traction), chart-insight, comparison (alternatives), table-insight (use of funds), closing-ask |
196
- | Pitch for a visual product, `studio` | cover-split-image, asymmetric-feature, big-number, image-split, section-numeral, kpi-row, chart-insight, timeline, closing-summary-list |
197
- | Business review, `ledger` | cover-figures, agenda, kpi-over-chart, chart-insight, ledger-table, comparison, section-rule, matrix-2x2, timeline, closing-decision-box, references-appendix |
198
- | Business review on a stage, `night` | cover-figures, kpi-row, kpi-over-chart, chart-insight, section-numeral, big-number, timeline, comparison, dashboard-grid, closing-decision-box |
199
- | Research talk, `paper` | cover-index, statement (the question), section-field, figure-academic, method, chart-insight, table-insight, section-field, quote, comparison, closing-summary-list, references-appendix |
200
- | Lecture, `chalk` | cover-rail, agenda, section-numeral, text-column, method, process, table-insight, image-split, comparison, comparison, closing-summary-list |
201
- | Data-heavy review, `night` | cover-numeral, kpi-row, full-chart, chart-insight, dashboard-grid, method, section-field, comparison, big-number, closing-decision-box |
202
- | Image-led report, `atlas` | cover-full-image, text-column, image-full, image-split, figure-pair, photo-grid, section-field, kpi-row, comparison, timeline, closing-ask |
203
- | Korean text briefing, `gazette` | cover-band, agenda, summary-box-list, text-two-column, ledger-table, comparison, section-band, timeline, ledger-table, closing-decision-box, references-appendix |
204
- | Status update, `ledger` | cover-figures, kpi-row, timeline, ledger-table, chart-insight, comparison, big-number, full-chart, closing-decision-box |
205
- | Portfolio, `studio` | cover-rail, text-two-column, image-full, photo-grid, section-rail, kpi-row, comparison, image-split, timeline, closing-contact-split |
206
- | Research tutorial, `chalk` | cover-numeral, agenda, comparison, section-numeral, process, method, table-insight, image-split, sidebar-note, closing-summary-list |
207
-
208
- A sequence earns its variety from slides that do different jobs. Two `comparison` slides in a row, or
209
- three tables in a deck without a chart, are the repeats OF-111 and `table_only_deck` catch later.
210
-
211
- ## 9. Failure patterns
212
-
213
- - Choosing by topic alone ("a startup, so signal") without counting the outline.
167
+ - Choosing by topic alone ("a startup, so Signal") without counting the outline.
214
168
  - Naming one tonality in the reply with no alternatives, or none at all.
215
- - A card whose reason restates the deck type where it should cite the signals that fired.
216
- - Moving a dial by three or more without asking.
217
- - A pack that forces a slide into a family it lacks; the `note:` line says so, and the fix is a different
218
- family for that slide or a different pack.
219
- - Building every slide, disliking the look, and swapping the tonality at the end without updating the
220
- card and the reply.
221
- - Rendering the strip from slides that favour one pack, so the comparison decides nothing.
169
+ - A card whose reason restates the deck type instead of the signals.
170
+ - Moving density or variance by three or more without asking.
171
+ - A pack that forces a slide into a family it does not have; the compile notes say so, and the fix
172
+ is a different family for that slide or a different pack.
173
+ - Building all slides, disliking the look, and swapping the tonality at the end without updating
174
+ the card and the reply.
222
175
 
223
176
  ## The example library
224
177
 
225
- Each file in `references/examples/` compiles under its tonality and passes the gate. Read the one closest
226
- to the job before writing a new deck.
178
+ Each file in `examples/` compiles under its tonality and passes the gate; read the one closest to
179
+ the job before writing a new deck.
227
180
 
228
181
  | File | Deck type | Tonality | Alternatives |
229
182
  |---|---|---|---|
230
- | `01-pitch-signal-ko.md` | pitch | `signal` | `studio`, `atlas` |
231
- | `02-pitch-studio-ko.md` | pitch for a visual product | `studio` | `signal`, `atlas` |
232
- | `03-business-review-ledger-ko.md` | business review | `ledger` | `gazette`, `night` |
233
- | `04-business-review-night-en.md` | business review on a stage screen | `night` | `ledger`, `gazette` |
234
- | `05-research-talk-paper-en.md` | research talk | `paper` | `night`, `chalk` |
235
- | `06-lecture-chalk-ko.md` | lecture | `chalk` | `paper`, `studio` |
236
- | `07-data-review-night-en.md` | data-heavy review | `night` | `ledger`, `paper` |
237
- | `08-image-led-atlas-ko.md` | image-led report | `atlas` | `studio`, `signal` |
238
- | `09-briefing-gazette-ko.md` | Korean text briefing | `gazette` | `ledger` |
239
- | `10-status-update-ledger-ko.md` | status update | `ledger` | `gazette`, `night` |
240
- | `11-portfolio-studio-en.md` | image-led portfolio | `studio` | `atlas`, `signal` |
241
- | `12-research-tutorial-chalk-en.md` | research tutorial | `chalk` | `paper`, `night` |
183
+ | `01-pitch-signal-ko.md` | pitch | Signal | Studio, Atlas |
184
+ | `02-pitch-studio-ko.md` | pitch for a visual product | Studio | Signal, Atlas |
185
+ | `03-business-review-ledger-ko.md` | business review | Ledger | Gazette, Night |
186
+ | `04-business-review-night-en.md` | business review on a stage screen | Night | Ledger, Gazette |
187
+ | `05-research-talk-paper-en.md` | research talk | Paper | Night, Chalk |
188
+ | `06-lecture-chalk-ko.md` | lecture | Chalk | Paper, Studio |
189
+ | `07-data-review-night-en.md` | data-heavy review | Night | Ledger, Paper |
190
+ | `08-image-led-atlas-ko.md` | image-led report | Atlas | Studio, Signal |
191
+ | `09-briefing-gazette-ko.md` | Korean text briefing | Gazette | Ledger |
192
+ | `10-status-update-ledger-ko.md` | status update | Ledger | Gazette, Night |
193
+ | `11-portfolio-studio-en.md` | image-led portfolio | Studio | Atlas, Signal |
194
+ | `12-research-tutorial-chalk-en.md` | research tutorial | Chalk | Paper, Night |
195
+ | `13-engineering-review-computational-brutalism-ko.md` | engineering review | Computational Brutalism | Night, Ledger |
196
+ | `14-launch-pitch-neo-brutalism-ko.md` | launch pitch | Neo-Brutalism | Signal, Studio |
197
+ | `15-design-lecture-bauhaus-ko.md` | design lecture | Bauhaus | Studio, Atlas |
198
+ | `16-community-programme-riso-ko.md` | community programme | Riso | Studio, Bauhaus |
199
+ | `17-public-data-briefing-newsroom-ko.md` | data story for residents | Newsroom | Gazette, Ledger |
242
200
 
243
201
  The examples that place pictures name `assets/example-a.png`, `assets/example-b.png` and
244
- `assets/example-c.png`; those files ship with the skill, and a real deck replaces them with its own
245
- images.
202
+ `assets/example-c.png`; supply real images under those names (or change the paths) before
203
+ compiling one.