@litfamily/litcodex 1.0.14 → 1.0.16

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 (122) hide show
  1. package/README-Ko-KR.md +10 -10
  2. package/README.md +10 -10
  3. package/dist/install/generated-skill-payload-hashes.d.ts +101 -40
  4. package/dist/install/generated-skill-payload-hashes.js +101 -40
  5. package/marketplace/plugins/litcodex/.codex-plugin/plugin.json +1 -1
  6. package/marketplace/plugins/litcodex/components/auto-update/package.json +1 -1
  7. package/marketplace/plugins/litcodex/components/comment-checker/package.json +1 -1
  8. package/marketplace/plugins/litcodex/components/git-bash/package.json +1 -1
  9. package/marketplace/plugins/litcodex/components/lit-loop/dist/auto-handoff.js +11 -7
  10. package/marketplace/plugins/litcodex/components/lit-loop/package.json +1 -1
  11. package/marketplace/plugins/litcodex/components/lsp/package.json +1 -1
  12. package/marketplace/plugins/litcodex/components/rules/package.json +1 -1
  13. package/marketplace/plugins/litcodex/components/start-work-continuation/package.json +1 -1
  14. package/marketplace/plugins/litcodex/components/telemetry/package.json +1 -1
  15. package/marketplace/plugins/litcodex/components/wikify-knowledge/package.json +1 -1
  16. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/THIRD-PARTY-NOTICE.txt +0 -2
  17. package/marketplace/plugins/litcodex/skills/lit-docx/SKILL.md +16 -12
  18. package/marketplace/plugins/litcodex/skills/lit-docx/references/components.md +113 -0
  19. package/marketplace/plugins/litcodex/skills/lit-docx/references/direction-step.md +164 -0
  20. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/01-report-ko.md +95 -0
  21. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/02-brief-ko.md +45 -0
  22. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/03-manual-ko.md +105 -0
  23. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/04-proposal-ko.md +97 -0
  24. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/05-memo-en.md +34 -0
  25. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/06-journal-en.md +89 -0
  26. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/07-report-en.md +101 -0
  27. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/08-proposal-en.md +94 -0
  28. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/09-memo-ko.md +34 -0
  29. package/marketplace/plugins/litcodex/skills/lit-docx/references/page-composition.md +141 -0
  30. package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/brief.md +70 -0
  31. package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/journal.md +73 -0
  32. package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/manual.md +70 -0
  33. package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/memo.md +75 -0
  34. package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/proposal.md +71 -0
  35. package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/report.md +83 -0
  36. package/marketplace/plugins/litcodex/skills/lit-docx/scripts/convert_md_to_docx.py +401 -58
  37. package/marketplace/plugins/litcodex/skills/lit-docx/scripts/docx_craft.py +124 -1
  38. package/marketplace/plugins/litcodex/skills/lit-docx/scripts/docx_design.py +2446 -0
  39. package/marketplace/plugins/litcodex/skills/lit-docx/scripts/docx_layout.py +960 -0
  40. package/marketplace/plugins/litcodex/skills/lit-docx/scripts/slop_lint.py +21 -6
  41. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/brief.yaml +28 -0
  42. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/journal.yaml +26 -0
  43. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/manual.yaml +26 -0
  44. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/memo.yaml +27 -0
  45. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/proposal.yaml +27 -0
  46. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/report.yaml +27 -0
  47. package/marketplace/plugins/litcodex/skills/lit-pptx/SKILL.md +12 -11
  48. package/marketplace/plugins/litcodex/skills/lit-pptx/pretendard-font/public/static/Pretendard-Bold.otf +0 -0
  49. package/marketplace/plugins/litcodex/skills/lit-pptx/pretendard-font/public/static/Pretendard-Regular.otf +0 -0
  50. package/marketplace/plugins/litcodex/skills/lit-pptx/references/anti-slop-checklist.md +33 -29
  51. package/marketplace/plugins/litcodex/skills/lit-pptx/references/authoring-guide.md +11 -2
  52. package/marketplace/plugins/litcodex/skills/lit-pptx/references/density-and-fill.md +179 -0
  53. package/marketplace/plugins/litcodex/skills/lit-pptx/references/design-system-azure.md +1 -1
  54. package/marketplace/plugins/litcodex/skills/lit-pptx/references/direction-step.md +203 -0
  55. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/01-pitch-signal-ko.md +185 -0
  56. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/02-pitch-studio-en.md +162 -0
  57. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/03-business-review-ledger-ko.md +229 -0
  58. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/04-research-talk-paper-en.md +212 -0
  59. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/05-research-keynote-night-ko.md +191 -0
  60. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/06-lecture-chalk-ko.md +175 -0
  61. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/07-data-review-night-en.md +241 -0
  62. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/08-field-report-atlas-ko.md +168 -0
  63. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/09-briefing-gazette-ko.md +219 -0
  64. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/10-status-update-ledger-en.md +157 -0
  65. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/11-portfolio-studio-ko.md +183 -0
  66. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/12-tutorial-chalk-en.md +176 -0
  67. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/13-status-update-gazette-ko.md +157 -0
  68. package/marketplace/plugins/litcodex/skills/lit-pptx/references/interview-protocol.md +1 -1
  69. package/marketplace/plugins/litcodex/skills/lit-pptx/references/layout-families.md +210 -0
  70. package/marketplace/plugins/litcodex/skills/lit-pptx/references/title-treatments.md +146 -0
  71. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/atlas.md +113 -0
  72. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/chalk.md +115 -0
  73. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/gazette.md +118 -0
  74. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/ledger.md +129 -0
  75. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/night.md +126 -0
  76. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/paper.md +109 -0
  77. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/signal.md +121 -0
  78. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/studio.md +111 -0
  79. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/compile-deck.js +65 -17
  80. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/craft_extras.py +654 -11
  81. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/embed_fonts.py +1 -1
  82. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/inventory.py +32 -2
  83. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/directive-parser.js +2 -2
  84. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/grid-resolver.js +521 -0
  85. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/layout-resolver.js +401 -16
  86. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/markdown-loader.js +6 -4
  87. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/render-adapter-html.js +2 -2
  88. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/render-adapter-pptx.js +498 -145
  89. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/render-pack.js +3558 -0
  90. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/slide-ast.js +54 -6
  91. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/template-registry.js +335 -11
  92. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/office-run.mjs +2 -1
  93. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/qa_deck.py +99 -19
  94. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/validate_pptx.py +6 -1
  95. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/boilerplate_professional.css +6 -6
  96. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/enrolled/AZURE-A2Z/layout-mapping.yaml +1 -1
  97. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/enrolled/AZURE-A2Z/template.yaml +4 -1
  98. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/enrolled/AZURE-PRO/layout-mapping.yaml +1 -1
  99. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/enrolled/AZURE-PRO/template.yaml +4 -1
  100. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/atlas/pack.yaml +105 -0
  101. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/chalk/pack.yaml +110 -0
  102. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/gazette/pack.yaml +105 -0
  103. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/ledger/pack.yaml +106 -0
  104. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/night/pack.yaml +106 -0
  105. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/paper/pack.yaml +111 -0
  106. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/signal/pack.yaml +107 -0
  107. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/studio/pack.yaml +105 -0
  108. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/THIRD_PARTY_NOTICES +1 -1
  109. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/fonts.mjs +6 -6
  110. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/gate.mjs +1 -1
  111. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/stage-qa.mjs +2 -2
  112. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/runtime.md +1 -1
  113. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/stage.md +1 -1
  114. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/style-bibles.md +2 -2
  115. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/treatment.md +1 -1
  116. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/type-and-timing.md +3 -3
  117. package/node_modules/@litcodex/lit-loop/dist/auto-handoff.js +11 -7
  118. package/node_modules/@litcodex/lit-loop/package.json +1 -1
  119. package/package.json +2 -2
  120. package/readme-assets/badge-version.svg +1 -1
  121. package/marketplace/plugins/litcodex/skills/lit-pptx/pretendard-font/public/static/PretendardGOV-Bold.otf +0 -0
  122. package/marketplace/plugins/litcodex/skills/lit-pptx/pretendard-font/public/static/PretendardGOV-Regular.otf +0 -0
@@ -0,0 +1,101 @@
1
+ ---
2
+ title: Customer support quarterly review, Q3 2026
3
+ subtitle: Contact volume, response times and the causes of repeat contacts
4
+ author: Example Support Operations
5
+ organization: Example Org
6
+ date: 2026-10-09
7
+ short_title: Support review Q3 2026
8
+ notice: "Sample report: teams, volumes and figures are examples"
9
+ tonality: Report
10
+ ---
11
+
12
+ # Summary
13
+
14
+ Customer contacts rose to 48,300 in the third quarter, 6 percent more than in the second, while the median first response time improved from 4.2 to 3.1 hours. The improvement came almost entirely from the chat channel after the September staffing change; email response times did not move. One contact in five was a repeat contact about the same issue within seven days, and half of those repeats traced back to three causes: unclear refund status, password resets that failed on the first attempt, and delivery updates that arrived late.
15
+
16
+ ::: keyfigures
17
+ - **48,300** contacts in Q3 (sample)
18
+ - Q2: 45,600
19
+ - **3.1 hours** median first response (sample)
20
+ - Q2: 4.2 hours
21
+ - **21%** repeat contacts within 7 days (sample)
22
+ - Q2: 22%
23
+ :::
24
+
25
+ The review covers volume, response times and repeat contacts in turn, and ends with three changes proposed for the fourth quarter.
26
+
27
+ # Contact volume
28
+
29
+ ## Volume by channel
30
+
31
+ Chat overtook email as the largest channel in August and stayed ahead in September. Phone volume fell slightly, continuing the trend of the past year.
32
+
33
+ Table 1. Contacts by channel (thousands, sample data)
34
+
35
+ | Channel | Q2 | Q3 | Change (%) |
36
+ | --- | ---: | ---: | ---: |
37
+ | Email | 19.8 | 18.9 | -4.5 |
38
+ | Chat | 16.1 | 20.4 | 26.7 |
39
+ | Phone | 7.9 | 7.4 | -6.3 |
40
+ | Social media | 1.8 | 1.6 | -11.1 |
41
+ | Total | 45.6 | 48.3 | 5.9 |
42
+
43
+ Source: support ticketing system, contacts opened 1 April to 30 September 2026
44
+
45
+ ## Volume by topic
46
+
47
+ Orders and delivery remained the largest topic at 38 percent of contacts. Account access rose from 14 to 17 percent after the login change of 22 July, which required every customer to confirm their email address once.
48
+
49
+ # Response times
50
+
51
+ ## First response
52
+
53
+ The median first response fell from 4.2 to 3.1 hours. Chat answered within 9 minutes at the median, compared with 21 minutes in the second quarter, after two agents moved from email to chat on 1 September. Email stayed at about 7 hours.
54
+
55
+ Table 2. Median first response time by channel (sample data)
56
+
57
+ | Channel | Q2 | Q3 | Target |
58
+ | --- | ---: | ---: | ---: |
59
+ | Email (hours) | 7.1 | 7.0 | 6.0 |
60
+ | Chat (minutes) | 21 | 9 | 10 |
61
+ | Phone (minutes) | 4.5 | 4.8 | 5.0 |
62
+
63
+ Source: support ticketing system and telephony logs
64
+
65
+ ## Resolution
66
+
67
+ Resolution within one working day held at 72 percent. Contacts about refunds took longest, at a median of 2.4 days, because agents waited for payment confirmations from the finance system.
68
+
69
+ # Repeat contacts
70
+
71
+ ## Causes
72
+
73
+ One in five customers contacted support again about the same issue within seven days. A sample review of 600 repeat contacts found three causes behind half of them.
74
+
75
+ ::: columns 2
76
+ ### Refund status
77
+
78
+ Customers asked again because the refund confirmation email did not say when the money would arrive. These made up 22 percent of reviewed repeats.
79
+
80
+ ### Password resets
81
+
82
+ The reset link expired after 15 minutes, and many customers opened it later. These made up 17 percent.
83
+
84
+ <!-- column-break -->
85
+
86
+ ### Late delivery updates
87
+
88
+ Tracking pages updated once a day, so customers who asked in the morning saw no change. These made up 12 percent.
89
+
90
+ ### Other causes
91
+
92
+ The remaining half spread over more than thirty causes, none above 4 percent of reviewed repeats.
93
+ :::
94
+
95
+ ::: callout kind=key title="Proposed changes for Q4"
96
+ 1. Add the expected arrival date to refund confirmation emails. 2. Extend password reset links to 60 minutes. 3. Ask the carrier for tracking updates every four hours. The three changes target about half of repeat contacts.
97
+ :::
98
+
99
+ # Next review
100
+
101
+ The fourth-quarter review will report repeat contacts for each of the three causes separately, so that the effect of each change can be seen. Email response time remains above target and will be reviewed with the staffing plan for January.
@@ -0,0 +1,94 @@
1
+ ---
2
+ title: Shared tool library for the maintenance teams
3
+ subtitle: A one-year pilot at the central workshop
4
+ author: Example Facilities Department
5
+ organization: Example Org
6
+ date: 2026-10-21
7
+ short_title: Shared tool library pilot
8
+ notice: "Sample proposal: teams, costs and figures are examples"
9
+ tonality: Proposal
10
+ ---
11
+
12
+ ::: cover variant=typographic kicker="Proposal"
13
+ A proposal to pool the specialist tools now held separately by four maintenance teams into one library at the central workshop, run as a one-year pilot from February 2027.
14
+ :::
15
+
16
+ # Proposal overview
17
+
18
+ The electrical, plumbing, carpentry and grounds teams each buy and store their own specialist tools. An inventory in September 2026 counted 412 tools worth about 186,000 in purchase value (sample figures), of which 141 were used fewer than five times in the past year. Expensive items are duplicated: three core drills, two pipe-threading machines, four thermal cameras.
19
+
20
+ ::: keyfigures
21
+ - **141 tools** used fewer than five times a year (sample)
22
+ - of 412 in the September 2026 inventory
23
+ - **38,000** purchases avoided over two years (sample)
24
+ - duplicate items not replaced when they wear out
25
+ - **14 months** payback of the pilot cost (sample)
26
+ - pilot cost 44,000 against avoided purchases
27
+ :::
28
+
29
+ The library would lend the specialist tools from one place through a simple booking system and keep them calibrated; hand tools stay with the teams.
30
+
31
+ ::: callout kind=key title="Decision requested"
32
+ Approval at the November planning meeting for a pilot budget of 44,000 (sample) and a start date of 1 February 2027, with a review at the end of the pilot year.
33
+ :::
34
+
35
+ # Current situation
36
+
37
+ ## Tool holdings by team
38
+
39
+ Each team keeps its own store room and replacement budget, so a technician who needs another team's tool often hires one instead.
40
+
41
+ Table 1. Specialist tools by team, September 2026 (sample data)
42
+
43
+ | Team | Tools | Purchase value | Used under 5 times | Hired in last year |
44
+ | --- | ---: | ---: | ---: | ---: |
45
+ | Electrical | 128 | 64,000 | 39 | 11 |
46
+ | Plumbing | 96 | 47,000 | 34 | 8 |
47
+ | Carpentry | 112 | 41,000 | 42 | 6 |
48
+ | Grounds | 76 | 34,000 | 26 | 9 |
49
+ | Total | 412 | 186,000 | 141 | 34 |
50
+
51
+ Source: facilities asset register and team store counts, September 2026
52
+
53
+ ## Costs of the current arrangement
54
+
55
+ Duplicate purchases are the largest cost: of 52 specialist tools replaced in three years, 19 duplicated an item another team held in working order. Hire charges for tools in another team's store came to about 7,500 last year, and two of the four thermal cameras were past their calibration date.
56
+
57
+ # Pilot design
58
+
59
+ ## Library operation
60
+
61
+ The library occupies the unused stores room at the central workshop. A part-time coordinator issues and checks tools and arranges calibration and repairs. Technicians book through a new screen in the existing work-order system; urgent requests can be collected without a booking during workshop hours.
62
+
63
+ ## Budget
64
+
65
+ Table 2. Pilot budget for one year (sample data)
66
+
67
+ | Item | Detail | Cost |
68
+ | --- | --- | ---: |
69
+ | Coordinator | Part-time, 12 months | 24,000 |
70
+ | Shelving and racks | Stores room fit-out | 8,500 |
71
+ | Booking screen | Work-order system change | 6,000 |
72
+ | Calibration catch-up | Instruments past due date | 3,200 |
73
+ | Labels and tags | Asset tags for all tools | 1,100 |
74
+ | Contingency | About 3 percent | 1,200 |
75
+ | Total | | 44,000 |
76
+
77
+ Note: costs are mid-range quotes from September 2026 and include tax.
78
+
79
+ ## Timeline
80
+
81
+ Table 3. Pilot timeline (sample data)
82
+
83
+ | When | Step | Owner |
84
+ | --- | --- | --- |
85
+ | November 2026 | Approval | Facilities manager |
86
+ | December 2026 | Stores room fit-out, booking screen | Workshop, IT |
87
+ | January 2027 | Tool transfer and tagging | Four team leads |
88
+ | February 2027 | Library opens | Coordinator |
89
+ | July 2027 | Mid-pilot review | Facilities manager |
90
+ | January 2028 | Final review and decision | Facilities manager |
91
+
92
+ # Risks and responses
93
+
94
+ Teams may worry that a tool will not be available when they need it. The pilot keeps one of each frequently used specialist tool with the team that uses it most, and the coordinator reports waiting times monthly. If the median wait for any tool exceeds one working day, a second unit returns to team use.
@@ -0,0 +1,34 @@
1
+ ---
2
+ title: 회의실 예약 방식 변경 안내
3
+ subtitle: 11월부터 적용하는 예약 시간 단위와 노쇼 처리
4
+ author: 예시 기업 경영지원팀
5
+ organization: 예시 기업
6
+ date: 2026-10-22
7
+ short_title: 회의실 예약 방식 변경
8
+ notice: "예시 데이터: 인원·수치는 모두 가정입니다"
9
+ tonality: Memo
10
+ ---
11
+
12
+ ::: cover variant=masthead kicker="안내"
13
+ 수신: 본사 전 직원 · 발신: 경영지원팀 · 제목: 회의실 예약 시간 단위와 노쇼 처리 변경
14
+ :::
15
+
16
+ # 변경 내용
17
+
18
+ 2026년 11월 3일(월)부터 본사 회의실 12곳의 예약 시간 단위를 1시간에서 30분으로 줄이고, 예약 시각 10분이 지나도록 아무도 입실 확인을 하지 않으면 예약을 자동으로 풀어 다른 사람이 쓸 수 있게 한다. 예약 화면과 회의실 앞 태블릿은 그대로 쓴다.
19
+
20
+ # 변경 배경
21
+
22
+ 3분기 예약 기록을 보면 회의실 예약의 23%가 실제로 쓰이지 않았고, 쓰인 예약도 절반 가까이가 예약 시간보다 일찍 끝났다. 회의실을 찾지 못해 자리에서 화상 회의를 하는 경우가 늘었다는 의견도 많았다. 30분 단위 예약과 자동 해제를 함께 적용하면, 같은 회의실로 하루 평균 9건 정도의 회의를 더 받을 수 있을 것으로 본다.
23
+
24
+ # 직원이 할 일
25
+
26
+ 회의를 시작할 때 회의실 앞 태블릿에서 '입실 확인'을 누른다. 예약자 본인이 아니어도 참석자 누구나 누를 수 있다. 회의가 일찍 끝나면 '회의 종료'를 눌러 남은 시간을 돌려준다. 반복 예약은 11월 3일 이후 일정이 30분 단위로 자동 변환되므로 따로 다시 잡을 필요가 없다.
27
+
28
+ # 예외
29
+
30
+ 임원 회의실 두 곳과 교육장은 이번 변경에서 빠진다. 외부 손님이 참석하는 회의는 예약할 때 '손님 회의'를 표시하면 자동 해제 시간이 20분으로 늘어난다.
31
+
32
+ # 문의
33
+
34
+ 변경 내용에 대한 문의는 10월 31일까지 경영지원팀 메일로 보내 주기 바란다. 첫 2주 동안은 태블릿 사용법을 안내하는 직원이 층마다 점심시간에 한 명씩 있다.
@@ -0,0 +1,141 @@
1
+ # Page composition
2
+
3
+ How a tonality page is measured, what the converter does without being asked, what the gate
4
+ measures on the rendered pages, and how to fix each finding from the source.
5
+
6
+ ## The page
7
+
8
+ | Token | Value | Why |
9
+ | --- | --- | --- |
10
+ | Paper | A4 | institute and government reports print on A4 |
11
+ | Side margins | 25 mm | a text block of about 160 mm keeps Korean lines near 40 syllables at 10.5 pt |
12
+ | Bottom margin | never smaller than the top | the page stands on its foot |
13
+ | Body | Pretendard 10.5 pt (Memo and Proposal English 11 pt) | institute body size |
14
+ | Heading ramp | h1 1.3-1.4 × body, h2 1.15-1.2 ×, h3 = body bold | separation by weight and space, not size jumps |
15
+ | Space | above a heading about twice the space below it | the heading belongs to what follows |
16
+ | Colour | near-black ink; one accent on at most two element kinds | restraint |
17
+
18
+ The density dial (1-10, pack default 8 or 9) scales margins, leading and body size within these
19
+ bounds. The skill may move it by at most 2 without asking and says so in the card.
20
+
21
+ ## Leading, calibrated by render
22
+
23
+ Pretendard's single line is tall: measured at about 1.55 em in Word and 1.51 em in LibreOffice,
24
+ mean 1.53 em. A Word "multiple" spacing is therefore a multiple of that, not of the font size.
25
+ The converter sets the multiple as the wanted pitch divided by 1.53:
26
+
27
+ | Text | Wanted pitch | Multiple written | Rendered pitch |
28
+ | --- | --- | --- | --- |
29
+ | Korean body | about 174 % of the size | about 1.14 | 172-177 % |
30
+ | Latin body | about 131-133 % | about 0.86 | 130-134 % |
31
+ | Table cells | tighter by one step | per pack | — |
32
+
33
+ Setting Hangul at 200 % or more (a common reflex) produces the loose, airy page that reads as
34
+ generated. Korean paragraphs are justified in Report, Brief, Proposal and Memo; Word gets
35
+ `w:wordWrap` on and the ko-KR language tag so it breaks Hangul between 어절. LibreOffice previews
36
+ may still break inside a word; Word does not.
37
+
38
+ ## What the converter does on its own
39
+
40
+ - Keeps every heading with the next paragraph, and a closing paragraph of up to about four lines with
41
+ the paragraph above, so the last page never holds one orphaned paragraph.
42
+ - Keeps a list of up to six items together (every item but the last keeps with the next), with a
43
+ lead-in of a line or two right before it ("다음 단계는 아래와 같다."). In a two-column body a list of
44
+ five or six items keeps its lead-in with its first two items and its last two items together, and may
45
+ break once between them, so the block does not jump to the next column and empty a third of the one before.
46
+ - Keeps the last section of a single-column document whole when it has no table or picture and runs to
47
+ about twelve lines or fewer, so its paragraph goes to the last page with its list.
48
+ - In a two-column body, spans a `자료:` or `Source:` line with its page-wide table, so the heading after it
49
+ opens the column section with its text, and ends the columns with a continuous break so the last page
50
+ balances them (the last paragraph may break across the two columns).
51
+ - Keeps a heading whose first paragraph opens a table with that table (caption and units line too), so
52
+ the heading and its sentence never wait at a page foot.
53
+ - Sets a source of about one page (by its own estimate) with tight spacing in any tonality, as a memo
54
+ is, so it does not spill a few lines onto a second page.
55
+ - Draws no second rule when a section that opens under a hairline follows a ruled box.
56
+ - Lets sections run on: no page break before an h1 unless the source asks for one.
57
+ - Sizes table columns to their longest word and content; never narrower than the longest word. A
58
+ text column that wraps while the others hold their longest cell with room to spare takes that room
59
+ when it is enough to set its longest cell on one line.
60
+ - Writes negative figures in tables with the minus sign (−), Korean tables too, and keeps 6 pt under a
61
+ sentence right above a table that has no caption.
62
+ - Under a publisher profile, stands the paragraph after a table three quarters of a body line clear and
63
+ a paragraph after a list 6 pt clear, and keeps a list of up to six items together.
64
+ - Keeps a table that fits on one page whole, with its caption and source lines; a long table (a
65
+ header and six or more body rows) may break between rows with the header repeated, three body
66
+ rows at least on each side.
67
+ - Converts ISO dates in Korean text to `2026. 10. 8.` form before typesetting.
68
+ - Prints the frontmatter `notice:` once (title block or cover line), never as a coloured chip in
69
+ every header.
70
+ - Restarts numbered lists after a heading; spaces a bold-lead list item from its text.
71
+
72
+ ## What the gate measures
73
+
74
+ `docx_craft.py` is the lit-docx gate. Run through the office runner:
75
+
76
+ ```bash
77
+ node <lit-pptx>/scripts/office-run.mjs docx qa out.docx --source draft.md --layout
78
+ node <lit-pptx>/scripts/office-run.mjs docx qa out.docx --source draft.md --compare other-tonality.docx
79
+ ```
80
+
81
+ Always (from the Word file):
82
+
83
+ | Check | Fails when |
84
+ | --- | --- |
85
+ | content | a source heading did not reach the document, a blank such as [금액] or TBD is left, or frontmatter is printed as text |
86
+ | `heading.declarative` | the title, subtitle or a heading is a sentence |
87
+ | `heading.order` | a level is skipped downward, or the first heading is below h2 |
88
+ | `date.iso` | an ISO date remains in Korean text (every path) |
89
+ | `notice.dash` | the frontmatter notice joins its label and line with a spaced dash instead of a colon (`예시 데이터: …`); FAIL on a tonality document, advice on the plain and publisher paths |
90
+ | OF-302 | a numeric table column is not right-aligned |
91
+
92
+ On a tonality document (restraint):
93
+
94
+ | Check | Fails when |
95
+ | --- | --- |
96
+ | `color.accent-kinds` | more than one non-ink hue, or the accent on more than two element kinds |
97
+ | `heading.ink` | a heading is set in a colour |
98
+ | `heading.ratio` | h1 is more than 1.5 × the body size |
99
+ | `table.fill` | a data cell is shaded, or a component tint is darker than L 95 % |
100
+ | `component.budget` | more than 3 kinds, more than 1 key-figure strip, any pull quote, or figures on the cover |
101
+ | `furniture.chip` | a coloured or shaded notice sits in a page header |
102
+
103
+ With `--layout` (rendered through soffice in a private profile):
104
+
105
+ | Check | Fails when |
106
+ | --- | --- |
107
+ | `fill.page` | a body page is filled under 35 % (cover and last page excepted) |
108
+ | `heading.stranded` | a page ends on a heading |
109
+ | `page.spill` | a two-page document fills its second page under 40 %, or a document ends on a page filled under an eighth (a paragraph or two) |
110
+ | `list.split` | a list of up to six items runs over two pages or columns (one break of a five- or six-item list in a column, two items or more each side, is allowed) |
111
+ | `heading.apart` | a heading and its lead sentence end a page while the table they open starts the next |
112
+ | `heading.column` | in a two-column body a heading ends a column while its first lines open the next |
113
+ | `columns.balance` | in a two-column body a column stops a quarter of the frame short (under 75 %) beside one that runs to the foot, or the last page sets one column under half the depth of the other |
114
+ | `heading.wrap`, `title.lines` | a heading breaks inside a word, or the title takes more than three lines |
115
+ | `table.split`, `figure.split` | a table that fits splits, a component box splits, or a picture leaves its caption |
116
+ | `component.variety` | a document of four or more pages uses fewer than two component kinds (Memo excepted) |
117
+ | `cover.block` | a filled shape covers more than a quarter of the cover |
118
+ | `sidebar.overlap`, `folio.total` | a sidebar runs into the next heading; a page / total folio miscounts |
119
+
120
+ With `--compare`: `tonality.structure` fails when two tonalities of one source differ in fewer
121
+ than three of title block, summary form, numbering, component set, running head and contents.
122
+
123
+ ## Fixing findings from the source
124
+
125
+ | Finding | Fix |
126
+ | --- | --- |
127
+ | Short page before a large table | move a paragraph that discusses the table above it, or split a long table at a natural group |
128
+ | Stranded heading | give the section a lead paragraph; never insert empty lines |
129
+ | Near-empty last page (`page.spill`) | cut the lines that spill or give the last page a whole section; never shrink type |
130
+ | Dashed notice (`notice.dash`) | write it as a label and its line: `notice: "예시 데이터: 수치는 가정입니다"` |
131
+ | Table split | shorten the table (move detail rows to an appendix table) or let it qualify as a long table |
132
+ | Sentence heading | rewrite as a label; move the claim into the first sentence of the section |
133
+ | Too few component kinds | a key-figure strip under the summary or a decision callout, each with a purpose; or accept the advisory when the document is a plain procedure |
134
+ | Budget exceeded | drop the component with the weakest purpose line |
135
+
136
+ ## Numbers on the page
137
+
138
+ Key figures are set at most at h2 size, each with its basis. Units go in captions or column heads
139
+ (`(단위: 천 권)`), not repeated in every cell. Negative changes are written with a minus sign; in
140
+ government 개조식 the triangle △ is the convention and may be used consistently. Percentages keep
141
+ one decimal only where the source does.
@@ -0,0 +1,70 @@
1
+ # Brief
2
+
3
+ Brief is the briefing for one decision. The reader may read only the first page, so the
4
+ request comes first and the evidence follows in as few pages as the decision allows. It is short
5
+ on purpose and plain on purpose.
6
+
7
+ ## Choose it when
8
+
9
+ - A decision for one meeting or one person, with supporting facts that fit in one to three pages.
10
+ - A 검토 보고 that must say yes or no to one option.
11
+ - An update whose reader needs the conclusion before the background.
12
+
13
+ ## Choose something else when
14
+
15
+ - Several decisions or a long evidence base: use Report.
16
+ - A notice with no decision: use Memo.
17
+ - A plan with a budget table at its centre: use Proposal.
18
+
19
+ ## Structure it builds
20
+
21
+ - Page 1: compact masthead, then the decision request as a `key` callout directly under it.
22
+ - Summary as numbered points: each a bold lead sentence, then one or two plain sentences.
23
+ - Unnumbered sections, each opening under a full-width hairline.
24
+ - One table at most per section; one box in the whole document.
25
+ - Footer: folio only.
26
+
27
+ Components: callout `key` (the decision request, once), columns for two options side by side.
28
+
29
+ ## Tokens (from `templates/tonalities/brief.yaml`)
30
+
31
+ | Token | Value |
32
+ | --- | --- |
33
+ | Dials | density 9, variance 3 |
34
+ | Body | Pretendard 10.5 pt (Korean), Pretendard 10.5 pt (Latin) |
35
+ | Heading ramp | h1 1.3 ×, h2 1.15 ×, title 2.5 × body |
36
+ | Numbering | none |
37
+ | Page 1 | masthead |
38
+ | Summary form | points |
39
+ | Running head | footer: folio, folio_align: right |
40
+ | Columns | 1 |
41
+ | Accent | 2D5A47 on title_rule, callout_rule |
42
+ | Allowed components | callout, columns |
43
+
44
+ Every tonality shares the restraint rules: ink headings, booktabs tables without fills, A4 with
45
+ 25 mm sides, leading calibrated from Pretendard's 1.53 em single line, the notice printed once.
46
+
47
+ ## Worked source
48
+
49
+ ```markdown
50
+ ::: callout kind=key title="결정 요청"
51
+ 11월 경영회의에서 동부 2개 노선 통합을 승인해 주기를 요청한다.
52
+ :::
53
+
54
+ # 핵심 요약
55
+
56
+ 1. **동부 2개 노선은 합쳐도 좌석이 남는다.** 출근 평균 탑승은 합계 61명이다.
57
+ 2. **통합으로 연간 약 5,800만 원을 아낀다.** 위탁 운행 단가 기준이다.
58
+ ```
59
+
60
+ ## Do
61
+
62
+ - Write the request so it can be approved as written: what, how much, by when.
63
+ - Make each lead sentence a finding a reader can repeat.
64
+ - Cut background the decision does not need.
65
+
66
+ ## Avoid
67
+
68
+ - A cover page or a contents list.
69
+ - More than four summary points.
70
+ - Boxes beyond the one decision callout.
@@ -0,0 +1,73 @@
1
+ # Journal
2
+
3
+ Journal is for long-form reading set in two columns: essays, newsletters, white papers and
4
+ research summaries that are not bound for a named journal (those use a publisher profile). Its
5
+ pages look like a printed paper: a title block with authors, abstract and keywords, then
6
+ continuous text.
7
+
8
+ ## Choose it when
9
+
10
+ - A continuous argument with an abstract, sections and references.
11
+ - A research summary or white paper for a general professional reader.
12
+ - Text that will be cross-referenced by section number.
13
+
14
+ ## Choose something else when
15
+
16
+ - A submission to Elsevier, ACS, IEEE or Nature: use `--publisher`.
17
+ - Tables carrying most of the content: use Report.
18
+ - A plan asking for approval: use Proposal.
19
+
20
+ ## Structure it builds
21
+
22
+ - Page 1: masthead title block with authors, abstract and keywords from the frontmatter.
23
+ - Two columns, ragged right; Latin text in Times New Roman, Hangul and headings in Pretendard.
24
+ - Decimal section numbers for cross-references.
25
+ - Tables span the column; captions above (Table n.), sources below.
26
+ - Header: short title and folio.
27
+
28
+ Components: callout `note` at most, used rarely; no key figures, no sidebar.
29
+
30
+ ## Tokens (from `templates/tonalities/journal.yaml`)
31
+
32
+ | Token | Value |
33
+ | --- | --- |
34
+ | Dials | density 9, variance 6 |
35
+ | Body | Pretendard 10.5 pt (Korean), Times New Roman 10.5 pt (Latin) |
36
+ | Heading ramp | h1 1.3 ×, h2 1.15 ×, title 2.5 × body |
37
+ | Numbering | decimal |
38
+ | Page 1 | masthead |
39
+ | Summary form | prose |
40
+ | Running head | header: title+folio |
41
+ | Columns | 2 |
42
+ | Accent | none (ink only) |
43
+ | Allowed components | callout |
44
+
45
+ Every tonality shares the restraint rules: ink headings, booktabs tables without fills, A4 with
46
+ 25 mm sides, leading calibrated from Pretendard's 1.53 em single line, the notice printed once.
47
+
48
+ ## Worked source
49
+
50
+ ```markdown
51
+ ---
52
+ title: Rainwater reuse in mid-size office buildings
53
+ tonality: Journal
54
+ abstract: Eight office buildings were metered for three years …
55
+ keywords: rainwater harvesting, office buildings
56
+ ---
57
+
58
+ # Introduction
59
+
60
+ Office buildings use most of their water for toilets, cooling and irrigation.
61
+ ```
62
+
63
+ ## Do
64
+
65
+ - Write the abstract as four or five sentences: question, method, main result, implication.
66
+ - Define measured quantities once, where first used.
67
+ - Keep paragraphs of similar length within a section only when the content does.
68
+
69
+ ## Avoid
70
+
71
+ - Boxes for emphasis; the argument carries emphasis.
72
+ - Pull quotes repeating the text.
73
+ - Section titles that state conclusions.
@@ -0,0 +1,70 @@
1
+ # Manual
2
+
3
+ Manual is for procedures and guides that someone follows with the document open: operating
4
+ steps, safety procedures, onboarding guides. Its pages are built for finding a step again, so
5
+ sections are numbered decimally and every caution looks the same.
6
+
7
+ ## Choose it when
8
+
9
+ - Numbered steps performed in order, by a named role.
10
+ - Hazards and prohibitions that must stand out the same way every time.
11
+ - Reference matter (contacts, tool lists) looked up beside the steps.
12
+
13
+ ## Choose something else when
14
+
15
+ - Results or analysis: use Report.
16
+ - A one-page instruction to all staff: use Memo.
17
+ - A request to approve a change: use Brief or Proposal.
18
+
19
+ ## Structure it builds
20
+
21
+ - Page 1: the title over a document-control block (document, owner, organisation, issued); a typographic cover when the procedure is long.
22
+ - A short contents list.
23
+ - Decimal sections 1 / 1.1; steps as a numbered list, one action per step.
24
+ - One callout style (`warning`) for every caution; a sidebar beside the text for contacts or definitions.
25
+ - Header: short title; footer: folio at the right.
26
+
27
+ Components: callout `warning` (cautions only), sidebar (reference matter), columns (steps beside checks).
28
+
29
+ ## Tokens (from `templates/tonalities/manual.yaml`)
30
+
31
+ | Token | Value |
32
+ | --- | --- |
33
+ | Dials | density 9, variance 6 |
34
+ | Body | Pretendard 10.5 pt (Korean), Pretendard 10.5 pt (Latin) |
35
+ | Heading ramp | h1 1.35 ×, h2 1.15 ×, title 2.5 × body |
36
+ | Numbering | decimal |
37
+ | Page 1 | manual; contents list |
38
+ | Summary form | prose |
39
+ | Running head | header: title, footer: folio, folio_align: right |
40
+ | Columns | 1 |
41
+ | Accent | 2E4A66 on callout_rule, sidebar_rule |
42
+ | Allowed components | callout, sidebar, columns |
43
+
44
+ Every tonality shares the restraint rules: ink headings, booktabs tables without fills, A4 with
45
+ 25 mm sides, leading calibrated from Pretendard's 1.53 em single line, the notice printed once.
46
+
47
+ ## Worked source
48
+
49
+ ```markdown
50
+ ## 입고 순서
51
+
52
+ 1. 납품서의 품목과 수량을 주문 내역과 맞춰 본다.
53
+ 2. 시약 관리 시스템에 등록하고 바코드 라벨을 붙인다.
54
+
55
+ ::: callout kind=warning title="혼합 금지"
56
+ 서로 다른 등급의 폐액을 한 통에 붓지 않는다.
57
+ :::
58
+ ```
59
+
60
+ ## Do
61
+
62
+ - Start every step with the action (확인한다, 적는다, Press, Record).
63
+ - State who does each part of the procedure.
64
+ - Keep the warning text short enough to read while working.
65
+
66
+ ## Avoid
67
+
68
+ - Narrative paragraphs where steps belong.
69
+ - Mixing note, key and warning boxes in one manual.
70
+ - A sidebar that holds steps; steps stay in the main text.
@@ -0,0 +1,75 @@
1
+ # Memo
2
+
3
+ Memo is for notices, internal memos, short requests and letters of one or two pages. It has
4
+ no cover and no components; the page carries a label, the subject and the addressing rows, then
5
+ plain paragraphs. Its restraint is what makes it read as written by a person.
6
+
7
+ ## Choose it when
8
+
9
+ - A notice to staff or a team about a change and what they must do.
10
+ - A short request or letter under about 600 words.
11
+ - Anything with a sender and recipients and no evidence tables.
12
+
13
+ ## Choose something else when
14
+
15
+ - A decision needing evidence: use Brief.
16
+ - Steps someone performs with the page open: use Manual.
17
+ - More than two pages: use Report or Brief.
18
+
19
+ ## Structure it builds
20
+
21
+ - Page 1: a label (안내, Memo), the subject as title, To / From / Subject rows between two hairlines, written in the cover line.
22
+ - Unnumbered short sections: what changes, why, who does what, exceptions, contact.
23
+ - No components; a callout in the source is set as a bold lead line.
24
+ - Folio from page 2 only.
25
+
26
+ Components: none.
27
+
28
+ ## Tokens (from `templates/tonalities/memo.yaml`)
29
+
30
+ | Token | Value |
31
+ | --- | --- |
32
+ | Dials | density 9, variance 2 |
33
+ | Body | Pretendard 10.5 pt (Korean), Pretendard 11 pt (Latin) |
34
+ | Heading ramp | h1 1.2 ×, h2 1.1 ×, title 1.8 × body |
35
+ | Numbering | none |
36
+ | Page 1 | memo |
37
+ | Summary form | prose |
38
+ | Running head | footer: folio, folio_align: right |
39
+ | Columns | 1 |
40
+ | Accent | none (ink only) |
41
+ | Allowed components | none |
42
+ | Spacing | tight: line pitch Hangul 165 %, Latin 120 % (the low ends); heading space 12/5 pt above/below h1, 10/4 h2; table cells 2 pt top and bottom |
43
+
44
+ A memo stays on one page when its content allows. The pack's `spacing: tight` sets the values above,
45
+ a run-in head (a callout title read as a bold lead line) keeps 12 pt above it, the paragraph after a
46
+ list keeps 6 pt, and the page check `memo.fit` (`docx qa --layout`) fails a memo that spills less than
47
+ a quarter of a page onto page 2. A memo that fills more of page 2 is a two-page memo, which the pack
48
+ allows.
49
+
50
+ Every tonality shares the restraint rules: ink headings, booktabs tables without fills, A4 with
51
+ 25 mm sides, leading calibrated from Pretendard's 1.53 em single line, the notice printed once.
52
+
53
+ ## Worked source
54
+
55
+ ```markdown
56
+ ::: cover variant=masthead kicker="안내"
57
+ 수신: 본사 전 직원 · 발신: 경영지원팀 · 제목: 회의실 예약 방식 변경
58
+ :::
59
+
60
+ # 변경 내용
61
+
62
+ 11월 3일(월)부터 회의실 예약 단위를 30분으로 줄인다.
63
+ ```
64
+
65
+ ## Do
66
+
67
+ - Put the date the change takes effect in the first paragraph.
68
+ - Address each affected group in its own short section.
69
+ - End with whom to ask and by when.
70
+
71
+ ## Avoid
72
+
73
+ - Boxes, key figures or a cover page.
74
+ - Headings phrased as questions or sentences.
75
+ - Bullet lists for content that reads better as two sentences.