chaffjs 0.19.0 → 0.20.0

package/rules/orthographic-variant.yaml

@@ -0,0 +1,87 @@
+id: orthographic-variant
+layer: L3
+status: experimental
+how_to_find: orthographic-variant
+# 語の一覧は持たない。文書の中の語を、日本語は辞書の形の読み（出来る・できる はどちらもデキル）で、カタカナ語は小さい字と「ー」を
+# ならした形で、英字は大文字小文字とハイフンを外した形で束ね、同じ語の書き方が二つあれば少ないほうを指す。
+# 読みが同じで意味の違う語（成る・なる）は lang-ja の orthographic-variant-distinct に並べて外す。
+uses: [pos]
+severity: info
+
+name:
+  ja: 同じ語の書き方がゆれている
+  en: One word spelled two ways
+
+why:
+  ja: 「出来る」と「できる」、「引っ越し」と「引越し」、「ウィンドウ」と「ウインドウ」、「e-mail」と「email」のように、同じ語を一つの文書の中で二通りに書くと、検索で別の語になり、読み手は別のものを指しているのかと迷います。どちらが正しいかは決めません。chaff は語の一覧を持たず、文書の中の語を読み（日本語）やならした綴り（カタカナ語と英字）で束ね、文書の中で少ないほうを指摘します。補助動詞と形式名詞（見て下さい、その事）は、本来の使い方（資料を下さい）と別に比べるので、「補助動詞はかなで書く」と決めた文書はそろっていると見ます。漢字の違う同音の語（書く・描く、機会・機械）は別の語と見ます。少ないほうが三分の一を超える文書は、使い分けていると見て言いません。
+  en: Writing one word two ways in one document (e-mail and email, GitHub and Github) makes search treat them as different words and leaves the reader wondering whether two things are meant. chaff does not decide which way is right and keeps no list of words; it groups the document's own words, by reading in Japanese and by spelling without hyphens and case in English, and points at whichever way the document uses less. The case of the first letter is left out, since a sentence or a title gives it (Email, email), and so are words in capitals only. It says nothing when the minority is more than a third, since the document then uses both on purpose.
+
+message:
+  ja: 「{written}」と書いています（この文書はふつう「{other}」と書く語です。{of} 箇所のうち {count} 箇所が違う）
+  en: '"{written}" here, where the document usually writes "{other}" ({count} of {of})'
+
+how_to_fix:
+  ja: 文書の多いほうの書き方に合わせてください。チームで決めているなら、chaff.yaml の prefer に書くと、それからは preferred-term がその向きで見ます。
+  en: Match the way the rest of the document writes it. If the team has decided, list it under prefer in chaff.yaml, and preferred-term checks that direction from then on.
+
+placeholders:
+  written:
+    ja: この箇所の書き方（日本語は辞書の形）
+    en: the spelling here
+  other:
+    ja: 文書でいちばん多い書き方
+    en: the spelling the document uses most
+
+# 少ないほうが語の何パーセントまでなら「ゆれている」と見るか。これを超えたら、文書が使い分けている。
+levels: { strict: 49, normal: 34, relaxed: 20 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: consistency
+summary:
+  ja: 「出来る」と「できる」、「引っ越し」と「引越し」のように、同じ語を一つの文書の中で二通りに書いている所（語の一覧なしで見つけます）
+  en: One word written two ways in one document (e-mail and email, GitHub and Github), found without a word list
+example:
+  ja:
+    before: |
+      申請は窓口でできます。郵送でもできます。代理の人も申請出来ます。
+    after: |
+      申請は窓口でできます。郵送でもできます。代理の人も申請できます。
+  en:
+    before: |
+      Send the form by email. We answer every email within a day. Attach the receipt to the e-mail.
+    after: |
+      Send the form by email. We answer every email within a day. Attach the receipt to the email.
+
+not_flagged:
+  ja: 読みが同じでも漢字の違う語（書く・描く）、補助動詞・形式名詞と本来の使い方の書き分け（見て下さい・資料を下さい）、書き分けが意味の違いになる語（成る・なる、言う・いう）、語末の「ー」だけの違い（katakana-long-vowel が見ます）、鉤括弧や引用符の中、chaff.yaml の names に書いた名前は見ません。英字は、頭の字の大文字小文字（Email と email）と、大文字だけの語（強調や略語）を書き方の違いにしません。少ないほうが三分の一を超えるときも言いません。文学のジャンルでは既定で止めています（その時代の書き方のため）。
+  en: The case of a word's first letter (Email, email; Long-Term, long-term) is not a spelling, nor is a word in capitals only (emphasis or an acronym). Hyphenated words that are another word (re-sign, resign), part of an address (github.com), anything in quotation marks and the team's names are not compared. Nothing is reported when the minority is more than a third. The literature preset turns it off, since old spelling belongs to its time.
+level_meaning:
+  ja: 少ないほうが語の {limit}% 以下のとき指摘
+  en: reported when the minority spelling is {limit}% of the word's uses or less
+rewrite:
+  ja:
+    direction: 同じ語の書き方を、文書でいちばん多い書き方にそろえてください。意味の違う語に書き分けているなら、そのままにします。
+    pairs:
+      - before: 代理の人も申請出来ます。
+        after: 代理の人も申請できます。
+      - before: 引越しの日を決めてください。
+        after: 引っ越しの日を決めてください。
+    keep:
+      - 語の意味と、文の中の位置
+      - 意味の違いで書き分けている語（資料を下さい・見てください）
+    avoid:
+      - 少ないほうに合わせて、多いほうを書き換える
+      - 引用した文の書き方を変える
+  en:
+    direction: Write each word the way the rest of the document writes it. If two spellings mark two meanings, leave them.
+    pairs:
+      - before: Attach the receipt to the e-mail.
+        after: Attach the receipt to the email.
+      - before: The code is on Github.
+        after: The code is on GitHub.
+    keep:
+      - the meaning and the place of the word
+      - quoted text as quoted
+    avoid:
+      - changing the majority to match the minority

package/rules/paragraph-restatement.yaml

@@ -0,0 +1,96 @@
+id: paragraph-restatement
+layer: L2
+status: experimental
+how_to_find: paragraph-restatement
+requires: [pos]
+severity: info
+
+name:
+  ja: 前の段落を言い直すだけの段落
+  en: A paragraph that only restates the one before
+
+why:
+  ja: 「つまり」「このように」「言い換えれば」で始まる段落が、すぐ前の段落と同じ語ばかりで書かれていると、読み手は同じことを二度読むことになります。まとめは、前の段落に無いこと（結論、次に何をするか、数字）を足してはじめて役に立ちます。chaff は、言い直しを告げる語（語彙表）で始まる段落の内容語（名詞・動詞・形容詞・副詞・数）のうち、前の段落にすでにある語の割合を数えます。
+  en: When a paragraph opens with "In other words" or "In short" and then uses mostly the words of the paragraph before it, the reader reads the same thing twice. A summary helps only when it adds something the paragraph before did not say (the conclusion, what to do next, a figure). chaff counts, for a paragraph that opens with a restating word (from the lexicon), the share of its content words (nouns, verbs, adjectives, adverbs, numbers) already in the paragraph before.
+
+message:
+  ja: 「{opener}」で始まるこの段落は、内容語の {share}% が前の段落の繰り返しです
+  en: 'This paragraph opens with "{opener}" and {share}% of its content words repeat the paragraph before'
+
+how_to_fix:
+  ja: 段落を消して、前の段落で言い切ってください。まとめが要るなら、前の段落に無いこと（結論、次の一手、数字）を書きます。
+  en: Cut the paragraph and let the one before stand. If a summary is needed, make it say what the paragraph before did not (the conclusion, the next step, a figure).
+
+# 言い直しを告げる語で始まる段落の内容語のうち、前の段落にある語の割合（パーセント）。これ以上で指摘。
+levels: { strict: 40, normal: 50, relaxed: 60 }
+
+use_for: [blog, business, technical, docs, academic, legal, literature, speech]
+
+group: readability
+summary:
+  ja: 「つまり」「このように」で始まり、前の段落の語をほとんど繰り返すだけの段落
+  en: A paragraph that opens with "In other words" or "In short" and mostly repeats the paragraph before
+
+example:
+  ja:
+    config: { genre: blog/tech }
+    before: |
+      新しい在庫システムでは、店舗の在庫を一つの画面で数えられます。棚卸しの時間も短くなります。
+
+      このように、新しい在庫システムでは店舗の在庫を一つの画面で数えられ、棚卸しの時間が短くなります。
+    after: |
+      新しい在庫システムでは、店舗の在庫を一つの画面で数えられます。棚卸しの時間も短くなります。
+
+      来月から全店で使い始め、最初の棚卸しは 4 月 10 日です。
+  en:
+    config: { genre: blog/tech }
+    before: |
+      The new inventory system counts every store's stock on one screen, and a stocktake takes less time.
+
+      In other words, the new inventory system counts the stock of every store on one screen, so a stocktake takes less time.
+    after: |
+      The new inventory system counts every store's stock on one screen, and a stocktake takes less time.
+
+      Every store switches next month, and the first stocktake is on April 10.
+
+not_flagged:
+  ja: 言い直しを告げる語で始まらない段落、内容語が 4 つに満たない段落、見出し・箇条書き・表・コードを挟んだ段落は見ません。前の段落の語の割合だけを見るので、まとめが前の数段落を受けていても、すぐ前の段落と比べます。法務・文学・話し言葉のジャンルでは見ません。
+  en: 'A paragraph that does not open with a restating word, one with fewer than four content words, and one separated from the paragraph before by a heading, a list, a table or code are not checked. Words that open other sentences too ("That is why", "Again the drums") count only with a comma after them ("That is,"). Legal, literary and speech genres do not run this rule.'
+level_meaning:
+  ja: 内容語の {limit}% 以上が前の段落の繰り返しのとき指摘
+  en: reported when {limit}% or more of the paragraph's content words repeat the paragraph before
+rewrite:
+  ja:
+    direction: 言い直しの段落を消すか、前の段落に無いことを書く段落に変えてください。結論・次にすること・数字のうち、本文にあるものを書きます。「つまり」「このように」で前の段落をなぞるだけの文は残しません。
+    pairs:
+      - before: |
+          このように、新しい在庫システムでは店舗の在庫を一つの画面で数えられ、棚卸しの時間が短くなります。
+        after: |
+          来月から全店で使い始め、最初の棚卸しは 4 月 10 日です。
+      - before: |
+          つまり、申込書は月末までに出す必要があり、遅れると受け付けられません。
+        after: |
+          郵送の場合は、月末の消印まで有効です。
+    keep:
+      - 前の段落の中身
+      - 本文にある日付・数字・名前
+    avoid:
+      - 本文に無い事実を足す
+      - 前の段落を別の言い方でもう一度書く
+  en:
+    direction: Cut the restating paragraph, or turn it into one that says what the paragraph before did not. Use the conclusion, the next step or a figure the text gives. Do not keep a sentence that only walks over the previous paragraph again after "In other words".
+    pairs:
+      - before: |
+          In other words, the new inventory system counts the stock of every store on one screen, so a stocktake takes less time.
+        after: |
+          Every store switches next month, and the first stocktake is on April 10.
+      - before: |
+          In short, the form must reach us by the end of the month, or it will not be accepted.
+        after: |
+          A posted form counts if it is postmarked by the last day of the month.
+    keep:
+      - what the paragraph before says
+      - the dates, figures and names in the text
+    avoid:
+      - adding a fact the text does not have
+      - saying the paragraph before again in other words

package/rules/person-consistency.yaml

@@ -0,0 +1,59 @@
+id: person-consistency
+layer: L2
+status: experimental
+how_to_find: person-mix
+word_list: person-word
+extra_word_lists: [person-form]
+severity: info
+
+name:
+  ja: 自分や読み手の呼び方が揃っていない
+  en: The document names itself or its reader two ways
+
+why:
+  ja: 文書が自分を「私たち」と呼ぶか「弊社」「当社」と呼ぶか、書き手を「私」と書くか「筆者」と書くか、英語で読み手を you と呼ぶか one と呼ぶかは文体の選択で、どれが正しいかは決めません。一つの文書の中で混ざると、読み手は話し手が変わったのか、別の誰かのことなのかを考えます。継ぎ合わせた文書や、別の人が足した段落によく起きます。chaff は呼び方ごとに文書の中で多いほうを文書の書き方とし、少ないほうを指します。鉤括弧と引用符の中、引用の段落、コードは数えません。英語の we と I は、多くの文書で別の相手（組織と話し手）を指すので比べません。
+  en: Whether a Japanese document calls itself 私たち or 弊社 and its writer 私 or 筆者, and whether an English document addresses its reader as "you" or as "one", is a choice of voice, and chaff does not pick one. Mixed in one document, the reader wonders whether the speaker changed or someone else is meant; it happens most where text was stitched together or another writer added a paragraph. chaff takes the form the document uses most as its habit and points at the other. Quotations, quoted blocks and code are not counted. English "we" and "I" are not compared, since in most documents they name two parties (the organisation and the speaker).
+
+message:
+  ja: 「{matched}」と書いています（この文書はふつう「{usual}」。{of} 箇所のうち {count} 箇所が違う）
+  en: '"{matched}" here, where the document usually says "{usual}" ({count} of {of})'
+
+placeholders:
+  matched:
+    ja: 見つけた呼び方
+    en: the form found
+  usual:
+    ja: 文書でふつうの呼び方
+    en: the form the document usually uses
+
+how_to_fix:
+  ja: 同じ相手を指しているなら、文書の多いほうの呼び方に揃えてください。別の相手（会社と、書き手個人）を指しているなら、その違いが読み手に分かるように書きます。
+  en: If the same party is meant, use the form the rest of the document uses. If another party is meant (the company and the writer), make the difference clear to the reader.
+
+# 少ないほうの呼び方が、その呼び方全体の何パーセントまでなら混ざりと見るか。超えたら、文書が使い分けている。
+levels: { strict: 30, normal: 20, relaxed: 10 }
+
+use_for: [technical, blog, business, legal, docs, academic, literature, speech]
+
+group: consistency
+summary:
+  ja: 「私たち」と「弊社」、「私」と「筆者」のように、一つの文書が自分や読み手を二通りに呼んでいる所
+  en: 'One document naming itself two ways (私たち and 弊社) or its reader two ways ("you" and "one")'
+example:
+  ja:
+    before: |
+      弊社は、来月から新しい窓口を開きます。弊社の担当者が、平日の午前に受け付けます。私たちは、相談の内容を記録に残します。弊社は、記録を一年間保管します。保管した記録は、弊社の外には出しません。
+    after: |
+      弊社は、来月から新しい窓口を開きます。弊社の担当者が、平日の午前に受け付けます。弊社は、相談の内容を記録に残します。弊社は、記録を一年間保管します。保管した記録は、弊社の外には出しません。
+  en:
+    before: |
+      You can book a slot online. Your booking shows on the next page. If you miss it, you can book again. One can also call the desk.
+    after: |
+      You can book a slot online. Your booking shows on the next page. If you miss it, you can book again. You can also call the desk.
+
+not_flagged:
+  ja: 呼び方が一通りの文書と、少ないほうが決まった割合を超える文書（使い分けていると見ます）は指摘しません。多いほうが 3 箇所に満たない文書も見ません。鉤括弧と引用符の中、引用の段落、コード、前後に漢字やカタカナが続く語（東京本社、当社比）は数えません。英語の one は、can や must の前の主語の one だけを数え、no one や the one や前置詞の後ろの one は数えません。どの呼び方が正しいかは決めません。
+  en: A document with one form, or whose other form passes a set share of the places (it uses both on purpose), is not reported, nor one whose usual form appears fewer than 3 times. Quotations, quoted blocks, code and words joined to longer ones (東京本社) are not counted. Only "one" as the subject of a modal verb is counted, not "no one", "the one" or "one" after a preposition. Which form is right is not decided.
+level_meaning:
+  ja: 少ないほうの呼び方が全体の {limit} パーセント以下のとき指摘
+  en: reported when the other form is {limit} percent of the places or fewer

package/rules/redundant-expression.yaml

@@ -0,0 +1,76 @@
+id: redundant-expression
+layer: L2
+status: experimental
+how_to_find: phrase-match
+word_list: redundant-expression
+uses: [pos]
+severity: info
+
+name:
+  ja: 重言
+  en: Redundant pair
+
+why:
+  ja: 「頭痛が痛い」「一番最初」「後で後悔する」のように同じ意味の語を重ねると、読み手は二度目の語に意味を探してつまずき、書き手が言葉を選んでいないように読めます。重ねを外しても意味は変わりません。言い回しの一覧は言語ごとの語彙表にあり、それぞれに重ねを外した形が付いています。辞書が一語として載せる慣用（排気ガス、射程距離）は数えません。
+  en: Two words that say the same thing ("end result", "each and every", "revert back") make the reader look for a meaning in the second word that is not there, and read as unedited. Dropping the repeat changes nothing. The pairs are listed in each language's lexicon, each with the form to use instead. Idioms that are sometimes needed ("whether or not", "period of time") are not counted.
+
+message:
+  ja: 「{matched}」は同じ意味の語を重ねています
+  en: '"{matched}" says the same thing twice'
+
+how_to_fix:
+  ja: 重ねた語の一方を消してください（一番最初 → 最初、後で後悔する → 後悔する）。
+  en: Drop the repeat ("end result" → "result", "revert back" → "revert").
+
+# 何回あれば指摘するか。1 は一つ目から。
+levels: { strict: 1, normal: 1, relaxed: 2 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: wording
+summary:
+  ja: 「頭痛が痛い」「一番最初」「後で後悔」のような、同じ意味の語の重なり
+  en: Two words that say the same thing, such as "end result" or "each and every"
+example:
+  ja:
+    before: |
+      一番最初に、手順を確認してください。
+    after: |
+      最初に、手順を確認してください。
+  en:
+    before: |
+      The end result is a shorter build.
+    after: |
+      The result is a shorter build.
+
+not_flagged:
+  ja: 辞書が一語として載せる慣用（排気ガス、射程距離、製造メーカー）、重ねて強める書き方として定着したもの（犯罪を犯す、あらかじめ予約）は指しません。文学のジャンルでは既定で止めています。
+  en: Idioms that are sometimes needed ("whether or not", "period of time", "past experience", "plan ahead") are not reported. The literature preset turns it off.
+level_meaning:
+  ja: 重言を含む文が {limit} 文あれば指摘
+  en: reported once {limit} sentences hold one
+rewrite:
+  ja:
+    direction: 重ねた語の一方を消して、一度だけ言ってください。語彙表の語ごとの書き換え（一番最初 → 最初）に従い、文のほかの所は変えません。
+    pairs:
+      - before: 一番最初に、手順を確認してください。
+        after: 最初に、手順を確認してください。
+      - before: 返事を返すまでに三日かかりました。
+        after: 返事をするまでに三日かかりました。
+    keep:
+      - 文の意味と語順
+      - 重ねていない語
+    avoid:
+      - 重ねを外すついでに文を書き換える
+  en:
+    direction: Drop one of the two words that say the same thing, following the lexicon's replacement for the phrase ("end result" → "result"). Leave the rest of the sentence alone.
+    pairs:
+      - before: The end result is a shorter build.
+        after: The result is a shorter build.
+      - before: We reverted back to the old schema.
+        after: We reverted to the old schema.
+    keep:
+      - what the sentence says
+      - the words around the pair
+    avoid:
+      - rewriting the whole sentence while dropping the repeat

package/rules/reference-title-mismatch.yaml

@@ -0,0 +1,101 @@
+id: reference-title-mismatch
+layer: L3
+status: experimental
+how_to_find: reference-title-mismatch
+requires: [structure]
+severity: warning
+
+name:
+  ja: 参照に添えた名前が、参照先の見出しと違う
+  en: A reference whose name does not match its target's heading
+
+why:
+  ja: 「第5条（秘密保持）」の第5条が、実は「第5条（損害賠償）」だと、読み手は番号と名前のどちらを信じればよいか分かりません。条や章を足したり消したりして番号がずれたのに、参照を直し忘れると起きます。参照のすぐ後ろの括弧か引用符の中の名前を、参照先の見出しと比べます。どちらかがどちらかを含めば合っているとみなします。
+  en: 'When "Section 5 (Confidentiality)" points at a Section 5 headed "Liability", the reader cannot tell whether the number or the name is right. It happens when sections are added or removed and the numbers shift, but the references are not updated. The name in brackets or quotes right after a reference is compared with the target''s heading; they agree when either contains the other.'
+
+message:
+  ja: "{label}に「{name}」と添えていますが、{label}の見出しは「{heading}」です"
+  en: '{label} is called "{name}" here, but its heading is "{heading}"'
+
+how_to_fix:
+  ja: 番号と名前のどちらが正しいかを確かめて、もう一方を直してください。番号がずれたのなら、ほかの参照も同じようにずれていないかを見てください。
+  en: Check whether the number or the name is right and correct the other. If the numbers shifted, check the other references too.
+
+levels: { normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: facts
+summary:
+  ja: 「第5条（秘密保持）」のように参照に添えた名前が、その条や章の見出しと違う所
+  en: A name given with a reference ("Section 5 (Confidentiality)") that differs from that section's heading
+example:
+  ja:
+    before: |
+      # 規約
+
+      ## 第1章 総則
+
+      料金は第2章「返金」を見てください。
+
+      ## 第2章 料金
+
+      月額です。
+    after: |
+      # 規約
+
+      ## 第1章 総則
+
+      料金は第2章「料金」を見てください。
+
+      ## 第2章 料金
+
+      月額です。
+  en:
+    before: |
+      # Terms
+
+      ## 1. Scope
+
+      For fees, see Section 2 (Refunds).
+
+      ## 2. Pricing
+
+      The fee is monthly.
+    after: |
+      # Terms
+
+      ## 1. Scope
+
+      For fees, see Section 2 (Pricing).
+
+      ## 2. Pricing
+
+      The fee is monthly.
+
+not_flagged:
+  ja: 参照先が見出しを持たないとき、参照先が一つに決まらないとき、他の文書の条（民法第709条）、括弧の中が数字を含むか「前述」「参照」のような語のときは見ません。
+  en: References whose target has no heading or cannot be told apart, references to another document, and brackets holding a number or a word like "above" or "see" are left alone.
+rewrite:
+  ja:
+    direction: 番号と名前のどちらが正しいかを書き手に確かめ、もう一方を直してください。名前を添える意味が無ければ、名前を消して番号だけにしてもかまいません。
+    pairs:
+      - before: 第2章「返金」を見てください。
+        after: 第2章「料金」を見てください。
+      - before: 第5条（秘密保持）に定めるとおり
+        after: 第6条（秘密保持）に定めるとおり
+    keep:
+      - 参照先の番号と見出しの対応
+    avoid:
+      - どちらが正しいかを推測で決める
+  en:
+    direction: Ask the writer whether the number or the name is right, and correct the other. If the name adds nothing, the reference can carry the number alone.
+    pairs:
+      - before: see Section 2 (Refunds)
+        after: see Section 2 (Pricing)
+      - before: as set out in Section 5 (Confidentiality)
+        after: as set out in Section 6 (Confidentiality)
+    keep:
+      - which numbered section has which heading
+    avoid:
+      - guessing which value is right

package/rules/reference-topic-missing.yaml

@@ -0,0 +1,101 @@
+id: reference-topic-missing
+layer: L3
+status: experimental
+how_to_find: reference-topic-missing
+requires: [structure]
+severity: info
+
+name:
+  ja: 「第2章で述べた〇〇」の〇〇が、第2章に無い
+  en: A reference to a topic its target never mentions
+
+why:
+  ja: 「第2章で述べた料金体系」と書いたのに、第2章に料金体系の話が無いと、読み手は探しても見つけられません。章を入れ替えたり、話を別の章へ移したりしたときに起きます。参照のすぐ後ろの「で述べた」「で説明した」に続く語を、参照先の見出しと本文から探し、どこにも無ければ指します。
+  en: 'When the text says "see Section 2 for pricing" and Section 2 never mentions pricing, the reader looks and finds nothing. It happens when sections are reordered or a topic moves elsewhere. The words right after "for" (or 「で述べた」) are looked for in the target''s heading and text, and it is pointed out when they are not there.'
+
+message:
+  ja: "{label}（{heading}）に「{topic}」が見当たりません"
+  en: '"{topic}" does not appear in {label} ({heading})'
+
+how_to_fix:
+  ja: 話がどの章にあるかを確かめて、参照の番号を直してください。言い換えて書いているなら、同じ言葉に揃えると読み手が探せます。
+  en: Find the section that covers the topic and correct the number. If the section words it differently, using the same word lets the reader find it.
+
+levels: { strict: warning, normal: info, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: facts
+summary:
+  ja: 「第2章で述べた料金体系」のように参照先の話題を書いたのに、その章に話題の語が無い所
+  en: A reference that names a topic ("see Section 2 for pricing") its target never mentions
+example:
+  ja:
+    before: |
+      # 案内
+
+      ## 第1章 総則
+
+      第2章で述べた返金手続は改定されます。
+
+      ## 第2章 料金
+
+      料金体系は月額です。
+    after: |
+      # 案内
+
+      ## 第1章 総則
+
+      第2章で述べた料金体系は改定されます。
+
+      ## 第2章 料金
+
+      料金体系は月額です。
+  en:
+    before: |
+      # Guide
+
+      ## 1. Scope
+
+      See Section 2 for refunds.
+
+      ## 2. Pricing
+
+      The price is monthly.
+    after: |
+      # Guide
+
+      ## 1. Scope
+
+      See Section 2 for pricing.
+
+      ## 2. Pricing
+
+      The price is monthly.
+
+not_flagged:
+  ja: 「詳細」「内容」のようにどの章にも当てはまる語、参照先が見出しを持たないか一つに決まらない参照、他の文書の条は見ません。言い換え（料金と価格）は見つけられないので、語が違えば指します。
+  en: Words that fit any section ("details", "more information"), references whose target has no heading or cannot be told apart, and references to another document are left alone. A synonym (price and fee) is not recognised, so a different word is pointed out.
+rewrite:
+  ja:
+    direction: 話題がどの章にあるかを書き手に確かめ、参照の番号を直してください。参照先が別の言葉で書いているなら、どちらかの言葉に揃えます。
+    pairs:
+      - before: 第2章で述べた返金手続は改定されます。
+        after: 第3章で述べた返金手続は改定されます。
+      - before: 第2章で述べた価格表
+        after: 第2章で述べた料金表
+    keep:
+      - 参照している話題
+    avoid:
+      - 参照先に無い話を、参照先にあることにする
+  en:
+    direction: Ask the writer which section covers the topic and correct the number. If the target words it differently, use one wording in both places.
+    pairs:
+      - before: See Section 2 for refunds.
+        after: See Section 3 for refunds.
+      - before: See Section 2 for fees.
+        after: See Section 2 for pricing.
+    keep:
+      - the topic being referred to
+    avoid:
+      - claiming the target covers something it does not

package/rules/relative-date-mismatch.yaml

@@ -0,0 +1,71 @@
+id: relative-date-mismatch
+layer: L3
+status: experimental
+how_to_find: relative-date-mismatch
+requires: [dates]
+severity: warning
+
+name:
+  ja: 「3日後の10月5日」の日付が、基準の日付から数えた日と合わない
+  en: A relative date that does not match its base date
+
+why:
+  ja: 「10月2日に申し込み、3日後の10月6日に通知」のように、相対の期間と日付を一緒に書くと、読み手はどちらが正しいのか分かりません。日程をずらしたときに、日付か期間の片方だけを直すと起きます。「3日後の」「1か月前の」のすぐ後ろの日付を、同じ文で前にある日付（文が「2週間後、」で始まるなら前の文の日付）に期間を足した（前なら引いた）日と比べます。
+  en: 'When a relative length and a date are written together ("Applications open on May 1, 2026. Two weeks later, on May 16, 2026, …"), the reader cannot tell which is right. It happens when a schedule moves and only the date or only the length is changed. The date right after "N days later" or "N weeks earlier" is compared with the nearest earlier date in the same sentence (or in the previous sentence when the sentence opens with the relative length), plus or minus the length.'
+
+message:
+  ja: "{base}の{relative}なら{expected}のはずですが、{target}と書かれています"
+  en: "{relative} from {base} is {expected}, but the date is given as {target}"
+
+how_to_fix:
+  ja: 基準の日付・期間・日付のどれが正しいかを確かめて、残りを合わせてください。
+  en: Check which is right, the base date, the length or the date, and make the rest agree.
+
+levels: { normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: facts
+summary:
+  ja: 「3日後の10月6日」のように、相対で書いた日付が基準の日付から数えた日と合わない所
+  en: A date written with a relative length ("two weeks later, on May 16") that is not that far from its base date
+example:
+  ja:
+    before: |
+      10月2日に申し込みを締め切り、3日後の10月6日に結果を通知します。
+    after: |
+      10月2日に申し込みを締め切り、3日後の10月5日に結果を通知します。
+  en:
+    before: |
+      Applications close on May 1, 2026. Two weeks later, on May 16, 2026, results are sent.
+    after: |
+      Applications close on May 1, 2026. Two weeks later, on May 15, 2026, results are sent.
+
+not_flagged:
+  ja: 期間のすぐ後ろ（「の」や読点だけを挟む）に日付があるときだけ見ます。基準の日付が同じ文（文の頭の「2週間後、」なら前の文）に無いもの、「3営業日後」のように単位が日・週・月・年でないものは見ません。
+  en: Only a date right after the relative length (with "on" or punctuation between) is checked. A relative length with no date before it in the same sentence (or the previous one, when the sentence opens with it), and units other than days, weeks, months and years ("3 business days later"), are left alone.
+rewrite:
+  ja:
+    direction: 基準の日付・期間・日付のどれが正しいかを書き手に確かめ、残りを合わせてください。期間か日付のどちらかを消して、一つだけにしてもかまいません。
+    pairs:
+      - before: 10月2日に締め切り、3日後の10月6日に通知します。
+        after: 10月2日に締め切り、3日後の10月5日に通知します。
+      - before: 発売日の5月1日の1か月前の4月2日に予約を始めます。
+        after: 発売日の5月1日の1か月前の4月1日に予約を始めます。
+    keep:
+      - 基準の日付
+      - 「後」か「前」かの向き
+    avoid:
+      - どれが正しいかを推測で決める
+  en:
+    direction: Ask the writer which of the base date, the length and the date is right, and make the rest agree. Dropping either the length or the date also works.
+    pairs:
+      - before: Applications close on May 1, 2026. Two weeks later, on May 16, 2026, results are sent.
+        after: Applications close on May 1, 2026. Two weeks later, on May 15, 2026, results are sent.
+      - before: The launch is on June 1, 2026; one month earlier, on May 2, 2026, preorders open.
+        after: The launch is on June 1, 2026; one month earlier, on May 1, 2026, preorders open.
+    keep:
+      - the base date
+      - whether the date is later or earlier
+    avoid:
+      - guessing which value is right

package/rules/rule-of-three.yaml

@@ -22,7 +22,7 @@ how_to_fix:
 
 levels: { strict: 50, normal: 70, relaxed: 90 }
 
-use_for: [blog, legal, docs, academic, literature, speech]
+use_for: [technical/readme, blog, legal, docs, academic, literature, speech]
 sources: [reinhart-2025, zhang-2024]
 
 group: ai-tells
@@ -116,8 +116,8 @@ example:
       - No review
 
 not_flagged:
-  ja: 箇条書きが 3 つより少ない文書は見ません。ビジネス文書と技術文書のジャンルでは見ません。
-  en: Documents with fewer than three lists are not checked. Business and technical genres do not run this rule.
+  ja: 箇条書きが 3 つより少ない文書は見ません。ビジネス文書と仕様書（technical/spec）のジャンルでは見ません。
+  en: Documents with fewer than three lists are not checked. Business and specification (technical/spec) genres do not run this rule.
 level_meaning:
   ja: 3 項目の箇条書きの割合 {limit}% まで
   en: up to {limit}% of lists with exactly three items

package/rules/section-length-uniformity.yaml

@@ -30,7 +30,7 @@ options:
       ja: 測る節の数の下限。節が少ないと長さのばらつきは偶然で小さく出て、人の書いた文書でも揃って見えます
       en: The fewest sections measured. With few sections, the variation is small by chance, and a person's writing looks uniform too
 
-use_for: [blog, legal, docs, academic, literature, speech]
+use_for: [technical/readme, blog, legal, docs, academic, literature, speech]
 
 group: ai-tells
 summary:
@@ -131,8 +131,8 @@ example:
       New versions are on the same page.
 
 not_flagged:
-  ja: 中身のある節が 5 より少ない文書は見ません（min_sections で変えられます）。ビジネス文書と技術文書のジャンルでは見ません。
-  en: Documents with fewer than 5 sections are not checked (min_sections changes it). Business and technical genres do not run this rule.
+  ja: 中身のある節が 5 より少ない文書は見ません（min_sections で変えられます）。ビジネス文書と仕様書（technical/spec）のジャンルでは見ません。
+  en: Documents with fewer than 5 sections are not checked (min_sections changes it). Business and specification (technical/spec) genres do not run this rule.
 level_meaning:
   ja: 節の長さのばらつきが {limit}% 未満なら指摘
   en: reported when section length varies by less than {limit}%