chaffjs 0.18.0 → 0.19.0

package/rules/ai-tell.yaml

@@ -26,6 +26,7 @@ how_to_fix:
 levels: { strict: 10, normal: 18, relaxed: 30 }
 
 use_for: [blog, business, legal, docs, academic, literature, speech]
+sources: [kobak-2025, liang-2024, juzek-ward-2025]
 
 group: ai-tells
 summary:
@@ -49,3 +50,36 @@ not_flagged:
 level_meaning:
   ja: 言い回しの重みの合計が {limit} 点まで
   en: up to a score of {limit}
+rewrite:
+  ja:
+    direction: 決まった言い回しを、その文が実際に言っている中身（誰が、何を、どれだけ）に置き換えてください。中身の無い文は消してください。
+    pairs:
+      - before: 現代社会において、在庫データは発注の判断で重要な役割を果たしています。
+        after: 発注は在庫データを見て決めています。
+      - before: 原因の調査に三日間、時間を溶かしました。
+        after: 原因の調査に三日かかりました。
+      - before: 本記事では、キャッシュの仕組みについて深く掘り下げていきます。
+        after: この記事では、キャッシュの仕組みを説明します。
+    keep:
+      - 数字、日付、名前、条件
+      - 書き手の確かさ（言い切りか、推量か）
+    avoid:
+      - 書き手が書いていない例や数字を作る
+      - 決まり文句を別の決まり文句に替える（「重要な役割を果たす」を「欠かせない存在だ」に）
+      - どの段落も同じ形に書き揃える
+  en:
+    direction: Replace the stock phrase with what the sentence actually claims, who does what and how much. If nothing is claimed, delete the sentence.
+    pairs:
+      - before: In today's fast-paced world, stock data plays a crucial role in ordering.
+        after: Orders are decided from stock data.
+      - before: Let's delve into how the cache works.
+        after: This section explains how the cache works.
+      - before: The release is a testament to the team's meticulous planning.
+        after: The team planned the release in detail.
+    keep:
+      - numbers, dates, names and conditions
+      - how sure the writer is
+    avoid:
+      - inventing an example or a number the writer did not give
+      - trading one stock phrase for another ("plays a crucial role" for "is pivotal")
+      - giving every paragraph the same shape

package/rules/announced-count-mismatch.yaml

@@ -53,5 +53,5 @@ example:
       - Your bank account
 
 not_flagged:
-  ja: 目安の数（約3点、3つ以上）、順番（3つ目）、選ぶ数（以下から1つ選ぶ）、見出しや表の前の数、箇条書きがすぐ後ろに無い数は比べません。予告の文に数が二つあるときも比べません。
-  en: An estimate (about three, three or more), a rank (the first three), how many to pick (choose two), a number before a heading or a table, and a number with no list right after it are not compared. Nor is a sentence with two numbers in it.
+  ja: 目安の数（約3点、3つ以上）、順番（3つ目）、選ぶ数（以下から1つ選ぶ）、見出しや表の前の数、箇条書きがすぐ後ろに無い数は比べません。予告の文に数が二つあるときも比べません。コロンだけで予告する文は、コロンにいちばん近い数を予告の数とみなし、その数の後ろにまだ数があれば比べません（「1 つのページを 2 ページに分けました:」）。どの行も「ラベル：A / B」の形の箇条書きは、斜線（/）で区切って並べた項目の数が合っていれば指摘しません。
+  en: An estimate (about three, three or more), a rank (the first three), how many to pick (choose two), a number before a heading or a table, and a number with no list right after it are not compared. Nor is a sentence with two numbers in it. When only a colon announces the list, the number nearest the colon is the count, so a number followed by another one is not compared ("We merged three tasks into 2 pages:"). A list whose every item is a label, a colon and members split at slashes is not reported when the members add up to the count.

package/rules/announcing-opener.yaml

@@ -49,3 +49,34 @@ not_flagged:
 level_meaning:
   ja: 予告で始まる文が {limit} 個あれば指摘
   en: reported once {limit} sentences open with an announcement
+rewrite:
+  ja:
+    direction: 「重要なのは、」「ポイントは、」のような予告を消し、その後ろの中身から文を始めてください。
+    pairs:
+      - before: 重要なのは、締め切りを先に決めることです。
+        after: 締め切りは先に決めます。
+      - before: 正直に言うと、この設定は分かりにくいです。
+        after: この設定は分かりにくいです。
+      - before: ポイントは、キャッシュを毎回消すことです。
+        after: キャッシュは毎回消します。
+    keep:
+      - 予告の後ろの中身
+      - 文書でいちばん大事な一つにだけ付けた予告
+    avoid:
+      - 予告を別の予告（「大切なのは」「注目すべきは」）に替える
+      - 予告を消したぶん、強める語（「必ず」「非常に」）を足す
+  en:
+    direction: Delete the announcement ("The key point is", "Here's the thing") and start the sentence with what came after it.
+    pairs:
+      - before: The key point is that deadlines come first.
+        after: Deadlines come first.
+      - before: Here's the thing, the setting is confusing.
+        after: The setting is confusing.
+      - before: Honestly, the cache should be cleared every time.
+        after: The cache should be cleared every time.
+    keep:
+      - what followed the announcement
+      - one announcement on the single point that matters most
+    avoid:
+      - swapping one announcement for another ("What matters is", "Notably")
+      - adding an intensifier ("always", "really") to make up for the deleted opener

package/rules/assistant-residue.yaml

@@ -27,6 +27,7 @@ how_to_fix:
 levels: { strict: 10, normal: 10, relaxed: 20 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+sources: [hayashi-aizawa-2026]
 
 group: ai-tells
 summary:
@@ -50,3 +51,32 @@ not_flagged:
 level_meaning:
   ja: 重みの合計が {limit} 点で指摘
   en: reported from a score of {limit}
+rewrite:
+  ja:
+    direction: チャットの相手に向けた言葉（「お役に立てれば」「ご質問があれば」）を消してください。知識の期限を書いた文は、確かめた日付と出典に置き換えます。分からなければ［ ］で空けて書き手に聞きます。
+    pairs:
+      - before: お役に立てれば幸いです。ほかにご質問があればお知らせください。
+        after: （削除）
+      - before: 私の知識は 2023 年までのものですが、料金は三段階です。
+        after: ［確かめた日付］に［出典］で確かめたところ、料金は三段階です。
+      - before: もちろんです！以下に手順をまとめました。
+        after: 手順をまとめます。
+    keep:
+      - 返事の言葉の後ろにある本文
+    avoid:
+      - 確かめた日付や出典を作る
+      - 返事の言葉を、別の丁寧な結び（「ご参考まで」）に替える
+  en:
+    direction: Delete words addressed to a chat partner ("I hope this helps", "Let me know if"). Replace a knowledge-cutoff line with the date checked and the source; if you do not know them, leave [ ] for the writer to fill.
+    pairs:
+      - before: I hope this helps! Let me know if you have any other questions.
+        after: (deleted)
+      - before: As of my last knowledge update, the API had three tiers.
+        after: As of [date checked], [source] lists three tiers.
+      - before: Certainly! Here is a summary of the steps.
+        after: The steps are below.
+    keep:
+      - the content behind the reply words
+    avoid:
+      - inventing the date checked or the source
+      - swapping the reply line for another polite close ("For your reference")

package/rules/bold-density.yaml

@@ -28,6 +28,7 @@ levels:
   relaxed: 40
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+sources: [zhang-2024]
 
 group: readability
 summary:
@@ -59,3 +60,30 @@ not_flagged:
 level_meaning:
   ja: 1000 字あたり太字 {limit} 箇所まで
   en: up to {limit} bold spans per 1000 characters
+rewrite:
+  ja:
+    direction: 太字をいったん全部外し、見落とすと困る所（期限、禁止、金額）を 1〜2 か所だけ太字に戻してください。
+    pairs:
+      - before: "**申請**は**金曜日**までに**必ず**行ってください。"
+        after: 申請は**金曜日まで**に行ってください。
+      - before: "この設定は**とても重要**で、**本番環境**にも**影響します**。"
+        after: この設定は本番環境にも影響します。
+    keep:
+      - 文の中身
+      - 見落とすと困る一か所の強調
+    avoid:
+      - 太字の代わりに「」や記号、絵文字で強める
+      - 太字を外したぶん、強める語を足す
+  en:
+    direction: Unbold everything, then bold again only the one or two spots a reader must not miss (a deadline, a prohibition, an amount).
+    pairs:
+      - before: "Submit the **form** by **Friday** without **fail**."
+        after: Submit the form by **Friday**.
+      - before: "This setting is **very important** and **affects production**."
+        after: This setting affects production.
+    keep:
+      - what the sentences say
+      - one emphasis on what must not be missed
+    avoid:
+      - emphasising with quotes, capitals or emoji instead
+      - adding intensifiers to make up for the removed bold

package/rules/bold-label-list.yaml

@@ -0,0 +1,81 @@
+id: bold-label-list
+layer: L1
+status: experimental
+how_to_find: bold-label-list
+requires: [markdown]
+# English human writing (handbooks, minutes, policies, changelogs) labels list items in bold as a matter of course: the
+# committed English corpus already passes the limit in documents no model wrote. Japanese only until a limit separates them.
+languages: [ja]
+severity: info
+
+name:
+  ja: 太字の札で始まる箇条書きが多い
+  en: Too many list items led by a bold label
+
+why:
+  ja: 「- **速さ**：〜」のように、項目ごとに太字の札とコロンを置いて説明を続ける形です。札が並ぶと、どの項目も同じ重さの見出しに見え、項目どうしの繋がりは書かれません。生成文によく見られる形です。
+  en: 'An item that opens with a bold label and a colon ("- **Speed**: ..."), item after item. The labels make every item look like a heading of equal weight, and the links between the items go unwritten. A shape common in generated text.'
+
+message:
+  ja: 「{label}」など、太字の札で始まる項目が {count} 個あります（{limit} 個から）
+  en: '"{label}" and other bold labels open {count} list items ({limit} needed)'
+
+how_to_fix:
+  ja: 札を外して、項目を文にしてください。大事な項目が 1 つ 2 つなら、それを段落で書き、残りは消すか 1 文にまとめます。用語集のように、本当に札と説明の組を並べるものはそのままでかまいません。
+  en: Drop the labels and write the items as sentences. If only one or two items matter, give them a paragraph and cut or merge the rest. A real glossary, where each label is the term being defined, can stay.
+
+# 指摘に要る項目の数。長さで割らない：人の記事は長くても 1 つ 2 つで、生成文は短くても並べる。
+levels: { strict: 3, normal: 5, relaxed: 8 }
+
+use_for: [blog, business, legal, docs, academic, literature, speech]
+sources: [zhang-2024]
+
+group: ai-tells
+summary:
+  ja: 「- **速さ**：〜」のように、太字の札とコロンで始まる項目が並び、説明が札の続きだけになっている所
+  en: 'List items that open with a bold label and a colon ("- **Speed**: ..."), one after another'
+example:
+  ja:
+    config: { genre: blog/tech }
+    before: |
+      # 新しい在庫システム
+
+      - **速さ**：一覧が 1 秒で出ます。
+      - **正確さ**：数え間違いが減ります。
+      - **安さ**：月の費用が下がります。
+      - **使いやすさ**：画面が分かりやすくなりました。
+      - **安全**：権限を細かく分けられます。
+    after: |
+      # 新しい在庫システム
+
+      一覧は 1 秒で出るようになり、数え間違いも減りました。
+      月の費用は下がり、権限も細かく分けられます。
+
+not_flagged:
+  ja: 札がコードだけの項目（`--flag` の説明のような、設定や引数の一覧）は数えません。札の後ろにコロンが無い項目と、コロンの後ろに何も無い項目も数えません。技術文書・法務・説明書・論文・文学のジャンルでは見ません。英語の文書は、人もよくこの形で書くので見ません。
+  en: An item whose label is only code (a list of options or fields) is not counted, nor is one without a colon after the label or without text after the colon. Technical, legal, documentation, academic and literary genres do not run this rule. Japanese documents only; English writers use this shape as a matter of course.
+level_meaning:
+  ja: 太字の札で始まる項目が {limit} 個あれば指摘
+  en: reported once {limit} list items open with a bold label
+rewrite:
+  ja:
+    direction: 太字の札を外し、項目を文に戻してください。札の語は文の中に入れ、項目どうしの関係（理由、順番、どちらが大事か）を書きます。用語集のように、札が定義される語そのものなら箇条書きのままにします。
+    pairs:
+      - before: |
+          - **速さ**：一覧が 1 秒で出ます。
+          - **正確さ**：数え間違いが減ります。
+        after: |
+          一覧は 1 秒で出るようになり、数え間違いも減りました。
+      - before: |
+          - **原因**：設定ファイルの読み込み順が変わった。
+          - **対策**：読み込み順を固定した。
+        after: |
+          設定ファイルの読み込み順が変わっていたので、順番を固定しました。
+    keep:
+      - 項目の中身と数字
+      - 手順の順番
+      - 用語集の語と定義の組
+    avoid:
+      - 札を消しただけで、同じ並びの短い箇条書きを残す
+      - 太字の札を、見出しのような一文に置き換える
+      - 項目の間に、書き手が書いていない因果を足す

package/rules/closing-cliche.yaml

@@ -57,8 +57,33 @@ example:
       Changing one line of the settings made the build twice as fast. Next, we will try running the tests in parallel.
 
 not_flagged:
-  ja: 最後の節だけを見ます。本文の途中の「まとめると」は普通のつなぎなので指しません。
-  en: Only the last section is checked; "to sum up" in the middle of the text is an ordinary link and is not reported.
+  ja: 最後の節の、終わりの四段落だけを見ます。見出しの無い文書でも同じです。文書の最初の段落と、それより前の本文の「まとめると」は普通のつなぎなので指しません。箇条書きの中も見ません。
+  en: Only the last four paragraphs of the last section are checked, with or without headings; the document's first paragraph and "to sum up" earlier in the text are ordinary links and are not reported. List items are not checked.
 level_meaning:
   ja: 当てはまる結びが {limit} 箇所あれば指摘
   en: reported once there are {limit}
+rewrite:
+  ja:
+    direction: 決まり文句の結びを消してください。本文の結論がすでに最後にあれば、そこで終えます。無ければ、本文で分かったことのうち持ち帰ってほしい一つを一文で書きます。
+    pairs:
+      - before: 設定は管理画面の一か所で変えられます。いかがでしたか？参考になれば幸いです。
+        after: 設定は管理画面の一か所で変えられます。
+      - before: 以上、キャッシュの消し方について解説しました。
+        after: キャッシュは、設定を変えるたびに消してください。（本文の結論がこれであるとき）
+    keep:
+      - 本文の結論
+    avoid:
+      - 本文に無い結論や呼びかけを足す
+      - 「いかがでしたか」を「ぜひ試してみてください」に替える
+  en:
+    direction: Delete the stock closing. If the piece already ends on its conclusion, stop there; if not, state in one sentence the one thing from the body the reader should take away.
+    pairs:
+      - before: The setting lives in one place on the admin page. Hope this helps!
+        after: The setting lives in one place on the admin page.
+      - before: In conclusion, we have explored how to clear the cache.
+        after: Clear the cache after every settings change. (when that is what the body found)
+    keep:
+      - the conclusion the body reached
+    avoid:
+      - adding a conclusion or a call to action that is not in the body
+      - swapping "Hope this helps" for "Give it a try"

package/rules/colon-lead-in.yaml

@@ -52,8 +52,32 @@ example:
       - 地図
 
 not_flagged:
-  ja: 1 つだけのコロンの前置きと、コロンで終わらない前置き（「次のとおりとする。」）は数えません。説明書・法務・技術文書のジャンルでは見ません。短い文書は測りません。英語の文書は、人もよくこの形で書くので見ません。
-  en: A single colon lead-in, and a lead-in that does not end in a colon, are not counted. Documentation, legal and technical genres do not run this rule. Short documents are not measured. Japanese documents only.
+  ja: 1 つだけのコロンの前置きと、コロンで終わらない前置き（「次のとおりとする。」）は数えません。説明書・法務・技術文書のジャンルでは見ません。短い文書は測りません。英語の文書は、人もよくこの形で書くので見ません。日本語の文書の中の英文（Examples include:）も数えません。
+  en: A single colon lead-in, and a lead-in that does not end in a colon, are not counted. Documentation, legal and technical genres do not run this rule. Short documents are not measured. Japanese documents only, and in them only Japanese sentences; an English sentence inside (Examples include:) is not counted.
 level_meaning:
-  ja: 1000 字あたり {limit} 個まで
-  en: up to {limit} per 1000 characters
+  ja: コロンで箇条書きへ渡す文が 1000 字あたり {limit} 個まで
+  en: "colon lead-ins to lists: up to {limit} per 1000 characters"
+rewrite:
+  ja:
+    direction: コロンで箇条書きへ渡す所のうち、項目が二つか三つで互いに繋がっているものを文に戻してください。手順や部品の一覧は箇条書きのままにします。
+    pairs:
+      - before: |
+          保存期間は以下の通りです：
+
+          - 30 日間
+          - 期限を過ぎると消える
+        after: |
+          保存期間は 30 日間で、期限を過ぎると消えます。
+      - before: |
+          利点は次のとおりです：
+
+          - 速い
+          - 安い
+        after: |
+          速くて安いのが利点です。
+    keep:
+      - 項目の中身と数
+      - 手順の順番
+    avoid:
+      - 長い箇条書きを一つの長い文に詰める
+      - 項目の間に、書き手が書いていない因果を足す

package/rules/contrast-framing.yaml

@@ -53,5 +53,36 @@ not_flagged:
   ja: 一つだけの対比、打ち消しを返していない「単なる」（「単なる設定ミスです」）、「A ではなく B です」だけの文、続けて並べた打ち消し（「まだです。まだ試していません。」）は指しません。短い文書は測りません。
   en: A single contrast, a denial nobody answers, and two denials in a row ("It's not ready. It's not tested.") are not reported. Short documents are not measured.
 level_meaning:
-  ja: 1000 字あたり {limit} 個まで
-  en: up to {limit} per 1000 words
+  ja: 1000 字あたり対比の枠 {limit} 個まで
+  en: up to {limit} contrast frames per 1000 words
+rewrite:
+  ja:
+    direction: 打ち消している側（X）を消し、言いたい側（Y）を普通の文で書いてください。X が誰かの実際の誤解なら、その誤解を書いたうえで一度だけ打ち消してください。
+    pairs:
+      - before: この仕組みは単なる道具ではなく、チームの文化です。
+        after: この仕組みは、チームの文化になっています。
+      - before: 問題はツールではなく、運用です。
+        after: 問題は運用にあります。
+      - before: 速さだけでなく、安心も届けます。
+        after: 速く、安心して使えます。
+    keep:
+      - 言いたい側（Y）の中身
+      - 誰かが実際に言った X への反論
+    avoid:
+      - 「ではなく」を「というより」「むしろ」に替えて、同じ枠を残す
+      - 消した X の代わりに、書き手が言っていない主張を足す
+  en:
+    direction: Delete the side you knock down (X) and state the side you mean (Y) as a plain sentence. If X is a real belief someone holds, name it and answer it once.
+    pairs:
+      - before: This tool is not just software, but a culture.
+        after: This tool has become part of how the team works.
+      - before: The problem isn't the tool, it's the process.
+        after: The problem is the process.
+      - before: We don't just ship fast; we ship safely.
+        after: We ship fast and safely.
+    keep:
+      - what Y says
+      - an answer to an X someone actually said
+    avoid:
+      - swapping "not X but Y" for "less X than Y" or "rather than X", which keeps the frame
+      - adding a claim the writer did not make in place of the deleted X

package/rules/cushion-phrase-density.yaml

@@ -15,7 +15,7 @@ why:
   en: One softener is courtesy. Several push the point further away, and the reader has to hunt for it.
 
 message:
-  ja: 「{matched}」など、クッション言葉が 1000 語あたり {density} 個あります（{limit} 個まで）
+  ja: 「{matched}」など、クッション言葉が 1000 字あたり {density} 個あります（{limit} 個まで）
   en: '"{matched}" and other softeners: {density} per 1000 words (limit {limit})'
 
 how_to_fix:
@@ -45,8 +45,35 @@ example:
       Could you check the quote by Friday? The total on page two changed.
 
 not_flagged:
-  ja: クッション言葉が一つだけなら礼儀なので指しません。短い文書は測りません。
-  en: One softener is courtesy and is not reported. Short documents are not measured.
+  ja: クッション言葉が一つだけなら礼儀なので指しません。短い文書（メールなど）は短い手紙ほどの長さの文書として測り、既定の水準では三つ目から指します。一つだけならどの水準でも指しません。
+  en: One softener is courtesy and is not reported. A short document, such as an email, is measured as if it were as long as a short letter, so at the default level the third softener is the first reported; one alone is never reported.
 level_meaning:
-  ja: 1000 字あたり {limit} 個まで
-  en: up to {limit} per 1000 words
+  ja: 1000 字あたりクッション言葉 {limit} 個まで
+  en: up to {limit} softeners per 1000 words
+rewrite:
+  ja:
+    direction: クッション言葉は最初の一つだけ残し、あとは用件（何を、いつまでに）から書いてください。敬語の丁寧さは変えません。
+    pairs:
+      - before: 恐れ入りますが、念のため、お手数ですが、資料をご確認いただけますでしょうか。
+        after: 恐れ入りますが、資料をご確認いただけますか。
+      - before: 大変申し訳ないのですが、もし可能であれば、金曜までにご返信いただけると幸いです。
+        after: 申し訳ありませんが、金曜までにご返信いただけますか。
+    keep:
+      - 敬語の丁寧さと、相手との距離
+      - 依頼の中身、期限、宛先
+    avoid:
+      - クッション言葉を全部消して命令の口調にする
+      - 期限や条件を落とす
+  en:
+    direction: Keep the first softener and lead with the request (what, by when) after that. Keep the level of politeness.
+    pairs:
+      - before: Sorry to bother you, but I just wanted to check whether you might possibly be able to review the draft.
+        after: Sorry to bother you. Could you review the draft?
+      - before: Just a quick note to gently remind you, if you don't mind, that the report is due Friday.
+        after: A reminder that the report is due Friday.
+    keep:
+      - the level of politeness
+      - the request, its deadline and who it is for
+    avoid:
+      - deleting every softener until the request reads as an order
+      - dropping a deadline or a condition

package/rules/dangling-reference.yaml

@@ -25,6 +25,7 @@ how_to_fix:
 levels: { normal: error, relaxed: warning }
 
 use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+sources: [jis-z8301-2019, femmer-2017]
 
 group: structure
 summary:

package/rules/date-order.yaml

@@ -24,6 +24,7 @@ how_to_fix:
 levels: { strict: error, normal: warning, relaxed: info }
 
 use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+sources: [de-marneffe-2008]
 
 group: facts
 summary:

package/rules/date-range-reversed.yaml

@@ -11,7 +11,7 @@ name:
 
 why:
   ja: 「2026年4月1日〜2026年3月31日」のように、期間の終わりの日付が始まりより前だと、読み手はどちらの日付が正しいのかを問い合わせることになります。年を書き写し間違えたときや、日付を片方だけ直したときに起きます。二つの日付の間が範囲の記号（〜、–）だけのときと、「から」でつなぎ終わりの日付のあとに「まで」が続くときを期間として比べます。年の無い期間（12月28日〜1月4日）は年をまたぐかもしれないので比べません。
-  en: 'When a period such as "5 April 2026 – 2 April 2026" ends before it starts, the reader has to ask which date is right. It happens when a year is copied wrong, or when only one of the two dates is changed. Two dates are read as a period when only a range mark (–, —) or a word such as "through" or "until" stands between them. A period without a year ("28 December – 4 January") may run into the next year and is not compared.'
+  en: 'When a period such as "5 April 2026 – 2 April 2026" ends before it starts, the reader has to ask which date is right. It happens when a year is copied wrong, or when only one of the two dates is changed. Two dates are read as a period when only a range mark (–, —) or a word such as "through" or "until" stands between them, or when they are written "from … to …". A period without a year ("28 December – 4 January") may run into the next year and is not compared.'
 
 message:
   ja: 期間「{period}」の終わりが始まりより前です
@@ -43,4 +43,4 @@ example:
 
 not_flagged:
   ja: 年の無い期間（12月28日〜1月4日）、「から」だけで「まで」の無いもの（10日から3日に変更）、日付の間に言葉のあるものは比べません。
-  en: 'A period without a year, "from … to …" (it may move a date rather than span a period), and two dates with words between them are not compared.'
+  en: 'A period without a year, "from … to …" in a sentence with a word that changes a date ("moved from March 10 to March 3", "… was postponed"), and two dates with words between them are not compared.'

package/rules/double-negative.yaml

@@ -0,0 +1,51 @@
+id: double-negative
+layer: L2
+status: experimental
+how_to_find: phrase-match
+word_list: double-negative
+uses: [pos]
+severity: info
+
+name:
+  ja: 二重否定
+  en: Double negative
+
+why:
+  ja: 「行かないわけではない」「知らなくはない」のように打ち消しを打ち消すと、読み手は文を二度ひっくり返して読み、書き手がどちらを言いたいのかも弱まります。言い切れるなら肯定で書けます。言い切れないなら、どの程度なのかを書くほうが伝わります。「ざるを得ない」「なければならない」のような決まった言い方は数えません。言い回しの一覧は言語ごとの語彙表にあります。
+  en: Negating a negative ("not uncommon", "not unlike") makes the reader turn the sentence over twice, and blurs which way the writer leans. If the claim holds, say it positively; if it only partly holds, say how far. "not without" is not counted, since "do not enter without a badge" is a plain prohibition. The phrases are listed in each language's lexicon.
+
+message:
+  ja: 「{matched}」は二重否定です
+  en: '"{matched}" is a double negative'
+
+how_to_fix:
+  ja: 肯定で言い切るか（「行くこともある」）、どの程度なのかを書いてください（「月に一度は行く」）。
+  en: Say it positively ("common", "similar to"), or say how far it holds ("in about a third of cases").
+
+# 何回あれば指摘するか。1 は一つ目から。
+levels: { strict: 1, normal: 1, relaxed: 2 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: readability
+summary:
+  ja: 「〜ないわけではない」「〜しないことはない」のように、打ち消しを打ち消した言い方
+  en: A negative negated, such as "not uncommon" or "not unlike"
+example:
+  ja:
+    before: |
+      その案に賛成しないわけではありません。
+    after: |
+      その案には、費用の点を除けば賛成です。
+  en:
+    before: |
+      Delays are not uncommon in the second quarter.
+    after: |
+      Delays are common in the second quarter.
+
+not_flagged:
+  ja: 「ざるを得ない」「なければならない」のような決まった言い方は指しません。法令・文学・話し言葉のジャンルでは既定で止めています（言い切らない言い方がその文書の書き方のため）。
+  en: Fixed forms such as "not without" are not reported. The legal, literature and speech presets turn it off, since the hedged form is part of how those are written.
+level_meaning:
+  ja: 二重否定を含む文が {limit} 文あれば指摘
+  en: reported once {limit} sentences hold one

package/rules/doubled-punctuation.yaml

@@ -41,5 +41,5 @@ example:
       We will send the file today, as agreed.
 
 not_flagged:
-  ja: 「...」「。。。」のように三つ以上並べたもの、「e.g.,」「etc.;」のような略語の後ろ、「1..10」「../」のような範囲と道のり、「!!」「??」とコロンは指しません。
-  en: Three or more of one mark ("...", "。。。"), the mark after an abbreviation ("e.g.,", "etc.;"), ranges and paths ("1..10", "../"), "!!", "??" and colons are not reported.
+  ja: 「...」「。。。」のように三つ以上並べたものと、そのすぐ後ろの一つの印（「...。」「、、、。」）、「e.g.,」「etc.;」のような略語の後ろ、「1..10」「../」のような範囲と道のり、「!!」「??」とコロンは指しません。
+  en: Three or more of one mark ("...", "。。。") and one mark right after them ("...。", "、、、。"), the mark after an abbreviation ("e.g.,", "etc.;"), ranges and paths ("1..10", "../"), "!!", "??" and colons are not reported.

package/rules/doubled-word.yaml

@@ -11,7 +11,7 @@ name:
   en: Word written twice
 
 why:
-  ja: 「資料をを送ります」「確認確認する」のように同じ語が続くのは、消し忘れか、書き換えの途中で残った語です。読み手はつまずき、急いで書いた文書に見えます。同じ語でも品詞が違うものと、重ねて強める書き方（「そうそう」「一つ一つ」）は数えていません。
+  ja: 「資料をを送ります」「確認確認します」のように同じ語が続くのは、消し忘れか、書き換えの途中で残った語です。読み手はつまずき、急いで書いた文書に見えます。重ねて「それぞれの」を言う名詞（人・単位・時・場所。「個人個人」「一行一行」「毎年毎年」）、名詞や形容詞を重ねて強める形（「駄目駄目」「若い若い」）、擬音・擬態語（「ムクムク」「もちもち」）、笑い声（「ははは」）、決まった言い回し（「などなど」「あるある」）は、重ねるのが正しい書き方なので数えていません。
   en: The same word twice in a row ("the the"), or two words where English takes one ("our the platform"), is left over from an edit. The reader stumbles, and the document looks rushed. Repeats that grammar allows ("had had", "that that", "is, is") and repeats for emphasis ("very very") are not counted.
 
 message:
@@ -39,5 +39,5 @@ example:
     after: We will send the file tomorrow.
 
 not_flagged:
-  ja: 品詞の違う同じ語と、重ねて強める書き方（「そうそう」「一つ一つ」「very very」）は指しません。英語で文法が許す重なり（had had、that that）も指しません。
+  ja: 品詞の違う同じ語、重ねて「それぞれの」を言う名詞（「個人個人」「一行一行」「毎年毎年」）、名詞や形容詞を重ねて強める形（「駄目駄目」「えらいえらい」）、仮名の擬音・擬態語（「ムクムク」「もちもち」）、同じ一字の仮名が三つ以上続く笑い声（「ははは」）、決まった言い回し（「などなど」「あるある」）、重ねて強める書き方（「そうそう」「very very」）は指しません。ほかの漢語の名詞の重なり（「確認確認」「資料資料」）、外来語の重なり（「ユーザーユーザー」）、三つ続く重なり（「早め早め早め」）は指します。英語で文法が許す重なり（had had、that that）も指しません。
   en: Repeats that grammar allows ("had had", "that that"), repeats for emphasis ("very very"), and the same word in two different parts of speech are not reported.

package/rules/duplicate-heading.yaml

@@ -0,0 +1,78 @@
+id: duplicate-heading
+layer: L1
+status: experimental
+how_to_find: duplicate-heading
+requires: [markdown]
+severity: warning
+
+name:
+  ja: 同じ見出しが兄弟に二つある
+  en: Duplicate sibling heading
+
+why:
+  ja: 同じ親の見出しの下に、同じ言葉の見出しが二つあると、目次では区別できず、ページ内リンクはどちらか一方にしか行けません。節を写して見出しを直し忘れたか、同じ話を二か所に書いたときに起きます。親が違えば同じ言葉でもかまいません（変更履歴の版ごとの「追加」「修正」、各章の「まとめ」）。全角と半角、大文字と小文字、空白の数は同じ見出しとして比べます。
+  en: Two headings with the same words under the same parent cannot be told apart in a table of contents, and an in-page link reaches only one of them. It happens when a section is copied and its heading is not changed, or when the same topic is written in two places. Under different parents the same words are fine (a changelog's "Added" and "Fixed" under each version, a "Summary" in each chapter). Case, full-width and half-width forms, and the number of spaces are ignored when comparing.
+
+message:
+  ja: 見出し「{heading}」は、同じ親の下の {firstLine} 行目の見出しと同じです
+  en: 'The heading "{heading}" repeats the one on line {firstLine} under the same parent'
+
+how_to_fix:
+  ja: 二つの節を一つにまとめるか、違いが分かる見出しに直してください。
+  en: Merge the two sections, or give each a heading that says how they differ.
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: structure
+summary:
+  ja: 同じ親の見出しの下に、同じ言葉の見出しが二つある所
+  en: Two headings with the same words under the same parent heading
+example:
+  ja:
+    before: |
+      # 手順書
+
+      ## 準備
+
+      道具をそろえます。
+
+      ## 準備
+
+      手袋をはめます。
+    after: |
+      # 手順書
+
+      ## 準備
+
+      道具をそろえます。
+
+      ## 安全の確認
+
+      手袋をはめます。
+  en:
+    before: |
+      # Setup guide
+
+      ## Before you start
+
+      Gather the tools.
+
+      ## Before you start
+
+      Wear gloves.
+    after: |
+      # Setup guide
+
+      ## Before you start
+
+      Gather the tools.
+
+      ## Safety
+
+      Wear gloves.
+
+not_flagged:
+  ja: 親が違う見出しどうし（版ごとの「追加」「修正」、章ごとの「まとめ」）は比べません。Markdown の文書でだけ動きます。
+  en: Headings under different parents (each version's "Added" and "Fixed", each chapter's "Summary") are not compared. It runs on Markdown only.

package/rules/emoji-density.yaml

@@ -13,17 +13,18 @@ why:
   en: One emoji marks a spot. Many turn the text into decoration, and a screen reader has to say all of them.
 
 message:
-  ja: 1000 語あたり {density} 個の絵文字があります（{limit} 個まで）
+  ja: 1000 字あたり {density} 個の絵文字があります（{limit} 個まで）
   en: "{density} emoji per 1000 words (limit {limit})"
 
 how_to_fix:
   ja: 見出しや強調で代えられるものは代えてください。
   en: Where a heading or emphasis would do the same job, use that instead.
 
-# 1000 語あたりの個数。件数で数えると長い文書ほど当たる。
+# 1000 語（日本語は 1000 字）あたりの個数。件数で数えると長い文書ほど当たる。
 levels: { strict: 3, normal: 8, relaxed: 20 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+sources: [zhang-2024]
 
 group: readability
 summary:
@@ -47,5 +48,5 @@ not_flagged:
   ja: 短い文書（日本語 500 字、英語 200 語より短いもの）は測りません。
   en: Documents under 200 words are not measured.
 level_meaning:
-  ja: 1000 字あたり {limit} 個まで
-  en: up to {limit} per 1000 words
+  ja: 1000 字あたり絵文字 {limit} 個まで
+  en: up to {limit} emoji per 1000 words