chaffjs 0.19.0 → 0.20.0

package/rules/citation-style-mix.yaml

@@ -0,0 +1,109 @@
+id: citation-style-mix
+layer: L3
+status: experimental
+how_to_find: citation-style
+severity: info
+
+name:
+  ja: 引用の書き方が揃っていない
+  en: Citations written in more than one style
+
+why:
+  ja: 一つの論文の中で、引用を [1] と書いた所と（山田, 2020）と書いた所が混ざっていると、読み手は文献一覧をどちらの引き方で探せばよいか迷います。別の原稿から文を移したときや、共著者が自分の書き方で足したときに起きます。chaff は、番号の角括弧（[1]）、亀甲括弧（〔1〕）、文の後ろの番号と片括弧（…である1)。）、著者と年（(Smith, 2020)、山田（2020））、年を書いた脚注（[^1]）を見分け、最も多い書き方と違う少数の書き方を指します。どの書き方が正しいかは決めません。
+  en: When one paper cites as [1] in some places and as (Smith, 2020) in others, the reader cannot tell which way to look up the reference list. It happens when text is moved from another manuscript, or when a co-author adds citations in their own style. chaff tells apart numbers in square brackets ([1]), numbers in tortoise-shell brackets (〔1〕), a number with a closing parenthesis after Japanese text (…である1)。), author and year ((Smith, 2020), Smith et al. (2020)) and footnotes whose note gives a year ([^1]), and points at the few citations that differ from the most common style. Which style is right is not decided.
+
+message:
+  ja: 引用「{citation}」の書き方が、この論文のほかの引用（「{majority}」など {count} 箇所）と違います
+  en: 'The citation "{citation}" is written differently from the paper''s other citations ("{majority}" and others, {count} in all)'
+
+how_to_fix:
+  ja: 多いほうの書き方に揃えてください。番号に揃えるなら、文献一覧にも番号を付けます。
+  en: Rewrite it in the style most citations use. If that style is numbered, give the reference its number in the list too.
+
+levels: { strict: 3, normal: 2, relaxed: 1 }
+
+use_for: [academic, legal, docs, literature, speech]
+
+group: consistency
+summary:
+  ja: 一つの論文の中で、[1] の引用と（山田, 2020）の引用のように、引用の書き方が混ざっている所
+  en: A paper that cites as [1] in one place and as (Smith, 2020) in another
+example:
+  ja:
+    config: { genre: academic/paper }
+    before: |
+      # 睡眠と記憶
+
+      睡眠は記憶の定着を助ける[1]。短い昼寝でも効果がある[2]。夜に学んだあとで眠ると、翌朝によく思い出せる（山田, 2020）。
+
+      ## 参考文献
+
+      - [1] 佐藤一郎. 睡眠の研究. 2019.
+      - [2] 鈴木花子. 昼寝の効果. 2021.
+      - [3] 山田太郎. 夜の学習. 2020.
+    after: |
+      # 睡眠と記憶
+
+      睡眠は記憶の定着を助ける[1]。短い昼寝でも効果がある[2]。夜に学んだあとで眠ると、翌朝によく思い出せる[3]。
+
+      ## 参考文献
+
+      - [1] 佐藤一郎. 睡眠の研究. 2019.
+      - [2] 鈴木花子. 昼寝の効果. 2021.
+      - [3] 山田太郎. 夜の学習. 2020.
+  en:
+    config: { genre: academic/paper }
+    before: |
+      # Sleep and memory
+
+      Sleep helps memories settle [1]. A short nap helps too [2]. Sleeping after study in the evening improves recall the next morning (Young, 2020).
+
+      ## References
+
+      - [1] Smith, A. Sleep. 2019.
+      - [2] Jones, B. Naps. 2021.
+      - [3] Young, C. Evening study. 2020.
+    after: |
+      # Sleep and memory
+
+      Sleep helps memories settle [1]. A short nap helps too [2]. Sleeping after study in the evening improves recall the next morning [3].
+
+      ## References
+
+      - [1] Smith, A. Sleep. 2019.
+      - [2] Jones, B. Naps. 2021.
+      - [3] Young, C. Evening study. 2020.
+
+not_flagged:
+  ja: 文献一覧の中、コードの中、行の頭の番号（箇条書きの番号）、年を書いていない脚注、月や季節の後ろの年（（2020年3月）、(March 2020)）は引用として数えません。少数の書き方が {limit} 箇所を超えるときは、意図して使い分けているとみなして指しません。論文のジャンルでだけ見ます。
+  en: 'Citations inside the reference list or code, numbers at the start of a line (a numbered list), footnotes whose note gives no year, and a year after a month or a season ("(March 2020)") are not counted. When the minority style is used more than {limit} times, it is taken as a deliberate choice and not reported. Only the academic paper genre runs this rule.'
+level_meaning:
+  ja: 少ないほうの書き方が {limit} 箇所以下のとき指摘
+  en: reported when the minority style appears {limit} times or fewer
+rewrite:
+  ja:
+    direction: 少数の書き方の引用を、論文で最も多い書き方に書き直してください。番号の方式なら、その文献の文献一覧での番号を使います。番号が分からなければ、書き手に確かめます。
+    pairs:
+      - before: 翌朝によく思い出せる（山田, 2020）。
+        after: 翌朝によく思い出せる[3]。
+      - before: 昼寝の効果は小さい〔4〕。
+        after: 昼寝の効果は小さい[4]。
+    keep:
+      - 引いている文献
+      - 引用を置いた文の中の位置
+    avoid:
+      - 文献一覧に無い番号を作る
+      - 引用を消す
+  en:
+    direction: Rewrite each citation in the minority style in the style the paper uses most. For a numbered style, use the reference's number in the list; if it is not clear, ask the writer.
+    pairs:
+      - before: improves recall the next morning (Young, 2020).
+        after: improves recall the next morning [3].
+      - before: as Jones et al. (2021) showed,
+        after: as shown in [2],
+    keep:
+      - which work is cited
+      - where in the sentence the citation sits
+    avoid:
+      - inventing a number the reference list does not have
+      - dropping the citation

package/rules/clause-chain.yaml

@@ -0,0 +1,59 @@
+id: clause-chain
+layer: L3
+status: experimental
+how_to_find: clause-chain
+requires: [pos]
+languages: [ja]
+severity: info
+
+name:
+  ja: 一文に節がつながりすぎている
+  en: Too many clauses chained in one sentence
+
+why:
+  ja: 「調べて、まとめ、報告したが、返事がないので、もう一度送ったところ、」のように、「て」「が」「ので」や読点で節を次々につなぐと、読み手はどの節がどれに係るのかを覚えたまま最後まで読むことになります。文の長さが上限に収まっていても起きます。数えるのは、接続助詞（て・が・ので・から・ば・たら・ながら など）と、読点で止めた動詞・形容詞（まとめ、）です。「調べている」「読んでもらう」のような補助動詞へのつなぎは一つの述語なので数えません。鉤括弧で引いたものの中も数えません。
+  en: In Japanese, chaining clause after clause with て, が, ので or a comma after a verb makes the reader hold how each one attaches until the end of the sentence, even when the sentence is within the length limit. Conjunctive particles and verbs or adjectives stopped by a comma are counted; て joining a helper verb (調べている) is one predicate and is not. Anything in 「」 is not counted.
+
+message:
+  ja: 一文に節が {count} つつながっています（{limit} つまで）
+  en: "{count} clauses chained in one sentence (limit {limit})"
+
+how_to_fix:
+  ja: 節のつなぎ目のどこかで文を切ってください。「〜が、」「〜ので、」の所で切ると、前後の関係を「しかし」「そのため」で言い直せます。
+  en: Split the sentence at one of the joins, and say how the parts relate with a connective at the start of the next sentence.
+
+levels: { strict: 4, normal: 5, relaxed: 7 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: readability
+summary:
+  ja: 「〜て、〜し、〜が、〜ので、」のように、一文の中で節を次々につないでいる所
+  en: A Japanese sentence that chains clause after clause with て, が, ので and commas
+example:
+  ja:
+    before: |
+      資料を調べて、内容をまとめ、課長に報告したが、返事がないので、もう一度送ってみたところ、翌日に返事が来て、修正を頼まれた。
+    after: |
+      資料を調べて内容をまとめ、課長に報告しました。返事がないのでもう一度送ると、翌日に返事が来ました。修正を頼まれています。
+
+not_flagged:
+  ja: 補助動詞へのつなぎ（調べている、読んでもらう）、鉤括弧で引いたものの中、上限までの節は数えません。英語の文書には使いません。
+  en: Joins to a helper verb, anything quoted in 「」, and clauses up to the limit are not counted. Not used on English documents.
+level_meaning:
+  ja: 一文の節 {limit} つまで
+  en: up to {limit} clauses in one sentence
+rewrite:
+  ja:
+    direction: 節のつなぎ目（「〜が、」「〜ので、」「〜て、」）のどこかで文を切り、切った所の関係を次の文の頭で言い直してください。
+    pairs:
+      - before: 資料を調べて、内容をまとめ、課長に報告したが、返事がないので、もう一度送った。
+        after: 資料を調べて内容をまとめ、課長に報告しました。しかし返事がないので、もう一度送りました。
+      - before: 会場を予約し、案内を送り、出欠を集めたが、人数が足りないので、日程を変えて、もう一度案内した。
+        after: 会場を予約し、案内を送って出欠を集めました。人数が足りなかったため、日程を変えてもう一度案内しました。
+    keep:
+      - 出来事の順序と、原因と結果の関係
+      - 誰が何をしたのか
+    avoid:
+      - 節を落として意味を変える
+      - 読点を消すだけで、同じ数の節をつないだままにする

package/rules/colon-lead-in.yaml

@@ -26,7 +26,7 @@ how_to_fix:
 # 1000 字あたりの数。2 つより少なければ言わない（ai-phrasing.ts の PILE）。
 levels: { strict: 1, normal: 2, relaxed: 4 }
 
-use_for: [blog, business, legal, docs, academic, literature, speech]
+use_for: [technical/readme, blog, business, legal, docs, academic, literature, speech]
 
 group: ai-tells
 summary:
@@ -52,8 +52,8 @@ example:
       - 地図
 
 not_flagged:
-  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.
+  ja: 1 つだけのコロンの前置きと、コロンで終わらない前置き（「次のとおりとする。」）は数えません。説明書・法務・仕様書（technical/spec）のジャンルでは見ません。短い文書は測りません。英語の文書は、人もよくこの形で書くので見ません。日本語の文書の中の英文（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 specification (technical/spec) 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: "colon lead-ins to lists: up to {limit} per 1000 characters"

package/rules/contrast-framing.yaml

@@ -29,7 +29,7 @@ levels:
   ja: { strict: 1, normal: 1.5, relaxed: 3 }
   en: { strict: 2, normal: 3, relaxed: 6 }
 
-use_for: [blog, business, legal, docs, academic, literature, speech]
+use_for: [technical/readme, blog, business, legal, docs, academic, literature, speech]
 
 group: ai-tells
 summary:

package/rules/cross-doc-broken-link.yaml

@@ -0,0 +1,83 @@
+id: cross-doc-broken-link
+layer: L1
+status: experimental
+how_to_find: cross-doc-broken-link
+# documents: compares the files of one run, so it runs only when chaff is given two or more files, or a folder.
+requires: [markdown, documents]
+severity: warning
+
+name:
+  ja: ほかのファイルへの行き先の無いリンク
+  en: Link to another file that goes nowhere
+
+why:
+  ja: 説明書や文書の束では、ページどうしを相対パスのリンクでつなぎます（[料金](./pricing.md#月額料金)）。ファイルの名前を変えたり見出しを書き換えたりすると、ほかのページからのリンクが行き先を失います。一つのファイルだけを見ても、行き先のファイルや見出しがあるかは分かりません。一度に渡したファイルどうしを突き合わせ、行き先のファイルが無いリンクと、行き先のファイルに無い見出しを指すリンクを指します。見出しの名前は字と数字だけで比べます。
+  en: 'A manual or a bundle of documents links its pages to each other with relative paths ("[Fees](./pricing.md#monthly-fee)"). Renaming a file or rewording a heading leaves the links from other pages with nowhere to go, and no single file shows it. The files given together are checked against each other: a link whose file is not there, and a link to a heading that file does not have, are pointed out. Heading anchors are compared on letters and digits only.'
+
+message:
+  ja: リンク「{link}」の行き先がありません
+  en: 'The link "{link}" goes nowhere'
+
+messages:
+  file:
+    ja: リンク「{link}」が指すファイル「{target}」が、一緒に見たファイルの中にありません
+    en: 'The link "{link}" points to "{target}", which is not among the files checked'
+  anchor:
+    ja: リンク「{link}」が指す「{target}」の見出しが、そのファイルにありません
+    en: 'The link "{link}" points to "{target}", but that file has no such heading'
+
+how_to_fix:
+  ja: 行き先のファイルの今の名前と、今の見出しの言葉に合わせてください。ファイルや見出しを消したなら、リンクも消すか、代わりのページを指してください。
+  en: Match the file's current name and the heading as it is now written. If the file or the heading is gone, remove the link or point it at the page that replaced it.
+
+placeholders:
+  link:
+    ja: 〇〇
+    en: the link
+  target:
+    ja: 行き先
+    en: the target
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: structure
+summary:
+  ja: 一緒に見たほかのファイルへのリンクで、行き先のファイルか見出しが無いもの
+  en: A link to another of the files checked together whose file or heading is not there
+example:
+  ja:
+    other: |
+      # 手順
+
+      ## 準備
+
+      道具をそろえます。
+    before: |
+      # 案内
+
+      始める前に[準備](./a.md#用意)を読んでください。
+    after: |
+      # 案内
+
+      始める前に[準備](./a.md#準備)を読んでください。
+  en:
+    other: |
+      # Steps
+
+      ## Setup
+
+      Gather the tools.
+    before: |
+      # Guide
+
+      Before you start, read [Setup](./a.md#preparation).
+    after: |
+      # Guide
+
+      Before you start, read [Setup](./a.md#setup).
+
+not_flagged:
+  ja: URL、サイトの根からのパス（/guide/）、同じページの中へのリンク（broken-link が見ます）、Markdown でないファイル（画像やスクリプト）へのリンクは見ません。行き先のファイルが無くても、一緒に見たファイルのどれも置かれていないフォルダのものと、フォルダを指すリンク（./guide/）は、確かめようがないので指しません。拡張子を書かないリンク（./reference）は、.md などを補って探します。
+  en: URLs, paths from the site's root ("/guide/"), links within the same page (broken-link checks those) and links to files that are not Markdown (images, scripts) are not checked. A missing file in a folder that none of the files checked are in, and a link to a folder ("./guide/"), cannot be confirmed and are not reported. A link without an extension ("./reference") is looked up as .md and the like.

package/rules/cross-doc-term-variant.yaml

@@ -0,0 +1,73 @@
+id: cross-doc-term-variant
+layer: L3
+status: experimental
+how_to_find: cross-doc-term-variant
+# documents: compares the files of one run, so it runs only when chaff is given two or more files, or a folder.
+requires: [documents]
+# The katakana words come from the language package's split. Without parts of speech only the Latin and listed words are read.
+uses: [pos]
+severity: warning
+
+name:
+  ja: ファイルによって書き方が違う語
+  en: A word spelled differently in different files
+
+why:
+  ja: 説明書や文書の束では、一つのファイルの中ではそろっていても、ファイルどうしで書き方が分かれることがあります（あるページは「サーバ」、ほかのページは「サーバー」）。書いた人や書いた時期が違うと起きます。読み手は別のものかと迷い、サイトの検索でも片方を取りこぼします。一度に渡したファイルどうしを比べ、同じ語をファイルによって違う書き方で書いている所を指します。見る書き方は三つです。カタカナ語の語末の「ー」（サーバ／サーバー）、イギリスとアメリカの綴り（colour／color）、英字の語のハイフンの有無（e-mail／email）。どちらが正しいかは決めず、使うファイルの少ないほうを指します。
+  en: 'In a manual or a bundle of documents, each file can be consistent on its own while the files disagree with each other: one page writes "e-mail", the others "email". It happens when different people write at different times. A reader wonders whether they are different things, and a site search misses one. The files given together are compared, and a word written one way in some files and another way in the rest is pointed out. Three kinds of spelling are compared: the final ー of a katakana word (サーバ / サーバー), British and American spellings (colour / color), and a Latin word with and without a hyphen (e-mail / email). chaff does not pick a side; it points at the way fewer files use.'
+
+message:
+  ja: 「{matched}」と書いていますが、一緒に見たほかの {count} ファイルでは「{preferred}」です（例：{other}）
+  en: '"{matched}" here, but "{preferred}" in {count} other {count|file|files} checked with it (as in {other})'
+
+how_to_fix:
+  ja: 「{preferred}」に直してください。どちらに寄せるかをチームで決めているなら、chaff.yaml の prefer に書いておくと、どのファイルでも決めた書き方で見ます。
+  en: Change it to "{preferred}". If the team has decided which way, list the pair under prefer in chaff.yaml, and every file is checked against it.
+
+placeholders:
+  matched:
+    ja: 見つけた語
+    en: the word found
+  preferred:
+    ja: ほかのファイルの書き方
+    en: the other files' spelling
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: consistency
+summary:
+  ja: 同じ語を、ファイルによって違う書き方で書いている所（サーバ／サーバー、e-mail／email）
+  en: The same word spelled one way in some files and another way in the rest (サーバ / サーバー, e-mail / email)
+example:
+  ja:
+    other: |
+      # 手順
+
+      サーバーを起動します。
+    before: |
+      # 案内
+
+      サーバに接続します。
+    after: |
+      # 案内
+
+      サーバーに接続します。
+  en:
+    other: |
+      # Steps
+
+      Send an email to the team.
+    before: |
+      # Guide
+
+      Reply to the e-mail by Friday.
+    after: |
+      # Guide
+
+      Reply to the email by Friday.
+
+not_flagged:
+  ja: 一つのファイルの中で両方の書き方を使っている語は、そのファイルを数えません（ファイルの中の揺れは katakana-long-vowel などが見ます）。違う語どうし（サーバーとブラウザ）は比べません。語末の「ー」の前が 1 音の語（カー）、辞書が固有名詞と知っている語、chaff.yaml の names に並べた名前、引用符の中の英語の綴り、文の途中で大文字で始まる英語の名前も見ません。ハイフンは、一緒に見たファイルのどれかがハイフンで書いた語だけを比べます。
+  en: A file that writes a word both ways is not counted for that word (the per-file rules, such as katakana-long-vowel, point at that). Different words are not compared (サーバー and ブラウザ). Katakana words of one mora before the final ー (カー), words the dictionary knows as proper nouns, the names under names in chaff.yaml, spellings inside quotation marks, and capitalized names in mid-sentence are left alone. For hyphens, only words that one of the files writes with a hyphen are compared.

package/rules/date-format-consistency.yaml

@@ -0,0 +1,85 @@
+id: date-format-consistency
+layer: L1
+status: experimental
+how_to_find: date-format
+severity: warning
+
+name:
+  ja: 日付の書き方が揃っていない
+  en: Dates written two ways
+
+why:
+  ja: 一つの文書で「2026-10-02」と「2026年10月2日」、「Oct 2, 2026」と「10/2/2026」のように日付を二通りに書くと、読み手は同じ種類の日付なのかを確かめ、10/2 が十月二日なのか二月十日なのかも迷います。書き写した所や、あとから足した所に多い揺れです。どちらの書き方が正しいかは決めず、文書の中で少ないほうを指します。年・月・日のそろった日付だけを比べます。月の名前と元号は言語ごとの語彙表にあります。
+  en: One document writing "2026-10-02" in one place and "October 2, 2026" or "10/2/2026" in another makes the reader check whether the dates are the same kind, and 10/2 may be read as October 2 or 10 February. The mix usually comes from a pasted or later-added passage. chaff does not pick a style; it points at the minority. Only dates with a year, a month and a day are compared. Month names and eras are in each language's lexicon.
+
+message:
+  ja: 日付「{written}」の書き方が、この文書のほかの日付（「{example}」など {count} 箇所）と違います
+  en: 'The date "{written}" is written differently from {count} other dates in the document (such as "{example}")'
+
+how_to_fix:
+  ja: 文書の中の日付を一つの書き方に揃えてください。
+  en: Write every date in the document the same way.
+
+placeholders:
+  written:
+    ja: 日付
+    en: the date
+  example:
+    ja: ほかの日付
+    en: another date
+  count:
+    ja: 〇
+    en: N
+
+# 少ないほうの日付が全体のこの割合（パーセント）以下なら指す。それより多ければ、二つの書き方を使い分けている文書と読む。
+levels: { strict: 49, normal: 34, relaxed: 20 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: consistency
+summary:
+  ja: 「2026-10-02」と「2026年10月2日」のように、一つの文書で日付を二通りに書いている所
+  en: Dates written two ways in one document, such as "2026-10-02" and "October 2, 2026"
+example:
+  ja:
+    before: |
+      申込は2026年10月2日に始まり、2026年10月9日に締め切ります。結果は2026/10/16に通知します。
+    after: |
+      申込は2026年10月2日に始まり、2026年10月9日に締め切ります。結果は2026年10月16日に通知します。
+  en:
+    before: |
+      Registration opens on October 2, 2026 and closes on October 9, 2026. Results are sent on 10/16/2026.
+    after: |
+      Registration opens on October 2, 2026 and closes on October 9, 2026. Results are sent on October 16, 2026.
+
+not_flagged:
+  ja: 年だけ、月日だけの日付、URL や版の中の数（/2026/10/02/、1.2026.10）、コードの中の日付は比べません。少ないほうが全体の三分の一を超える文書は、二つの書き方を使い分けている（表は 2026-10-02、本文は 2026年10月2日）と読んで指しません。いちばん多い書き方が同じ数で並ぶときも指しません。
+  en: Year-only and month-day dates, numbers inside URLs and versions (/2026/10/02/, 1.2026.10), and dates in code are not compared. When the minority is more than a third of the dates, the document is taken to use two styles on purpose (ISO in tables, long dates in prose) and nothing is reported, nor when the two commonest styles are tied.
+level_meaning:
+  ja: 少ないほうの書き方の日付が全体の {limit}% 以下なら指摘
+  en: reported while the minority style is {limit}% of the dates or less
+rewrite:
+  ja:
+    direction: 指された日付を、文書の多いほうの書き方（指摘が例に引く日付の書き方）に書き直してください。日付そのもの（年・月・日）は変えません。
+    pairs:
+      - before: 結果は2026/10/16に通知します。（ほかは「2026年10月2日」）
+        after: 結果は2026年10月16日に通知します。
+      - before: 締切は2026-10-09です。（ほかは「2026年10月2日」）
+        after: 締切は2026年10月9日です。
+    keep:
+      - 年・月・日と曜日
+      - 文の言い回し
+    avoid:
+      - 月と日の順の分からない日付（10/2/2026）を、確かめずに書き換える
+  en:
+    direction: Rewrite the flagged date in the style most of the document uses (the one the finding quotes). Keep the date itself.
+    pairs:
+      - before: Results are sent on 10/16/2026. (other dates read "October 2, 2026")
+        after: Results are sent on October 16, 2026.
+      - before: The deadline is 2026-10-09. (other dates read "October 2, 2026")
+        after: The deadline is October 9, 2026.
+    keep:
+      - the year, month, day and weekday
+      - the wording around the date
+    avoid:
+      - rewriting an ambiguous date (10/2/2026) without checking which order was meant

package/rules/date-without-year.yaml

@@ -0,0 +1,70 @@
+id: date-without-year
+layer: L1
+status: experimental
+how_to_find: date-without-year
+requires: [dates]
+# The dates come from the language package's date reader. English does not read a date written without its year yet,
+# so the rule checks Japanese only until it does.
+languages: [ja]
+severity: warning
+
+name:
+  ja: 年の無い日付
+  en: Date without a year
+
+why:
+  ja: 文書のほかの日付には年があるのに、一つだけ年が無い日付は、読み手がどの年かを推し量ることになります。年をまたぐ日付が並ぶ文書（12月と1月）では、年の無い日付がどちらの年か決まりません。
+  en: When the document's other dates carry a year, a date without one leaves the reader to guess it. When the dates cross the turn of a year (December and January), a yearless date could be either year.
+
+message:
+  ja: 「{date}」には年がありません（この文書のほかの日付 {count} 個には年があります）
+  en: '"{date}" has no year (the document''s other {count} dates do)'
+messages:
+  boundary:
+    ja: 「{date}」には年がありません。年の変わり目をまたぐ日付が並んでいるので、どちらの年か決まりません
+    en: '"{date}" has no year, and the dates around it cross the turn of a year'
+
+how_to_fix:
+  ja: 年を書いてください（2027年1月15日）。
+  en: Write the year (January 15, 2027).
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: structure
+summary:
+  ja: ほかの日付には年があるのに年の無い日付と、年の変わり目をまたいで並ぶ年の無い日付
+  en: A date without a year where the document's other dates carry one, or where the dates cross the turn of a year
+example:
+  ja:
+    before: |
+      # 日程
+
+      - 2026年10月14日（水）：説明会
+      - 2026年10月21日（水）：申込の締め切り
+      - 10月28日（水）：結果の連絡
+    after: |
+      # 日程
+
+      - 2026年10月14日（水）：説明会
+      - 2026年10月21日（水）：申込の締め切り
+      - 2026年10月28日（水）：結果の連絡
+
+not_flagged:
+  ja: 年を一度だけ書いて、あとの日付は月と日だけで書く文書（年の無い日付のほうが多い文書）は、書き方の選び方として指しません。ただしその場合も、年をまたぐ日付は指します。月だけ・年だけの日付は見ません。
+  en: A document that writes the year once and the rest as month and day (more yearless dates than dated ones) is a style, and not reported, except for a date across the turn of a year. Month-only and year-only dates are not checked.
+rewrite:
+  ja:
+    direction: 指摘された日付に年を書き足してください。年は本文のほかの日付と、曜日から確かめます。決められなければ、作らずに［年］と空けて書き手に聞きます。
+    pairs:
+      - before: 10月28日（水）：結果の連絡
+        after: 2026年10月28日（水）：結果の連絡
+      - before: 1月15日に次の会議を開きます。
+        after: 2027年1月15日に次の会議を開きます。
+    keep:
+      - 月・日・曜日
+      - ほかの日付の書き方
+    avoid:
+      - 曜日と合わない年を書く
+      - 本文から決まらない年を推して書く

package/rules/demonstrative-opener-run.yaml

@@ -0,0 +1,59 @@
+id: demonstrative-opener-run
+layer: L3
+status: experimental
+how_to_find: opener-run
+word_list: demonstrative-opener
+requires: [pos]
+languages: [ja]
+severity: info
+
+name:
+  ja: 指示語で始まる文の連続
+  en: Sentences in a row opening with a demonstrative
+
+why:
+  ja: 「これは」「その結果」「この方法は」のように指示語で始まる文が続くと、読み手は一文ごとに「どれのことか」を前に戻って確かめることになります。指すものが一つ前の文なのか、もっと前なのかも曖昧になります。数えるのは同じ段落の中の連続だけです。
+  en: In Japanese, sentence after sentence opening with a demonstrative (これは, その結果) sends the reader back each time to find what it points at, and blurs whether it means the last sentence or one before. Only runs within one paragraph are counted.
+
+message:
+  ja: 「{word}」など、指示語で始まる文が {count} 文続いています（{limit} 文まで）
+  en: '{count} sentences in a row open with a demonstrative such as "{word}" (limit {limit})'
+
+how_to_fix:
+  ja: 指示語のどれかを、指している名詞に置き換えてください（その結果 → 調査の結果）。
+  en: Replace one of the demonstratives with the noun it points at (その結果 → 調査の結果).
+
+levels: { strict: 1, normal: 2, relaxed: 3 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: readability
+summary:
+  ja: 「これは」「その」「この」のような指示語で始まる文が、同じ段落の中で続く所
+  en: Japanese sentences in a row, within one paragraph, that open with a demonstrative (これ, その)
+example:
+  ja:
+    before: |
+      新しい手順を導入しました。これは作業を減らすためです。その結果、残業が減りました。この効果は来月も続く見込みです。
+    after: |
+      新しい手順を導入しました。作業を減らすためです。その結果、残業が減りました。残業の減少は来月も続く見込みです。
+
+not_flagged:
+  ja: 段落が変われば数え直します。「それぞれ」のように一語になったものと、接続詞の「そして」は数えません。
+  en: The count restarts at each paragraph. Words such as それぞれ and the conjunction そして are not counted.
+level_meaning:
+  ja: 指示語で始まる文 {limit} 文の連続まで
+  en: up to {limit} such sentences in a row
+rewrite:
+  ja:
+    direction: 続いた指示語のうち、指すものが遠いものから、指している名詞に置き換えてください。一つ前の文を指す指示語は残してかまいません。
+    pairs:
+      - before: 新しい手順を導入しました。これは作業を減らすためです。その結果、残業が減りました。この効果は来月も続く見込みです。
+        after: 新しい手順を導入しました。作業を減らすためです。その結果、残業が減りました。残業の減少は来月も続く見込みです。
+      - before: 監査で三件の不備が見つかりました。それらは手順書の古さが原因です。その手順書は二年前のものです。この点を来月までに直します。
+        after: 監査で三件の不備が見つかりました。原因は手順書の古さです。手順書は二年前のものです。来月までに手順書を改めます。
+    keep:
+      - 指しているものと、文の順序
+    avoid:
+      - 指しているものを取り違える
+      - 指示語を別の指示語（同様に、前述の）に替えるだけ

package/rules/doubled-nado.yaml

@@ -0,0 +1,57 @@
+id: doubled-nado
+layer: L2
+status: experimental
+how_to_find: phrase-match
+word_list: doubled-nado
+requires: [pos]
+languages: [ja]
+severity: warning
+
+name:
+  ja: 「など」と「等」の重ね
+  en: など and 等 doubled
+
+why:
+  ja: 「書類等など」「申請など等」のように「など」と「等」を重ねても、どちらも「ほかにもある」と言うだけで、意味は増えません。読み手には書き損じに見えます。組は言語ごとの語彙表にあります。
+  en: In Japanese, など and 等 both mean "and so on"; writing them together (書類等など) adds nothing and reads as a slip. The pairs are listed in the lexicon.
+
+message:
+  ja: 「{matched}」は、「など」と「等」を重ねています
+  en: '"{matched}" doubles など and 等'
+
+how_to_fix:
+  ja: どちらか一つにしてください（書類等など → 書類など）。
+  en: Keep one of the two (書類等など → 書類など).
+
+levels: { strict: 1, normal: 1, relaxed: 2 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: slips
+summary:
+  ja: 「書類等など」のように、「など」と「等」を重ねた所
+  en: など and 等, both "and so on", written together in Japanese
+example:
+  ja:
+    before: |
+      申請書等などを提出してください。
+    after: |
+      申請書などを提出してください。
+not_flagged:
+  ja: 一覧にある組だけを見ます。「などなど」は話し言葉の強めなので数えません。
+  en: Only the pairs on chaff's list. などなど, a spoken intensifier, is not counted.
+level_meaning:
+  ja: 重ねた所が {limit} 箇所あれば指摘
+  en: reported once there are {limit}
+rewrite:
+  ja:
+    direction: 「など」か「等」のどちらか一つを消してください。文書の中でほかに多く使っている方を残します。
+    pairs:
+      - before: 申請書等などを提出してください。
+        after: 申請書などを提出してください。
+      - before: 交通費、宿泊費など等は会社が負担します。
+        after: 交通費、宿泊費などは会社が負担します。
+    keep:
+      - 並べた項目
+    avoid:
+      - 項目を足して「など」を言い換える