chaffjs 0.19.0 → 0.21.0

package/rules/hiragana-fukushi.yaml

@@ -1,6 +1,6 @@
 id: hiragana-fukushi
 layer: L3
-status: experimental
+status: stable
 how_to_find: phrase-match
 word_list: hiragana-fukushi
 uses: [pos]
@@ -26,6 +26,9 @@ how_to_fix:
 levels: { strict: 1, normal: 1, relaxed: 3 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+off_for:
+  literature: "Length, rhythm, repetition and register are the author's choices in literature, and dialogue mixes styles. Only what one work can hold itself to runs: consistent spacing and commas, and numbering without gaps."
+  speech/transcript: "A transcript records what was said: its sentences, repeats and register are the speaker's, not the writer's to fix."
 
 group: readability
 summary:

package/rules/homophone-slip.yaml

@@ -0,0 +1,62 @@
+id: homophone-slip
+layer: L2
+status: stable
+how_to_find: phrase-match
+word_list: homophone-slip
+requires: [pos]
+languages: [en]
+severity: warning
+
+name:
+  ja: 取り違えた同音語（its / it's、their / there）
+  en: Homophone typed for another (its / it's, their / there)
+
+why:
+  ja: 英語の「its」と「it's」、「their」と「there」と「they're」は音が同じで、打ち間違えても綴りの点検では見つかりません。chaff は、次の語で意味が一つに決まる組だけを見ます（「it's own」は「its own」しかなく、「their are」は「there are」しかない）。次の語で決まらない組（its time、they're people）は見ません。組は言語ごとの語彙表にあります。
+  en: '"Its" and "it''s", "their", "there" and "they''re" sound alike, and a spell checker passes either. chaff looks only at pairs where the next word settles which was meant: "it''s own" can only be "its own", "their are" can only be "there are". Pairs the next word does not settle ("its time", "they''re people") are not checked. The pairs are listed in the lexicon.'
+
+message:
+  ja: 「{matched}」は、取り違えた同音語です
+  en: '"{matched}" has one homophone typed for another'
+
+how_to_fix:
+  ja: 意図した語に直してください（it's own → its own、their are → there are、could of → could have）。
+  en: Use the word you meant ("it's own" → "its own", "their are" → "there are", "could of" → "could have").
+
+levels: { strict: 1, normal: 1, relaxed: 2 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+off_for:
+  literature: 'A narrator and a character speak as they speak: dialect ("would of"), "So," and hearsay are the voice.'
+  speech: "A transcript keeps the speaker's words: hedges and ら dropped as spoken."
+
+group: slips
+summary:
+  ja: 英語で、「it's own」「their are」のように、次の語から見て取り違えたと決まる同音語
+  en: '"It''s own", "their are" and other homophones the next word shows were typed for another'
+example:
+  en:
+    before: |
+      The team kept it's own schedule. Their are two reviews left.
+    after: |
+      The team kept its own schedule. There are two reviews left.
+
+not_flagged:
+  ja: 一覧にある組だけを見ます。英語の文書だけで動きます。次の語で決まらない「its time」「they're people」は見ません。小説と話し言葉では使いません（方言や話しぶりをわざと綴るため）。
+  en: Only the pairs on chaff's list are checked, and only in English documents. Pairs the next word does not settle ("its time", "they're people") are not. Not used in fiction or speeches, which spell dialect on purpose.
+level_meaning:
+  ja: 取り違えが {limit} 箇所あれば指摘
+  en: reported once there are {limit}
+rewrite:
+  depth: light
+  en:
+    direction: Correct only the confused word, to the form the lexicon gives.
+    pairs:
+      - before: The service restarts on it's own.
+        after: The service restarts on its own.
+      - before: Their are three open tickets.
+        after: There are three open tickets.
+    keep:
+      - every other word in the sentence
+    avoid:
+      - rewriting the sentence while correcting the word

package/rules/humble-for-others.yaml

@@ -0,0 +1,63 @@
+id: humble-for-others
+layer: L3
+status: stable
+how_to_find: phrase-match
+word_list: humble-for-others
+uses: [pos]
+languages: [ja]
+severity: warning
+
+name:
+  ja: 謙譲語を相手の動作に使っている
+  en: Humble form used for someone else's action
+
+why:
+  ja: 謙譲語（伺う・拝見する・申す・参る）は、自分の側の動作を低めて相手を立てる語です。「伺ってください」「拝見してください」のように読み手の動作に使ったり、「申される」のように尊敬の「れる」を付けたりすると、読み手を低めることになり、失礼に読まれます。
+  en: Japanese humble verbs (伺う, 拝見する, 申す) lower the speaker's own side. Used for the reader's action (伺ってください) or dressed with an honorific (申される), they lower the reader instead.
+
+message:
+  ja: 「{matched}」は謙譲語を相手の動作に使っています
+  en: '"{matched}" uses a humble verb for someone else''s action'
+
+how_to_fix:
+  ja: 尊敬語に直してください。「伺ってください」は「お越しください」、「拝見してください」は「ご覧ください」、「申されました」は「おっしゃいました」です。
+  en: Use the honorific form instead (お越しください, ご覧ください, おっしゃいました).
+
+levels: { strict: 1, normal: 1, relaxed: 2 }
+
+use_for: [blog, business, legal, docs, academic, literature, speech]
+off_for:
+  literature: "Dialogue keeps a character's keigo, mistakes and all."
+
+group: wording
+summary:
+  ja: 「伺ってください」「拝見してください」「申される」のように、謙譲語を読み手や第三者の動作に使った所
+  en: A Japanese humble verb used for the reader's or a third party's action (伺ってください, 申される)
+example:
+  ja:
+    before: 資料は受付で拝見してください。
+    after: 資料は受付でご覧ください。
+
+not_flagged:
+  ja: 一覧にある形だけを見ます。「伺われる」は「窺われる（うかがえる）」と同じ字になるので見ません。「お伺いください」「ご持参ください」のように認める手引きがある形も見ません。小説の台詞にはわざと崩した敬語があるので、文学のジャンルでは見ません。
+  en: Only the forms on chaff's list are checked. 伺われる is not, as it is also 窺われる ("can be seen"). Forms some guides accept (お伺いください) are not listed. Literature does not run this rule.
+level_meaning:
+  ja: 当てはまる形が {limit} 箇所あれば指摘
+  en: reported once there are {limit}
+rewrite:
+  depth: light
+  ja:
+    direction: 読み手や第三者の動作に使った謙譲語を、尊敬語に置き換えてください。頼む形は「お〜ください」「ご〜ください」にします。
+    pairs:
+      - before: 資料は受付で拝見してください。
+        after: 資料は受付でご覧ください。
+      - before: 部長が申されたとおりです。
+        after: 部長がおっしゃったとおりです。
+      - before: 内容をご確認してください。
+        after: 内容をご確認ください。
+    keep:
+      - 誰の動作か（主語）と、頼んでいる中身
+      - 自分の側の動作に使った謙譲語（「私が伺います」）
+    avoid:
+      - 自分の側の動作まで尊敬語にする
+      - 「ご覧になられる」のように、尊敬語を二重にする

package/rules/hyphen-as-dash.yaml

@@ -0,0 +1,59 @@
+id: hyphen-as-dash
+layer: L1
+status: stable
+how_to_find: hyphen-dash
+languages: [en]
+severity: info
+
+name:
+  ja: ダッシュの代わりのハイフン
+  en: Hyphen used as a dash
+
+why:
+  ja: 英語で、空白で挟んだハイフン（late - very late）や二つ重ねたハイフン（late--very late）は、ダッシュ（— や –）の代わりです。ハイフンは語をつなぐ印なので、読み手は一瞬、語の一部かと迷います。
+  en: A spaced hyphen ("late - very late") or a double hyphen ("late--very late") stands in for a dash (— or –). A hyphen joins words, so the reader stops for a moment to see whether it is part of one.
+
+message:
+  ja: 「{matched}」をダッシュの代わりに使っています
+  en: '"{matched}" stands in for a dash'
+
+how_to_fix:
+  ja: ダッシュ（— か –）にするか、読点やコロンで書き直してください。
+  en: Use a dash (— or –), or rewrite with a comma or a colon.
+
+levels: { strict: 1, normal: 1, relaxed: 3 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+off_for:
+  literature: 'Older printed texts set the dash as "--" and titles in capitals.'
+
+group: slips
+summary:
+  ja: 英語で、ダッシュの代わりに、空白で挟んだハイフンや二重のハイフンを使った所
+  en: A spaced hyphen or a double hyphen standing in for a dash
+example:
+  en:
+    before: |
+      The release is late - very late.
+    after: |
+      The release is late — very late.
+
+not_flagged:
+  ja: 語と語のあいだのものだけを見ます。箇条書きの印の「- 」、数の範囲（1 - 2）、語の中のハイフン（well-known）、コードは見ません。文学の文書では既定で止めています（古い版がダッシュを「--」で組むため）。
+  en: Only between words. A list marker ("- "), a number range ("1 - 2"), a hyphen inside a word ("well-known") and code are not reported. The literature presets turn it off, since older printed texts set the dash as "--".
+level_meaning:
+  ja: "{limit} 箇所あれば指摘"
+  en: reported once there are {limit}
+rewrite:
+  depth: light
+  en:
+    direction: Replace the spaced or doubled hyphen with a dash, or rewrite the sentence with a comma or a colon. Use the dash the document already uses, if any.
+    pairs:
+      - before: The release is late - very late.
+        after: The release is late — very late.
+      - before: Two teams--sales and support--will attend.
+        after: Two teams (sales and support) will attend.
+    keep:
+      - the words on both sides
+    avoid:
+      - adding more dashes than the sentence had hyphens

package/rules/idiom-misuse.yaml

@@ -0,0 +1,63 @@
+id: idiom-misuse
+layer: L3
+status: stable
+how_to_find: misuse-match
+word_list: idiom-misuse
+uses: [pos]
+languages: [ja]
+severity: warning
+
+name:
+  ja: 慣用句の誤用
+  en: Misused Japanese idiom
+
+why:
+  ja: 「的を得る」「汚名挽回」のように、二つの慣用句が混ざった形や、語を取り違えた形です。意味は通じても、読み手には言葉を知らない書き手に見え、文書全体が信用されにくくなります。
+  en: A Japanese idiom with a word swapped or two idioms blended (的を得る for 的を射る). The meaning comes through, but the reader takes the writer for careless, and trusts the rest less.
+
+message:
+  ja: 「{matched}」は誤用とされる形です。「{correct}」と書きます
+  en: '"{matched}" is the misused form; the idiom is "{correct}"'
+
+how_to_fix:
+  ja: 正しい形に直してください。「的を得た意見」は「的を射た意見」です。
+  en: Write the established form. 的を得た意見 becomes 的を射た意見.
+
+levels: { strict: 1, normal: 1, relaxed: 2 }
+
+use_for: [blog, business, legal, docs, academic, literature, speech]
+off_for:
+  literature: "Dialogue may misuse an idiom on purpose, to draw the speaker."
+
+group: wording
+summary:
+  ja: 「的を得る」「汚名挽回」のように、取り違えたと決まっている慣用句
+  en: A Japanese idiom in a form dictionaries and style guides list as a mistake (的を得る for 的を射る)
+example:
+  ja:
+    before: 課長の指摘は的を得ていました。
+    after: 課長の指摘は的を射ていました。
+
+not_flagged:
+  ja: 一覧にある形だけを見ます。辞書によって認め方が分かれる形（「押しも押されもしない」）は載せていません。小説の台詞のように、わざと崩した言い方があるので、文学のジャンルでは見ません。
+  en: Only the forms on chaff's list are checked. Forms dictionaries disagree on are not listed. Literature does not run this rule, since dialogue may misuse an idiom on purpose.
+level_meaning:
+  ja: 当てはまる形が {limit} 箇所あれば指摘
+  en: reported once there are {limit}
+rewrite:
+  depth: light
+  ja:
+    direction: 指摘された慣用句を、指摘が示す正しい形に置き換えてください。活用（得た→射た）と前後の語はそのまま残します。
+    pairs:
+      - before: 課長の指摘は的を得ていました。
+        after: 課長の指摘は的を射ていました。
+      - before: 次の大会で汚名挽回を狙います。
+        after: 次の大会で汚名返上を狙います。
+      - before: 油断して足元をすくわれた。
+        after: 油断して足をすくわれた。
+    keep:
+      - 文の意味と、慣用句の活用の形
+      - 引用の中の言葉（人の発言をそのまま写した所）
+    avoid:
+      - 慣用句を消して、平らな言い方に書き換える
+      - 正しい形の候補が二つあるとき（汚名返上と名誉挽回）、文の意味に合わないほうを選ぶ

package/rules/image-file-name-alt.yaml

@@ -0,0 +1,83 @@
+id: image-file-name-alt
+layer: L1
+status: stable
+how_to_find: image-file-name-alt
+word_list: image-file-name
+requires: [markdown]
+severity: warning
+
+name:
+  ja: 画像の代替テキストがファイル名
+  en: Image alt text is a file name
+
+why:
+  ja: 「![IMG_1234.png](IMG_1234.png)」「![スクリーンショット 2026-04-01](a.png)」のように、代替テキストが画像のファイル名のままの所です。画像が読み込めないときと画面読み上げで読むときは代替テキストだけが画像の代わりに伝わりますが、ファイル名は何が写っているかを言いません。画像を貼った道具が名前を入れたまま残ったものがほとんどです。代替テキストが空の画像は image-alt-text が指します。
+  en: An image whose alt text is its file's name ("![IMG_1234.png](IMG_1234.png)", "![Screenshot 2026-04-01](a.png)"). When the image does not load, or a screen reader reads the page, the alt text is all that stands in for it, and a file name says nothing about what it shows. It is usually the name a tool put in when the image was pasted. An empty alt text is image-alt-text's.
+
+message:
+  ja: 画像の代替テキスト「{alt}」はファイルの名前です
+  en: 'The image alt text "{alt}" is a file name'
+
+how_to_fix:
+  ja: 画像が伝えることを一言で書いてください（![4月の売上の推移](IMG_1234.png)）。
+  en: Write what the image shows in a few words ("![Sales by month, April](IMG_1234.png)").
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: structure
+summary:
+  ja: 「![IMG_1234.png](…)」のように、代替テキストがファイル名のままの画像
+  en: An image whose alt text is a file name, as in "![IMG_1234.png](…)"
+example:
+  ja:
+    before: |
+      四月から六月の売上です。
+
+      ![IMG_2041.png](IMG_2041.png)
+    after: |
+      四月から六月の売上です。
+
+      ![四月から六月の売上の推移](IMG_2041.png)
+  en:
+    before: |
+      Sales from April to June.
+
+      ![IMG_2041.png](IMG_2041.png)
+    after: |
+      Sales from April to June.
+
+      ![Sales from April to June](IMG_2041.png)
+
+not_flagged:
+  ja: 画像の拡張子で終わらず、カメラや画面の撮影が付ける名前でもない代替テキスト（![構成図](diagram.png)）は指しません。名前の始まりは言語の語彙表 image-file-name が言います。引用（>）とコードの中の画像も見ません。
+  en: Alt text that does not end in an image extension and does not start with a name a camera or screenshot tool gives ("![Architecture](diagram.png)") is not reported. The names are in the language's image-file-name lexicon. Images in quotations (>) and code are not read.
+rewrite:
+  depth: light
+  ja:
+    direction: 代替テキストを、画像が伝えることを言う短い言葉に変えてください。画像のファイル名（パス）は変えません。何が写っているかが文から分からなければ、推し量らずに書き手に確かめます。
+    pairs:
+      - before: "![IMG_2041.png](sales-q2.png)"
+        after: "![四月から六月の売上の推移](sales-q2.png)"
+      - before: "![スクリーンショット 2026-04-01 10.12.03](settings.png)"
+        after: "![設定画面の通知の欄](settings.png)"
+    keep:
+      - 画像のパス
+      - 前後の文
+    avoid:
+      - 「画像」「図」「スクリーンショット」だけの言葉にする
+      - 写っていないものを推し量って書く
+  en:
+    direction: Replace the alt text with a few words that say what the image shows. Keep the image's path. If the text does not say what it shows, ask the writer rather than guess.
+    pairs:
+      - before: "![IMG_2041.png](sales-q2.png)"
+        after: "![Sales from April to June](sales-q2.png)"
+      - before: "![Screenshot 2026-04-01 at 10.12.03](settings.png)"
+        after: "![The notification options on the settings screen](settings.png)"
+    keep:
+      - the image's path
+      - the sentences around it
+    avoid:
+      - '"image", "picture" or "screenshot" as the whole alt text'
+      - describing what the image may not show

package/rules/impossible-date.yaml

@@ -0,0 +1,79 @@
+id: impossible-date
+layer: L3
+status: stable
+how_to_find: impossible-date
+severity: error
+
+name:
+  ja: 暦に無い日付
+  en: A date the calendar does not have
+
+why:
+  ja: 「2月30日」「4月31日」「2023年2月29日」のような日付は暦にありません。読み手は前の日か次の日か、月の書き違いかを確かめに行くことになり、予定や期限なら誰かが間違った日に動きます。月末を「31日」と決め打ちしたときや、うるう年の予定を使い回したときに起きます。月の長さとうるう年は暦で決まるので、機械で言えます。
+  en: A date such as "February 30", "April 31" or "2023-02-29" is not on the calendar. The reader has to find out whether the day before, the day after or another month was meant, and for a deadline someone acts on the wrong day. It happens when the end of a month is taken to be the 31st, or a leap-year schedule is reused. Month lengths and leap years are fixed by the calendar, so a machine can tell.
+
+message:
+  ja: 「{written}」は暦にありません（{month}月は{days}日まで）
+  en: '"{written}" is not on the calendar (that month has {days} days)'
+
+messages:
+  day:
+    ja: 「{written}」は暦にありません（{month}月は{days}日まで）
+    en: '"{written}" is not on the calendar (that month has {days} days)'
+  leap:
+    ja: 「{written}」は暦にありません（その年はうるう年でなく、2月は{days}日まで）
+    en: '"{written}" is not on the calendar (that year is not a leap year, so February has {days} days)'
+  month:
+    ja: 「{written}」は暦にありません（月は1から12まで）
+    en: '"{written}" is not on the calendar (months run from 1 to 12)'
+
+how_to_fix:
+  ja: 正しい日付を確かめて直してください。月末のつもりなら、その月の最後の日（4月30日、2月28日）を書きます。
+  en: Check the date that was meant and correct it. For the end of a month, write that month's last day (30 April, 28 February).
+
+levels: { normal: error, relaxed: warning }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: facts
+summary:
+  ja: 「2月30日」「4月31日」「2023年2月29日」のように、暦に無い日付
+  en: A date the calendar does not have, such as "February 30", "April 31" or "2023-02-29"
+example:
+  ja:
+    before: 申込みの締切は 4月31日 です。
+    after: 申込みの締切は 4月30日 です。
+  en:
+    before: Applications close on April 31.
+    after: Applications close on April 30.
+
+not_flagged:
+  ja: 元号の年（令和5年）と年を書いていない日付は、うるう年を決められないので 2月29日を言いません。2026-13-45 や 2026/10/45 のような数字だけの並びは、番号や版のこともあるので、月が 1〜12、日が 31 までのときだけ月の長さと比べます。英語の月の名前の日付も、日が 31 までのときだけ見ます。コードの中は読みません。
+  en: For a year in a Japanese era, and for a date without a year, February 29 is not reported, since the leap year cannot be decided. A bare run of numbers such as 2026-13-45 may be an identifier or a version, so it is compared with the month's length only when the month is 1 to 12 and the day at most 31; a date with a month's name is likewise checked only up to the 31st. Code is not read.
+
+rewrite:
+  depth: light
+  ja:
+    direction: 書き手が意図した日を確かめて、暦にある日付に直してください。月末のつもりなら、その月の最後の日を書きます。曜日を添えているなら、曜日も合わせて確かめます。
+    pairs:
+      - before: 締切は 4月31日 です。
+        after: 締切は 4月30日 です。
+      - before: 2023年2月29日に開催します。
+        after: 2023年2月28日に開催します。
+    keep:
+      - 意図した月と、前後の予定の順番
+    avoid:
+      - どの日が正しいか確かめずに、月末の日へ機械的に寄せる
+      - 曜日や「何日後」の数を直さずに残す
+  en:
+    direction: Find out which day was meant and write a date the calendar has. For the end of a month, write that month's last day. When a weekday is written beside it, check that too.
+    pairs:
+      - before: Applications close on April 31.
+        after: Applications close on April 30.
+      - before: The audit runs on 2023-02-29.
+        after: The audit runs on 2023-02-28.
+    keep:
+      - the month meant, and the order of the dates around it
+    avoid:
+      - moving the date to the month's last day without checking which day was meant
+      - leaving a weekday or a "three days later" that no longer matches

package/rules/impossible-time.yaml

@@ -0,0 +1,76 @@
+id: impossible-time
+layer: L3
+status: stable
+how_to_find: impossible-time
+severity: error
+
+name:
+  ja: 時計に無い時刻
+  en: A time the clock does not have
+
+why:
+  ja: 「午後13時」「13 PM」「10時75分」のような時刻は時計にありません。午後1時のつもりか13時のつもりか、分の書き違いか、読み手には分からず、集まる時刻を間違える人が出ます。24時間の書き方と午前・午後の書き方を混ぜたときや、打ち間違えたときに起きます。午前・午後を付けた時は12まで、分と秒は59までなので、機械で言えます。
+  en: A time such as "13 PM", "午後13時" or "10:75" is not on the clock. The reader cannot tell whether 1 PM or 13:00 was meant, or which minute, and someone turns up at the wrong time. It happens when the 24-hour clock and AM/PM are mixed, or a digit is mistyped. With AM or PM the hour runs to 12, and minutes and seconds to 59, so a machine can tell.
+
+message:
+  ja: 「{written}」は時計にありません（午前・午後を付けた時は12まで）
+  en: '"{written}" is not a time (with AM or PM, the hour runs to 12)'
+
+messages:
+  hour:
+    ja: 「{written}」は時計にありません（午前・午後を付けた時は12まで）
+    en: '"{written}" is not a time (with AM or PM, the hour runs to 12)'
+  minute:
+    ja: 「{written}」は時計にありません（分と秒は59まで）
+    en: '"{written}" is not a time (minutes and seconds run to 59)'
+
+how_to_fix:
+  ja: 意図した時刻を確かめて直してください。午後1時なら「午後1時」か「13時」のどちらかで書き、二つを混ぜません。
+  en: Check the time that was meant and correct it. For one in the afternoon write "1 PM" or "13:00", not both at once.
+
+levels: { normal: error, relaxed: warning }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: facts
+summary:
+  ja: 「午後13時」「13 PM」「10時75分」のように、時計に無い時刻
+  en: A time the clock does not have, such as "13 PM", "午後13時" or "10:75"
+example:
+  ja:
+    before: 説明会は午後13時から始めます。
+    after: 説明会は午後1時から始めます。
+  en:
+    before: The briefing starts at 13 PM.
+    after: The briefing starts at 1 PM.
+
+not_flagged:
+  ja: 午前・午後を付けない「25:00」「26時」は、深夜の番組表のように24を超えて数える書き方があるので言いません。「Genesis 24:67」「Science, 12:75」のように頭が大文字の語や区切りの印の後ろの数、「1:75」のような縮尺や比、24を超える数に付いた pm（50 pm はピコメートル）は時刻と読みません。コードの中は読みません。
+  en: A time past 24 without AM or PM ("25:00") is not reported, since late-night schedules count on past midnight that way. Numbers right after a capitalised word or a punctuation mark ("Genesis 24:67", "Science, 12:75"), scales and ratios such as "1:75", and "pm" after a number above 24 (50 pm is picometres) are not read as times. Code is not read.
+
+rewrite:
+  depth: light
+  ja:
+    direction: 書き手が意図した時刻を確かめて、時計にある時刻に直してください。午前・午後を付けるなら時は12までで、24時間で書くなら午前・午後を外します。
+    pairs:
+      - before: 説明会は午後13時から始めます。
+        after: 説明会は午後1時から始めます。
+      - before: 受付は9時75分までです。
+        after: 受付は9時45分までです。
+    keep:
+      - 意図した時刻と、前後の予定の順番
+    avoid:
+      - 午前・午後と24時間の書き方を一つの時刻に重ねる
+      - どの時刻が正しいか確かめずに数だけを変える
+  en:
+    direction: Find out which time was meant and write one the clock has. With AM or PM the hour runs to 12; on the 24-hour clock, drop AM and PM.
+    pairs:
+      - before: The briefing starts at 13 PM.
+        after: The briefing starts at 1 PM.
+      - before: Doors close at 10:75 sharp.
+        after: Doors close at 10:45 sharp.
+    keep:
+      - the time meant, and the order of the times around it
+    avoid:
+      - writing AM or PM on a 24-hour time
+      - changing the digits without checking which time was meant

package/rules/internal-jargon.yaml

@@ -1,6 +1,6 @@
 id: internal-jargon
 layer: L2
-status: experimental
+status: stable
 how_to_find: internal-jargon
 word_list: internal-jargon
 severity: warning

package/rules/invisible-character.yaml

@@ -1,6 +1,6 @@
 id: invisible-character
 layer: L1
-status: experimental
+status: stable
 how_to_find: invisible-character
 severity: warning
 

package/rules/katakana-density.yaml

@@ -0,0 +1,94 @@
+id: katakana-density
+layer: L3
+status: stable
+how_to_find: katakana-density
+# Katakana runs are read from the characters, so the rule needs no morphology. chaff.yaml の names に並べた名前は数えない。
+languages: [ja]
+severity: info
+
+name:
+  ja: カタカナ語が多い
+  en: Too many katakana loanwords
+
+why:
+  ja: 「アジェンダ」「エビデンス」「コンセンサス」のようなカタカナ語が続くと、その言葉に慣れない読み手は意味を追えなくなります。書いた人には普段の言葉なので、多さに気づきにくいところです。
+  en: A run of katakana loanwords (アジェンダ, エビデンス, コンセンサス) loses readers who do not use those words every day. To the writer they are ordinary, so the density goes unnoticed.
+
+message:
+  ja: カタカナ語が 1000 字あたり {density} 語あります（{limit} 語まで）。多いのは「{words}」です
+  en: "{density} katakana loanwords per 1000 characters (limit {limit}); the most used: {words}"
+
+how_to_fix:
+  ja: 日本語で言える語から言い換えてください（アジェンダ→議題、エビデンス→根拠）。製品名や、読み手が使っている用語はそのままでかまいません。
+  en: Replace the ones that have a plain Japanese word (議題 for アジェンダ, 根拠 for エビデンス). Product names and terms the readers use themselves can stay.
+
+# 1000 字あたりの語の数。2022 年より前の Qiita の日本語記事（人が書いた技術記事）で測った分布の上の方に置く。
+# 測り方は PR に残した（数字はここに書かない）。
+levels: { strict: 45, normal: 55, relaxed: 65 }
+
+use_for: [blog, business, legal, docs, academic, literature, speech]
+
+group: wording
+summary:
+  ja: 「アジェンダ」「エビデンス」のようなカタカナ語が、人の書いた技術記事より多い文書
+  en: A Japanese document with more katakana loanwords per 1000 characters than human-written technical articles
+example:
+  ja:
+    before: |
+      今回のアジェンダは、プロジェクトのスコープとスケジュールのレビューです。エビデンスをベースにコンセンサスを取り、ネクストアクションをアサインします。
+
+      クライアントのニーズをヒアリングし、ソリューションのコンセプトをブラッシュアップします。リソースのアロケーションはマネージャーがジャッジします。
+
+      タスクのプライオリティをアップデートし、マイルストーンのリスクをシェアします。フィードバックはチャットでリマインドします。
+
+      ステークホルダーとのミーティングでは、KPI のトレンドをダッシュボードでモニタリングします。ボトルネックはチームでブレインストーミングします。
+
+      ナレッジのドキュメントはテンプレートでフォーマットをアラインし、オンボーディングのマニュアルにマージします。
+
+      パートナーとのアライアンスでは、コストとベネフィットのバランスをシミュレーションします。
+
+      プロセスのボトルネックをアナリティクスでビジュアライズし、オペレーションのコンプライアンスをチェックします。
+
+      カスタマーサクセスのメンバーは、ユーザーのインサイトをインタビューでキャッチアップします。
+
+      セールスのパイプラインは、ウィークリーのレポートでマネジメントにエスカレーションします。
+    after: |
+      今回の議題は、計画の範囲と日程の見直しです。根拠をもとに合意を取り、次にすることの担当を決めます。
+
+      お客様の求めることを聞き取り、解決策の考え方を磨きます。人と予算の割り振りは課長が決めます。
+
+      仕事の優先順位を改め、節目ごとの危うさを伝え合います。意見は連絡用の画面で念を押します。
+
+      関係する部署との会議では、目標の数字の動きを一覧の画面で見守ります。つかえている所は皆で案を出し合います。
+
+      知っていることの記録は、決まった型で書き方を揃え、新しく来た人向けの手引きにまとめます。
+
+      取引先と手を組むときは、かかる費用と得られるものの釣り合いを試算します。
+
+      仕事の流れでつかえている所を数字で見えるようにし、決まりどおりに進んでいるかを確かめます。
+
+      お客様を支える係の人は、使う人の本音を聞き取りで拾い上げます。
+
+      営業の見込みの一覧は、毎週の報告で上の人に上げます。
+
+not_flagged:
+  ja: 短い文書は測りません。コードの中の語と、chaff.yaml の names に並べた名前は数えません。製品名も外来語と区別できないので数えますが、上限は人の書いた技術記事の多さに合わせてあり、普通の技術文書はたいてい収まります。
+  en: Short documents are not measured. Words in code and the names listed in chaff.yaml are not counted. Product names are counted, as they cannot be told apart, but the limit sits above most human-written technical articles.
+level_meaning:
+  ja: カタカナ語が 1000 字あたり {limit} 語まで
+  en: "katakana loanwords: up to {limit} per 1000 characters"
+rewrite:
+  depth: light
+  ja:
+    direction: 多いと示されたカタカナ語から、日本語で言えるものを言い換えてください。読み手が毎日使う用語と製品名は残します。
+    pairs:
+      - before: 今回のアジェンダは、スケジュールのレビューです。
+        after: 今回の議題は、日程の見直しです。
+      - before: エビデンスをベースにコンセンサスを取ります。
+        after: 根拠をもとに合意を取ります。
+    keep:
+      - 製品名・サービス名・人名
+      - 読み手が使っている技術用語（サーバー、ブラウザ）
+    avoid:
+      - 日本語にすると意味がずれる語まで言い換える
+      - カタカナ語を漢語の硬い言葉に置き換えて、かえって読みにくくする

package/rules/katakana-long-vowel.yaml

@@ -1,6 +1,6 @@
 id: katakana-long-vowel
 layer: L3
-status: experimental
+status: stable
 how_to_find: katakana-long-vowel
 # 語は形態素解析で取る。複合語の中の「ユーザー」も一語として見る。品詞が無ければ動かない。
 requires: [pos]