chaffjs 0.18.0 → 0.20.0

package/rules/nominalization.yaml

@@ -0,0 +1,89 @@
+id: nominalization
+layer: L3
+status: experimental
+how_to_find: nominalization
+# 動詞を名詞にして別の動詞に運ばせる言い方。英語は語の並び（nominalization-phrase）、日本語はサ変名詞（品詞の VerbForm=Vnoun）と、
+# その後ろの「を実施する」（nominalization-light-verb）で見る。片方しか持たない言語があるので word_list には書かない（書くと、無い言語で動かなくなる）。
+requires: [pos]
+severity: info
+
+name:
+  ja: 動詞を名詞にして回りくどく書いている
+  en: Verbs hidden in nouns
+
+why:
+  ja: 「調査を実施した」は「調査した」で、「確認を行う」は「確認する」で足ります。動詞を名詞にして別の動詞に運ばせると、文が長くなり、誰が何をしたのかが遠くなります。在留支援のためのやさしい日本語ガイドラインが「調査を実施した」を「調査した」に直す例を挙げ、米国連邦政府の Plain Language Guidelines と英国政府（GOV.UK）の書き方の手引きも、"make a decision" ではなく "decide" と書くよう求めています。一つ二つは普通の言い方なので、文書の長さに対して多いときだけ指します。
+  en: '"Make a decision" says in three words what "decide" says in one. A verb turned into a noun and carried by another verb makes the sentence longer and the action harder to see. The Federal Plain Language Guidelines call these hidden verbs, and GOV.UK asks for the verb; the Japanese guideline for plain Japanese rewrites 調査を実施した as 調査した. One or two are ordinary, so chaff speaks only when they are dense for the document''s length.'
+
+message:
+  ja: 「{matched}」は「{preferred}」で足ります（動詞を名詞にした言い方が 1000 字あたり {density} 個、{limit} 個まで）
+  en: '"{matched}" can be "{preferred}" ({density} hidden verbs per 1000 words, limit {limit})'
+
+how_to_fix:
+  ja: 名詞を動詞に戻してください。「調査を実施した」は「調査した」、「確認を行います」は「確認します」に。
+  en: 'Use the verb: "made a decision" becomes "decided", "conduct an analysis" becomes "analyze".'
+
+placeholders:
+  matched:
+    ja: 見つけた言い方
+    en: the phrase found
+  preferred:
+    ja: 動詞にした形
+    en: the verb
+
+levels: { strict: 1, normal: 2, relaxed: 4 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+sources: [yasashii-nihongo-2020, plain-2011, gov-uk-clear-language, reinhart-2025]
+
+group: wording
+summary:
+  ja: 「調査を実施した」「確認を行う」のように、動詞を名詞にして別の動詞に運ばせた言い方が、文書の長さに対して多い所
+  en: Verbs hidden in nouns ("make a decision", "conduct an analysis"), many for the document's length
+example:
+  ja:
+    pad: true
+    before: |
+      先月、顧客の満足度の調査を実施しました。結果の確認を行い、改善の検討を行います。
+    after: |
+      先月、顧客の満足度を調査しました。結果を確認し、改善を検討します。
+  en:
+    pad: true
+    before: |
+      We will conduct an analysis of the results and make a decision next week.
+    after: |
+      We will analyze the results and decide next week.
+
+not_flagged:
+  ja: 「する」を付けても動詞にならない名詞（イベントを行う）、「を実施する」が催す意味になる語（研修を実施する、試験を行う）、「勉強をする」のような「〜をする」、文書の長さに対して少ないものは見ません。短すぎる文書も測りません。
+  en: Phrases not on chaff's list, and a document where they are few for its length, are not reported. Very short documents are not measured.
+level_meaning:
+  ja: 1000 字あたり「〜を実施する」のような名詞化した動詞 {limit} 個まで
+  en: up to {limit} nominalized verbs ("make a decision") per 1000 words
+rewrite:
+  ja:
+    direction: 「〜を実施する」「〜を行う」の名詞を動詞に戻し、運び役の動詞を消してください。誰がしたのかが書かれていれば、その人を主語に残します。
+    pairs:
+      - before: 先月、顧客満足度の調査を実施しました。
+        after: 先月、顧客満足度を調査しました。
+      - before: 結果の確認を行い、改善の検討を行います。
+        after: 結果を確認し、改善を検討します。
+    keep:
+      - 何を、いつ、誰がしたのか
+      - 催す意味の「実施する」（研修を実施する、試験を行う）
+    avoid:
+      - 「実施する」を「行う」「図る」のような別の運び役に替える
+      - 動詞に戻すときに目的語や時期を落とす
+  en:
+    direction: Turn the noun back into its verb and drop the verb that was carrying it ("make a decision" becomes "decide"). Keep who acted as the subject.
+    pairs:
+      - before: We will conduct an analysis of the results next week.
+        after: We will analyze the results next week.
+      - before: The board made a decision to postpone the launch.
+        after: The board decided to postpone the launch.
+    keep:
+      - what was done, to what, and when
+      - who acted
+    avoid:
+      - swapping one carrying verb for another ("perform", "carry out")
+      - dropping the object or the time while making the verb

package/rules/number-style-consistency.yaml

@@ -0,0 +1,105 @@
+id: number-style-consistency
+layer: L2
+status: experimental
+how_to_find: number-style-consistency
+uses: [pos]
+severity: info
+
+name:
+  ja: 数の書き方が混ざっている
+  en: Numbers written two ways
+
+why:
+  ja: 数をどう書くか（3件か三件か、1,000 か 1000 か、10% か 10％ か 10パーセントか）は、どれでも読めます。困るのは一つの文書の中で混ざることで、読み手は違う書き方に違う意味があるのかと迷い、検索でも別の語になります。chaff はどれが正しいかを決めず、数え方の語の前の数（漢数字か算用数字か）、位取りのコンマ、百分率の書き方、英語の数（three か 3 か、10 未満と 10〜12 は別に）ごとに、文書の中で少ないほうを指摘します。
+  en: How a document writes numbers (1,000 or 1000; 10% or 10 percent; three files or 3 files) is a choice either way. What reads badly is mixing them in one document, which makes the reader wonder whether the difference means something. chaff does not decide which is right; for digit grouping, the percent unit and counts (below ten, and ten to twelve, separately, so that a style that spells out small numbers stays consistent) it points at whichever the document uses less.
+
+message:
+  ja: 「{written}」と書いています（この文書はふつう「{usual}」の書き方。{of} 箇所のうち {count} 箇所が違う）
+  en: '"{written}" here, where the document usually writes "{usual}" ({count} of {of})'
+
+messages:
+  count:
+    ja: 数え方の数を「{written}」と書いています（この文書はふつう「{usual}」の書き方。{of} 箇所のうち {count} 箇所が違う）
+    en: 'The count "{written}" here, where the document usually writes counts like "{usual}" ({count} of {of})'
+  grouping:
+    ja: 「{written}」と書いています（この文書は大きな数をふつう「{usual}」のように書きます。{of} 箇所のうち {count} 箇所が違う）
+    en: '"{written}" here, where the document usually writes large numbers like "{usual}" ({count} of {of})'
+  percent:
+    ja: 百分率を「{written}」と書いています（この文書はふつう「{usual}」の書き方。{of} 箇所のうち {count} 箇所が違う）
+    en: 'The percentage "{written}" here, where the document usually writes "{usual}" ({count} of {of})'
+  count-small:
+    ja: 数を「{written}」と書いています（この文書は 10 未満の数をふつう「{usual}」のように書きます。{of} 箇所のうち {count} 箇所が違う）
+    en: '"{written}" here, where the document usually writes numbers below ten like "{usual}" ({count} of {of})'
+  count-large:
+    ja: 数を「{written}」と書いています（この文書は 10 から 12 の数をふつう「{usual}」のように書きます。{of} 箇所のうち {count} 箇所が違う）
+    en: '"{written}" here, where the document usually writes ten to twelve like "{usual}" ({count} of {of})'
+
+how_to_fix:
+  ja: 文書の多いほうの書き方に合わせてください。チームで決めているなら、STYLE.md に書いておくと迷いません。
+  en: Match the way the rest of the document does it. If the team has decided, write it in the style guide.
+
+# 少ないほうが、その種類の数の何パーセントまでなら「混ざっている」と見るか。これを超えたら、文書が使い分けている。
+levels: { strict: 49, normal: 34, relaxed: 20 }
+
+use_for: [blog, business, technical, docs, academic, legal, literature, speech]
+
+group: consistency
+summary:
+  ja: 3件と三件、1,000 と 1000、10% と 10％ のように、一つの文書で数の書き方が混ざっている所
+  en: One document writing numbers two ways, such as 1,000 and 1000, 10% and 10 percent, or three files and 3 files
+
+example:
+  ja:
+    config: { genre: blog/tech }
+    before: |
+      今月の問い合わせは 12件、先月は 9件、先々月は 7件でした。うち三件は同じ内容です。
+    after: |
+      今月の問い合わせは 12件、先月は 9件、先々月は 7件でした。うち 3件は同じ内容です。
+  en:
+    config: { genre: blog/tech }
+    before: |
+      We fixed three bugs, closed four issues and merged two pull requests. The release also adds 5 tests.
+    after: |
+      We fixed three bugs, closed four issues and merged two pull requests. The release also adds five tests.
+
+not_flagged:
+  ja: 鉤括弧や引用符の中の数、注や URL を含む文、日本語の中の英文は数えません。「一つ」「一人」のような一だけの漢数字と、「万人」「千人」のような位の字だけの漢数字、「第三回」「統一」のように漢字の後ろの数、日付の日・月・年は数えません。位取りは、通貨の記号か数え方の語・単位が付いた大きな数だけを見て、年に見える 4 桁の数（2019 年）、番号（H.R. 5376）、版や電話番号は見ません。全角と半角の違いは fullwidth-alnum-consistency が見ます。法務・文学・話し言葉のジャンルでは見ません。
+  en: 'Numbers inside quotation marks, sentences with a note mark or a URL, and text in another language are not counted. A number word that opens a sentence (spelt out by every style), "one", and a number before a unit of measure (6 months, 3 miles) are not counts. Grouping is checked only for large numbers with a currency sign or a word after them; a four-digit number that looks like a year, a label number (H.R. 5376, Form 1040), versions and phone numbers are left out. Legal, literary and speech genres do not run this rule.'
+level_meaning:
+  ja: 少ないほうの書き方が、その種類の数の {limit}% 以下のとき指摘
+  en: reported when the less common style is {limit}% of its kind or less
+rewrite:
+  ja:
+    direction: 少ないほうの書き方の数を、文書の多いほうの書き方に直してください。数そのものと単位は変えません。
+    pairs:
+      - before: |
+          今月の問い合わせは 12件、先月は 9件でした。うち三件は同じ内容です。
+        after: |
+          今月の問い合わせは 12件、先月は 9件でした。うち 3件は同じ内容です。
+      - before: |
+          参加費は 1,500円、資料代は 2,000円、懇親会は 3000円です。
+        after: |
+          参加費は 1,500円、資料代は 2,000円、懇親会は 3,000円です。
+    keep:
+      - 数の値と単位
+      - 引用した文の中の数
+    avoid:
+      - 多いほうの書き方を少ないほうに合わせる
+      - 数え方の語や単位を言い換える
+  en:
+    direction: Rewrite each number in the less common style the way the rest of the document writes that kind of number. Keep the value and the unit.
+    pairs:
+      - before: |
+          We fixed three bugs, closed four issues and merged two pull requests. The release also adds 5 tests.
+        after: |
+          We fixed three bugs, closed four issues and merged two pull requests. The release also adds five tests.
+      - before: |
+          Turnout rose 12% in March and 9% in April, and fell 3 percent in May.
+        after: |
+          Turnout rose 12% in March and 9% in April, and fell 3% in May.
+    keep:
+      - the value and the unit of every number
+      - numbers inside a quotation
+    avoid:
+      - changing the many numbers to match the odd one
+      - rewording the unit or the counted noun

package/rules/number-without-unit.yaml

@@ -0,0 +1,96 @@
+id: number-without-unit
+layer: L1
+status: experimental
+how_to_find: number-without-unit
+severity: warning
+
+name:
+  ja: 単位の無い数
+  en: Number without its unit
+
+why:
+  ja: 表の同じ列や、同じ見出しの語（「予算：」）のほかの値には単位があるのに、一つだけ数しか書いていない所です。円なのか千円なのか、分なのか時間なのかを、読み手が推し量ることになります。
+  en: Every other value in the same table column, or under the same label ("Budget:"), carries a unit, and this one is a bare number. The reader has to guess whether it is dollars or thousands, minutes or hours.
+
+message:
+  ja: 「{value}」に単位がありません（「{name}」のほかの値には「{unit}」が付いています）
+  en: '"{value}" has no unit (the other "{name}" values carry "{unit}")'
+
+how_to_fix:
+  ja: 単位を書いてください。列のすべての値が同じ単位なら、見出しに書いて（「金額（円）」）値から外す書き方もあります。
+  en: Write the unit. If every value in a column shares it, you can move it to the header ("Amount ($)") and drop it from the values.
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: structure
+summary:
+  ja: 同じ列や同じ見出しの語のほかの値には単位があるのに、数だけを書いた値
+  en: A bare number where the other values of the same column or label all carry one unit
+example:
+  ja:
+    before: |
+      # 費用
+
+      | 品目 | 金額 |
+      | --- | --- |
+      | 設計 | 300,000円 |
+      | 開発 | 1,200,000 |
+      | 試験 | 250,000円 |
+    after: |
+      # 費用
+
+      | 品目 | 金額 |
+      | --- | --- |
+      | 設計 | 300,000円 |
+      | 開発 | 1,200,000円 |
+      | 試験 | 250,000円 |
+  en:
+    before: |
+      # Costs
+
+      | Item | Cost |
+      | --- | --- |
+      | Train | $600 |
+      | Hotel | 960 |
+      | Taxi | $100 |
+    after: |
+      # Costs
+
+      | Item | Cost |
+      | --- | --- |
+      | Train | $600 |
+      | Hotel | $960 |
+      | Taxi | $100 |
+
+not_flagged:
+  ja: ほかの値に二つ以上、同じ一つの単位が付いているときだけ指します。単位の無い値のほうが多い列、単位が混ざる列（分と時間）、数でない値（未定）は見ません。表の見出しの単位（「金額（円）」）は読みません。
+  en: Reported only when at least two other values carry one and the same unit. A column where bare numbers are the majority, one that mixes units (minutes and hours), and values that are not numbers (TBD) are not checked. A unit written in the header ("Amount ($)") is not read.
+rewrite:
+  ja:
+    direction: 指摘された数に、同じ列や同じ見出しの語のほかの値と同じ単位を付けてください。単位が違うはずなら、作らずに書き手に聞きます。
+    pairs:
+      - before: "| 開発 | 1,200,000 |"
+        after: "| 開発 | 1,200,000円 |"
+      - before: "- 所要時間：45"
+        after: "- 所要時間：45分"
+    keep:
+      - 数そのもの
+      - ほかの値と、列の並び
+    avoid:
+      - 単位に合わせて数を換算する
+      - 違う単位を推して書く（千円の列に円）
+  en:
+    direction: Give the bare number the unit the other values in its column or under its label carry. If it should be a different unit, do not guess; ask the writer.
+    pairs:
+      - before: "- Train: 120"
+        after: "- Train: $120"
+      - before: "| Build | 1,200,000 |"
+        after: "| Build | $1,200,000 |"
+    keep:
+      - the number itself
+      - the other values and the order of the columns
+    avoid:
+      - converting the number to match a unit
+      - guessing a different unit (thousands in a column of dollars)

package/rules/one-sentence-paragraph-run.yaml

@@ -0,0 +1,95 @@
+id: one-sentence-paragraph-run
+layer: L3
+status: experimental
+how_to_find: one-sentence-paragraph-run
+severity: info
+
+name:
+  ja: 一文だけの段落が続いている
+  en: Run of one-sentence paragraphs
+
+why:
+  ja: 段落は、一つの話題にまとまった文の組です。一文ごとに段落を分けると、どの文とどの文が同じ話なのかが見えなくなり、読み手は文の関係を自分で組み立てることになります。一文の段落は強調として効きますが、続くと効かなくなります。見出し・箇条書き・表・コードを挟んだ所で数え直します。
+  en: A paragraph groups the sentences that belong to one point. Setting every sentence apart as its own paragraph hides which sentences go together, and leaves the reader to work out how they relate. A one-sentence paragraph works as emphasis; a run of them does not. A heading, a list, a table or code between paragraphs starts the count again.
+
+message:
+  ja: 一文だけの段落が {count} 個続いています（{limit} 個まで）
+  en: "{count} one-sentence paragraphs in a row (limit {limit})"
+
+how_to_fix:
+  ja: 同じ話の文を一つの段落にまとめてください。並べたい項目なら箇条書きにします。
+  en: Join the sentences that make one point into one paragraph. If they are items, make them a list.
+
+levels: { strict: 3, normal: 4, relaxed: 6 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: readability
+summary:
+  ja: 一文ごとに段落を分けた所が続き、どの文が同じ話なのかが見えない所
+  en: Paragraph after paragraph of a single sentence, so nothing is grouped
+example:
+  ja:
+    before: |
+      新しい会議室が来月から使えます。
+
+      予約は総務部の画面から入れてください。
+
+      一回の予約は二時間までです。
+
+      飲食はできません。
+
+      使い終わったら机を元に戻してください。
+    after: |
+      新しい会議室が来月から使えます。予約は総務部の画面から入れてください。一回の予約は二時間までです。
+
+      使うときは、飲食はしないでください。使い終わったら机を元に戻してください。
+  en:
+    before: |
+      The new meeting room opens next month.
+
+      Book it through the facilities page.
+
+      A booking can last two hours.
+
+      No food or drink is allowed.
+
+      Put the desks back when you leave.
+    after: |
+      The new meeting room opens next month. Book it through the facilities page; a booking can last two hours.
+
+      In the room, no food or drink is allowed. Put the desks back when you leave.
+
+not_flagged:
+  ja: 上限までの一文の段落、見出し・箇条書き・表・コードを挟んだ段落、改行一つでつないだ行は数えません。法務と文学のジャンルでは既定で止めています（条項や定義、台詞や詩の行は、一文ずつ立てるのが形のため）。
+  en: One-sentence paragraphs up to the limit, paragraphs separated by a heading, a list, a table or code, and lines joined by a single line break are not counted together. The legal and literature presets turn it off, since a clause, a definition, a line of dialogue or of verse stands alone by form.
+level_meaning:
+  ja: 一文だけの段落の連続 {limit} 個まで
+  en: up to {limit} one-sentence paragraphs in a row
+rewrite:
+  ja:
+    direction: 同じ話の文を一つの段落にまとめてください。並べた項目なら箇条書きにします。文の中身と順序は変えません。
+    pairs:
+      - before: "新しい会議室が来月から使えます。\n\n予約は総務部の画面から入れてください。\n\n一回の予約は二時間までです。"
+        after: 新しい会議室が来月から使えます。予約は総務部の画面から入れてください。一回の予約は二時間までです。
+      - before: "障害は直りました。\n\n原因は設定の誤りでした。\n\n同じ設定の機器も直しました。"
+        after: 障害は直りました。原因は設定の誤りで、同じ設定の機器も直しました。
+    keep:
+      - 文の中身と順序
+      - 強調のために一文で立てた段落（一つなら残す）
+    avoid:
+      - 話題の違う文を一つの段落に詰める
+      - 文を削る
+  en:
+    direction: Join the sentences that make one point into one paragraph; if they are items, make a list. Keep what each sentence says, in order.
+    pairs:
+      - before: "The new meeting room opens next month.\n\nBook it through the facilities page.\n\nA booking can last two hours."
+        after: The new meeting room opens next month. Book it through the facilities page; a booking can last two hours.
+      - before: "The outage is over.\n\nThe cause was a wrong setting.\n\nWe fixed the other servers with the same setting."
+        after: The outage is over. The cause was a wrong setting, and we fixed the other servers that had it.
+    keep:
+      - what each sentence says, in order
+      - a single one-sentence paragraph kept for emphasis
+    avoid:
+      - packing different points into one paragraph
+      - deleting sentences

package/rules/orthographic-variant.yaml

@@ -0,0 +1,87 @@
+id: orthographic-variant
+layer: L3
+status: experimental
+how_to_find: orthographic-variant
+# 語の一覧は持たない。文書の中の語を、日本語は辞書の形の読み（出来る・できる はどちらもデキル）で、カタカナ語は小さい字と「ー」を
+# ならした形で、英字は大文字小文字とハイフンを外した形で束ね、同じ語の書き方が二つあれば少ないほうを指す。
+# 読みが同じで意味の違う語（成る・なる）は lang-ja の orthographic-variant-distinct に並べて外す。
+uses: [pos]
+severity: info
+
+name:
+  ja: 同じ語の書き方がゆれている
+  en: One word spelled two ways
+
+why:
+  ja: 「出来る」と「できる」、「引っ越し」と「引越し」、「ウィンドウ」と「ウインドウ」、「e-mail」と「email」のように、同じ語を一つの文書の中で二通りに書くと、検索で別の語になり、読み手は別のものを指しているのかと迷います。どちらが正しいかは決めません。chaff は語の一覧を持たず、文書の中の語を読み（日本語）やならした綴り（カタカナ語と英字）で束ね、文書の中で少ないほうを指摘します。補助動詞と形式名詞（見て下さい、その事）は、本来の使い方（資料を下さい）と別に比べるので、「補助動詞はかなで書く」と決めた文書はそろっていると見ます。漢字の違う同音の語（書く・描く、機会・機械）は別の語と見ます。少ないほうが三分の一を超える文書は、使い分けていると見て言いません。
+  en: Writing one word two ways in one document (e-mail and email, GitHub and Github) makes search treat them as different words and leaves the reader wondering whether two things are meant. chaff does not decide which way is right and keeps no list of words; it groups the document's own words, by reading in Japanese and by spelling without hyphens and case in English, and points at whichever way the document uses less. The case of the first letter is left out, since a sentence or a title gives it (Email, email), and so are words in capitals only. It says nothing when the minority is more than a third, since the document then uses both on purpose.
+
+message:
+  ja: 「{written}」と書いています（この文書はふつう「{other}」と書く語です。{of} 箇所のうち {count} 箇所が違う）
+  en: '"{written}" here, where the document usually writes "{other}" ({count} of {of})'
+
+how_to_fix:
+  ja: 文書の多いほうの書き方に合わせてください。チームで決めているなら、chaff.yaml の prefer に書くと、それからは preferred-term がその向きで見ます。
+  en: Match the way the rest of the document writes it. If the team has decided, list it under prefer in chaff.yaml, and preferred-term checks that direction from then on.
+
+placeholders:
+  written:
+    ja: この箇所の書き方（日本語は辞書の形）
+    en: the spelling here
+  other:
+    ja: 文書でいちばん多い書き方
+    en: the spelling the document uses most
+
+# 少ないほうが語の何パーセントまでなら「ゆれている」と見るか。これを超えたら、文書が使い分けている。
+levels: { strict: 49, normal: 34, relaxed: 20 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: consistency
+summary:
+  ja: 「出来る」と「できる」、「引っ越し」と「引越し」のように、同じ語を一つの文書の中で二通りに書いている所（語の一覧なしで見つけます）
+  en: One word written two ways in one document (e-mail and email, GitHub and Github), found without a word list
+example:
+  ja:
+    before: |
+      申請は窓口でできます。郵送でもできます。代理の人も申請出来ます。
+    after: |
+      申請は窓口でできます。郵送でもできます。代理の人も申請できます。
+  en:
+    before: |
+      Send the form by email. We answer every email within a day. Attach the receipt to the e-mail.
+    after: |
+      Send the form by email. We answer every email within a day. Attach the receipt to the email.
+
+not_flagged:
+  ja: 読みが同じでも漢字の違う語（書く・描く）、補助動詞・形式名詞と本来の使い方の書き分け（見て下さい・資料を下さい）、書き分けが意味の違いになる語（成る・なる、言う・いう）、語末の「ー」だけの違い（katakana-long-vowel が見ます）、鉤括弧や引用符の中、chaff.yaml の names に書いた名前は見ません。英字は、頭の字の大文字小文字（Email と email）と、大文字だけの語（強調や略語）を書き方の違いにしません。少ないほうが三分の一を超えるときも言いません。文学のジャンルでは既定で止めています（その時代の書き方のため）。
+  en: The case of a word's first letter (Email, email; Long-Term, long-term) is not a spelling, nor is a word in capitals only (emphasis or an acronym). Hyphenated words that are another word (re-sign, resign), part of an address (github.com), anything in quotation marks and the team's names are not compared. Nothing is reported when the minority is more than a third. The literature preset turns it off, since old spelling belongs to its time.
+level_meaning:
+  ja: 少ないほうが語の {limit}% 以下のとき指摘
+  en: reported when the minority spelling is {limit}% of the word's uses or less
+rewrite:
+  ja:
+    direction: 同じ語の書き方を、文書でいちばん多い書き方にそろえてください。意味の違う語に書き分けているなら、そのままにします。
+    pairs:
+      - before: 代理の人も申請出来ます。
+        after: 代理の人も申請できます。
+      - before: 引越しの日を決めてください。
+        after: 引っ越しの日を決めてください。
+    keep:
+      - 語の意味と、文の中の位置
+      - 意味の違いで書き分けている語（資料を下さい・見てください）
+    avoid:
+      - 少ないほうに合わせて、多いほうを書き換える
+      - 引用した文の書き方を変える
+  en:
+    direction: Write each word the way the rest of the document writes it. If two spellings mark two meanings, leave them.
+    pairs:
+      - before: Attach the receipt to the e-mail.
+        after: Attach the receipt to the email.
+      - before: The code is on Github.
+        after: The code is on GitHub.
+    keep:
+      - the meaning and the place of the word
+      - quoted text as quoted
+    avoid:
+      - changing the majority to match the minority

package/rules/outside-announced-list.yaml

@@ -0,0 +1,80 @@
+id: outside-announced-list
+layer: L3
+status: experimental
+how_to_find: outside-announced-list
+requires: [pos]
+severity: warning
+
+name:
+  ja: 挙げた一覧に無い名前
+  en: A name outside the announced list
+
+why:
+  ja: 「対応 OS は Windows と macOS です」と挙げたあとに「Linux にも対応しています」と書くと、どちらが本当の一覧なのか読み手は決められません。対応先を足したときに最初の一覧を直し忘れたか、別の製品の文を写したことが多いです。chaff はどちらが正しいかを決めず、一覧に無い名前を指します。一覧を言う語は言語ごとの語彙表にあり、同じ組（対応する OS、対応する言語）の語どうしだけを比べます。
+  en: Listing "supported on Windows and macOS" and later writing "also runs on Linux" leaves the reader unable to tell which list is true. Usually a platform was added and the first list was not updated, or a sentence came from another product's page. chaff does not decide which is right; it points at the name the first list does not have. The words that announce a list are in each language's lexicon, and only words of the same group (platforms, languages) are compared.
+
+message:
+  ja: 「{name}」は、{listLine} 行目で挙げた一覧（{list}）にありません
+  en: '"{name}" is not in the list given on line {listLine} ({list})'
+
+how_to_fix:
+  ja: 一覧が古いなら一覧に足し、後の文が誤りなら直してください。
+  en: If the list is out of date, add the name to it; if the later sentence is wrong, correct it.
+
+placeholders:
+  name:
+    ja: 名前
+    en: the name
+  list:
+    ja: 一覧
+    en: the list
+  listLine:
+    ja: 〇
+    en: N
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: consistency
+summary:
+  ja: 「対応 OS は Windows と macOS」と挙げたあとで、一覧に無い「Linux」に対応すると書いている所
+  en: A later sentence naming a platform or language that the list given earlier does not have
+example:
+  ja:
+    before: |
+      対応OSはWindowsとmacOSです。インストールは五分で終わります。Linuxにも対応しています。
+    after: |
+      対応OSはWindowsとmacOSとLinuxです。インストールは五分で終わります。Linuxにも対応しています。
+  en:
+    before: |
+      The app is supported on Windows and macOS. Setup takes five minutes. It is also supported on Linux.
+    after: |
+      The app is supported on Windows, macOS and Linux. Setup takes five minutes. It is also supported on Linux.
+
+not_flagged:
+  ja: 一覧を言う語（対応OSは、に対応、版）のすぐ隣に並べた固有名詞だけを読みます。最初に二つ以上の名前を挙げた文を一覧とし、それより前の文は見ません。組の違う語（対応する OS と、対応する言語）は比べません。
+  en: Only proper nouns right next to a listing word (supported on, available in, version) are read. The first sentence naming two or more is the list, and earlier sentences are not checked. Words of different groups (platforms and languages) are not compared.
+rewrite:
+  ja:
+    direction: 一覧と後の文のどちらが正しいかを書き手に確かめてください。後の文が正しければ一覧に名前を足し、一覧が正しければ後の文を直すか消します。
+    pairs:
+      - before: 対応OSはWindowsとmacOSです。（中略）Linuxにも対応しています。
+        after: 対応OSはWindowsとmacOSとLinuxです。（中略）Linuxにも対応しています。（Linux に対応しているとき）
+      - before: 本製品はiOSとAndroidに対応しています。（中略）Windows版では設定画面が違います。
+        after: 本製品はiOSとAndroidに対応しています。（中略の後の文を消す。Windows 版が無いとき）
+    keep:
+      - 一覧の名前と、それぞれの文の中身
+    avoid:
+      - 書き手に確かめずに一覧を足したり減らしたりする
+  en:
+    direction: Ask the writer whether the list or the later sentence is right. If the later sentence is right, add the name to the list; if the list is right, correct or delete the later sentence.
+    pairs:
+      - before: The app is supported on Windows and macOS. (...) It is also supported on Linux.
+        after: The app is supported on Windows, macOS and Linux. (...) It is also supported on Linux. (when Linux is supported)
+      - before: The guide is available in English and French. (...) It is also available in German.
+        after: The guide is available in English and French. (the later sentence deleted, when there is no German edition)
+    keep:
+      - the names in the list and what each sentence says
+    avoid:
+      - adding to or trimming the list without asking the writer

package/rules/padded-intro.yaml

@@ -49,3 +49,28 @@ not_flagged:
 level_meaning:
   ja: 当てはまる書き出しが {limit} 箇所あれば指摘
   en: reported once there are {limit}
+rewrite:
+  ja:
+    direction: どの文書にも当てはまる書き出し（「近年、〜が注目されています」）を消し、この文書だけが扱う状況か主張から始めてください。それが本文に無ければ書き手に聞きます。
+    pairs:
+      - before: 近年、生成 AI が注目されています。本記事では、社内での使い方を紹介します。
+        after: 社内で生成 AI を使うときの手順を紹介します。
+      - before: テレワークが普及する中、会議の進め方が見直されています。当社では週次会議を 30 分に短くしました。
+        after: 当社では週次会議を 30 分に短くしました。
+    keep:
+      - この文書だけの状況と主張
+    avoid:
+      - 書き出しを別の一般論（「今や〜は欠かせません」）に替える
+      - 本文に無い場面や逸話を作る
+  en:
+    direction: Delete the opening that fits any document ("In recent years, X has gained attention") and start from the situation or the claim only this piece has. If the body has none, ask the writer.
+    pairs:
+      - before: In recent years, generative AI has gained attention. This article shows how we use it internally.
+        after: This article shows how we use generative AI internally.
+      - before: As remote work spreads, meetings are being rethought. We cut our weekly meeting to 30 minutes.
+        after: We cut our weekly meeting to 30 minutes.
+    keep:
+      - the situation and claim only this piece has
+    avoid:
+      - swapping the opening for another generality ("X is now essential")
+      - inventing a scene or an anecdote that is not in the body

package/rules/paragraph-length-variance.yaml

@@ -22,6 +22,14 @@ how_to_fix:
 
 levels: { strict: 40, normal: 30, relaxed: 20 }
 
+options:
+  min_paragraphs:
+    kind: count
+    default: 6
+    about:
+      ja: 測る段落の数の下限。段落が少ないと長さのばらつきは偶然で小さく出て、人の書いた文書でも揃って見えます
+      en: The fewest paragraphs measured. With few paragraphs, the variation is small by chance, and a person's writing looks uniform too
+
 use_for: [blog, legal, docs, academic, literature, speech]
 
 group: ai-tells
@@ -38,6 +46,10 @@ example:
 
       続けて、仲間を招きます。左の端にある招待の画面で、相手の宛先を入れて送ってください。
 
+      それから、規則を選びます。設定の画面の中ほどで、使いたい規則の段階を一つずつ決めてください。
+
+      そのあとで、記録を残します。どの設定を変えたかを、仲間が読める場所に書き留めてください。
+
       最後に、動きを確かめます。試しの文書を一つ置いて、指摘が画面に出ることを見てください。
     after: |
       最初に、道具を手元に入れます。
@@ -46,6 +58,10 @@ example:
 
       続けて、仲間を招きます。
 
+      それから、規則を選びます。
+
+      そのあとで、記録を残します。どの設定を変えたかを、仲間が読める場所に書き留めてください。変えた理由も一言添えておくと、半年後の自分が助かります。
+
       最後に、動きを確かめます。試しの文書を一つ置いて、指摘が画面に出ることを見てください。
   en:
     config: { genre: blog/tech }
@@ -56,6 +72,10 @@ example:
 
       Then, invite your team. Enter their addresses on the invite page on the left and press send.
 
+      After that, choose the rules. In the middle of the settings page, set the level of each rule you want.
+
+      Then, write it down. Note which settings you changed in a place where your team can read it.
+
       Finally, check that it works. Add a sample document and look for the findings on the screen.
     after: |
       First, install the tool.
@@ -64,11 +84,15 @@ example:
 
       Then, invite your team.
 
+      After that, choose the rules.
+
+      Then, write it down. Note which settings you changed in a place where your team can read it. Add a line on why, too; it will help you in six months.
+
       Finally, check that it works. Add a sample document and look for the findings on the screen.
 
 not_flagged:
-  ja: ビジネス文書と技術文書のジャンルでは見ません。
-  en: Business and technical genres do not run this rule.
+  ja: 段落が 6 より少ない文書は見ません（min_paragraphs で変えられます）。ビジネス文書と技術文書のジャンルでは見ません。
+  en: Documents with fewer than 6 paragraphs are not checked (min_paragraphs changes it). Business and technical genres do not run this rule.
 level_meaning:
   ja: 段落の長さのばらつきが {limit}% 未満なら指摘
   en: reported when paragraph length varies by less than {limit}%