chaffjs 0.18.0 → 0.19.0

package/rules/name-variant.yaml

@@ -0,0 +1,88 @@
+id: name-variant
+layer: L3
+status: experimental
+how_to_find: name-variant
+requires: [pos]
+severity: warning
+
+name:
+  ja: 同じ名前の書き分け
+  en: One name written two ways
+
+why:
+  ja: 人や会社や製品の名前を、ある所では「山田太郎」、別の所では「山田太朗」と書くと、読み手は同じ人か別の人か分かりません。契約書なら当事者の特定が揺らぎます。多いのは打ち間違いと、別の文書から写した段落です。どちらの形が正しいかは決めず、文書の中で少ないほうを指します。
+  en: A person, company or product written as "GitHub" in one place and "Github" in another leaves the reader unsure whether they are the same. In a contract it blurs who the party is. The usual causes are a typo and a paragraph pasted from another document. chaff does not decide which form is right; it points at the one the document uses less.
+
+message:
+  ja: 「{name}」は、ほかの所では「{usual}」と書いています
+  en: '"{name}" is written "{usual}" elsewhere in the document'
+
+messages:
+  spelling:
+    ja: 「{name}」は、ほかの所では「{usual}」と書いています（字の大小・幅・記号の違い）
+    en: '"{name}" is written "{usual}" elsewhere in the document (case, width or punctuation)'
+  reading:
+    ja: 「{name}」は、ほかの所では同じ読みの「{usual}」と書いています
+    en: '"{name}" is written "{usual}", read the same, elsewhere in the document'
+  near:
+    ja: 「{name}」は、ほかの所で何度も書いた「{usual}」と一字違いです
+    en: '"{name}" is one letter away from "{usual}", which the document uses more than once'
+
+how_to_fix:
+  ja: 正しい形を確かめ、一つに揃えてください。本当に別の人や会社なら、そのままで構いません。
+  en: Check the right form and use it throughout. If they really are different people or companies, leave them.
+
+placeholders:
+  name:
+    ja: 名前
+    en: the name
+  usual:
+    ja: 別の形
+    en: another form
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: consistency
+summary:
+  ja: 同じ人・会社・製品の名前を、少しだけ違う形で書いている所（山田太郎 と 山田太朗、GitHub と Github）
+  en: The same person, company or product written in slightly different forms (GitHub and Github, Acme, Inc. and Acme Inc.)
+example:
+  ja:
+    before: |
+      担当は山田太郎です。見積もりは山田太郎が作り、請求書は山田太朗が送ります。
+    after: |
+      担当は山田太郎です。見積もりは山田太郎が作り、請求書も山田太郎が送ります。
+  en:
+    before: |
+      The code lives on GitHub. Reviews happen on GitHub, and releases are tagged on Github.
+    after: |
+      The code lives on GitHub. Reviews happen on GitHub, and releases are tagged on GitHub.
+
+not_flagged:
+  ja: 品詞解析が固有名詞と読んだ語だけを見ます。大文字だけの名前（ACME INC、NASA）は見ません。一字違いの英字の名前は、6 字以上で、多いほうが二度以上、少ないほうが一度だけのときに限ります（Iran と Iraq は別の名前）。
+  en: Only words the tagger reads as proper nouns are checked. Names in capitals only (ACME INC, NASA) are left out. Names one letter apart are reported only when six letters or longer, with the usual form used at least twice and the other once (Iran and Iraq are different names).
+rewrite:
+  ja:
+    direction: 少ないほうの形を、多いほうの形に替えてください。どちらが正しいか本文から分からなければ、書き手に聞きます。別の人や会社なら替えません。
+    pairs:
+      - before: 見積もりは山田太郎が作り、請求書は山田太朗が送ります。
+        after: 見積もりは山田太郎が作り、請求書も山田太郎が送ります。
+      - before: 発注先は株式会社ミナト商事です。納品はミナト商時が行います。
+        after: 発注先は株式会社ミナト商事です。納品はミナト商事が行います。
+    keep:
+      - 名前の正しい形
+    avoid:
+      - 別の人や会社の名前を一つにまとめる
+  en:
+    direction: Replace the less frequent form with the usual one. If the text does not show which is right, ask the writer. Leave names that belong to different people or companies.
+    pairs:
+      - before: Reviews happen on GitHub, and releases are tagged on Github.
+        after: Reviews happen on GitHub, and releases are tagged on GitHub.
+      - before: Acme Inc. signs the order. Payment goes to Acme, Inc. within thirty days.
+        after: Acme Inc. signs the order. Payment goes to Acme Inc. within thirty days.
+    keep:
+      - the name's right form
+    avoid:
+      - merging the names of two different people or companies

package/rules/no-doubled-joshi.yaml

@@ -26,6 +26,7 @@ how_to_fix:
 levels: { strict: 1, normal: 2, relaxed: 3 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+sources: [yamamoto-cheng-2015]
 
 group: readability
 summary:

package/rules/no-em-dash.yaml

@@ -30,6 +30,7 @@ levels:
   en: { strict: 3, normal: 8, relaxed: 20 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+sources: [freeburg-2026]
 
 group: ai-tells
 summary:
@@ -53,5 +54,28 @@ not_flagged:
   ja: 短い文書は測りません。英語では、ダッシュそのものを誤りとは言いません。
   en: Short documents are not measured. In English a dash is not called wrong; only a heavy hand is.
 level_meaning:
-  ja: 1000 字あたり {limit} 個まで
-  en: up to {limit} per 1000 words
+  ja: 1000 字あたりダッシュ {limit} 個まで
+  en: up to {limit} dashes per 1000 words
+rewrite:
+  ja:
+    direction: 挟み込みのダッシュは括弧に、言い換えや補足のダッシュは読点に替えるか、二文に分けてください。
+    pairs:
+      - before: この設定——とくに保存期間——は慎重に決めてください。
+        after: この設定（とくに保存期間）は慎重に決めてください。
+      - before: 答えは一つ——締め切りを守ることです。
+        after: 答えは一つ、締め切りを守ることです。
+    keep:
+      - 挟み込んだ中身と、それが掛かる語
+    avoid:
+      - ダッシュを全角コロンや別の線の記号に替えるだけで済ませる
+  en:
+    direction: Turn an aside between dashes into commas or brackets, and a dash before an explanation into a comma, a colon or a new sentence.
+    pairs:
+      - before: The setting — especially retention — needs care.
+        after: The setting, especially retention, needs care.
+      - before: There is one answer — meet the deadline.
+        after: There is one answer. Meet the deadline.
+    keep:
+      - the aside and what it belongs to
+    avoid:
+      - swapping every dash for a colon or a semicolon

package/rules/no-mixed-desumasu.yaml

@@ -34,6 +34,7 @@ how_to_fix:
 levels: { strict: 5, normal: 3, relaxed: 1 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+sources: [yasashii-nihongo-2020, koyobun-2022, jtf-style-guide]
 
 group: consistency
 summary:

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/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}%

package/rules/preferred-term.yaml

@@ -31,6 +31,7 @@ placeholders:
 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:

package/rules/proper-noun-density.yaml

@@ -15,14 +15,18 @@ 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]
 
@@ -39,15 +43,20 @@ example:
     after: |
       営業部の二人が、取引先三社の展示を見てから、大阪で別の取引先の担当者と会いました。翌日は関西の二社を回り、名古屋に戻って取引先二社に報告しました。
   en:
+    config: { rules: { proper-noun-density: strict } }
     pad: true
     before: |
-      Alice and Bob from Contoso met Carol from Fabrikam in Seattle, then flew with Dave from Northwind to Boston to see Erin at Tailspin and Frank at Litware.
+      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} per 1000 words
+  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/requirement-modal.yaml

@@ -0,0 +1,94 @@
+id: requirement-modal
+layer: L2
+status: experimental
+how_to_find: requirement-modal
+# 何を見るかは options で決める。決めなければ何も見ない。語は言語ごとの語彙表 requirement-modal-<standard> と requirement-modal-must にある。
+uses: [pos]
+severity: warning
+
+name:
+  ja: 規定の文末が、決めた書き方と違う
+  en: A provision's verb form is not the one the house rule uses
+
+why:
+  ja: 規格や規程は、要求・推奨・許容を文末の形で書き分けます。読み手は文末で、守らなければならないのか、望ましいだけなのか、してもよいのかを読み取ります。JIS Z 8301:2019 は、推奨に「…すべきである」を、許容と可能性に文末の「…できる」を使わないと決め、「…することが望ましい」「…してもよい」「…可能である」を使います。英語では、米国連邦政府の Plain Language Guidelines が、義務には曖昧な "shall" ではなく "must" を使うとしています。どちらもチームが選ぶ決まりなので、options で決めたときだけ見ます。
+  en: 'A standard or a set of rules tells a requirement from a recommendation and a permission by the form of the verb, and the reader takes from it whether something must be done, should be done or may be done. JIS Z 8301:2019 does not use 「…すべきである」 for a recommendation or a closing 「…できる」 for a permission or a possibility; it uses 「…することが望ましい」, 「…してもよい」 and 「…可能である」. In English, the Federal Plain Language Guidelines use "must" for an obligation instead of "shall", which readers and courts take in more than one way. Both are a team''s choice, so the rule checks only what options turn on.'
+
+message:
+  ja: 「{matched}」は使わない形です。「{preferred}」と書きます
+  en: 'Write "{preferred}" instead of "{matched}"'
+
+how_to_fix:
+  ja: 文が言っていることが要求・推奨・許容・可能性のどれかを決めて、その形に直してください。推奨なら「…することが望ましい」、許容なら「…してもよい」、可能性なら「…可能である」「…場合がある」です。
+  en: 'Decide whether the sentence states an obligation and write "must" ("must not" for a prohibition). Keep "shall" only where a law you quote uses it.'
+
+placeholders:
+  matched:
+    ja: 見つけた形
+    en: the form found
+  preferred:
+    ja: 使う形
+    en: the form to use
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+options:
+  standard:
+    kind: choice
+    default: none
+    about:
+      ja: 規定の文末を、どの規格の決まりで見るか（日本語）
+      en: Which standard's verbal forms a Japanese provision is checked against
+    choices:
+      none:
+        ja: 見ない
+        en: Not checked
+      jis-z8301-2019:
+        ja: JIS Z 8301:2019 の 7.3〜7.5。文末の「すべきである」「すべきでない」「できる」「できない」を指す
+        en: "JIS Z 8301:2019, 7.3 to 7.5: a closing すべきである, すべきでない, できる or できない"
+  shall:
+    kind: choice
+    default: allow
+    about:
+      ja: 英語の "shall" を見るか
+      en: Whether "shall" is checked in English
+    choices:
+      allow:
+        ja: 見ない
+        en: Not checked
+      must:
+        ja: '"shall" を指し、"must" と書かせる（Federal Plain Language Guidelines）'
+        en: 'Point at "shall" and ask for "must" (Federal Plain Language Guidelines)'
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+sources: [jis-z8301-2019, plain-2011]
+
+group: team
+summary:
+  ja: 規格・規程の文末が、チームの選んだ決まり（JIS Z 8301:2019 など）と違う所。options で決めたときだけ見ます
+  en: A provision's verb form that the house rule the team picked does not use ("shall" under the Federal Plain Language Guidelines); checked only when options pick one
+example:
+  ja:
+    before: |
+      試験の前に、試料を乾燥させるべきである。
+    after: |
+      試験の前に、試料を乾燥させることが望ましい。
+    config:
+      genre: technical/spec
+      options:
+        requirement-modal:
+          standard: jis-z8301-2019
+  en:
+    before: |
+      The supplier shall deliver the goods within 30 days.
+    after: |
+      The supplier must deliver the goods within 30 days.
+    config:
+      genre: technical/spec
+      options:
+        requirement-modal:
+          shall: must
+
+not_flagged:
+  ja: options で決めなければ何も見ません。「できる」は文の終わりだけを見ます（JIS は能力を示す「できる」を文の途中で使うのを認めています）。
+  en: Nothing is checked until options pick a standard. In Japanese, できる is checked only at the end of a sentence, since JIS allows it mid-sentence for an ability.