chaffjs 0.17.0 → 0.19.0

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/oxford-comma-consistency.yaml

@@ -25,3 +25,21 @@ how_to_fix:
 levels: { strict: 3, normal: 2, relaxed: 1 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: consistency
+summary:
+  ja: 英語で、並べた最後の and の前にカンマを打つか打たないかが揃っていない所
+  en: Lists that put a comma before the final "and" in some places and not in others
+example:
+  en:
+    before: |
+      We sell apples, pears, and plums. We ship to homes, offices, and schools. We accept cash, cards and vouchers.
+    after: |
+      We sell apples, pears, and plums. We ship to homes, offices, and schools. We accept cash, cards, and vouchers.
+
+not_flagged:
+  ja: カンマを打つかどうかは決めません。半々に分かれた文書では、どちらが少ないとも言えないので指しません。
+  en: Whether to use the comma is not decided. A document split evenly has no minority and is not reported.
+level_meaning:
+  ja: 少ないほうの打ち方が {limit} 箇所以下のとき指摘
+  en: reported when the minority style appears {limit} times or fewer

package/rules/padded-intro.yaml

@@ -30,3 +30,47 @@ levels:
 
 # プレスリリース・メール・議事録の冒頭は理由や用件を言う所で、つかみではない。
 use_for: [blog, business/report, business/proposal, legal, docs, academic, literature, speech]
+
+group: wording
+summary:
+  ja: 「近年、〜が注目されています」のように、どの文書にも当てはまる書き出し
+  en: An opening such as "In recent years, X has gained attention" that fits any document
+example:
+  ja:
+    before: 近年、生成 AI が注目を集めています。今回、社内の問い合わせ対応に試しました。
+    after: 社内の問い合わせ対応に生成 AI を試し、回答までの時間が半分になりました。
+  en:
+    before: In recent years, generative AI has gained significant attention. We tried it on our internal help desk.
+    after: We tried generative AI on our internal help desk, and replies now take half as long.
+
+not_flagged:
+  ja: 文書の冒頭（最初の 4 文）だけを見ます。本文の途中の「近年」は指しません。
+  en: Only the opening (the first four sentences) is checked; "in recent years" later in the text is not reported.
+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,4 +22,77 @@ 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
+summary:
+  ja: どの段落もほぼ同じ長さで、型に流しこんだように見える所
+  en: Paragraphs all of about the same length, as if poured into a mould
+example:
+  ja:
+    config: { genre: blog/tech }
+    before: |
+      最初に、道具を手元に入れます。公式のページから、使う機械に合った版を選んでください。
+
+      次に、設定の画面を開きます。右上の歯車の印を押すと、変えられる項目の一覧が出てきます。
+
+      続けて、仲間を招きます。左の端にある招待の画面で、相手の宛先を入れて送ってください。
+
+      それから、規則を選びます。設定の画面の中ほどで、使いたい規則の段階を一つずつ決めてください。
+
+      そのあとで、記録を残します。どの設定を変えたかを、仲間が読める場所に書き留めてください。
+
+      最後に、動きを確かめます。試しの文書を一つ置いて、指摘が画面に出ることを見てください。
+    after: |
+      最初に、道具を手元に入れます。
+
+      次に、設定の画面を開きます。右上の歯車の印を押すと、変えられる項目の一覧が出てきます。項目は多いですが、最初に触るのは言語と文書の種類の二つだけで足ります。ほかは、使いながら必要になったときに変えてください。
+
+      続けて、仲間を招きます。
+
+      それから、規則を選びます。
+
+      そのあとで、記録を残します。どの設定を変えたかを、仲間が読める場所に書き留めてください。変えた理由も一言添えておくと、半年後の自分が助かります。
+
+      最後に、動きを確かめます。試しの文書を一つ置いて、指摘が画面に出ることを見てください。
+  en:
+    config: { genre: blog/tech }
+    before: |
+      First, install the tool. Pick the version for your computer from the official download page.
+
+      Next, open the settings. The gear icon at the top right shows everything that you can change.
+
+      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.
+
+      Next, open the settings. The gear icon at the top right shows everything that you can change. There are many options, but at first you only need two: the language and the kind of document. Change the rest when you need to.
+
+      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: 段落が 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}%

package/rules/percent-sum-mismatch.yaml

@@ -0,0 +1,58 @@
+id: percent-sum-mismatch
+layer: L3
+status: experimental
+how_to_find: percent-sum-mismatch
+requires: [quantities]
+severity: warning
+
+name:
+  ja: 内訳の割合を足しても 100% にならない
+  en: Shares of a whole that do not add up to 100%
+
+why:
+  ja: 構成比や内訳の百分率を足して 100% にならないと、読み手はどの数字が違うのか、項目が抜けたのかを確かめることになります。項目を足したり消したり、数字を一つだけ直したりしたときに起きます。表のその列の見出しか、箇条書きや表のすぐ上の文・見出しに、全体を分けた割合の語（構成比、内訳、シェア）があるときだけ足します。丸めの誤差は、項目ごとに最後の桁の半分まで（少なくとも 1 ポイント）認めます。
+  en: When the shares of a whole do not add up to 100%, the reader has to work out which figure is wrong or which item is missing. It happens when an item is added or removed, or when one figure is changed. The percentages are added only when the column's header, or the sentence or heading right above the list or the table, names the parts of a whole (breakdown, market share, composition). Rounding is allowed, up to half the last digit per item (at least one point).
+
+message:
+  ja: 内訳の割合の和が {sum} で、100% になりません
+  en: The shares add up to {sum}, not 100%
+
+how_to_fix:
+  ja: 数字を確かめて、違う数字を直すか、抜けた項目（その他など）を足してください。
+  en: Check the figures. Correct the wrong one, or add the missing item (such as "Other").
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: facts
+summary:
+  ja: 構成比や内訳の百分率を足しても 100% にならない所
+  en: A breakdown whose percentages do not add up to 100%
+example:
+  ja:
+    before: |
+      売上の構成比は次のとおりです。
+
+      - 国内：60%
+      - 海外：30%
+    after: |
+      売上の構成比は次のとおりです。
+
+      - 国内：60%
+      - 海外：40%
+  en:
+    before: |
+      Revenue breakdown by region:
+
+      - US: 60%
+      - Europe: 30%
+    after: |
+      Revenue breakdown by region:
+
+      - US: 60%
+      - Europe: 40%
+
+not_flagged:
+  ja: 割合の語の無い百分率（利用率、伸び率）、複数回答の集計、符号の付いた増減（+3%）、合計の行がある表（合計が内訳の和と合わない の対象）、項目が一つだけのものは足しません。
+  en: 'Percentages not named as shares (rates, growth), multiple-answer counts, signed changes (+3%), a table with a total row (left to "A total that is not the sum of its items"), and a single item are not added.'

package/rules/preamble-length.yaml

@@ -2,6 +2,7 @@ id: preamble-length
 layer: L1
 status: stable
 how_to_find: preamble-length
+requires: [headings]
 severity: info
 
 name:
@@ -23,3 +24,58 @@ how_to_fix:
 levels: { strict: 1, normal: 2, relaxed: 4 }
 
 use_for: [business, legal, docs, academic, literature, speech]
+
+group: structure
+summary:
+  ja: 最初の見出しまでの前置きが長く、本題になかなか入らない所
+  en: Too many paragraphs before the first heading, which delays the point
+example:
+  ja:
+    before: |
+      # 来期の出店計画
+
+      当社はこれまで、駅前を中心に店を増やしてきました。
+
+      この十年で、店の数は二倍になりました。
+
+      一方で、郊外の店の売上は伸び悩んでいます。
+
+      ## 決めたこと
+
+      来期は、郊外の二店を閉じ、駅前に一店を開きます。
+    after: |
+      # 来期の出店計画
+
+      来期は、郊外の二店を閉じ、駅前に一店を開きます。
+
+      ## 理由
+
+      この十年で店の数は二倍になりましたが、郊外の店の売上は伸び悩んでいます。
+  en:
+    before: |
+      # Store plan for next year
+
+      Over the years we have opened most of our stores near stations.
+
+      In the last ten years the number of stores has doubled.
+
+      Suburban stores, however, have struggled to grow.
+
+      ## Decision
+
+      Next year we will close two suburban stores and open one near a station.
+    after: |
+      # Store plan for next year
+
+      Next year we will close two suburban stores and open one near a station.
+
+      ## Why
+
+      The number of stores has doubled in ten years, but suburban stores have struggled to grow.
+
+not_flagged:
+  ja: 表題より下の見出しが一つもない文書は測りません。法務やブログのジャンルでは見ません。
+  en: A document with no heading below its title is not measured. Legal and blog genres do not run this rule.
+level_meaning:
+  ja: 最初の見出しまで {limit} 段落まで
+  en: up to {limit} paragraphs before the first heading

package/rules/preferred-term.yaml

@@ -21,7 +21,35 @@ how_to_fix:
   ja: 「{preferred}」に直してください。固有名詞など、そのままにすべき箇所なら stet で理由を添えて黙らせます。
   en: Change it to "{preferred}". Where it must stay (a product's own name, a quotation), silence it with stet and the reason.
 
+# chaff explain と規則の一覧には指摘が無いので、{preferred} をこう読ませる。
+placeholders:
+  preferred:
+    ja: prefer に並べた使う書き方
+    en: the spelling listed under prefer
+
 # チームが並べた書き方なので、1 つでも指摘する。並べた時点で「使わない」と決めている。
 levels: { strict: 1, normal: 1, relaxed: 3 }
 
 use_for: [business, blog, technical, legal, docs, academic, literature, speech]
+sources: [plain-2011, kyodo-2022]
+
+group: team
+summary:
+  ja: チームで決めた表記と違う書き方（「サーバー」と決めたのに「サーバ」と書いた、など）。chaff.yaml の prefer に書いた組だけを見ます
+  en: A spelling the team has chosen not to use ("e-mail" where the team writes "email"), from prefer in chaff.yaml
+example:
+  ja:
+    config: { prefer: { サーバ: サーバー } }
+    before: 新しいサーバを来週入れます。
+    after: 新しいサーバーを来週入れます。
+  en:
+    config: { prefer: { e-mail: email } }
+    before: Please send it by e-mail.
+    after: Please send it by email.
+
+not_flagged:
+  ja: chaff.yaml の prefer に書いた組だけを見ます。何も書かなければ何も言いません。
+  en: Only the pairs under prefer in chaff.yaml are checked. With nothing listed, it says nothing.
+level_meaning:
+  ja: 当てはまる語が {limit} 箇所あれば指摘
+  en: reported once there are {limit}

package/rules/proper-noun-density.yaml

@@ -15,13 +15,48 @@ why:
   en: A run of product, company and person names hides the shape of the sentence from anyone who does not already know them. It reads fine to the person who wrote it.
 
 message:
-  ja: 1000 語あたり {density} 個の固有名詞があります（{limit} 個まで）
+  ja: 1000 字あたり {density} 個の固有名詞があります（{limit} 個まで）
   en: "{density} proper {density|noun|nouns} per 1000 words (limit {limit})"
 
 how_to_fix:
   ja: 2 度目からは「その製品」「そのチーム」のように受けてください。初出で何者かを一言添えると、知らない人も読めます。
   en: After first use, refer back to it. One phrase saying what it is lets a stranger keep reading.
 
-levels: { strict: 20, normal: 40, relaxed: 80 }
+# 英語は 1000 語あたり。英語の人の書いた文書（コーパスと Project Gutenberg の小説・随筆）で測ると、名前の多さの分布の
+# 95 パーセンタイルあたりに normal を置く。測り方とその値は PR に残した（数字はここに書かない）。
+levels:
+  ja: { strict: 20, normal: 40, relaxed: 80 }
+  en: { strict: 150, normal: 200, relaxed: 260 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: readability
+summary:
+  ja: 製品名・会社名・人名が詰まりすぎて、知らない人には文の形が見えない所
+  en: So many product, company and personal names that a newcomer cannot see the sentence
+example:
+  ja:
+    config: { rules: { proper-noun-density: strict } }
+    pad: true
+    before: |
+      田中さんと佐藤さんが、東京の丸の内にあるトヨタとソニーとパナソニックの展示を見てから、大阪の梅田で日立の鈴木さんと会いました。翌日は京都で任天堂の山本さんと、神戸で川崎重工の中村さんと会い、名古屋に戻ってデンソーの小林さんとトヨタの加藤さんに報告しました。
+    after: |
+      営業部の二人が、取引先三社の展示を見てから、大阪で別の取引先の担当者と会いました。翌日は関西の二社を回り、名古屋に戻って取引先二社に報告しました。
+  en:
+    config: { rules: { proper-noun-density: strict } }
+    pad: true
+    before: |
+      Alice Moreno and Bob Tanaka from Contoso met Carol Diaz from Fabrikam in Seattle, then flew with Dave Okafor from Northwind to Boston to see Erin Walsh at Tailspin and Frank Liu at Litware.
+      In Chicago, Grace Kim of Proseware and Henry Park of Wingtip joined Ivan Petrov of Adatum, and Julia Rossi of Contoso brought Kevin Shah of Fabrikam.
+      From Denver, Laura Chen of Northwind and Mark Evans of Tailspin called Nina Alvarez of Litware, Oscar Grant of Proseware and Paula Novak of Wingtip.
+    after: |
+      Two of our sales team met three customers on the West Coast, then flew to Boston to meet two more.
+      In Chicago, three partners joined them, and our account lead brought a fourth.
+      From Denver, two of the team called the remaining customers.
+
+not_flagged:
+  ja: chaff.yaml の names に書いた名前は、何語に分かれても 1 つと数えます。短い文書（日本語 500 字、英語 200 語より短いもの）は測りません。
+  en: A name listed under names in chaff.yaml counts as one, however many words it has. Short documents (under 200 words) are not measured.
+level_meaning:
+  ja: 1000 字あたり固有名詞 {limit} 個まで
+  en: up to {limit} proper nouns per 1000 words

package/rules/ra-nuki.yaml

@@ -0,0 +1,43 @@
+id: ra-nuki
+layer: L2
+status: experimental
+how_to_find: ra-nuki
+# 一段動詞かどうかは品詞解析で読む。品詞が無ければ動かない。
+requires: [pos]
+languages: [ja]
+severity: warning
+
+name:
+  ja: ら抜き言葉
+  en: Potential form without ra
+
+why:
+  ja: 一段動詞とカ変動詞の可能の形は「られる」です（見られる・食べられる・来られる）。「見れる」「食べれる」「来れる」は話し言葉では広く使われますが、書き言葉では誤りと読まれます。五段動詞の可能の形（走れる・帰れる）は正しいので指しません。どの動詞が一段動詞かは品詞解析で読みます。鉤括弧や引用符で引いた言葉（話した言葉をそのまま引いたもの）は数えません。話し言葉と文学のジャンルでは既定で止めています。
+  en: The potential form of an ichidan verb or of 来る takes られる (見られる, 食べられる, 来られる). 見れる, 食べれる and 来れる are common in speech but read as mistakes in writing. The potential of a godan verb (走れる, 帰れる) is correct and is not reported. Which verbs are ichidan is read by the morphological analyser. Words quoted in brackets or quotation marks (speech quoted as spoken) are not counted. The speech and literature presets turn it off.
+
+message:
+  ja: 「{matched}」は「ら」の抜けた形です
+  en: '"{matched}" drops the ら of the potential form'
+
+how_to_fix:
+  ja: 「ら」を入れてください（見れる → 見られる、食べれる → 食べられる、来れる → 来られる）。
+  en: Put the ら back (見れる → 見られる, 食べれる → 食べられる, 来れる → 来られる).
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: wording
+summary:
+  ja: 「見れる」「食べれる」「来れる」のような、ら抜き言葉
+  en: A Japanese potential form without ら, such as 見れる for 見られる
+example:
+  ja:
+    before: |
+      資料は明日から見れます。
+    after: |
+      資料は明日から見られます。
+
+not_flagged:
+  ja: 五段動詞の可能の形（走れる・帰れる）、鉤括弧や引用符で引いた言葉は指しません。話し言葉と文学のジャンルでは既定で止めています。
+  en: The potential of godan verbs (走れる, 帰れる) and quoted words are not reported. The speech and literature presets turn it off.

package/rules/repeated-conjunction.yaml

@@ -25,3 +25,50 @@ how_to_fix:
 levels: { strict: 1, normal: 2, relaxed: 4 }
 
 use_for: [business, blog, technical, legal, docs, academic, literature, speech]
+
+group: readability
+summary:
+  ja: 「また、」「さらに、」のように、接続詞で始まる段落が続く所
+  en: Paragraph after paragraph opening with a connective such as "Also" or "Moreover"
+example:
+  ja:
+    before: |
+      新しい料金は来月から始まります。
+
+      また、請求書の形式も変わります。
+
+      さらに、支払いの期限が月末になります。
+
+      そして、古い料金は三月で終わります。
+    after: |
+      新しい料金は来月から始まります。
+
+      請求書の形式も変わります。
+
+      支払いの期限は月末になります。
+
+      古い料金は三月で終わります。
+  en:
+    before: |
+      The new prices start next month.
+
+      Also, the invoice format will change.
+
+      Moreover, payment will be due at the end of the month.
+
+      Furthermore, the old prices end in March.
+    after: |
+      The new prices start next month.
+
+      The invoice format will change.
+
+      Payment will be due at the end of the month.
+
+      The old prices end in March.
+
+not_flagged:
+  ja: 接続詞で始まる段落が一つだけなら、流れをつなぐ普通の書き方なので指しません。
+  en: One paragraph opening with a connective is ordinary and is not reported.
+level_meaning:
+  ja: 接続詞で始まる段落の連続 {limit} まで
+  en: up to {limit} paragraphs in a row opening with a connective

package/rules/repeated-sentence-head.yaml

@@ -26,3 +26,26 @@ levels:
   relaxed: 4
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: readability
+summary:
+  ja: 同じ言葉で始まる文が続き、文の切れ目がぼやける所
+  en: Several sentences in a row that open with the same words
+example:
+  ja:
+    before: |
+      この機能は、無料です。この機能は、登録なしで使えます。この機能は、スマートフォンにも対応しています。この機能は、英語でも使えます。
+    after: |
+      この機能は無料で、登録なしで使えます。スマートフォンにも対応していて、英語でも使えます。
+  en:
+    before: |
+      The tool is free. The tool is ready without an account. The tool is fine on phones too. The tool is available in Japanese as well.
+    after: |
+      The tool is free and needs no account. It works on phones too, and it speaks Japanese as well.
+
+not_flagged:
+  ja: 箇条書きの項目どうしが同じ形で始まるのは書き方そのものなので、項目をまたいでは数えません。
+  en: List items that open the same way are a format, not a slip, so a run does not continue across items.
+level_meaning:
+  ja: 同じ書き出しの文の連続 {limit} 文まで
+  en: up to {limit} sentences in a row with the same opening

package/rules/required-sections.yaml

@@ -24,3 +24,52 @@ how_to_fix:
 levels: { strict: 1, normal: 1, relaxed: 2 }
 
 use_for: [business, blog, technical, legal, docs, academic, literature, speech]
+
+group: team
+summary:
+  ja: チームが必須と決めた見出し（「リスク」「費用」など）が無い文書。chaff.yaml の required_sections に書いた見出しだけを見ます
+  en: A heading the team requires (such as "Risks" or "Cost") missing from the document, from required_sections in chaff.yaml
+example:
+  ja:
+    config: { required_sections: [リスク] }
+    before: |
+      # 新しい会計の仕組みへの切り替え
+
+      ## 効果
+
+      月末の締めが三日早くなります。
+    after: |
+      # 新しい会計の仕組みへの切り替え
+
+      ## 効果
+
+      月末の締めが三日早くなります。
+
+      ## リスク
+
+      切り替えの月は、経理部の残業が増えます。
+  en:
+    config: { required_sections: [Risks] }
+    before: |
+      # Moving to the new accounting system
+
+      ## Benefits
+
+      The month closes three days sooner.
+    after: |
+      # Moving to the new accounting system
+
+      ## Benefits
+
+      The month closes three days sooner.
+
+      ## Risks
+
+      Finance will work longer hours in the month we switch.
+
+not_flagged:
+  ja: chaff.yaml の required_sections に書いた見出しだけを見ます。見出しの一部に含まれていれば満たします（「リスク」は「リスクと対策」でも満たす）。
+  en: Only the headings under required_sections in chaff.yaml are checked. A heading that contains the word counts ("Risks" is met by "Risks and mitigations").
+level_meaning:
+  ja: 無い見出しが {limit} 個あれば指摘
+  en: reported once {limit} required headings are missing