@litfamily/litclaude 1.0.19 → 1.0.21

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 (101) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/README.md +14 -8
  3. package/README_ko-KR.md +13 -8
  4. package/docs/assets/readme/badge-version.svg +1 -1
  5. package/docs/hooks.md +3 -2
  6. package/package.json +1 -1
  7. package/plugins/litclaude/.claude-plugin/plugin.json +1 -1
  8. package/plugins/litclaude/bin/litclaude-hook.js +4 -4
  9. package/plugins/litclaude/bin/litclaude-mcp.js +1 -1
  10. package/plugins/litclaude/lib/canonical-skill-resources.mjs +91 -31
  11. package/plugins/litclaude/skills/frontend-ui-ux/ATTRIBUTION.md +3 -6
  12. package/plugins/litclaude/skills/lit-docx/SKILL.md +50 -19
  13. package/plugins/litclaude/skills/lit-docx/references/components.md +207 -0
  14. package/plugins/litclaude/skills/lit-docx/references/direction-step.md +277 -0
  15. package/plugins/litclaude/skills/lit-docx/references/examples/01-report-ko.md +166 -0
  16. package/plugins/litclaude/skills/lit-docx/references/examples/02-brief-ko.md +105 -0
  17. package/plugins/litclaude/skills/lit-docx/references/examples/03-manual-ko.md +164 -0
  18. package/plugins/litclaude/skills/lit-docx/references/examples/04-proposal-ko.md +138 -0
  19. package/plugins/litclaude/skills/lit-docx/references/examples/05-memo-en.md +55 -0
  20. package/plugins/litclaude/skills/lit-docx/references/examples/06-journal-en.md +130 -0
  21. package/plugins/litclaude/skills/lit-docx/references/examples/07-report-en.md +123 -0
  22. package/plugins/litclaude/skills/lit-docx/references/examples/08-proposal-en.md +123 -0
  23. package/plugins/litclaude/skills/lit-docx/references/examples/09-memo-ko.md +45 -0
  24. package/plugins/litclaude/skills/lit-docx/references/page-composition.md +221 -0
  25. package/plugins/litclaude/skills/lit-docx/references/tonalities/brief.md +143 -0
  26. package/plugins/litclaude/skills/lit-docx/references/tonalities/journal.md +142 -0
  27. package/plugins/litclaude/skills/lit-docx/references/tonalities/manual.md +148 -0
  28. package/plugins/litclaude/skills/lit-docx/references/tonalities/memo.md +137 -0
  29. package/plugins/litclaude/skills/lit-docx/references/tonalities/proposal.md +140 -0
  30. package/plugins/litclaude/skills/lit-docx/references/tonalities/report.md +156 -0
  31. package/plugins/litclaude/skills/lit-docx/scripts/convert_md_to_docx.py +274 -73
  32. package/plugins/litclaude/skills/lit-docx/scripts/docx_design.py +2449 -0
  33. package/plugins/litclaude/skills/lit-docx/scripts/docx_layout.py +959 -0
  34. package/plugins/litclaude/skills/lit-docx/scripts/qa_docx.py +66 -9
  35. package/plugins/litclaude/skills/lit-docx/scripts/slop_lint.py +18 -6
  36. package/plugins/litclaude/skills/lit-docx/templates/tonalities/brief.yaml +28 -0
  37. package/plugins/litclaude/skills/lit-docx/templates/tonalities/journal.yaml +25 -0
  38. package/plugins/litclaude/skills/lit-docx/templates/tonalities/manual.yaml +26 -0
  39. package/plugins/litclaude/skills/lit-docx/templates/tonalities/memo.yaml +26 -0
  40. package/plugins/litclaude/skills/lit-docx/templates/tonalities/proposal.yaml +26 -0
  41. package/plugins/litclaude/skills/lit-docx/templates/tonalities/report.yaml +26 -0
  42. package/plugins/litclaude/skills/lit-pptx/SKILL.md +105 -48
  43. package/plugins/litclaude/skills/lit-pptx/references/agents/analyst.md +1 -1
  44. package/plugins/litclaude/skills/lit-pptx/references/agents/thesis.md +1 -1
  45. package/plugins/litclaude/skills/lit-pptx/references/anti-slop-checklist.md +59 -30
  46. package/plugins/litclaude/skills/lit-pptx/references/authoring-guide.md +119 -42
  47. package/plugins/litclaude/skills/lit-pptx/references/consensus-protocol.md +1 -1
  48. package/plugins/litclaude/skills/lit-pptx/references/data-display-cookbook.md +13 -6
  49. package/plugins/litclaude/skills/lit-pptx/references/density-and-fill.md +164 -0
  50. package/plugins/litclaude/skills/lit-pptx/references/design-system-azure.md +7 -4
  51. package/plugins/litclaude/skills/lit-pptx/references/direction-step.md +186 -0
  52. package/plugins/litclaude/skills/lit-pptx/references/examples/01-pitch-signal-ko.md +210 -0
  53. package/plugins/litclaude/skills/lit-pptx/references/examples/02-pitch-studio-ko.md +147 -0
  54. package/plugins/litclaude/skills/lit-pptx/references/examples/03-business-review-ledger-ko.md +199 -0
  55. package/plugins/litclaude/skills/lit-pptx/references/examples/04-business-review-night-en.md +203 -0
  56. package/plugins/litclaude/skills/lit-pptx/references/examples/05-research-talk-paper-en.md +179 -0
  57. package/plugins/litclaude/skills/lit-pptx/references/examples/06-lecture-chalk-ko.md +199 -0
  58. package/plugins/litclaude/skills/lit-pptx/references/examples/07-data-review-night-en.md +194 -0
  59. package/plugins/litclaude/skills/lit-pptx/references/examples/08-image-led-atlas-ko.md +175 -0
  60. package/plugins/litclaude/skills/lit-pptx/references/examples/09-briefing-gazette-ko.md +204 -0
  61. package/plugins/litclaude/skills/lit-pptx/references/examples/10-status-update-ledger-ko.md +179 -0
  62. package/plugins/litclaude/skills/lit-pptx/references/examples/11-portfolio-studio-en.md +164 -0
  63. package/plugins/litclaude/skills/lit-pptx/references/examples/12-research-tutorial-chalk-en.md +174 -0
  64. package/plugins/litclaude/skills/lit-pptx/references/interview-protocol.md +1 -1
  65. package/plugins/litclaude/skills/lit-pptx/references/layout-families.md +198 -0
  66. package/plugins/litclaude/skills/lit-pptx/references/stages/autopilot.md +1 -1
  67. package/plugins/litclaude/skills/lit-pptx/references/stages/interview.md +2 -2
  68. package/plugins/litclaude/skills/lit-pptx/references/stages/plan.md +1 -1
  69. package/plugins/litclaude/skills/lit-pptx/references/title-treatments.md +109 -0
  70. package/plugins/litclaude/skills/lit-pptx/references/tonalities/atlas.md +139 -0
  71. package/plugins/litclaude/skills/lit-pptx/references/tonalities/chalk.md +148 -0
  72. package/plugins/litclaude/skills/lit-pptx/references/tonalities/gazette.md +149 -0
  73. package/plugins/litclaude/skills/lit-pptx/references/tonalities/ledger.md +149 -0
  74. package/plugins/litclaude/skills/lit-pptx/references/tonalities/night.md +147 -0
  75. package/plugins/litclaude/skills/lit-pptx/references/tonalities/paper.md +151 -0
  76. package/plugins/litclaude/skills/lit-pptx/references/tonalities/signal.md +150 -0
  77. package/plugins/litclaude/skills/lit-pptx/references/tonalities/studio.md +132 -0
  78. package/plugins/litclaude/skills/lit-pptx/scripts/compile-deck.js +64 -16
  79. package/plugins/litclaude/skills/lit-pptx/scripts/craft_extras.py +664 -3
  80. package/plugins/litclaude/skills/lit-pptx/scripts/deck_craft.py +48 -6
  81. package/plugins/litclaude/skills/lit-pptx/scripts/lib/grid-resolver.js +521 -0
  82. package/plugins/litclaude/skills/lit-pptx/scripts/lib/layout-resolver.js +362 -11
  83. package/plugins/litclaude/skills/lit-pptx/scripts/lib/markdown-loader.js +6 -4
  84. package/plugins/litclaude/skills/lit-pptx/scripts/lib/render-adapter-pptx.js +211 -65
  85. package/plugins/litclaude/skills/lit-pptx/scripts/lib/render-pack.js +3559 -0
  86. package/plugins/litclaude/skills/lit-pptx/scripts/lib/slide-ast.js +10 -6
  87. package/plugins/litclaude/skills/lit-pptx/scripts/lib/template-registry.js +286 -1
  88. package/plugins/litclaude/skills/lit-pptx/scripts/qa_deck.py +39 -10
  89. package/plugins/litclaude/skills/lit-pptx/scripts/validate_pptx.py +22 -7
  90. package/plugins/litclaude/skills/lit-pptx/templates/enrolled/AZURE-A2Z/layout-mapping.yaml +1 -1
  91. package/plugins/litclaude/skills/lit-pptx/templates/enrolled/AZURE-A2Z/template.yaml +4 -1
  92. package/plugins/litclaude/skills/lit-pptx/templates/enrolled/AZURE-PRO/layout-mapping.yaml +1 -1
  93. package/plugins/litclaude/skills/lit-pptx/templates/enrolled/AZURE-PRO/template.yaml +4 -1
  94. package/plugins/litclaude/skills/lit-pptx/templates/tonalities/atlas/pack.yaml +92 -0
  95. package/plugins/litclaude/skills/lit-pptx/templates/tonalities/chalk/pack.yaml +97 -0
  96. package/plugins/litclaude/skills/lit-pptx/templates/tonalities/gazette/pack.yaml +93 -0
  97. package/plugins/litclaude/skills/lit-pptx/templates/tonalities/ledger/pack.yaml +94 -0
  98. package/plugins/litclaude/skills/lit-pptx/templates/tonalities/night/pack.yaml +93 -0
  99. package/plugins/litclaude/skills/lit-pptx/templates/tonalities/paper/pack.yaml +98 -0
  100. package/plugins/litclaude/skills/lit-pptx/templates/tonalities/signal/pack.yaml +94 -0
  101. package/plugins/litclaude/skills/lit-pptx/templates/tonalities/studio/pack.yaml +92 -0
@@ -0,0 +1,139 @@
1
+ # Atlas
2
+
3
+ Atlas is a picture book with good captions. Photographs bleed to the edge or take most of the body,
4
+ titles sit on a dark panel over the picture or under it, and the words stay calm but carry the
5
+ facts each picture needs: what, where, when and how much. The
6
+ palette is quiet on purpose, a near-black ink and one muted navy, because the photographs bring the
7
+ colour. Every picture carries a numbered caption and its source, which keeps the deck honest about
8
+ what the reader is looking at.
9
+
10
+ ## When to use it
11
+
12
+ Use Atlas when the evidence is visual: product reports, portfolios, site and field visits,
13
+ renovation or construction progress, exhibitions. It is the first candidate for the image-led deck
14
+ type and moves up whenever a third or more of the slides hold an image or a screenshot. It works for
15
+ a client or a review panel who judges by seeing, and it suits short narrative text between pictures.
16
+
17
+ ## When it is the wrong choice
18
+
19
+ Atlas fails without real images. A pack built around pictures turns into grey boxes when the
20
+ source has none, so for a text or number deck pick Ledger, Gazette or Signal. It keeps a
21
+ statement for the one claim a picture deck needs, but a deck that lives on one-line claims belongs
22
+ in Signal or Studio. Long tables also sit awkwardly here, because its table style is light and its
23
+ families give
24
+ the room to images.
25
+
26
+ ## Tokens
27
+
28
+ These values are read from the pack file `pack.yaml` of the `atlas` tonality.
29
+
30
+ | Token | Value |
31
+ |---|---|
32
+ | ground / surface | `#FFFFFF` / `#F3F4F5` |
33
+ | ink / ink-muted | `#1A1D21` / `#555B63` |
34
+ | line | `#D6D9DD` |
35
+ | accent / accent-deep / accent-tint | `#2B4C7E` / `#1B2F4E` / `#E6ECF4` |
36
+ | field / on-field | `#1A1D21` / `#FFFFFF` |
37
+ | positive / negative | `#1E7A3F` / `#B3261E` |
38
+ | series | `#2B4C7E`, `#555B63`, `#8A6A2E`, `#3E7A5A` |
39
+ | faces | title Pretendard Bold, body, label, display and numerals Pretendard Regular; `faces: a2z` swaps display and numerals to A2Z Light |
40
+ | ramp / hero | compact (body 13 pt, labels 11, sources 9) / no hero step, figures at most title size |
41
+ | density / variance | 10 / 7 |
42
+ | radius / edge | 0 / fill |
43
+ | table | light grid: no header fill, bold ink header, hairline rows, no banding, numbers right-aligned, totals bold |
44
+ | chart | hairline gridlines, direct labels, accent on the item that matters |
45
+ | image | no frame |
46
+ | decoration | caption band, hairline rule, colour field |
47
+
48
+ ## Treatments by slide role
49
+
50
+ Image slides take `overlay`, where the title sits on a dark panel over a full-bleed photograph.
51
+ Charts and figures with a takeaway take `bottom-anchor`, so the visual fills the top and the title
52
+ explains it from below. Text, reference and definition slides take `side-rail`, data and
53
+ sequences take `top-plain-large`, and a pull quote takes `statement` on the dark field over the
54
+ whole page (a plate under half the page left its top half open). The
55
+ engine starts from the role's treatment and, when
56
+ the body would stay half empty, tries the others the family allows and keeps the one that fills,
57
+ within the variance cap. A `title: <treatment>` line under `layout:` pins one slide, provided the
58
+ family allows it; `image-full` only ever takes `overlay`.
59
+
60
+ ## Families and variants
61
+
62
+ - `image-full`: one photograph across the whole slide with the title on its panel.
63
+ - `image-split`: a large image beside three or four short facts about it.
64
+ - `photo-grid`: up to three images in a row, with one line under them.
65
+ - `figure-pair`: before and after, or two places, side by side with one line of evidence.
66
+ - `asymmetric-feature`: one image or number given most of the width, with short evidence.
67
+ - `kpi-row`: two to four numbers that prove the pictures, each with a basis row and a sourced caption.
68
+ - `comparison`: two options or two problems, row by row.
69
+ - `timeline`: dated next steps on one axis.
70
+ - `text-column`: the short narrative that opens or links the picture sections.
71
+
72
+ Covers are `cover-full-image` (it takes the first image in the deck; the title's panel is only as
73
+ tall as the title and its meta line and stands on the foot of the page, so the picture keeps the rest), `cover-split-image` and
74
+ `cover-typographic`. Sections are `section-image` and `section-field`. Closings are
75
+ `closing-contact-split` and `closing-ask`. A cover takes no image block of its own; put the picture
76
+ on a content slide and the cover finds it.
77
+
78
+ Display slides. Without a picture, the typographic cover puts the title on a dark plate over the
79
+ lower part of the page, like a caption under a photograph that is not there. A pull quote fills the
80
+ page with the dark field, the quotation in the middle. A closing's rows carry their dates or amounts at title size, and the next step runs in a dark
81
+ band above the footer.
82
+
83
+ ## Do
84
+
85
+ Give every photograph a numbered caption with its source. Let one image dominate each slide, and
86
+ write the facts about it next to it in short lines, with a number, a date or a place in each. Title
87
+ each slide with a label (place, subject, period) and let the first fact carry the claim. Keep the
88
+ narrative slides brief and use them to move from one group of pictures to the next. End with the ask
89
+ and the dated next step.
90
+
91
+ ## Avoid
92
+
93
+ Avoid text placed straight on a photograph without the panel, images in card frames, and more than
94
+ three images in one row. Never deliver a deck with grey sample boxes in place of the real pictures.
95
+ Keep the `statement` family for a pull quote; claims belong in the first fact or the caption of the
96
+ picture that proves them, never in the title.
97
+
98
+ ## Two worked slides
99
+
100
+ An image-split slide puts the picture first and five short facts beside it, the claim in the first,
101
+ so the reader gets the evidence without a paragraph.
102
+
103
+ ```markdown
104
+ ---
105
+ layout: image-split
106
+
107
+ ## 재개관 첫 주 창가 좌석 이용 현황
108
+
109
+ ![도 2. 오후 3시의 창가 좌석 | 출처: 예시 이미지](assets/example-b.png)
110
+
111
+ - **요약** 창가 좌석은 개관부터 마감까지 하루 종일 차 있다
112
+ - **좌석 수** 창가 좌석을 24석에서 56석으로 늘렸다
113
+ - **점유율** 재개관 첫 주 오후 점유율이 92%였다
114
+ - **조명** 창가에 차양을 달아 오후 눈부심 민원이 없었다
115
+ - **동선** 서가를 벽 쪽으로 옮겨 통로 폭이 1.2m에서 1.8m가 됐다
116
+ ---
117
+ ```
118
+
119
+ A figure pair shows the change, and the lines under both pictures state it with its basis.
120
+
121
+ ```markdown
122
+ ---
123
+ layout: figure-pair
124
+
125
+ ## 공사 전후 어린이실 좌석 배치
126
+
127
+ ![도 3. 공사 전 어린이실 | 출처: 예시 이미지](assets/example-b.png)
128
+
129
+ ![도 4. 공사 후 어린이실 | 출처: 예시 이미지](assets/example-b.png)
130
+
131
+ - 공사 전후의 어린이실은 같은 방으로 보이지 않는다
132
+ - 낮은 서가와 계단식 좌석으로 동시 착석이 18명에서 40명으로 늘었다
133
+ - 주말 어린이실 이용은 하루 평균 95명에서 160명이 됐다 (예시)
134
+ ---
135
+ ```
136
+
137
+ ## Examples
138
+
139
+ `08-image-led-atlas-ko.md` uses the pack defaults (density 10, variance 7).
@@ -0,0 +1,148 @@
1
+ # Chalk
2
+
3
+ Chalk is a good teacher's board after someone has tidied it. Steps are numbered because they really
4
+ happen in order, one idea per slide is marked as the thing to learn and worked through with its
5
+ numbers, and the definition or the
6
+ common mistake sits in its own fenced box at the side. Surfaces have soft corners, the ground is a
7
+ cool near-white, and a warm rust accent always points at what is being taught. The rhythm is
8
+ deliberate: explain, show, try, check.
9
+
10
+ ## When to use it
11
+
12
+ Choose Chalk for lectures, tutorials, onboarding sessions and training, where the audience has to be
13
+ able to do something afterwards. It is the first candidate for the lecture deck type and a good
14
+ second for a research talk given as a tutorial. It climbs the list when the source contains
15
+ equations, definitions or a "how it works" sequence of three or more steps, which are exactly the
16
+ slides its numbered and sidebar families are built for.
17
+
18
+ ## When it is the wrong choice
19
+
20
+ Chalk is wrong for decision decks. A board of numbered steps in front of executives reads as padding
21
+ and slows the ask; Ledger or Signal fit that room. It is also a poor match for a dense data review,
22
+ because its families favour a few explained items over many numbers on one page, and for
23
+ image-led portfolios, where Atlas lets pictures carry the slides.
24
+
25
+ ## Tokens
26
+
27
+ These values are read from the pack file `pack.yaml` of the `chalk` tonality.
28
+
29
+ | Token | Value |
30
+ |---|---|
31
+ | ground / surface | `#FAFBFC` / `#EEF2F5` |
32
+ | ink / ink-muted | `#1F2933` / `#4E5A66` |
33
+ | line | `#CBD3DA` |
34
+ | accent / accent-deep / accent-tint | `#9A3412` / `#6B2409` / `#FCEBE0` |
35
+ | field / on-field | `#1F3B33` / `#FFFFFF` |
36
+ | positive / negative | `#1E7A3F` / `#B3261E` |
37
+ | series | `#9A3412`, `#1F3B33`, `#4E5A66`, `#2E6A8E` |
38
+ | faces | Pretendard Bold for display, title and numerals, Pretendard Regular for body and labels; `faces: a2z` swaps to A2Z Bold display and titles, A2Z Black numerals |
39
+ | ramp / hero | compact (body 13 pt, labels 11, sources 9) / no hero step, figures at most title size |
40
+ | density / variance | 10 / 6 |
41
+ | radius / edge | 6 / fill |
42
+ | rail | the side rail is a field-coloured fill |
43
+ | table | header row in the accent tint with deep-accent bold text, hairline rules between rows, no banding, numbers right-aligned, totals bold |
44
+ | chart | hairline gridlines, direct labels, accent on the item that matters and muted colours on the rest |
45
+ | decoration | accent rule, marked term underline, rail fill, numeral |
46
+
47
+ The marked-term underline is listed in the pack but the engine does not draw it yet, so mark the
48
+ term
49
+ in the wording for now.
50
+
51
+ ## Treatments by slide role
52
+
53
+ Sequences take `kicker-numeral`, where the step or part number stands left of the title at title size. Text
54
+ and data slides take `top-rule` with its short accent bar, chart and image slides with a takeaway
55
+ take `side-rail`, definitions take `side-rail`, a comparison sets its criteria on the board rail under a
56
+ `side-rail` title (the pack's `structure`), and a pull quote takes `statement`. When a slide's own
57
+ treatment would leave the body half empty, the engine tries the other treatments its family allows
58
+ and keeps the one that fills best, within the number of treatments the variance dial allows. A
59
+ `title: top-rule` line under `layout:` pins a slide to a treatment; the lecture example does that
60
+ for
61
+ a method slide whose definitions need the full width. An agenda carries no numeral (OF-119), so a
62
+ chalk deck whose only kicker was its agenda needs a step or sidebar slide under `kicker-numeral` to
63
+ keep three treatments (OF-110), and a sidebar note set across the top adds one more top-title slide
64
+ in a grid, which can carry top/grid past 40 % of the content slides (OF-111).
65
+
66
+ ## Families and variants
67
+
68
+ - `step-diagram`: numbered steps across the body, each with its action and detail.
69
+ - `process`: the same steps when they read as a flow rather than a procedure.
70
+ - `method`: a formula with the meaning of each symbol under it.
71
+ - `sidebar-note`: the explanation with a fenced box for the definition or the trap.
72
+ - `comparison`: two ideas students confuse, side by side row by row.
73
+ - `image-split`: a worked example with its figure.
74
+ - `quote`: a line worth remembering, set as a statement.
75
+ - `agenda`: what the session covers, numbered.
76
+ - `statement`: a pull quote or the lesson's rule, kept for a display-led deck the user asks for.
77
+ - `text-column`: an explanation at reading measure.
78
+ - `table-insight`: a small table with the pattern spelled out beside it.
79
+
80
+ Covers are `cover-rail`, `cover-typographic` and `cover-numeral`. Sections are `section-numeral` and
81
+ `section-rail`. Closings are `closing-summary-list` (the recap plus the exercise) and `closing-ask`.
82
+
83
+ Display slides. The typographic cover is the board-green rail with the topic name beside it. A
84
+ statement is written on the board: the whole slide in the field green, the quoted line in white. A section
85
+ numeral reads as the part of the whole ("03 / 04") when the deck has an agenda. A closing's rows are
86
+ keyed by their dates, and the next step sits in a tinted box on the body floor.
87
+
88
+ ## Do
89
+
90
+ Use numbers only for things that happen in order or for real parts of the session. Put every
91
+ definition and every common mistake in a sidebar box, where students can find it again. Give each
92
+ worked example the actual arithmetic, step by step, with a sample value at each step. Title each
93
+ slide with what it teaches ("신뢰구간 계산 네 단계"), and put the rule in the first line of the body. End with what was learnt and what to practise,
94
+ with a due date.
95
+
96
+ ## Avoid
97
+
98
+ Avoid more than one marked term per slide; two underlines mean neither is the point. Avoid numerals
99
+ on points that are not a sequence. Do not bury a definition inside a bullet list. Avoid a sentence
100
+ as a title; the slide names the topic and the body states the rule.
101
+
102
+ ## Two worked slides
103
+
104
+ A step slide spells out each action, its detail and a worked value, so the steps fill the body and
105
+ can be followed without the speaker.
106
+
107
+ ```markdown
108
+ ---
109
+ layout: step-diagram
110
+
111
+ ## 95% 신뢰구간 계산 네 단계
112
+
113
+ - **1. 평균 구하기** 표본 값의 합을 n으로 나눈다 · 예: 키 표본 25명, 평균 168cm
114
+ - **2. 표준편차 구하기** 편차 제곱의 평균에 제곱근을 씌운다 · 예: 10cm
115
+ - **3. 표준오차 구하기** 표준편차를 √n으로 나눈다 · 예: 10 ÷ 5 = 2cm
116
+ - **4. 구간 만들기** 평균 ± 1.96 × 표준오차 · 예: 164.1-171.9cm
117
+ ---
118
+ ```
119
+
120
+ A sidebar slide names each wrong reading and why it fails, and keeps the right reading in the box;
121
+ the title labels the topic.
122
+
123
+ ```markdown
124
+ ---
125
+ layout: sidebar-note
126
+ title: top-rule
127
+
128
+ ## 신뢰구간 해석의 흔한 오류 두 가지
129
+
130
+ - **참값이 이 구간 안에 있을 확률이 95%라는 읽기**
131
+ (1) 참값은 정해진 하나의 수라서 확률로 말하지 않는다
132
+ (2) 확률은 구간을 만드는 방법에 붙는 말이다
133
+ - **학생의 95%가 이 구간 안에 있다는 읽기**
134
+ (1) 구간은 평균에 대한 것이고 개인 값의 범위가 아니다
135
+ (2) 개인 값의 범위는 표준편차로 따로 말한다
136
+
137
+ ::: main-box
138
+ 같은 방법으로 구간을 100번 만들면 약 95개가 참값을 담는다고 읽는다
139
+ :::
140
+
141
+ - **확인 질문** 표본을 100명으로 늘리면 구간 폭은 어떻게 바뀌는가 (답: 절반)
142
+ ---
143
+ ```
144
+
145
+ ## Examples
146
+
147
+ `06-lecture-chalk-ko.md` and `12-research-tutorial-chalk-en.md` both use the pack defaults (density
148
+ 10, variance 6).
@@ -0,0 +1,149 @@
1
+ # Gazette
2
+
3
+ Gazette sets a Korean briefing paper as slides. A slate header band carries the title on most
4
+ content
5
+ pages, a boxed one-line conclusion opens the argument, and 개조식 evidence runs in two columns at
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.
10
+
11
+ ## When to use it
12
+
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
+
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.
26
+
27
+ ## Tokens
28
+
29
+ Read from the pack file; these are the values the engine draws.
30
+
31
+ | Token | Value |
32
+ |---|---|
33
+ | ground / surface | #FFFFFF / #F1F4F8 |
34
+ | ink / ink-muted / line | #1A2230 / #4A5568 / #C8D0DA |
35
+ | accent / accent-deep / accent-tint | #A61B1B / #233A4F / #E8EEF4 |
36
+ | field / on-field | #233A4F / #FFFFFF |
37
+ | positive / negative | #1E7A3F / #1A2230 |
38
+ | series | #A61B1B, #233A4F, #4A5568, #7A6A2A |
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) / not allowed, 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 |
44
+ | chart | hairline gridlines, direct labels, accent on the highlighted series |
45
+
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.
49
+
50
+ ## Treatments by slide role
51
+
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.
58
+
59
+ ## Families and variants
60
+
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.
64
+ - `ledger-table` sets a table with its reading under it; `table-insight` sets the reading beside it.
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.
79
+
80
+ ## Do
81
+
82
+ - Put the conclusion first, in the summary box, in one or two lines; the title stays a label
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.
88
+ - End with a decision table: what to decide, who decides, by when.
89
+
90
+ ## Avoid
91
+
92
+ - English section kickers or labels on a Korean page.
93
+ - Red for anything other than the key line.
94
+ - A summary box longer than three lines.
95
+ - More than three text families in a row; break them with a table, a timeline or a comparison.
96
+ - The `statement` family; a single claim becomes the summary box.
97
+
98
+ ## Two worked slides
99
+
100
+ The summary page labels the topic in its band, states the recommendation in the box and lays the
101
+ evidence under it.
102
+
103
+ ```markdown
104
+ ---
105
+ layout: summary-box-list
106
+
107
+ ## 핵심 요약: 재택근무 주 2일 정례화 건의
108
+
109
+ ::: key-message
110
+ 재택근무를 주 2일로 정례화하되, 팀마다 협업일 하루를 지정해 대면 회의를 그날에 모은다
111
+ :::
112
+
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월 전면 시행
124
+ ---
125
+ ```
126
+
127
+ The closing labels the request, turns it into a decision table, and states the ask and the follow-up
128
+ above it.
129
+
130
+ ```markdown
131
+ ---
132
+ layout: closing-decision-box
133
+
134
+ ## 건의 사항: 결정 요청 사항과 기한
135
+
136
+ - 아래 세 가지를 기한 안에 결정해 주시기 바랍니다
137
+ - 결정 후 인사기획팀이 11월 첫째 주까지 세부 시행 계획을 보고한다
138
+
139
+ | 결정 사항 | 담당 | 기한 |
140
+ |---|---|---|
141
+ | 안 2(주 2일 정례화 + 협업일 지정) 채택 여부 | 경영위원회 | 10월 넷째 주 |
142
+ | 회의실 예약 체계 개편 예산 4천만 원 | 재무팀 | 10월 말 |
143
+ | 노사협의회 심의 상정 시기 | 인사기획팀 | 11월 첫째 주 |
144
+ ---
145
+ ```
146
+
147
+ ## Examples
148
+
149
+ `09-briefing-gazette-ko.md`
@@ -0,0 +1,149 @@
1
+ # Ledger
2
+
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
+
9
+ ## When to use it
10
+
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.
17
+
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.
25
+
26
+ ## Tokens
27
+
28
+ Read from the pack file; these are the values the engine draws.
29
+
30
+ | Token | Value |
31
+ |---|---|
32
+ | ground / surface | #FFFFFF / #F2F4F6 |
33
+ | ink / ink-muted / line | #16212C / #4B5866 / #D0D6DC |
34
+ | accent / accent-deep / accent-tint | #0E6B5A / #0A4438 / #E2F0EC |
35
+ | field / on-field | #0A4438 / #FFFFFF |
36
+ | positive / negative | #1E7A3F / #B3261E |
37
+ | series | #0E6B5A, #4B5866, #9A6A12, #2F5F8A |
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) / not allowed |
40
+ | density / variance | 10 / 5 |
41
+ | radius / edge | 0 / fill |
42
+ | table | ledger style, header in the field colour with on-field text, rules under the header and above totals, bold totals |
43
+ | chart | hairline gridlines, direct labels, accent on the highlighted series over muted ones |
44
+
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).
49
+
50
+ ## Treatments by slide role
51
+
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.
58
+
59
+ ## Families and variants
60
+
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.
79
+
80
+ ## Do
81
+
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.
87
+
88
+ ## Avoid
89
+
90
+ - KPI values for counts that are not results, such as the number of meetings held.
91
+ - More than one accent on a chart.
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.
97
+
98
+ ## Two worked slides
99
+
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.
102
+
103
+ ```markdown
104
+ ---
105
+ layout: ledger-table
106
+
107
+ ## 사업부별 3분기 매출·영업이익 실적
108
+
109
+ | 사업부 | 매출 계획 | 매출 실적 | 영업이익 | 전년 대비 |
110
+ |---|---|---|---|---|
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억 원이다
122
+ ---
123
+ ```
124
+
125
+ A status update sets the risk as a data panel: three related figures, each with its basis, and the
126
+ reading beside it.
127
+
128
+ ```markdown
129
+ ---
130
+ layout: big-number
131
+
132
+ ## 결제 연동 재시험 일정과 영향
133
+
134
+ | 재시험 잔여 영업일 | 사전 공개 지연 위험 | 연동 시험 진척 |
135
+ |---|---|---|
136
+ | 5일 | 1주 | 62% |
137
+ | 마감 10월 17일 기준 | 재시험 미완료 시 | 계획 85% 대비 |
138
+
139
+ > 결제 연동 일정 점검, 2026년 10월 10일 기준, 내부 일정표 (예시)
140
+
141
+ - 결제 연동 지연이 이번 분기 가장 큰 위험이다
142
+ - 외부 결제사가 시험 환경을 바꿔 연동 시험을 처음부터 다시 한다
143
+ - 결제사와 매일 오전 점검 회의로 진행을 확인한다
144
+ ---
145
+ ```
146
+
147
+ ## Examples
148
+
149
+ `03-business-review-ledger-ko.md`, `10-status-update-ledger-ko.md`