@litfamily/litclaude 1.0.19 → 1.0.21

package/plugins/litclaude/skills/lit-docx/references/direction-step.md

@@ -0,0 +1,277 @@
+# The direction step
+
+A Word document gets its shape decided before its first heading is written. The shape is a
+tonality: a pack file in `templates/tonalities/<name>.yaml` that fixes the page, the type ramp, what
+stands on page 1, how the summary is set, how headings are numbered, which page components the
+document may use and what the running head carries. Six tonalities ship with the skill. The
+converter reads the pack as data; nothing in it forks per look. Skipping this step brings back the
+old failure: every report, memo and proposal came out as the same plain page.
+
+What sets one tonality apart from another is its structure. Every pack sets body text and every heading in the same
+near-black ink and declares at most one accent, which the converter puts on at most two element
+kinds (a title rule and a callout rule, for instance). The build never picks a colour, a coloured
+cover, a figure tile or a tinted box; those choices are not on the card because they no longer exist.
+
+The step takes a few minutes of reading and needs no conversation. Close the brief, rank the candidates
+for the document type, let the source reorder them, write a direction card, then say the choice
+and two alternatives in the reply. The skill picks the tonality itself. It never falls back to a
+silent default, and under a bare `lit` request it asks nothing at all.
+
+## 1. Close the brief
+
+Write down five facts. When the request does not state one, infer it from the wording and the
+source files and put the inference on the card, where the user can correct it later.
+
+- **Document type.** One of the rows in the table below, or "other, nearest to …".
+- **Reader.** Who opens the file and what they do with it: a director deciding on a budget, a new
+  operator following a procedure at the machine, a committee reading before a meeting.
+- **Delivery.** Printed and handed out, read on screen, or sent ahead and read alone. A printed
+  briefing tolerates denser pages than a document read once on a laptop, but both stay dense.
+- **Language.** Korean, English or mixed. It sets the body size of the pack (`body_pt_ko`,
+  `body_pt_en`), the caption convention (`<표 1>` or `Table 1.`) and the callout labels.
+- **Length.** Pages the reader will accept. One to two pages points to Memo or Brief whatever the
+  topic.
+
+## 2. Start from the document type
+
+Each type lists two or three candidates in order. The first is the choice when no signal moves it.
+The dials are the pack defaults from the yaml files (density, variance).
+
+| Document type | Candidates in order | Dials of the first (density, variance) |
+|---|---|---|
+| Report, results, analysis (보고서, 결과 보고, 분석) | Report, Brief, Manual | 9, 5 |
+| Korean itemised briefing for a decision maker, one to three pages (개조식, 현황 보고, 검토 보고) | Brief, Memo, Report | 9, 3 |
+| Guide, procedure, operating manual, onboarding (가이드, 매뉴얼, 절차서) | Manual, Report, Brief | 9, 6 |
+| Proposal, plan, pitch as a document (제안서, 기획서, 계획서) | Proposal, Report, Brief | 8, 6 |
+| Memo, notice, letter, one or two pages (메모, 공지, 안내문) | Memo, Brief, Report | 9, 2 |
+| Essay, newsletter, white paper, research summary not bound for a journal | Journal, Report, Proposal | 9, 6 |
+| Journal submission, or a publisher named by the user | that publisher profile, no tonality | profile rules |
+
+**A Korean report is institute prose by default.** Report writes the way a central-bank or
+think-tank issue note does: full sentences in paragraphs, sections numbered Ⅰ. / 1. / 가., tables
+carrying the evidence. Government 개조식 (□ ○ - lines ending in ~함/~임) is not a built-in variant
+of any tonality. When the reader wants an itemised briefing, that is Brief; write 개조식 lines
+yourself only when the user asks for them in so many words.
+
+**Publisher profiles stay outside this step.** When the user names Elsevier, ACS, IEEE, Nature or
+`korean-generic`, or the document is a manuscript for submission, convert with `--publisher` and
+no tonality; the converter refuses the two together. The same holds for `--template <file.docx>`:
+the user's own Word template is a request for that look. In both cases the card still records the
+choice, and the reply mentions that a tonality (name one) is available if the file is not bound
+for the journal or the house template.
+
+### The structure each tonality sets (A4.6)
+
+This is what actually changes when the tonality changes. Read the row of the chosen tonality before
+outlining, because the outline has to fit it: a Brief summary is written as separate paragraphs
+that each open with a lead sentence, a Report needs its decision request in a callout under the
+summary, a Memo has no room for any component at all.
+
+| Tonality | Page 1 | Summary form | Numbering | Components allowed (budget) | Running head |
+|---|---|---|---|---|---|
+| Report | title block: kind label left and date right on one line, title, subtitle, author and organisation, one accent rule, the notice; a short contents list from about five pages | prose; one key-figure strip under its first paragraph | Ⅰ. / 1. / 가. (English 1 / 1.1) | key figures, callout, columns; about one callout per four pages, the decision request first | footer: short title left, folio right |
+| Brief | compact title block, then the decision box straight under it | numbered points ① ② ③ ④, each a bold lead sentence then plain text | none; each h1 under a full-width ink hairline | callout (one at most), columns | folio alone at the foot, right |
+| Proposal | a typographic cover page: label, title left-aligned in the upper third, one short accent rule, subtitle, lead paragraph; byline, date and notice at its foot | prose; key figures once under the summary | none | key figures, callout (one at most), columns | folio centred at the foot |
+| Manual | title over a document-control block (문서 / 작성 부서 / 기관 / 시행일), the notice; a short contents list from about five pages | prose | 1 / 1.1, numbered procedure steps | callout (one warning style for all), sidebar, columns | header: short title; footer: folio right |
+| Memo | no cover: a label, the subject as title, To / From / Date / Subject rows between two hairlines, the notice | prose | none | none (a callout reads as a bold lead line) | folio from page 2 |
+| Journal | masthead with authors, affiliations, abstract and keywords, then two columns | prose | 1 / 1.1, so "Section 2.4" resolves | callout | header: short title and folio |
+
+Two tonalities rendered from the same source differ in at least three of these features. The
+direction strip in section 7 shows that difference, and the gate proves it with
+`qa_docx.py a.docx --compare b.docx` (check `tonality.structure`).
+
+The running head carries the short title and the folio, never the section name: a field that
+repeats the section showed the first section that starts on a page, not the one the page opens
+in, so no pack uses it.
+
+## 3. Let the source reorder the candidates
+
+Draft the outline first: headings, which sections carry a table, a warning, a list of steps, key
+figures. Then count on the outline. A signal moves a candidate within the set; it never brings in a
+tonality from outside the row. Apply the signals in this order, and keep the table order on a tie,
+so the same source always gives the same choice.
+
+| Signal | When it fires | Effect |
+|---|---|---|
+| The user names a tonality, or picked one earlier in the conversation | always | use it; still write the card |
+| Tables make up 30 % or more of the body blocks, or there are four or more tables | counted on the outline | Report or Manual to the front |
+| Three or more images | counted | Proposal or Journal to the front |
+| Under about 900 words, or the brief says one or two pages | counted or stated | Memo or Brief to the front |
+| English long-form prose with few tables (at most one per three pages) | counted | Journal to the front |
+| Numbered procedures, or three or more warnings or cautions | counted | Manual to the front |
+| The document asks the reader for a decision (승인 요청, 결정 사항) | stated in the source | Brief or Proposal up one place; plan a `key` callout for the request |
+| A pack does not allow a component the outline needs (only Manual has a sidebar; Brief and Memo have no key figures; Memo has no components; Journal has callouts only) | any section | move that pack down, or write that content as ordinary text and say so on the card |
+
+A worked case. The request is a six-page Korean review of a warehouse automation pilot, with five
+tables and a decision at the end. The type row gives Report, Brief, Manual. Five tables fire the
+table signal, which keeps Report first. The decision request moves Brief up one place, but it is
+already second. Report stays; Brief and Manual are the alternatives, and the card says Brief would
+fit better if the director reads only the first page.
+
+## 4. Write the direction card
+
+The card is the record of the decision. Keep it in the build log and summarise it in the reply.
+Fill every field; a build that cannot name the tonality and the reason stops there.
+
+Each planned component gets its own line with a one-line purpose: what out-of-sequence content it
+carries, the thing a reader needs that does not belong in the running text at that point. A
+decision request the director must find without reading, a warning the operator must see before
+the step, the three numbers the summary rests on. A component without a purpose is left out of the
+card and out of the source. "Breaks up the page" or "adds visual interest" is not a purpose.
+
+```text
+Direction card
+  Document type     report (결과 보고), 6 pages expected
+  Reader            logistics director and two plant managers, printed for the monthly review
+  Tonality          report   alternatives: brief, manual
+  Reason            5 tables in 14 body blocks (36 %); one decision request at the end
+  Signals fired     table share, decision request
+  Dials             density 9, variance 5 (pack defaults)
+  Page 1            report title block (kind label, date, title, subtitle, byline, one rule, notice once)
+  Headings          Ⅰ. / 1. / 가., ink, weight and space only; every heading a noun phrase
+  Components        keyfigures (summary)   the three results the summary rests on, each with its basis
+                    callout key            the 2.1억 원 approval request, findable without reading
+  Left out          sidebar of terms (Report has none; the definitions go in the method paragraph)
+  Fonts             Pretendard (pack default)
+  Wrong if          the director reads only page one; Brief's conclusion-first points fit that better
+```
+
+The "wrong if" line is checked first in review. If it turns out true, the direction was mis-chosen
+and the document is rebuilt under the alternative it names, with the card updated.
+
+**Component budget.** The card stays inside these limits whatever the pack allows; the converter
+enforces the same limits and the gate's `component.budget` check fails a document past them.
+
+- At most three component kinds in one document, beyond headings, paragraphs, lists, tables and
+  figures. A cover or title block is not counted.
+- One key-figure strip at most, in the summary (under its first paragraph or right after it), three
+  or four comparable metrics, each with a label and a basis line. Never on a cover: figures written
+  inside `::: cover` are moved into the summary, or kept in the summary text by a pack without key
+  figures.
+- Callouts about one per four pages, and only for out-of-sequence content: a decision request, a
+  warning, a definition. The converter boxes the decision request first, then warnings, then notes,
+  and writes the rest as text. Brief and Proposal box one callout at most.
+- Pull quotes are off in every tonality. A pull quote repeats a sentence the reader has just read;
+  the converter leaves it out with a note.
+- A sidebar only in a Manual, beside enough text to float, or full width.
+- `::: columns` only when the parts are within about 20 % of each other in length; unequal parts
+  are read in sequence.
+
+**The notice.** The frontmatter `notice:` (the sample-data or confidentiality line) is printed once,
+in small muted text under the title block, or at the foot of a Proposal cover. It never goes in a
+page header and never becomes a coloured chip; do not repeat it in the body.
+
+**Dials.** Density (1-10) sets the margins (sides never under 25 mm), the leading and the page fill
+the document aims for; variance (1-10) sets how many component kinds and table styles one document
+may mix, inside the budget above. The skill may move either dial by up to 2 from the pack default
+without asking and says so on the card. A larger move needs the user's word. Dials go in the
+frontmatter (`density:`, `variance:`) or on the command line (`--density`, `--variance`).
+
+## 5. Four rules every card carries
+
+These come from the user and bind every tonality. The card names them so the build cannot drift.
+
+1. **Headings, the title and the subtitle are noun-phrase labels.** "1년 운영 결과", "Commissioning
+   checklist", never "1년 동안 목표를 달성했다" or "Costs fell by a third". The claim goes in the first
+   sentence under the heading. The gate's `heading.declarative` check fails a heading, title or
+   subtitle that reads as a sentence; reword the label, never the gate.
+2. **No exaggerated numbers.** Every figure traces to a source and is rounded honestly; the
+   numbers in the summary, the key figures and the tables agree with each other. A key figure is
+   set no larger than the pack's h2 size and carries a label and a basis line (the period and the
+   source) written as an indented list item under it. Invented figures carry (예시) or (sample).
+3. **Pretendard by default.** Every pack declares Pretendard for Latin and Hangul in the document
+   defaults, the styles, the theme and the bullet glyphs. Journal keeps Times New Roman for Latin
+   body text only. Another face appears only when the user asks for it or the template brings it.
+4. **Dense by default.** Body pages carry information to the bottom (no body page under 0.35 of the
+   frame, a median near 0.80). The density comes from the measure, the leading and the structure:
+   a 160 mm text block, calibrated line pitch, sections that carry their tables. It never comes
+   from type under 10.5 pt, narrow margins or boxes crammed with text. An airy page is built only
+   when the user asks for one.
+
+## 6. Say it and record it
+
+In the reply, with the delivered files, say in plain words which tonality was chosen, why, and the
+two alternatives. For example: "Report 방향으로 만들었습니다. 표가 본문의 3분의 1이 넘고 마지막에
+승인 요청이 있어서입니다. 첫 장만 읽힐 문서라면 Brief, 절차 안내가 중심이면 Manual도 맞습니다."
+One sentence each for choice, reason and alternatives; no design lecture.
+
+Under a bare `lit` request the same sentence goes in the reply and nothing is asked before the
+build. Under an explicit request the skill still decides; it asks only when the brief leaves the
+look open on purpose (then it builds the strip below) or a dial must move by more than 2.
+
+Write the build log beside the source. It holds the card, the converter's stdout notes (a directive
+the pack does not use kept as text, a callout past the budget written as text, a pull quote left
+out, columns read in sequence because the parts were unequal), and the gate result. It is working
+evidence and never part of the document.
+
+```text
+<name>.md          the source, with tonality: (and any dials) in its frontmatter
+<name>.build.md    the direction card, converter notes, qa_docx result, pages looked at
+<name>.docx        the converted document
+```
+
+## 7. The direction strip
+
+When the user asks to compare looks, or the brief says the look is open ("어떤 느낌이 좋을지
+모르겠다", "show me a few options"), convert the same source under the chosen tonality and the two
+alternatives, render the first three pages of each, and show three labelled rows before writing
+the rest. The text stays the same in every row; only `tonality:` changes. The user's pick replaces
+the reason on the card ("chosen by the user from the strip").
+
+```bash
+for t in Report Brief Manual; do
+  sed "s/^tonality: .*/tonality: $t/" strip.md > "strip-$t.md"
+  python3 "$SKILL_ROOT/scripts/convert_md_to_docx.py" "strip-$t.md" "strip-$t.docx"
+  python3 "$SKILL_ROOT/scripts/visual_audit.py" "strip-$t.docx" --out-dir "strip-$t" --pages 3
+done
+python3 "$SKILL_ROOT/scripts/qa_docx.py" strip-Report.docx --source strip-Report.md --compare strip-Brief.docx
+```
+
+The rows should differ in what stands on page 1, how the summary reads, how headings are numbered
+and what runs at the foot. If two rows look alike apart from a rule colour, the `--compare` run
+fails `tonality.structure` and the strip is not worth showing. A component one pack does not allow
+is kept as text in that row (the converter says so); that is expected and part of what the strip
+shows.
+
+## 8. Failure patterns
+
+- Choosing by topic alone ("a factory, so Manual") without counting the outline.
+- No tonality and no publisher on a document that is not a manuscript: the plain profile used as a
+  silent default.
+- A reply that names one direction with no alternatives, or none at all.
+- A reason that restates the document type instead of the signals that fired.
+- Asking a style question under a bare `lit` request.
+- Moving a dial by three or more without the user's word.
+- Headings written as conclusions, or a key figure without a basis line, because an older habit
+  said headings should state findings.
+- A component on the card with no purpose, or a callout holding text that belongs in the running
+  paragraph; a pull quote; a sidebar outside a Manual; key figures on the cover or a second strip.
+- Choosing a tonality for its colour, or asking for a coloured cover, a band or figure tiles.
+- Writing a Korean report in 개조식 lines because it is Korean; that is Brief's form or the user's
+  explicit request.
+- The notice repeated in the body or in a header.
+- A tonality and `--publisher` together, or a tonality forced onto a journal manuscript.
+- Swapping the tonality after the build without updating the card and the reply.
+
+## 9. The example library
+
+Each file in `examples/` converts under the tonality in its frontmatter and passes `qa_docx.py
+--layout`. Read the one closest to the job before writing a new source; copy its structure and write
+your own text. Each one stays inside the component budget, uses only components its pack draws, keeps its
+numbers consistent across summary, figures and tables, and writes Korean dates as `2026. 6. 30.`
+in the body.
+
+| File | Document type | Tonality | Alternatives |
+|---|---|---|---|
+| `examples/01-report-ko.md` | results report with tables | Report | Brief, Manual |
+| `examples/02-brief-ko.md` | itemised briefing with a decision | Brief | Memo, Report |
+| `examples/03-manual-ko.md` | operating procedure | Manual | Report, Brief |
+| `examples/04-proposal-ko.md` | project proposal | Proposal | Report, Brief |
+| `examples/05-memo-en.md` | internal notice | Memo | Brief, Report |
+| `examples/06-journal-en.md` | white paper in two columns | Journal | Report, Proposal |
+| `examples/07-report-en.md` | quarterly operations report | Report | Brief, Manual |
+| `examples/08-proposal-en.md` | funding proposal | Proposal | Report, Brief |
+| `examples/09-memo-ko.md` | 안내문 (one-page notice) | Memo | Brief, Report |
+
+All figures in the examples are invented and labelled as examples; the organisations are
+placeholders. None of them places an image, so they convert without asset files.

package/plugins/litclaude/skills/lit-docx/references/examples/01-report-ko.md

@@ -0,0 +1,166 @@
+---
+title: 물류센터 자동 분류 라인 1년 운영 결과
+subtitle: 예시 물류 동부센터 2025년 10월-2026년 9월 실적과 남은 과제
+author: 예시 물류 운영기획팀
+organization: 예시 물류
+date: 2026-10-06
+short_title: 자동 분류 라인 1년 운영 결과
+notice: "예시 데이터: 회사·수치·일정은 모두 가정입니다"
+tonality: Report
+---
+
+::: cover variant=typographic kicker="운영 결과 보고"
+동부센터 자동 분류 라인의 첫 1년 실적을 처리량, 오분류, 정지 시간, 인력 네 가지로 정리하고, 2027년 상반기에 손볼 과제와 예산 요청을 함께 담았다.
+:::
+
+# 요약
+
+자동 분류 라인은 도입 1년 동안 시간당 처리량을 31% 늘렸고, 오분류율은 수작업 분류 시절 0.84%에서 0.21%로 낮아졌다. 처리량 목표(+25%)와 오분류율 목표(0.30% 이하)를 모두 넘겼다. 다만 소형 박스가 몰리는 오후 시간대에 투입부 정체가 반복되고, 야간 교대의 재가동 대응이 주간보다 느렸다.
+
+::: keyfigures
+- **+31%** 시간당 처리량 (예시)
+  - 2026년 3분기 평균, 2025년 3분기 수작업 대비
+- **0.21%** 오분류율 (예시)
+  - 2026년 1-9월 누적, 출고 검수 기록 기준
+- **7분** 정지 후 재가동 시간 (예시)
+  - 2026년 하반기 평균, 설비 로그 기준
+:::
+
+2027년 상반기에는 투입부 개조와 야간 교대 훈련을 진행한다. 개조 공사비 1.8억 원(예시)과 훈련 인건비 0.3억 원(예시)의 승인을 요청한다. 개조가 끝나면 오후 정체 시간이 하루 평균 52분에서 20분 이하로 줄어들 것으로 추정한다.
+
+::: callout kind=key title="승인 요청 사항"
+2026년 11월 운영위원회에서 투입부 개조 공사비 1.8억 원과 야간 교대 훈련 인건비 0.3억 원, 합계 2.1억 원(예시)의 집행 승인을 요청한다. 공사는 성수기를 피해 2027년 2월에 시작한다.
+:::
+
+# 운영 개요
+
+## 도입 범위와 일정
+
+자동 분류 라인은 2025년 10월 동부센터 1층에 설치되었다. 투입부 2곳, 분류 슈트 48개, 출고 레인 12개로 구성되며, 하루 두 교대(주간 07-16시, 야간 16-01시)로 운영한다. 첫 두 달은 기존 수작업 분류와 병행했고, 2025년 12월부터 전량을 자동 라인으로 처리했다.
+
+도입 전에는 분류 인력 34명이 박스를 손으로 읽어 레인별 카트에 담았다. 지금은 투입과 예외 처리에 16명, 출고 적재에 10명이 배치되어 있다. 줄어든 8명은 반품 검수와 재고 실사 지원으로 옮겼다.
+
+표 1. 자동 분류 라인 구성 (2026년 9월 기준, 예시)
+
+| 구성 요소 | 수량 | 시간당 설계 용량 | 비고 |
+| --- | ---: | ---: | --- |
+| 투입부 | 2곳 | 2,400박스 | 곳당 1,200박스 |
+| 분류 슈트 | 48개 | 4,800박스 | 소형 박스 전용 12개 포함 |
+| 출고 레인 | 12개 | 해당 없음 | 권역별 배정 |
+| 바코드 판독기 | 6대 | 해당 없음 | 상·측면 동시 판독 |
+
+출처: 예시 물류 설비 설계서(2025년 7월), 운영기획팀 배치 기록
+
+## 성과 측정 방법
+
+이 보고서의 용어는 다음과 같이 쓴다. 투입부는 박스를 라인에 올리는 입구로, 판독기가 여기서 바코드를 읽는다. 슈트는 분류된 박스가 미끄러져 내려가는 경사로이고, 예외 처리는 바코드를 읽지 못한 박스를 사람이 다시 분류하는 작업이다. 재가동 시간은 정지 신호에서 라인이 다시 움직이기까지 걸린 시간을 말한다.
+
+처리량은 투입부 판독기 기록에서 시간당 통과 박스 수를 뽑아 교대별 평균을 냈다. 오분류율은 출고 검수에서 잘못된 레인으로 간 박스 수를 전체 출고 박스로 나눈 값이다. 정지 시간은 설비 로그의 정지 신호부터 재가동 신호까지를 셌고, 계획 정비 시간은 뺐다.
+
+비교 기준은 도입 직전 1년(2024년 10월-2025년 9월)의 수작업 분류 실적이다. 물량이 계절마다 달라지므로, 분기별로 같은 분기끼리 비교했다. 2025년 4분기는 병행 운영 기간이어서 처리량 비교에서 뺐다.
+
+# 처리량과 정확도
+
+## 분기별 처리량
+
+처리량은 2026년 1분기부터 목표를 넘었다. 3분기 평균은 시간당 2,030박스로, 도입 전 같은 분기 1,550박스보다 31% 많다. 주간 교대의 처리량이 야간보다 약 8% 높았는데, 야간에는 소형 박스 비중이 커서 투입부에서 간격을 더 벌려야 했기 때문이다.
+
+표 2. 분기별 시간당 처리량 (박스, 예시)
+
+| 분기 | 도입 전 | 도입 후 | 증감률 (%) | 목표 달성 |
+| --- | ---: | ---: | ---: | --- |
+| 1분기 | 1,480 | 1,870 | 26.4 | 달성 |
+| 2분기 | 1,520 | 1,960 | 28.9 | 달성 |
+| 3분기 | 1,550 | 2,030 | 31.0 | 달성 |
+| 1-3분기 평균 | 1,517 | 1,953 | 28.7 | 달성 |
+
+출처: 투입부 판독기 기록, 2024년 10월-2026년 9월
+
+처리량이 늘어난 만큼 출고 마감 시각도 앞당겨졌다. 도입 전에는 오후 물량의 마감이 평균 18시 40분이었으나, 2026년 3분기에는 17시 55분으로 45분 빨라졌다. 덕분에 수도권 권역의 당일 배송 접수 마감을 30분 늦출 수 있었다.
+
+## 오분류와 예외 처리
+
+2026년 1-9월에 출고된 박스는 약 810만 개였고, 이 가운데 1만 7,000개가 잘못된 레인으로 갔다(0.21%). 분기별로는 1분기 0.29%에서 3분기 0.15%로 꾸준히 낮아졌다. 오분류의 61%는 바코드가 테이프나 송장에 가려진 박스에서 나왔다. 판독 실패 박스는 예외 처리 구역으로 빠지는데, 하루 평균 410박스가 이 구역을 거쳤다.
+
+표 3. 오분류 원인별 건수 (2026년 1-9월, 예시)
+
+| 원인 | 건수 | 비중 (%) |
+| --- | ---: | ---: |
+| 바코드 가림 | 10,370 | 61.0 |
+| 박스 겹침 투입 | 3,910 | 23.0 |
+| 레인 배정 오류 | 1,700 | 10.0 |
+| 기타 | 1,020 | 6.0 |
+| 합계 | 17,000 | 100.0 |
+
+출처: 출고 검수 기록, 2026년 1-9월
+
+바코드 가림은 투입 전 단계에서 걸러낼 수 있다. 3분기에 시범으로 투입부 앞에 확인 인력 1명을 둔 주간 교대에서는 가림으로 인한 오분류가 절반 가까이 줄었다. 이 방식을 야간 교대에도 적용할지 검토가 필요하다. 확인 인력은 기존 예외 처리 인원 가운데서 돌려 배치할 수 있어 추가 채용은 필요하지 않다.
+
+# 설비 정지와 인력
+
+## 정지 시간 변화
+
+정지 후 재가동까지 걸린 시간은 상반기 평균 19분에서 하반기 7분으로 줄었다. 하반기에 재가동 절차를 한 장짜리 점검표로 만들고, 교대마다 정비 담당 1명을 지정한 효과다. 월간 정지 횟수는 평균 11회로 큰 변화가 없었다.
+
+표 4. 월평균 정지 횟수와 재가동 시간 (예시)
+
+| 기간 | 정지 횟수 (회) | 재가동 시간 (분) | 월 정지 합계 (시간) |
+| --- | ---: | ---: | ---: |
+| 2026년 상반기 | 11.2 | 19 | 3.5 |
+| 2026년 하반기 | 10.8 | 7 | 1.3 |
+
+출처: 설비 로그, 계획 정비 제외
+
+정지 원인은 상반기와 하반기 모두 박스 걸림이 절반가량을 차지했다. 걸림 자체는 줄지 않았지만, 점검표 덕분에 근무자가 걸린 위치를 찾는 시간이 짧아졌다.
+
+## 인력 배치와 숙련
+
+자동 라인 운영 인력은 26명이며, 이 중 9명이 정비 기초 교육을 마쳤다. 주간 교대에는 교육을 마친 인력이 늘 2명 이상 있지만, 야간 교대에는 1명뿐인 날이 한 달에 8일 정도 된다. 야간 재가동 시간이 주간보다 평균 4분 긴 것도 이 때문이다.
+
+# 남은 과제
+
+## 투입부 정체
+
+오후 14-16시에는 소형 박스가 몰려 투입부에서 하루 평균 52분 정체가 생긴다. 소형 박스는 투입 간격을 넓혀야 판독기가 겹치지 않게 읽을 수 있는데, 지금은 대형 박스와 같은 투입구를 쓰기 때문에 소형 박스가 몰리는 시간에는 대형 박스까지 함께 느려지고, 그 여파가 출고 레인 적재와 오후 마감까지 이어진다. 소형 박스 전용 투입구를 하나 더 만들면 정체를 20분 이하로 줄일 수 있다는 설비 업체의 검토 결과가 있다. 공사비는 1.8억 원(예시)이고 기간은 3주다.
+
+공사 중에는 분류 라인 하나가 멈추므로, 직전 주에 수작업 분류 인원 6명을 미리 확보한다. 11-12월 성수기에는 공사를 하지 않는다.
+
+## 야간 운영 역량
+
+야간 교대의 정비 교육 이수자를 2027년 3월까지 4명으로 늘린다. 월 1회 모의 재가동 훈련을 하고, 훈련 시간은 교대 시간 안에 넣어 추가 근무를 만들지 않는다. 훈련 인건비는 연 0.3억 원(예시)으로 추정한다.
+
+## 현장과 관리자 의견
+
+2026년 9월 운영 점검 회의에서 현장 근무자와 관리자의 의견을 따로 받았다. 두 쪽 모두 투입부 정체를 첫 과제로 꼽았다.
+
+::: columns 2
+### 현장 근무자 의견
+
+- 소형 박스가 몰리는 시간대에 정체가 반복된다.
+- 재가동 점검표는 쓸모 있지만 화면 안내와 순서가 다르다.
+- 바코드가 가려진 상자를 투입 전에 걸러 내는 단계가 필요하다.
+
+<!-- column-break -->
+
+### 관리자 의견
+
+- 투입부 개조를 성수기 전에 끝내야 한다.
+- 야간 교대의 정비 인력이 한 명뿐인 날을 없애야 한다.
+- 오분류 원인 기록을 출고 검수와 같은 양식으로 맞춘다.
+:::
+
+# 향후 일정
+
+승인 이후의 일정은 다음과 같다. 개조 효과는 공사 후 3개월 실적으로 점검해 2027년 6월에 보고한다.
+
+표 5. 향후 일정 (예시)
+
+| 시기 | 할 일 | 담당 |
+| --- | --- | --- |
+| 2026년 11월 | 운영위원회 승인 | 운영기획팀 |
+| 2027년 1월 | 개조 설계 확정, 공사 업체 계약 | 설비팀 |
+| 2027년 2월 | 투입부 개조 공사 (3주) | 설비팀 |
+| 2027년 3월 | 야간 정비 교육 이수자 4명 확보 | 운영팀 |
+| 2027년 6월 | 개조 효과 점검 보고 | 운영기획팀 |
+
+주: 일정은 승인 시점에 따라 한 달 안에서 바뀔 수 있다.

package/plugins/litclaude/skills/lit-docx/references/examples/02-brief-ko.md

@@ -0,0 +1,105 @@
+---
+title: 재택근무 제도 개편안 검토 보고
+subtitle: 시범 운영 1년 결과와 주 2일 정례화 방안
+author: 예시 기관 인사기획팀
+organization: 예시 기관
+date: 2026-10-08
+short_title: 재택근무 개편안 검토
+notice: "예시 데이터: 기관·인원·수치는 모두 가정입니다"
+tonality: Brief
+---
+
+::: cover variant=masthead kicker="검토 보고"
+:::
+
+::: callout kind=key title="결정 요청"
+주 2일 재택근무 정례화와 팀별 협업일 지정(안 2)을 2027년 1월부터 시행하는 안과, 회의실 예약 체계 개편 예산 4천만 원(예시)을 2026년 10월 경영위원회에서 승인해 주기를 요청한다.
+:::
+
+# 요약
+
+이용률과 만족도가 함께 올랐다. 2025년 10월부터 1년 동안 대상 612명의 월평균 이용률은 78%로 시범 첫 달의 61%보다 높았고, 업무 만족도는 5점 척도에서 3.4점에서 4.1점으로 올랐다(예시).
+
+생산성은 유지되었다. 과제 기한 준수율과 1인당 처리 건수는 시범 전과 같았다. 다만 협업 수요가 짧은 화상회의 여러 번으로 흩어지면서 1인당 주간 회의 시간이 4.1시간에서 5.3시간으로 1.2시간 늘었고, 대면 결재를 기다리는 문서가 재택일에 쌓여 결재 처리 기간도 1.8일에서 2.1일로 길어졌다.
+
+세 가지 방안 가운데 안 2가 가장 균형이 맞다. 이용자가 가장 많이 고른 주 2일을 기준으로 삼고, 흩어진 회의를 팀별 협업일에 모은다. 노사 모두 수용 가능하다는 의견을 냈다.
+
+추가 비용은 회의실 예약 체계 개편 4천만 원이다. 2026년 4분기 예비비에서 집행할 수 있다.
+
+# 검토 배경
+
+- 2025년 10월부터 본사 4개 본부 612명을 대상으로 재택근무를 시범 운영함(주 1-3일 자율 선택, 전날 18시까지 사전 신청)
+- 2026년 9월 시범 기간이 끝나 정식 제도 여부를 결정해야 함
+- 노사협의회가 2026년 8월 정례화를 공식 요청하였고, 12월 정기 협의 안건으로 상정됨
+- 같은 기간 동종 기관 다섯 곳 중 세 곳이 주 2일 재택을 정식 제도로 도입함
+
+# 시범 운영 결과
+
+## 이용 현황
+
+- 이용률은 시범 첫 달 61%에서 석 달 만에 75%를 넘었고 이후 큰 변화 없이 유지됨
+- 이용자의 47%가 주 2일을 골라 가장 많았음
+- 본부 간 이용률 편차는 최대 21%p로, 영업 본부(68%)는 고객 방문 일정 때문에 낮았고 개발 본부(89%)는 거의 전원이 이용함
+- 주 3일 이용자는 전체의 18%였으며, 이들 중 절반이 팀장의 협업 요청으로 다음 달 2일로 줄임
+
+## 생산성과 협업 지표
+
+표 1. 시범 전후 주요 지표 비교 (2025년 9월 대비 2026년 9월, 예시)
+
+| 지표 | 시범 전 | 시범 후 | 변화 |
+| --- | ---: | ---: | --- |
+| 과제 기한 준수율 (%) | 92 | 93 | 유지 |
+| 1인당 월 처리 건수 (건) | 41 | 42 | 유지 |
+| 결재 처리 기간 (일) | 1.8 | 2.1 | 0.3일 증가 |
+| 1인당 주간 회의 시간 (시간) | 4.1 | 5.3 | 1.2시간 증가 |
+| 화상회의 비중 (%) | 22 | 61 | 39%p 증가 |
+
+출처: 업무관리 시스템 과제·결재 기록, 회의실·화상회의 예약 기록
+
+- 결재 처리 기간이 늘어난 것은 대면 결재를 기다리는 문서가 재택일에 쌓였기 때문으로 확인됨
+- 회의 시간 증가는 협업 수요가 대면 대신 짧은 화상회의 여러 번으로 흩어진 결과로 판단됨
+- 협업일을 먼저 운영한 3개 팀(41명)은 주간 회의가 4.6시간으로 전체 평균보다 0.7시간 적었음
+
+## 불편 사항
+
+- 불편 응답의 64%가 회의 일정 조율과 대면 협업 부족에 집중됨
+- 그다음은 결재 지연 18%, 장비 지원 11%, 보안 절차 7% 순
+- 신규 입사자(입사 1년 미만 58명)는 업무 질문을 할 곳이 없다는 응답이 기존 직원의 두 배
+
+# 개편 방안 비교
+
+세 방안은 재택 일수와 협업일 유무에서 갈린다. 비용과 효과는 인사기획팀 추정치다.
+
+표 2. 검토한 세 가지 방안 (예시)
+
+| 구분 | 안 1 현행 유지 | 안 2 주 2일 정례화 + 협업일 | 안 3 주 3일 확대 |
+| --- | --- | --- | --- |
+| 재택 일수 | 주 1-3일 자율 | 주 2일, 요일은 팀이 정함 | 주 3일 자율 |
+| 협업일 | 없음 | 팀별 주 1일 지정 | 없음 |
+| 추가 비용 | 없음 | 회의실 예약 체계 개편 4천만 원 | 장비 지원 확대 1.1억 원 |
+| 예상 효과 | 현 상태 유지 | 회의 시간 주 1시간 감소 추정 | 만족도 상승, 협업 부담 증가 |
+| 노사 의견 | 노조 반대 | 노사 모두 수용 가능 | 경영진 반대 |
+
+주: 확정 전 재무팀 검토가 필요하다.
+
+- 안 3은 만족도는 더 높일 수 있으나 협업 불편이 커지고 신규 입사자 적응 문제가 악화될 우려
+- 안 1은 노사협의회 요청과 동종 기관 흐름에 맞지 않아 12월 협의에서 쟁점이 될 가능성이 큼
+
+# 시행 방안과 일정
+
+- 2027년 1월부터 4개 본부 전체에 주 2일 재택근무를 정식 제도로 시행
+- 팀별 협업일 1일을 지정하고, 협업일에는 재택 신청을 받지 않음
+- 신규 입사자는 입사 후 3개월 동안 주 1일만 재택을 허용하고, 사수와 같은 날 출근하도록 함
+- 협업일 우선 예약과 화상 장비가 있는 소회의실 6곳 증설로 회의실 수요 집중에 대비함
+
+표 3. 향후 일정 (예시)
+
+| 시기 | 내용 | 담당 |
+| --- | --- | --- |
+| 2026년 10월 | 경영위원회 보고, 예산 승인 | 인사기획팀 |
+| 2026년 11월 | 규정 개정안 작성, 본부별 협업일 수요 조사 | 인사기획팀 |
+| 2026년 12월 | 노사협의회 심의, 회의실 개편 완료 | 인사기획팀, 총무팀 |
+| 2027년 1월 | 전면 시행 | 전 본부 |
+| 2027년 6월 | 6개월 효과 점검 보고 | 인사기획팀 |
+
+출처: 인사기획팀 이용 기록(2025년 10월-2026년 9월), 직원 만족도 조사(2026년 9월, 523명 응답)