chaffjs 0.17.0 → 0.19.0

package/rules/broken-link.yaml

@@ -0,0 +1,65 @@
+id: broken-link
+layer: L1
+status: experimental
+how_to_find: broken-link
+requires: [markdown]
+severity: warning
+
+name:
+  ja: 行き先の無いリンク
+  en: Link that goes nowhere
+
+why:
+  ja: 押しても何も起きないリンクは、読み手に「あるはずの情報が無い」と思わせます。三つを見ます。行き先が空のリンク（[資料]()）、同じページの見出しを指すのにその見出しが無いリンク（[手順](#手順) で「手順」の見出しを消した・書き換えた）、参照の形で書いたのに定義が無いもの（[資料][1] で「[1]:」の行が無い。そのまま字で表示されます）。見出しから名前を作る決まりは表示するものごとに違うので、字と数字だけを比べ、大文字小文字・空白・記号の違いは問いません。[1][2] のように数だけの括弧は文献の番号として数えません（markdownlint の MD042・MD051・MD052）。
+  en: A link that does nothing when clicked tells the reader something is missing. Three kinds are checked. A link with an empty destination ("[report]()"); a link to a heading on the same page that the page does not have ("[Setup](#setup)" after the heading was renamed or removed); and a reference-style link whose label is never defined ("[report][1]" with no "[1]:" line), which is shown as plain brackets. Renderers build heading anchors differently, so only letters and digits are compared; case, spaces and punctuation do not matter. Brackets holding only numbers ("[1][2]") are citation numbers and are not counted (markdownlint's MD042, MD051 and MD052).
+
+message:
+  ja: リンク「{link}」の行き先がありません
+  en: 'The link "{link}" goes nowhere'
+
+messages:
+  empty:
+    ja: リンク「{link}」の行き先が空です
+    en: 'The link "{link}" has an empty destination'
+  anchor:
+    ja: リンク「{link}」が指す「{target}」の見出しがこの文書にありません
+    en: 'The link "{link}" points to "{target}", which is not a heading on this page'
+  reference:
+    ja: 「{link}」は参照の形ですが、名前の定義がありません（字のまま表示されます）
+    en: '"{link}" is a reference-style link with no definition (it shows as plain text)'
+
+how_to_fix:
+  ja: "行き先を書いてください。見出しを指すなら、今の見出しの言葉に合わせてください。参照の形なら、文書のどこかに「[名前]: URL」の行を足してください。"
+  en: 'Fill in the destination. For a heading, match the heading as it is now written. For a reference-style link, add a "[label]: URL" line somewhere in the document.'
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: structure
+summary:
+  ja: 行き先が空のリンク、文書に無い見出しを指すリンク、定義の無い参照の形のリンク
+  en: A link with no destination, a link to a heading the page does not have, or a reference-style link with no definition
+example:
+  ja:
+    before: |
+      ## 準備
+
+      道具をそろえます。詳しくは[手順](#手順)を見てください。
+    after: |
+      ## 準備
+
+      道具をそろえます。詳しくは[準備](#準備)を見てください。
+  en:
+    before: |
+      ## Setup
+
+      Gather the tools. See [Install](#install) for more.
+    after: |
+      ## Setup
+
+      Gather the tools. See [Setup](#setup) for more.
+
+not_flagged:
+  ja: 見出しの名前は字と数字だけで比べ、大文字小文字や記号の違いは問いません。「[1][2]」のような文献の番号、「A[i][j]」のような添字、使われていない定義も指しません。
+  en: Heading anchors are compared on letters and digits only, ignoring case and punctuation. Citation numbers ("[1][2]"), subscripts ("A[i][j]") and definitions no link uses are not reported.

package/rules/closing-cliche.yaml

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

package/rules/colon-lead-in.yaml

@@ -0,0 +1,83 @@
+id: colon-lead-in
+layer: L1
+status: experimental
+how_to_find: colon-lead-in
+# English human writing hands off to a list after a colon as a matter of course: two in a short self-written English
+# document already passed any limit that the generated-style samples reached. Japanese only until a limit separates them.
+languages: [ja]
+severity: info
+
+name:
+  ja: コロンで箇条書きへ渡す文が多い
+  en: Too many colon lead-ins to lists
+
+why:
+  ja: 「以下の通りです：」「ポイントは次の 3 つ：」のように、コロンで終わる文から箇条書きへ渡す形です。1 つなら案内ですが、節ごとに続くと、説明が箇条書きの前置きだけになり、項目どうしの繋がりが書かれません。生成文によく見られる形です。
+  en: 'A sentence ending in a colon that hands the reader to a list ("Here''s what you need to know:"). Once, it guides; section after section, the prose shrinks to list captions and the links between the items go unwritten. A shape common in generated text.'
+
+message:
+  ja: コロンで箇条書きへ渡す文が 1000 字あたり {density} 個あります（{limit} 個まで）
+  en: "{density} colon lead-ins to lists per 1000 characters (limit {limit})"
+
+how_to_fix:
+  ja: 箇条書きの一部を文に戻し、項目どうしがどう繋がるのかを書いてください。手順や部品の一覧のように、本当に並べるものはそのままでかまいません。
+  en: Turn some of the lists back into sentences and say how the items connect. Real lists (steps, parts) can stay.
+
+# 1000 字あたりの数。2 つより少なければ言わない（ai-phrasing.ts の PILE）。
+levels: { strict: 1, normal: 2, relaxed: 4 }
+
+use_for: [blog, business, legal, docs, academic, literature, speech]
+
+group: ai-tells
+summary:
+  ja: 「以下の通りです：」のように、コロンで終わる文から箇条書きへ渡す形が続き、説明が箇条書きの前置きだけになっている所
+  en: 'Sentences ending in a colon that hand off to a list ("Here''s what you need to know:"), section after section'
+example:
+  ja:
+    pad: true
+    before: |
+      準備は以下の通りです：
+
+      - 鍵
+      - 地図
+
+      当日の流れは次の通りです：
+
+      - 集合
+      - 出発
+    after: |
+      鍵と地図を用意してください。当日は駅に集合してから出発します。
+
+      - 鍵
+      - 地図
+
+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.
+level_meaning:
+  ja: コロンで箇条書きへ渡す文が 1000 字あたり {limit} 個まで
+  en: "colon lead-ins to lists: up to {limit} per 1000 characters"
+rewrite:
+  ja:
+    direction: コロンで箇条書きへ渡す所のうち、項目が二つか三つで互いに繋がっているものを文に戻してください。手順や部品の一覧は箇条書きのままにします。
+    pairs:
+      - before: |
+          保存期間は以下の通りです：
+
+          - 30 日間
+          - 期限を過ぎると消える
+        after: |
+          保存期間は 30 日間で、期限を過ぎると消えます。
+      - before: |
+          利点は次のとおりです：
+
+          - 速い
+          - 安い
+        after: |
+          速くて安いのが利点です。
+    keep:
+      - 項目の中身と数
+      - 手順の順番
+    avoid:
+      - 長い箇条書きを一つの長い文に詰める
+      - 項目の間に、書き手が書いていない因果を足す

package/rules/concrete-evidence-density.yaml

@@ -25,3 +25,44 @@ how_to_fix:
 levels: { strict: 1, normal: 3, relaxed: 6 }
 
 use_for: [blog, business, legal, docs, academic, literature, speech]
+
+group: structure
+summary:
+  ja: 数字もコードもリンクも無く、読み手が持ち帰れるものの無い節
+  en: A section with no number, no code and no link, so the reader has nothing to take away
+example:
+  ja:
+    config: { rules: { concrete-evidence-density: strict } }
+    before: |
+      # 改善の報告
+
+      ## 成果
+
+      問い合わせ対応が大きく良くなりました。お客様からの評判も上々です。担当者の負担も軽くなりました。
+    after: |
+      # 改善の報告
+
+      ## 成果
+
+      問い合わせへの回答が、平均 3 日から 1 日になりました。お客様アンケートの満足度は 72% から 85% に上がりました。担当者の残業は月 10 時間減りました。
+  en:
+    config: { rules: { concrete-evidence-density: strict } }
+    before: |
+      # Improvement report
+
+      ## Results
+
+      Our help desk got much better. Customers are pleased with it. The team feels less pressure too.
+    after: |
+      # Improvement report
+
+      ## Results
+
+      Replies to help desk tickets now take 1 day on average, down from 3. Customer satisfaction rose from 72% to 85%. Overtime fell by 10 hours a month.
+
+not_flagged:
+  ja: 3 文より短い節、索引のように項目を並べた節は見ません。
+  en: Sections shorter than three sentences, and index-like sections of entries, are not checked.
+level_meaning:
+  ja: 具体物のない節が {limit} 個あれば指摘
+  en: reported once {limit} sections have nothing concrete

package/rules/contraction-consistency.yaml

@@ -26,3 +26,21 @@ how_to_fix:
 levels: { strict: 4, normal: 2, relaxed: 1 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: consistency
+summary:
+  ja: 英語で、「don't」と「do not」のように短縮形を使う書き方と使わない書き方が混ざっている所
+  en: Contractions ("don't") and full forms ("do not") mixed in one document
+example:
+  en:
+    before: |
+      We don't store your password. We can't read your messages. We won't share your data. We do not sell your address.
+    after: |
+      We don't store your password. We can't read your messages. We won't share your data. We don't sell your address.
+
+not_flagged:
+  ja: 短縮形を使うかどうかは決めません。文書の中で少ないほうだけを指します。
+  en: Whether to use contractions is not decided; only the minority form in the document is pointed at.
+level_meaning:
+  ja: 少ないほうの書き方が {limit} 箇所以下のとき指摘
+  en: reported when the minority form appears {limit} times or fewer

package/rules/contrast-framing.yaml

@@ -0,0 +1,88 @@
+id: contrast-framing
+layer: L2
+status: experimental
+how_to_find: contrast-framing
+word_list: contrast-frame
+# 打ち消し（it's not）と、それを返す語（it's、but）。後ろに返しが来たときだけ対比の枠になる。
+extra_word_lists: [contrast-lead, contrast-turn]
+uses: [pos]
+severity: info
+
+name:
+  ja: 対比の枠が多い
+  en: Too many contrast frames
+
+why:
+  ja: 「単なる X ではなく Y」「X だけでなく Y も」は、1 つなら論点を整理します。重なると、誰も言っていない X を打ち消し続ける文章になります。生成文によく見られる癖として知られています。
+  en: '"It''s not X, it''s Y" and "not just X, but Y" sort out a point when used once. Piled up, the text keeps knocking down an X nobody said, a habit well known in generated text.'
+
+message:
+  ja: 「{matched}」など、対比の枠が 1000 字あたり {density} 個あります（{limit} 個まで）
+  en: '"{matched}" and other contrast frames: {density} per 1000 words (limit {limit})'
+
+how_to_fix:
+  ja: 打ち消した側（X）を消して、言いたいこと（Y）だけを書いてください。
+  en: Drop the X you knocked down and say Y directly.
+
+# 1000 語（日本語は 1000 字）あたりの数。
+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]
+
+group: ai-tells
+summary:
+  ja: 「単なる X ではなく Y」「X だけでなく Y も」のような対比の枠が重なり、誰も言っていない X を打ち消し続けている所
+  en: 'Contrast frames piling up ("It''s not X, it''s Y", "not just X, but Y"), knocking down an X nobody said'
+example:
+  ja:
+    pad: true
+    before: |
+      この仕組みは単なる道具ではなく、チームの文化です。速さだけでなく、安心も届けます。
+    after: |
+      この仕組みで、見積もりの作成が一件あたり十分短くなりました。
+  en:
+    pad: true
+    before: |
+      This tool is not just software, but a culture. It's not a feature. It's a promise.
+    after: |
+      This tool cut the time to draft a quote by ten minutes.
+
+not_flagged:
+  ja: 一つだけの対比、打ち消しを返していない「単なる」（「単なる設定ミスです」）、「A ではなく B です」だけの文、続けて並べた打ち消し（「まだです。まだ試していません。」）は指しません。短い文書は測りません。
+  en: A single contrast, a denial nobody answers, and two denials in a row ("It's not ready. It's not tested.") are not reported. Short documents are not measured.
+level_meaning:
+  ja: 1000 字あたり対比の枠 {limit} 個まで
+  en: up to {limit} contrast frames per 1000 words
+rewrite:
+  ja:
+    direction: 打ち消している側（X）を消し、言いたい側（Y）を普通の文で書いてください。X が誰かの実際の誤解なら、その誤解を書いたうえで一度だけ打ち消してください。
+    pairs:
+      - before: この仕組みは単なる道具ではなく、チームの文化です。
+        after: この仕組みは、チームの文化になっています。
+      - before: 問題はツールではなく、運用です。
+        after: 問題は運用にあります。
+      - before: 速さだけでなく、安心も届けます。
+        after: 速く、安心して使えます。
+    keep:
+      - 言いたい側（Y）の中身
+      - 誰かが実際に言った X への反論
+    avoid:
+      - 「ではなく」を「というより」「むしろ」に替えて、同じ枠を残す
+      - 消した X の代わりに、書き手が言っていない主張を足す
+  en:
+    direction: Delete the side you knock down (X) and state the side you mean (Y) as a plain sentence. If X is a real belief someone holds, name it and answer it once.
+    pairs:
+      - before: This tool is not just software, but a culture.
+        after: This tool has become part of how the team works.
+      - before: The problem isn't the tool, it's the process.
+        after: The problem is the process.
+      - before: We don't just ship fast; we ship safely.
+        after: We ship fast and safely.
+    keep:
+      - what Y says
+      - an answer to an X someone actually said
+    avoid:
+      - swapping "not X but Y" for "less X than Y" or "rather than X", which keeps the frame
+      - adding a claim the writer did not make in place of the deleted X

package/rules/cushion-phrase-density.yaml

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

package/rules/dangling-figure-reference.yaml

@@ -0,0 +1,61 @@
+id: dangling-figure-reference
+layer: L3
+status: experimental
+how_to_find: dangling-figure
+severity: warning
+
+name:
+  ja: 図や表の参照先が無い
+  en: Reference to a missing figure or table
+
+why:
+  ja: 本文が「図3を参照」と書いているのに、図3がどこにも無いと、読み手は探し回ったうえで、図が抜けたのか番号がずれたのかを確かめることになります。図や表を消したり入れ替えたりしたあとに、本文の番号を直し忘れると起きます。行の頭に書いた番号（「図1　売上の推移」のようなキャプションや、「## 付録A」のような見出し）を図の置き場所とし、本文の番号がその中に無ければ指します。図・表・付録の種類ごとに、行の頭に一つも書いていない文書は見ません（図を別の紙に付けているかもしれないため）。
+  en: 'When the text says "see Figure 3" and there is no Figure 3, the reader searches for it and then has to work out whether the figure was dropped or the numbers shifted. It happens when a figure or a table is removed or reordered and the text is not updated. A number written at the start of a line (a caption such as "Figure 1: Sales by month", or a heading such as "## Appendix A") is where that figure is, and a number in the text that is none of them is pointed out. A kind (figures, tables, appendices) that the document never labels at the start of a line is not checked, because its figures may be in another file.'
+
+message:
+  ja: 「{label}」を指していますが、この文書に{label}がありません
+  en: "{label} is referred to, but the document has no {label}"
+
+how_to_fix:
+  ja: 番号がずれていないか確かめて、本文の番号を直すか、抜けた図や表を足してください。
+  en: Check whether the numbers shifted. Correct the number in the text, or add the missing figure or table.
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: facts
+summary:
+  ja: 本文が指す「図3」「表2」が、文書のどこにも無い所
+  en: A figure or table the text refers to that the document does not have
+example:
+  ja:
+    before: |
+      売上は図1のとおり伸び、費用は図3のとおり減った。
+
+      図1　売上の推移
+
+      図2　費用の推移
+    after: |
+      売上は図1のとおり伸び、費用は図2のとおり減った。
+
+      図1　売上の推移
+
+      図2　費用の推移
+  en:
+    before: |
+      Sales rose (Figure 1) and costs fell (Figure 3).
+
+      Figure 1: Sales by month
+
+      Figure 2: Costs by month
+    after: |
+      Sales rose (Figure 1) and costs fell (Figure 2).
+
+      Figure 1: Sales by month
+
+      Figure 2: Costs by month
+
+not_flagged:
+  ja: 図や表を行の頭に一つも書いていない文書、長い語の一部（地図3、一覧表2）、別の法令の別表（法別表第二）、図の数（図3枚）、コードの中は見ません。
+  en: 'A document that labels no figure or table at the start of a line, a figure of another document ("Figure 5 of the 2024 report"), and code are not checked.'

package/rules/dangling-reference.yaml

@@ -22,6 +22,59 @@ how_to_fix:
   en: Fix the number or remove the reference. If it points into another document, name that document so the reader knows where to look.
 
 # 何件あれば指摘するか。1 は「1 件でもあれば」。
-levels: { strict: 1, normal: 1, relaxed: 1 }
+levels: { normal: error, relaxed: warning }
 
 use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+sources: [jis-z8301-2019, femmer-2017]
+
+group: structure
+summary:
+  ja: 「第5条に定める」と書いてあるのに、その第5条が文書に無い所
+  en: A reference such as "as set out in Article 5" to a provision the document does not have
+example:
+  ja:
+    before: |
+      # 就業規則
+
+      ## 第1条（目的）
+
+      この規則は、働き方の決まりを定める。
+
+      ## 第2条（休日）
+
+      休日は、第5条に定める勤務表による。
+    after: |
+      # 就業規則
+
+      ## 第1条（目的）
+
+      この規則は、働き方の決まりを定める。
+
+      ## 第2条（休日）
+
+      休日は、第1条に定める決まりのほか、会社が別に定める勤務表による。
+  en:
+    before: |
+      # Staff rules
+
+      ## Article 1 (Purpose)
+
+      These rules set out how we work.
+
+      ## Article 2 (Holidays)
+
+      Holidays follow the rota set out in Article 5.
+    after: |
+      # Staff rules
+
+      ## Article 1 (Purpose)
+
+      These rules set out how we work.
+
+      ## Article 2 (Holidays)
+
+      Holidays follow the rota that the company publishes each month.
+
+not_flagged:
+  ja: 「法第2条」のように、ほかの文書の条を指す参照は探しません。条で番号を振っていない文書では、条で数える参照を見ません。
+  en: References into another document ("Article 2 of the Act") are not looked up. A document that numbers none of its provisions as articles is not checked for article references.

package/rules/date-order.yaml

@@ -21,6 +21,39 @@ how_to_fix:
   ja: 日付を確かめて、書き間違いなら直し、順番が違うなら並べ替えてください。
   en: Check the date. Correct it if it is a typo, or move the row if the order is wrong.
 
-levels: { strict: 1, normal: 1, relaxed: 1 }
+levels: { strict: error, normal: warning, relaxed: info }
 
 use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+sources: [de-marneffe-2008]
+
+group: facts
+summary:
+  ja: 旅程や予定表で、一つだけ日付の順番が前後している所
+  en: One date out of order in an itinerary or a schedule
+example:
+  ja:
+    before: |
+      - 2026年4月1日 出発
+      - 2026年4月3日 視察
+      - 2026年3月5日 会議
+      - 2026年4月10日 帰国
+    after: |
+      - 2026年4月1日 出発
+      - 2026年4月3日 視察
+      - 2026年4月5日 会議
+      - 2026年4月10日 帰国
+  en:
+    before: |
+      - 1 April 2026: depart
+      - 3 April 2026: site visit
+      - 5 March 2026: meeting
+      - 10 April 2026: return
+    after: |
+      - 1 April 2026: depart
+      - 3 April 2026: site visit
+      - 5 April 2026: meeting
+      - 10 April 2026: return
+
+not_flagged:
+  ja: その向きに沿う日付が半分以下の並びは、名前や版の順に並べた一覧として扱い、何も言いません。
+  en: A list where no more than half of the dates follow one direction is taken as sorted by something else, and nothing is said.

package/rules/date-range-reversed.yaml

@@ -0,0 +1,46 @@
+id: date-range-reversed
+layer: L3
+status: experimental
+how_to_find: date-range-reversed
+requires: [dates]
+severity: warning
+
+name:
+  ja: 期間の終わりが始まりより前
+  en: A period that ends before it starts
+
+why:
+  ja: 「2026年4月1日〜2026年3月31日」のように、期間の終わりの日付が始まりより前だと、読み手はどちらの日付が正しいのかを問い合わせることになります。年を書き写し間違えたときや、日付を片方だけ直したときに起きます。二つの日付の間が範囲の記号（〜、–）だけのときと、「から」でつなぎ終わりの日付のあとに「まで」が続くときを期間として比べます。年の無い期間（12月28日〜1月4日）は年をまたぐかもしれないので比べません。
+  en: 'When a period such as "5 April 2026 – 2 April 2026" ends before it starts, the reader has to ask which date is right. It happens when a year is copied wrong, or when only one of the two dates is changed. Two dates are read as a period when only a range mark (–, —) or a word such as "through" or "until" stands between them, or when they are written "from … to …". A period without a year ("28 December – 4 January") may run into the next year and is not compared.'
+
+message:
+  ja: 期間「{period}」の終わりが始まりより前です
+  en: 'The period "{period}" ends before it starts'
+
+how_to_fix:
+  ja: 始まりと終わりの日付を確かめて、書き間違えたほうを直してください。
+  en: Check both dates and correct the one that is wrong.
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: facts
+summary:
+  ja: 「4月1日〜3月31日」のように、期間の終わりが始まりより前の所
+  en: A period whose end date comes before its start date
+example:
+  ja:
+    before: |
+      申し込みの期間は2026年4月1日〜2026年3月31日です。
+    after: |
+      申し込みの期間は2026年4月1日〜2027年3月31日です。
+  en:
+    before: |
+      Applications are open 1 April 2026 – 31 March 2026.
+    after: |
+      Applications are open 1 April 2026 – 31 March 2027.
+
+not_flagged:
+  ja: 年の無い期間（12月28日〜1月4日）、「から」だけで「まで」の無いもの（10日から3日に変更）、日付の間に言葉のあるものは比べません。
+  en: 'A period without a year, "from … to …" in a sentence with a word that changes a date ("moved from March 10 to March 3", "… was postponed"), and two dates with words between them are not compared.'