@litfamily/litopencode 1.0.16 → 1.0.18

package/skills/lit-pptx/references/tonalities/ledger.md

@@ -0,0 +1,150 @@
+# Ledger
+
+Ledger sets a deck like a set of accounts made readable: small exact type, with
+tables and figure rows doing most of the talking. Colour is rationed to two jobs, marking the
+current period and the one number that matters. Pack file: `templates/tonalities/ledger/pack.yaml`.
+
+## Use it for
+
+- Management and business reviews read closely, on screen or at the table (경영 실적, 사업부 리뷰).
+- Weekly and monthly status updates with work items, owners, defects and budget.
+- Data reviews where the audience questions every figure and wants the table, not just the chart.
+- Any deck where 30 % or more of the slides hold a table or chart and the reader has time.
+
+## Wrong for
+
+- A live pitch with little data: Ledger's restraint makes a thin deck look thinner. Use signal.
+- A Korean briefing that is read as prose with boxed conclusions: gazette fits that better.
+- Photo-led showcases: Ledger lists no image family.
+- A dark keynote hall: night.
+
+## Palette roles
+
+| Role | Colour | Used for |
+|---|---|---|
+| ground | white `#FFFFFF` | every slide background |
+| surface | pale grey `#F2F4F6` | rail fill, quiet panels |
+| ink / ink-muted | near-black slate `#16212C` / slate grey `#4B5866` | text, secondary text |
+| line | light grey `#D0D6DC` | hairlines, table rules |
+| accent | deep teal green `#0E6B5A` | the current period, the figure that matters, accent rule |
+| accent-deep / accent-tint | dark teal `#0A4438` / pale mint `#E2F0EC` | field and table header / number panel tint |
+| field / on-field | dark teal `#0A4438` / white | table header row, filled devices |
+| positive / negative | green `#1E7A3F` / red `#B3261E` | signed deltas |
+| series | teal, slate, ochre, steel blue | chart series in that order |
+
+## Type
+
+Pretendard Regular and Bold throughout (A2Z display and numerals only with `faces: a2z`). At
+density 10 the compact ramp applies: body 13 pt, labels and table cells 11 pt, sources 9 pt, titles
+26 pt. Titles track slightly tight.
+
+## Dials
+
+Density 10, variance 5: at most four title treatments in one deck, of the pack's four.
+
+## Title treatments by role
+
+| Role | Default treatment |
+|---|---|
+| content | top-rule |
+| data | top-rule |
+| data-takeaway | side-rail |
+| sequence | kicker-numeral |
+| image | bottom-anchor |
+| statement | side-rail (no statement treatment; a statement slide becomes a top-rule title) |
+| reference | top-rule |
+| definition | side-rail |
+
+The pack's treatments are top-rule, side-rail, kicker-numeral and bottom-anchor; a slide may take
+any of them that its family allows (`--list-layouts ledger` prints the pairs). Its top-rule draws
+the short accent bar (`accent-rule`), not a hairline. kicker-numeral appears on the agenda (the
+part count) and on content slides after a section (the part number).
+
+## Families and variants
+
+Families: kpi-row, kpi-over-chart, dashboard-grid, ledger-table, table-insight, chart-insight,
+full-chart, big-number, comparison, timeline, matrix-2x2, agenda, text-two-column,
+references-appendix.
+
+Covers: cover-figures (needs a KPI table in the deck), cover-typographic, cover-index (needs an
+agenda or two sections). Sections: section-rule, section-numeral. Closings: closing-decision-box,
+closing-ask.
+
+Display devices: the cover device is `figures`, big numbers stand on a tinted panel, a closing's
+next step sits in a box, and `index: true` turns section-rule pages into an index of the agenda
+with the current part marked.
+
+## Tables and charts
+
+- Tables in the `ledger` style: the header row is the deck's one dark mass (dark teal field, white
+  labels); rules under the header and above the totals only; no banding; numbers right-aligned;
+  totals bold.
+- Charts: hairline gridlines, direct labels, one accent on muted series.
+- Images (rare here): hairline frame.
+
+## Decoration vocabulary
+
+accent-rule, hairline-rule, rail-fill, numeral. Nothing else is drawn: no cards for counts that are
+not results, no colour fields on content slides.
+
+## Fill behaviour
+
+`fill-order`: step-up (off at density 10), distribute, anchor-visual, change-family. Ledger slides
+fill by spreading first; a short table slide therefore shows its gaps between rows and takeaways
+rather than a larger font.
+
+## Avoid
+
+- KPI cards for counts that are not results (a headcount is not a KPI unless it is the result).
+- More than one accent on a chart; highlight the current period only.
+- Tables stretched by padding; add rows or takeaways instead.
+- Side-rail on two data slides in a row.
+
+## A sample fragment
+
+```text
+---
+tonality: ledger
+title: 2026년 3분기 구매 원가 리뷰
+date: 2026-10-06
+notice: 예시 데이터
+---
+layout: kpi-row
+
+## 3분기 구매 원가 핵심 지표
+
+| 구매액 | 단가 변동 | 절감액 | 계약 준수율 | 긴급 발주 |
+|---|---|---|---|---|
+| 1,920억 원 | +2.4% | 31억 원 | 94.1% | 38건 |
+| 계획 대비 −1.8% | 전년 동기 대비 | 목표 28억 원 | 목표 95% | 전 분기 52건 |
+
+- 원자재 단가 상승분 2.4% 중 1.1%p를 장기 계약으로 흡수
+- 긴급 발주는 생산 계획 확정 시점을 사흘 앞당긴 뒤 27% 줄어듦
+- 출처: 예시 기업 구매 시스템 집계(2026년 7~9월)
+- 주: 단가 변동은 상위 50개 품목의 물량 가중 평균
+---
+layout: ledger-table
+
+## 품목군별 구매액과 단가 변동
+
+| 품목군 | 구매액 | 비중 | 단가 변동 | 절감액 |
+|---|---|---|---|---|
+| 철강재 | 640억 원 | 33% | +3.9% | 9억 원 |
+| 수지류 | 410억 원 | 21% | +1.2% | 8억 원 |
+| 전장 부품 | 380억 원 | 20% | +2.8% | 6억 원 |
+| 포장재 | 190억 원 | 10% | −0.6% | 5억 원 |
+| 기타 | 300억 원 | 16% | +1.5% | 3억 원 |
+| 합계 | 1,920억 원 | 100% | +2.4% | 31억 원 |
+
+> 표 1. 품목군별 3분기 구매 실적 (예시 데이터)
+
+- 철강재가 단가 상승의 절반 이상을 차지
+- 포장재는 규격 통일 뒤 유일하게 단가가 내림
+- 수지류 절감 8억 원은 공급사 두 곳 경쟁 입찰 결과
+- 출처: 예시 기업 구매 시스템 집계(2026년 7~9월)
+```
+
+## Examples
+
+- `examples/01-ops-review-ledger-ko.md`: Korean logistics operations review, 11 slides.
+- `examples/09-status-update-ledger-en.md`: English programme status update, 9 slides.

package/skills/lit-pptx/references/tonalities/night.md

@@ -0,0 +1,148 @@
+# Night
+
+Night is a stage screen in a dark room. A near-black blue ground, off-white type, an amber accent and
+a soft blue second series, light numerals and big charts. It is the only dark pack, and a Night deck
+is dark from cover to closing. Pack file: `templates/tonalities/night/pack.yaml`.
+
+## Use it for
+
+- Data and technical keynotes in a dark hall or on a large stage screen.
+- Data reviews presented to a room: reliability, forecasting, analytics, operations metrics.
+- Demo days and engineering all-hands where charts carry the talk.
+
+## Wrong for
+
+- Anything printed or read on paper: a dark ground wastes toner and loses contrast in print.
+- Decks that mix dark and light slides: Night never mixes.
+- Photo-led showcases: Night lists no image family.
+- Long-form Korean reading briefs: gazette.
+
+## Palette roles
+
+| Role | Colour | Used for |
+|---|---|---|
+| ground | near-black blue `#0F1419` (never pure black) | every slide |
+| surface | dark slate `#1A222B` | table header, rail, panels |
+| ink / ink-muted | off-white `#E8EDF2` / blue-grey `#A3AEBA` | text |
+| line | slate grey `#5A6672` | hairlines |
+| accent | amber `#E3A857` | the highlighted series or figure |
+| accent-deep / accent-tint | pale amber `#F2C98A` / dark umber `#2A2418` | emphasis text / protagonist row and number tint |
+| field / on-field | deep blue slate `#1E2A36` / white | header band, section field |
+| positive / negative | soft green `#6CC08B` / soft coral `#F08A7E` | signed deltas |
+| series | amber, soft blue `#7FB8E0`, blue-grey, lilac | chart series |
+
+## Type
+
+Pretendard throughout. Compact ramp at density 10; display tracks tight (−2). On a
+dark ground thin light type below 18 pt is avoided, which is why Night never uses a light weight.
+
+## Dials
+
+Density 10, variance 6: up to four of its five treatments. For a large keynote hall, density 8
+(body 14 pt) is the usual card move.
+
+## Title treatments by role
+
+| Role | Default treatment |
+|---|---|
+| content | top-plain-large |
+| data | band |
+| data-takeaway | side-rail |
+| sequence | kicker-numeral |
+| image | top-plain-large |
+| statement | statement |
+| reference | band |
+| definition | side-rail |
+
+Treatments: top-plain-large, statement, side-rail, kicker-numeral, band. The band is the deep blue
+slate field across the top. The statement is drawn `open` on the dark ground.
+
+## Families and variants
+
+Families: full-chart, chart-insight, kpi-row, kpi-over-chart, dashboard-grid, big-number, method,
+comparison, timeline, statement.
+
+Covers: cover-numeral (a year in the title or date; the cover device is `numeral`),
+cover-typographic, cover-figures (needs a KPI table in the deck). Sections: section-numeral,
+section-field. Closings: closing-statement, closing-decision-box.
+
+Display devices: cover `numeral`, statement `open`, big number on a tint, closing step in a `band`.
+
+## Tables and charts
+
+- Tables `header-fill`: dark slate header with off-white labels, row rules, no banding, numbers
+  right-aligned, totals bold, the protagonist row tinted umber.
+- Charts: hairline gridlines, direct labels, amber on one series with the rest muted.
+  Charts are drawn native and editable, with the pack's body face named for Hangul axis labels.
+  The amber goes to the current series: the latest period, else the measured series over its plan
+  or target, else the last.
+- Images: no frame.
+- Figures brought in as pictures: a chart or diagram exported on white stands here as a white card
+  with small grey labels. Put its dark variant beside it, named with `.dark` before the extension
+  (`assets/flow.png` and `assets/flow.dark.png`); Night draws the variant at full size, and the gate
+  fails a mostly-white figure on the dark ground (OF-117). Better still, give the numbers as a table
+  and let the engine draw a native chart.
+
+## Decoration vocabulary
+
+header-band, hairline-rule, numeral, rail-fill. No glows, no neon, no saturated gradients.
+
+## Fill behaviour
+
+`fill-order`: anchor-visual, step-up (off at density 10), distribute, change-family. Charts take the
+room first, which suits the pack.
+
+## Writing for Night
+
+- Lead with a KPI row of five figures with basis lines, or a `kpi-over-chart` that puts the trend
+  under the figures.
+- Use `dashboard-grid` with four panels when several small breakdowns belong together (by cause, by
+  severity, by region, by quarter).
+- A `method` slide with a formula reads well under the band treatment (`title: band`): the formula
+  across the top, the terms in two columns. Give it five terms with sub-points.
+- Keep one accent per chart: amber marks the series the slide is about.
+
+## Avoid
+
+- Neon or saturated glows.
+- A pure black ground.
+- Light slides mixed in.
+- Thin light type below 18 pt.
+
+## A sample fragment
+
+```text
+---
+tonality: night
+title: Search ranking quality review 2026
+date: 2026-10-06
+notice: Sample data
+---
+layout: kpi-over-chart
+
+## Ranking quality, January to September
+
+| NDCG@10 | Click-through | Zero-result rate | p95 latency | Queries a day |
+|---|---|---|---|---|
+| 0.612 | 31.4% | 2.1% | 186 ms | 4.8M |
+| was 0.574 | was 28.9% | was 3.6% | target 200 ms | up 12% |
+
+::: chart type=line unit="NDCG@10"
+| Month | New ranker | Old ranker |
+|---|---|---|
+| Jan | 0.578 | 0.574 |
+| Mar | 0.589 | 0.571 |
+| May | 0.597 | 0.569 |
+| Jul | 0.606 | 0.570 |
+| Sep | 0.612 | 0.568 |
+> NDCG@10 on the weekly judged query set (sample data)
+:::
+
+- Source: Example Search offline evaluation, 2,000 judged queries a week
+- Note: NDCG@10 scores the top ten results against human relevance labels
+```
+
+## Examples
+
+- `examples/08-reliability-keynote-night-en.md`: English platform reliability keynote, 9 slides.
+- `examples/11-forecast-review-night-ko.md`: Korean electricity demand forecast review, 8 slides.

package/skills/lit-pptx/references/tonalities/paper.md

@@ -0,0 +1,135 @@
+# Paper
+
+Paper is a journal page projected. Ink on white, hairline rules instead of fills, figures first,
+numbered captions, booktabs tables, and a single deep crimson that always means "the proposed
+method". Pack file: `templates/tonalities/paper/pack.yaml`.
+
+## Use it for
+
+- Research talks, thesis defences, lab meetings and seminars (연구 발표, 학위 심사).
+- Technical reviews built on figures, tables and citations.
+- Written analyses that will be read as a document after the talk.
+
+## Wrong for
+
+- Sales, launch and fundraising audiences: the restraint reads as cold. Use signal or studio.
+- Photo-led showcases: Paper has figure families but no full-bleed image family.
+- Status updates with owners and budgets: ledger.
+
+## Palette roles
+
+| Role | Colour | Used for |
+|---|---|---|
+| ground / surface | white / near-white grey `#F5F5F6` | background, quiet panels |
+| ink / ink-muted | near-black `#111418` / grey `#50565E` | text |
+| line | grey `#C9CDD2` | hairlines, booktabs rules |
+| accent | deep crimson `#8C1C2B` | the proposed method, and nothing else |
+| accent-deep / accent-tint | dark crimson `#5E121C` / pale rose `#F6E6E8` | deep text / rare tint |
+| field / on-field | near-black / white | section field |
+| positive / negative | green `#1E6B3A` / grey `#50565E` | gains; losses in muted ink with their sign |
+| series | crimson, ink, grey, steel blue | charts, in series order |
+
+## Type
+
+Pretendard throughout. Compact ramp at density 10; titles at normal tracking.
+
+## Dials
+
+Density 10, variance 5: up to four of its four treatments.
+
+## Title treatments by role
+
+| Role | Default treatment |
+|---|---|
+| content | top-rule |
+| data | top-rule |
+| data-takeaway | bottom-anchor |
+| sequence | top-rule |
+| image | bottom-anchor |
+| statement | statement |
+| reference | top-rule |
+| definition | side-rail |
+
+Treatments: top-rule, bottom-anchor, side-rail, statement. There is no accent bar: a top-rule title
+always sits on a full-width hairline. A comparison is drawn as a ruled table under a `top-rule` title
+(`structure: comparison: top-rule`), kept even when the deck already leans on that title. Statements, covers and closings are drawn with `rules`:
+hairlines above and below, like a journal title page.
+
+## Families and variants
+
+Families: figure-academic, figure-pair, method, chart-insight, full-chart, table-insight,
+comparison, quote, statement, text-column, references-appendix.
+
+Covers: cover-index (needs an agenda or two or more sections), cover-typographic, cover-split-image
+(needs an image in the deck). Sections: section-rule, section-field. Closings:
+closing-summary-list, closing-ask.
+
+Display devices: cover `rules`, statement `rules`, big number in an `outline`, closing step under
+`rules`, and `index: true`, so section-rule pages show the deck's parts with the current one marked.
+
+## Tables and charts
+
+- Tables in `booktabs` style: no header fill, horizontal rules over and under the header and at
+  the foot only, no vertical rules, no banding, numbers right-aligned, totals bold.
+- Charts: hairline gridlines, direct labels, series in order (the first series takes the crimson,
+  so put the proposed method first).
+- Images: no frame; every figure has a numbered caption from its alt text.
+
+## Decoration vocabulary
+
+hairline-rule, box-outline. Nothing else: no coloured card fills, no short bar under titles.
+
+## Fill behaviour
+
+`fill-order`: anchor-visual, distribute, step-up (off at density 10), change-family. Figures and
+charts take the room first.
+
+## Writing for Paper
+
+- State the research question and scope on a text-column slide of headed points, not on a
+  statement; claims are not titles.
+- Put the proposed method in the first chart series and the first table row so it takes the accent.
+- A method slide lists each fitted term with its range or value and how it was fitted.
+- References: eight to ten entries in one style, sources first; a list too long for the body steps
+  down to label size and then runs in two columns.
+- With two section slides, the cover can be `cover-index` and lists both parts.
+
+## Avoid
+
+- The short accent bar under a title (the rule is a hairline).
+- Coloured card fills.
+- Figures without numbered captions.
+- The accent on anything but the proposed method.
+
+## A sample fragment
+
+```text
+---
+tonality: paper
+title: Membrane fouling in seawater pretreatment
+date: 2026-10-06
+notice: Sample data
+---
+layout: table-insight
+title: bottom-anchor
+
+## Flux decline by pretreatment, 500-hour runs
+
+| Pretreatment | Initial flux (LMH) | Flux at 500 h | Decline | Cleaning cycles |
+|---|---|---|---|---|
+| Proposed coagulation + UF | 62 | 55 | 11% | 2 |
+| UF only | 63 | 44 | 30% | 5 |
+| Media filtration | 58 | 39 | 33% | 6 |
+| Cartridge only | 60 | 31 | 48% | 9 |
+| Untreated feed | 61 | 22 | 64% | 12 |
+
+> Flux decline over 500 hours at 15 °C and 35 g/L salinity (sample data)
+
+- The proposed train keeps flux within 11% of its start value
+- Cleaning cycles fall from five to two against UF alone
+- Source: Example lab pilot skid, runs P-31 to P-35, 2026
+```
+
+## Examples
+
+- `examples/05-research-talk-paper-en.md`: English catalysis research talk, 12 slides.

package/skills/lit-pptx/references/tonalities/signal.md

@@ -0,0 +1,147 @@
+# Signal
+
+Signal is a talk where every slide says one thing at size. A white ground, near-black type set
+large, very few words per slide, and one hot red-orange accent reserved for the protagonist: the
+product, the ask, the figure the room should remember. Pack file:
+`templates/tonalities/signal/pack.yaml`.
+
+## Use it for
+
+- Investor and partner pitches, presented live in 10-15 minutes.
+- Product launches and internal kick-offs where the speaker carries the detail.
+- Proposal decks that must land three or four numbers and one ask.
+
+## Wrong for
+
+- Decks that are read later without the speaker: the large-type rhythm loses the reader. Use
+  ledger or gazette.
+- Table-heavy content: Signal lists `table-insight` but no `ledger-table`, `dashboard-grid` or
+  `references-appendix`.
+- Research talks with citations: paper.
+
+## Palette roles
+
+| Role | Colour | Used for |
+|---|---|---|
+| ground / surface | white / pale zinc `#F4F4F5` | background, quiet panels |
+| ink / ink-muted | near-black violet-grey `#15131A` / grey `#55525C` | text |
+| line | light zinc `#D4D4D8` | hairlines, table rules |
+| accent | red-orange `#C8361A` | the protagonist only |
+| accent-deep / accent-tint | dark rust `#6E1A0C` / pale coral `#FBE7E2` | deep text on tint / table protagonist row |
+| field / on-field | red-orange / white | cover drench, number panel, split field |
+| positive / negative | green `#1E7A3F` / ink | gains in green; losses stay in ink and carry `▼` |
+| series | red-orange, ink, grey, slate blue | chart series |
+
+Because the accent is red, a loss is never red here; write the sign (`▼ 4%`, `−4%`).
+
+## Type
+
+Pretendard throughout; A2Z only on request. Compact ramp at density 10 (body 13, title 26,
+display 36). Display text tracks tighter (−2) than titles (−1).
+
+## Dials
+
+Density 10, variance 6: up to four of its four treatments in one deck. For a large hall, lowering
+density to 8 is a sensible move (record it on the card).
+
+## Title treatments by role
+
+| Role | Default treatment |
+|---|---|
+| content | top-plain-large |
+| data | top-rule |
+| data-takeaway | top-plain-large |
+| sequence | top-rule |
+| image | bottom-anchor |
+| statement | statement |
+| reference | top-rule |
+| definition | top-rule |
+
+Treatments: statement, top-plain-large, bottom-anchor, top-rule. Its top-rule draws a hairline
+(the pack has no accent bar). The statement is drawn `open`: the sentence on the white ground, no
+plate.
+
+## Families and variants
+
+Families: statement, big-number, image-split, asymmetric-feature, process, kpi-row, chart-insight,
+full-chart, comparison, table-insight, quote.
+
+Covers: cover-numeral (a year in the title or date), cover-typographic (drawn with the `drench`
+device: the field over the whole page, title anchored low), cover-split-field. Sections:
+section-field, section-numeral. Closings: closing-statement (no table or image), closing-ask.
+
+Display devices: cover `drench`, statement `open`, big number on a `field` panel, closing step in a
+`band`.
+
+## Tables and charts
+
+- Tables `open`: no header fill, rules at top and bottom only, no banding, numbers right-aligned,
+  totals bold, and the protagonist row tinted pale coral.
+- Charts: no gridlines, direct labels, the accent on one series and the rest muted.
+- Images: no frame.
+
+## Decoration vocabulary
+
+colour-field, hairline-rule, numeral. No cards at all, no accent bar under titles.
+
+## Fill behaviour
+
+`fill-order`: step-up (off at density 10), change-family, anchor-visual, distribute. A short Signal
+slide is a cue to pick a family that suits one idea (statement, big-number) rather than to stretch
+a list.
+
+## Writing for Signal
+
+- One idea per slide, but the idea still has its basis: a big-number slide carries the basis row and
+  three evidence lines; a KPI row carries five figures with their comparisons.
+- A mid-deck statement slide needs its one support line, or the composition check reports the
+  page as nearly empty.
+- Keep bullet lists to four items; Signal's own avoid list says so.
+- Two lines of display text at most per title.
+
+## Avoid
+
+- Red for losses (losses carry `▼` in ink).
+- More than two lines of display text.
+- Cards.
+- Bullet lists longer than four items.
+
+## A sample fragment
+
+```text
+---
+tonality: signal
+title: Fieldbook 2027 launch plan
+date: 2026-10-06
+notice: Sample data
+---
+layout: statement
+
+# Site notes that file themselves
+
+Photos, voice notes and measurements tagged to the drawing in under ten seconds
+---
+layout: big-number
+
+## Time spent on site reports, before and after
+
+| Report time | Rework requests | Photos filed | Adoption |
+|---|---|---|---|
+| 14 min | −61% | 98% | 83% |
+| per visit, was 52 | after 3 months | to the right drawing | of pilot engineers |
+
+- Pilot across 9 contractors and 140 engineers, May-September 2026
+- Most time saved on matching photos to drawing references
+- Source: Example Fieldbook pilot log, 2026
+---
+layout: closing-statement
+
+## 400 sites by the end of 2027
+
+Seed round of 3M USD, first close 15 December
+```
+
+## Examples
+
+- `examples/02-launch-pitch-signal-en.md`: English hardware launch pitch, 10 slides.
+- `examples/10-investor-pitch-signal-ko.md`: Korean software investor pitch, 9 slides.