chaffjs 0.17.0 → 0.19.0

package/rules/stock-transition.yaml

@@ -0,0 +1,86 @@
+id: stock-transition
+layer: L2
+status: experimental
+how_to_find: stock-transition
+word_list: stock-transition
+uses: [pos]
+severity: info
+
+name:
+  ja: 決まった接ぎで始まる文が多い
+  en: Too many stock transitions
+
+why:
+  ja: 「さらに」「加えて」「このように」で文を始めると、前の文と何がどう繋がるのかを言わずに済んでしまいます。重なると、並べただけの文章に見えます。生成文によく見られる癖として知られています。
+  en: Opening with "Moreover" or "Additionally" lets a sentence skip saying how it follows from the last. Piled up, the text reads as a list with glue, a habit well known in generated text.
+
+message:
+  ja: 「{matched}」など、決まった接ぎで始まる文が 1000 字あたり {density} 個あります（{limit} 個まで）
+  en: '"{matched}" and other stock transitions open {density} sentences per 1000 words (limit {limit})'
+
+how_to_fix:
+  ja: 接ぎの語を消して読んでください。繋がりが要るなら、何が何の理由なのかを言葉で書いてください。
+  en: Delete the transition and reread. If the link matters, say what it is.
+
+# 1000 語（日本語は 1000 字）あたりの数。
+levels:
+  ja: { strict: 2, normal: 3, relaxed: 5 }
+  en: { strict: 4, normal: 6, relaxed: 10 }
+
+use_for: [blog, business, legal, docs, academic, literature, speech]
+
+group: ai-tells
+summary:
+  ja: 「さらに」「加えて」「このように」で始まる文が多く、何がどう繋がるのかを言わずに並べている所
+  en: Too many sentences opening with "Moreover", "Additionally" or "Furthermore", listing without saying how they connect
+example:
+  ja:
+    pad: true
+    before: |
+      さらに、費用が下がります。加えて、作業も速くなります。このように、良い点が多くあります。
+    after: |
+      費用が下がり、見積もりも一件あたり十分早く出せるようになりました。
+  en:
+    pad: true
+    before: |
+      Moreover, costs go down. Additionally, the work gets faster. Furthermore, the team is happier.
+    after: |
+      Costs went down, so each quote now goes out ten minutes sooner.
+
+not_flagged:
+  ja: 話を運ぶ接続詞（「また」「そのため」「しかし」）と、文の途中の接ぎは数えません。短い文書は測りません。
+  en: Words that carry the argument (However, Therefore), a transition inside a sentence, and "In addition to …" are not counted. Short documents are not measured.
+level_meaning:
+  ja: 決まった接ぎで始まる文が 1000 字あたり {limit} 個まで
+  en: up to {limit} sentences per 1000 words opening with a stock transition
+rewrite:
+  ja:
+    direction: 文頭の接ぎの語を消して読み返してください。繋がりが分からなくなる所だけ、前の文との関係（理由、例外、順番）を言葉で書きます。
+    pairs:
+      - before: さらに、ログの保存期間も延ばしました。
+        after: ログの保存期間も延ばしました。
+      - before: 費用が下がりました。加えて、速度も上がりました。
+        after: 費用が下がり、速度も上がりました。
+      - before: このように、設定は三か所で変わります。
+        after: 設定が変わるのは、この三か所です。
+    keep:
+      - 文の順番
+      - 書き手が書いた理由や対比
+    avoid:
+      - 「さらに」を「また」「そして」に替えるだけで済ませる
+      - 書き手が書いていない因果（「〜なので」）を作る
+  en:
+    direction: Delete the transition at the start of the sentence and reread. Only where the link is lost, say what it is (a reason, an exception, an order).
+    pairs:
+      - before: Moreover, we extended log retention.
+        after: We also extended log retention.
+      - before: Costs fell. Additionally, speed improved.
+        after: Costs fell and speed improved.
+      - before: In conclusion, the settings change in three places.
+        after: The settings change in three places.
+    keep:
+      - the order of the sentences
+      - a reason or contrast the writer stated
+    avoid:
+      - swapping "Moreover" for "Also" at the start of every sentence
+      - inventing a cause ("because") the writer did not state

package/rules/stray-space.yaml

@@ -36,3 +36,21 @@ levels: { strict: 1, normal: 1, relaxed: 3 }
 
 # 歌の行は句点で終わらないので、ジャンルを問わず数えない。
 use_for: [business, blog, technical, legal, docs, academic, literature, speech]
+
+group: slips
+summary:
+  ja: 「確認 しました」のように、ひとつながりの語句の途中に空白が紛れこんだ所
+  en: A stray space inside a Japanese phrase, usually left over from retyping
+example:
+  ja:
+    before: |
+      資料を確認しました。担当者が払いました。会議で決めました。見積もりを 送りました。
+    after: |
+      資料を確認しました。担当者が払いました。会議で決めました。見積もりを送りました。
+
+not_flagged:
+  ja: 名詞と名詞のあいだの空白（担当 田中）、句点で終わらない行、見出し、表、「」の中、英数字との境目は見ません。文書全体が文節ごとに空ける書き方なら指しません。
+  en: Spaces between two nouns, lines that do not end with a full stop, headings, tables, quotations and boundaries with Latin letters are not checked. A document that spaces every phrase on purpose is not reported.
+level_meaning:
+  ja: 少ないほうの空け方が {limit} 箇所あれば指摘
+  en: reported once {limit} spaces go against the document's habit

package/rules/taigen-dome-in-prose.yaml

@@ -25,3 +25,36 @@ how_to_fix:
 levels: { strict: 2, normal: 4, relaxed: 8 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: readability
+summary:
+  ja: 名詞で終わる文（体言止め）が本文に続き、言いかけのように読める所
+  en: Many Japanese sentences in the body that stop on a noun, which read as unfinished
+example:
+  ja:
+    config: { rules: { taigen-dome-in-prose: strict } }
+    before: |
+      今年の目標は売上の回復。そのための施策は三つ。最初は店頭の品ぞろえの見直し。
+    after: |
+      今年の目標は売上の回復です。そのための施策は三つあります。最初に、店頭の品ぞろえを見直します。
+
+not_flagged:
+  ja: 箇条書きの中の体言止めは、その書き方が普通なので数えません。
+  en: Noun endings in bullet lists, where the form is normal, are not counted.
+level_meaning:
+  ja: 本文の体言止め {limit} 文まで
+  en: up to {limit} noun-ending sentences in the body
+rewrite:
+  ja:
+    direction: 本文で名詞で止めた文に、文書の文体に合わせた述語（です・ます、または、だ・である）を足してください。見出し、箇条書き、表はそのままにします。
+    pairs:
+      - before: 次の課題は費用。
+        after: 次の課題は費用です。
+      - before: 導入は来月から。対象は営業部。
+        after: 導入は来月からです。対象は営業部です。
+    keep:
+      - 見出し、箇条書き、表の体言止め
+      - 文書の文体（です・ます、または、だ・である）
+    avoid:
+      - 文末を「〜となります」「〜になります」に揃えて別の癖を作る
+      - 述語を足すときに強める（「大きな課題です」）

package/rules/title-case-consistency.yaml

@@ -24,3 +24,45 @@ how_to_fix:
 levels: { strict: 3, normal: 2, relaxed: 1 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: consistency
+summary:
+  ja: 英語の見出しで、Title Case と sentence case が混ざっている所
+  en: Headings that mix Title Case and sentence case
+example:
+  en:
+    before: |
+      # User guide
+
+      ## Getting started
+
+      Install the app.
+
+      ## Changing your settings
+
+      Open the menu.
+
+      ## Sharing Files With Your Team
+
+      Press share.
+    after: |
+      # User guide
+
+      ## Getting started
+
+      Install the app.
+
+      ## Changing your settings
+
+      Open the menu.
+
+      ## Sharing files with your team
+
+      Press share.
+
+not_flagged:
+  ja: 文書の題（最初の一番上の見出し）は名前なので比べません。どちらの流儀が正しいかは決めません。
+  en: The document's title (the single top-level heading that opens it) is a name and is not compared. Neither style is called right.
+level_meaning:
+  ja: 少ないほうの流儀の見出しが {limit} 個以下のとき指摘
+  en: reported when the minority style has {limit} headings or fewer

package/rules/total-mismatch.yaml

@@ -21,6 +21,43 @@ how_to_fix:
   ja: 内訳の金額と合計のどちらが正しいかを確かめて、片方を直してください。
   en: Check which is right, the items or the total, and correct the other.
 
-levels: { strict: 1, normal: 1, relaxed: 1 }
+levels: { normal: error, relaxed: warning }
 
 use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+sources: [de-marneffe-2008]
+
+group: facts
+summary:
+  ja: 見積もりや請求書で、合計が上に並べた金額の和と合わない所
+  en: A total in a quote or an invoice that is not the sum of the amounts above it
+example:
+  ja:
+    before: |
+      | 項目 | 金額 |
+      | --- | --- |
+      | 設計 | 300,000円 |
+      | 開発 | 500,000円 |
+      | 合計 | 900,000円 |
+    after: |
+      | 項目 | 金額 |
+      | --- | --- |
+      | 設計 | 300,000円 |
+      | 開発 | 500,000円 |
+      | 合計 | 800,000円 |
+  en:
+    before: |
+      | Item | Amount |
+      | --- | --- |
+      | Design | $3,000 |
+      | Build | $5,000 |
+      | Total | $9,000 |
+    after: |
+      | Item | Amount |
+      | --- | --- |
+      | Design | $3,000 |
+      | Build | $5,000 |
+      | Total | $8,000 |
+
+not_flagged:
+  ja: 単位や列の違う金額は足しません。足し方が何通りもあるとき（小計と税のあとの総計など）は、どれとも合わないときだけ指します。
+  en: Amounts in another unit or column are not added. Where there is more than one way to add them up, it is reported only when none matches.

package/rules/unbalanced-bracket.yaml

@@ -0,0 +1,56 @@
+id: unbalanced-bracket
+layer: L1
+status: experimental
+how_to_find: unbalanced-bracket
+severity: warning
+
+name:
+  ja: 括弧が組になっていない
+  en: Unbalanced bracket
+
+why:
+  ja: 閉じ忘れた「（」や、開きの無い「」」があると、読み手はどこまでが括弧の中なのか分からなくなります。全角の「（」を半角の「)」で閉じるのも、書き換えの途中で残った印です。見出しで区切った節ごとに、「」『』（）()［］[]【】〔〕〈〉《》“” の組を数えます。詩の連や長い引用は段落をまたぐので、段落を越えて組にします。行の頭や空白の後ろの「1)」「a)」「事例）」のような三文字までの番号の印と数の後ろの「）」、コードと URL は数えません。英語の小説のように、次の段落も同じ開きで始まるなら、閉じない開きは続きとして数えません。
+  en: A "(" never closed, or a ")" never opened, leaves the reader unsure where the aside ends. A full-width "（" closed by a half-width ")" is left over from an edit too. Brackets are paired within each section under a heading ((), [], “”, and the Japanese 「」『』（）［］【】〔〕〈〉《》), across paragraphs, since a stanza or a long quotation may span several. A short label of up to three characters such as "1)", "a)" or "iv)" at the start of a line or after a space, a ")" right after a number, code and URLs are not counted. An opening quotation mark carried into a paragraph that opens with the same mark, as in fiction, is not counted.
+
+message:
+  ja: 「{mark}」が組になっていません
+  en: '"{mark}" has no partner'
+
+messages:
+  unclosed:
+    ja: 「{mark}」が閉じていません
+    en: '"{mark}" is never closed'
+  unopened:
+    ja: 「{mark}」に対応する開きがありません
+    en: '"{mark}" closes nothing that was opened'
+  mismatch:
+    ja: 「{partner}」を「{mark}」で閉じています（全角と半角が違います）
+    en: '"{partner}" is closed by "{mark}" (full-width and half-width differ)'
+
+how_to_fix:
+  ja: 足りない括弧を足すか、余分な括弧を消してください。全角と半角は、開きと閉じをそろえてください。
+  en: Add the missing bracket or remove the extra one. Make the opening and closing marks the same width.
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: slips
+summary:
+  ja: 閉じ忘れた「（」や開きの無い「」」のように、組になっていない括弧と引用符
+  en: A bracket or quotation mark with no partner, such as a "(" that is never closed
+example:
+  ja:
+    before: |
+      資料（別紙を参照してください。
+    after: |
+      資料（別紙）を参照してください。
+  en:
+    before: |
+      The plan (see below is ready.
+    after: |
+      The plan (see below) is ready.
+
+not_flagged:
+  ja: 行の頭や空白の後ろの「1)」「a)」「事例）」のような三文字までの番号の印、数の後ろの「）」、コードと URL は数えません。段落をまたいで閉じる括弧と、次の段落を同じ引用符で始める台詞も指しません。
+  en: Labels of up to three characters such as "1)" or "a)" at the start of a line or after a space, a ")" right after a number, code and URLs are not counted. A bracket closed in a later paragraph, and a quotation carried into a paragraph that opens with the same mark, are not reported.

package/rules/undefined-acronym.yaml

@@ -13,6 +13,7 @@ extra_word_lists:
     us-state-code,
     emphasis-word,
     numbered-division,
+    abbreviated-label,
     honorific,
     name-title,
     date-time-unit,
@@ -40,3 +41,25 @@ how_to_fix:
 levels: { strict: 1, normal: 3, relaxed: 6 }
 
 use_for: [business, technical, legal, docs, academic, literature, speech]
+sources: [plain-2011, jis-z8301-2019]
+
+group: readability
+summary:
+  ja: 「KGI」「PMF」のように、説明なしで出てくる略語
+  en: An acronym such as "KGI" or "PMF" used without ever being spelled out
+example:
+  ja:
+    config: { rules: { undefined-acronym: strict } }
+    before: 今期の KGI は、PMF の達成です。
+    after: 今期の最終目標（KGI, Key Goal Indicator）は、製品が市場に受け入れられること（PMF, Product Market Fit）です。
+  en:
+    config: { rules: { undefined-acronym: strict } }
+    before: Our KGI this term is to reach PMF.
+    after: Our key goal indicator (KGI) this term is to reach product-market fit (PMF).
+
+not_flagged:
+  ja: 誰でも知っている略語（URL、PDF など）と、前後の括弧で説明した略語は指しません。
+  en: Common acronyms (URL, PDF) and acronyms spelled out in brackets next to them are not reported.
+level_meaning:
+  ja: 説明のない略語が {limit} 種類あれば指摘
+  en: reported once {limit} different acronyms go unexplained

package/rules/unfilled-placeholder.yaml

@@ -0,0 +1,50 @@
+id: unfilled-placeholder
+layer: L2
+status: experimental
+how_to_find: unfilled-placeholder
+word_list: placeholder-word
+severity: warning
+
+name:
+  ja: 埋め忘れた空欄
+  en: Unfilled placeholder
+
+why:
+  ja: 「【会社名】」「[Your Name]」は、雛形や生成した下書きに残る空欄です。文体の好みではなく、埋め忘れです。例として置いた「○○」は正しい書き方なので数えません。
+  en: '"[Your Name]" and "[Insert Date]" are the blanks a template or a generated draft leaves. This is not a matter of style: the blank was never filled.'
+
+message:
+  ja: 「{matched}」が埋まっていません
+  en: '"{matched}" was never filled in'
+
+how_to_fix:
+  ja: 中身を書いてください。例のつもりなら、例だと分かる書き方（例：山田太郎）にしてください。
+  en: Fill it in. If it is meant as an example, say so ("for example, Jane Smith").
+
+# 指摘に要る空欄の数。
+levels: { strict: 1, normal: 1, relaxed: 2 }
+
+use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: slips
+summary:
+  ja: 「【会社名】」「[Your Name]」のように、雛形の空欄が埋まらないまま残っている所
+  en: A template blank left unfilled, such as "[Your Name]" or "[Insert Date]"
+example:
+  ja:
+    before: |
+      【会社名】の田中です。見積もりをお送りします。
+    after: |
+      山田商事の田中です。見積もりをお送りします。
+  en:
+    before: |
+      We can meet on [Insert Date] to go through the quote.
+    after: |
+      We can meet on Friday 9 October to go through the quote.
+
+not_flagged:
+  ja: 例として置いた「○○」、Markdown のリンク、脚注の番号、チェック欄、値が続く見出しの札（【氏名】山田）は指しません。
+  en: 'Markdown links and reference definitions, footnote numbers, checkboxes, and a label its value follows ("[Date]: 2024-04-01") are not reported.'
+level_meaning:
+  ja: 空欄が {limit} 箇所あれば指摘
+  en: reported once there are {limit}

package/rules/unqualified-superlative.yaml

@@ -26,3 +26,23 @@ how_to_fix:
 levels: { strict: 1, normal: 2, relaxed: 4 }
 
 use_for: [business, blog, legal, docs, academic, literature, speech]
+sources: [femmer-2017]
+
+group: wording
+summary:
+  ja: 「最速」「最高の品質」のように、何と比べたのかを書いていない最上級
+  en: A superlative such as "the fastest" with nothing to compare it against
+example:
+  ja:
+    before: 当社の新製品は最速で、最高の品質です。圧倒的な使いやすさです。
+    after: 当社の新製品は、従来品より処理が二割速くなりました。
+  en:
+    before: Our new product is the fastest on the market, with unmatched quality and unparalleled ease of use.
+    after: Our new product processes orders a fifth faster than the previous model.
+
+not_flagged:
+  ja: 「当社比」「〜の中で」「〜のほうが」のように、比べる相手や範囲が同じ文にあれば指しません。「SES との最大の違い」のように、最上級のすぐ前に相手があるときも同じです。「国内最大」「業界最速」のように名詞がじかに付いた最上級と、「日本で最も」のように名前と「で」が前にある最上級は、範囲を言っているので指しません。「」や引用符で引いた言葉の中の最上級は、書き手の主張ではないので指しません。
+  en: A superlative with its comparison or scope in the same sentence ("in our range", "than last year", "the fastest in the industry") is not reported, nor is one inside quotation marks, which are someone else's words.
+level_meaning:
+  ja: 比べる相手のない最上級が {limit} 箇所あれば指摘
+  en: reported once there are {limit} such claims

package/rules/unsourced-number.yaml

@@ -38,3 +38,19 @@ levels:
   relaxed: info
 
 use_for: [business]
+
+group: facts
+summary:
+  ja: どこから来たのか確かめようのない数字（AI に読ませる検査）
+  en: A number the reader has no way to check (checked by an AI)
+example:
+  ja:
+    before: 利用者の 9 割が、この機能に満足しています。
+    after: 9 月に利用者 120 人へ聞いたアンケートでは、108 人（9 割）がこの機能に満足と答えました。
+  en:
+    before: Nine in ten users are happy with this feature.
+    after: In a survey of 120 users in September, 108 (nine in ten) said they were happy with this feature.
+
+not_flagged:
+  ja: 機械では決めません。chaff test で、機械が数字を含む文を絞り込み、その文だけを AI が読みます。
+  en: No machine decides this. chaff test narrows the text to sentences with numbers, and an AI reads only those.

package/rules/unused-definition.yaml

@@ -0,0 +1,75 @@
+id: unused-definition
+layer: L3
+status: experimental
+how_to_find: unused-definition
+requires: [structure]
+severity: warning
+
+name:
+  ja: 定義したのに使っていない語
+  en: Term defined but never used
+
+why:
+  ja: 定義した語が本文に一度も出てこなければ、その定義は読み手に覚えさせるだけで何も決めていません。多いのは、本文で別の語に言い換えたあと、定義だけが残った場合です。本文のほうが定義と違う語を使っていないかも確かめてください。
+  en: A term defined and then never used makes the reader learn it for nothing. Usually the body was reworded to another word and the definition stayed behind, so check whether the body now uses a different word for the same thing.
+
+message:
+  ja: 「{term}」を定義していますが、本文で使っていません
+  en: '"{term}" is defined but never used'
+
+how_to_fix:
+  ja: 本文で使っていないなら定義を消してください。本文が別の語で同じものを指しているなら、どちらかに揃えます。
+  en: Delete the definition if nothing uses it. If the body calls the same thing by another word, use one of the two throughout.
+
+# chaff explain と規則の一覧には指摘が無いので、{term} をこう読ませる。
+placeholders:
+  term:
+    ja: 〇〇
+    en: the term
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: structure
+summary:
+  ja: 定義した語が、本文のどこにも出てこない所
+  en: A term the document defines and then never uses
+example:
+  ja:
+    before: |
+      「本サービス」とは、当社が運営する予約のサイトをいう。利用者は、このサイトを無料で使える。
+    after: |
+      「本サービス」とは、当社が運営する予約のサイトをいう。利用者は、本サービスを無料で使える。
+  en:
+    before: |
+      "Service" means the booking website we run. Users may use the website free of charge.
+    after: |
+      "Service" means the booking website we run. Users may use the Service free of charge.
+
+not_flagged:
+  ja: 定義の書き方（「X」とは、以下「X」という）で書いた語だけを見ます。複数形と所有の形（Services、Seller's）は使用に数えます。同じ語の二つ目の定義は duplicate-definition が言います。
+  en: Only terms defined in a recognised form ("X" means, (the "X")) are checked. Plurals and possessives (Services, Seller's) count as uses. A second definition of the same term is duplicate-definition's to report.
+rewrite:
+  ja:
+    direction: 本文で使っていない定義を消してください。本文が同じものを別の語で呼んでいるなら、その語を定義した語に替えます。どちらかは書き手に聞きます。
+    pairs:
+      - before: 「本サービス」とは、当社が運営する予約のサイトをいう。利用者は、このサイトを無料で使える。
+        after: 「本サービス」とは、当社が運営する予約のサイトをいう。利用者は、本サービスを無料で使える。
+      - before: 「登録情報」とは、利用者が登録した氏名と住所をいう。利用者は、氏名と住所をいつでも変えられる。
+        after: 利用者は、登録した氏名と住所をいつでも変えられる。（本文が定義した語をどこでも使わないとき）
+    keep:
+      - 定義の中身
+    avoid:
+      - 定義を残したまま、本文に使い道を作る
+  en:
+    direction: Delete a definition nothing uses. If the body calls the same thing by another word, replace that word with the defined term; ask the writer which.
+    pairs:
+      - before: '"Service" means the booking website we run. Users may use the website free of charge.'
+        after: '"Service" means the booking website we run. Users may use the Service free of charge.'
+      - before: '"Account Data" means the name and address a user registers. Users may change their name and address at any time.'
+        after: Users may change the name and address they registered at any time. (when nothing else uses the term)
+    keep:
+      - what the definition says
+    avoid:
+      - inventing a use for the term to keep the definition

package/rules/url-run-on.yaml

@@ -0,0 +1,45 @@
+id: url-run-on
+layer: L1
+status: experimental
+how_to_find: url-run-on
+severity: warning
+
+name:
+  ja: URL のすぐ後ろに字が続いている
+  en: Text runs on after a URL
+
+why:
+  ja: 「https://example.jp/をご覧ください」のように、そのまま書いた URL の直後に空白を置かずに日本語や全角の記号（。」）など）が続くと、GitHub などの自動リンクや多くのメールソフトは空白が来るまでを URL と読みます。押すと存在しないページが開きます。ASCII でない字が続くときだけを指摘します。リンクの記法（[資料](https://…) と <https://…>）で書いたものと、コードの中は数えません。
+  en: When a URL written as plain text is followed straight away by a character outside ASCII ("https://example.com/—see", "https://example.jp/をご覧ください"), GitHub's automatic links and many mail clients read everything up to the next space as the URL, and clicking it opens a page that does not exist. Only a character outside ASCII right after the URL is reported. A URL written with link syntax ([docs](https://…) or <https://…>) and URLs in code are not counted.
+
+message:
+  ja: URL「{url}」の直後に「{next}」が続いています。リンクがそこまで伸びます
+  en: 'The URL "{url}" is followed by "{next}" with no space; the link runs on into it'
+
+how_to_fix:
+  ja: URL の後ろに空白を入れるか、<https://…> または [説明](https://…) の形で書いてください。
+  en: Put a space after the URL, or write it as <https://…> or [text](https://…).
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: slips
+summary:
+  ja: 「https://example.jp/をご覧ください」のように、URL のすぐ後ろに字が続き、リンクがそこまで伸びる所
+  en: A URL followed straight away by a character outside ASCII, which the link swallows
+example:
+  ja:
+    before: |
+      詳しくは https://example.jp/guideをご覧ください。
+    after: |
+      詳しくは https://example.jp/guide をご覧ください。
+  en:
+    before: |
+      See https://example.com/guide—it has the details.
+    after: |
+      See https://example.com/guide — it has the details.
+
+not_flagged:
+  ja: リンクの記法（[説明](URL) と <URL>）で書いた URL、コードの中、空白や ASCII の記号が続く URL、ゼロ幅の空白のような見えない字は指しません。
+  en: URLs written with link syntax ([text](URL) or <URL>), URLs in code, a URL followed by a space or an ASCII mark, and invisible characters such as a zero-width space are not reported.

package/rules/use-before-definition.yaml

@@ -0,0 +1,77 @@
+id: use-before-definition
+layer: L3
+status: experimental
+how_to_find: use-before-definition
+requires: [structure]
+severity: warning
+
+name:
+  ja: 定義より前で使っている語
+  en: Term used before it is defined
+
+why:
+  ja: 文の途中で「（以下「甲」という。）」と定義した語を、その定義より前で使うと、読み手は意味の分からない語を先に読むことになります。前で使った箇所は、定義の前に書き足した文であることが多く、定義の位置が古いままです。
+  en: A term defined in passing, as in (the "Seller"), and used before that point makes the reader meet a word whose meaning has not been given yet. The earlier use is usually a sentence added later, in front of a definition that stayed where it was.
+
+message:
+  ja: 「{term}」を、{defined} 行目の定義より前で使っています
+  en: '"{term}" is used here, before it is defined on line {defined}'
+
+how_to_fix:
+  ja: 定義を最初に使う所へ移すか、前の箇所を定義した語を使わない書き方にしてください。
+  en: Move the definition to the first use, or reword the earlier sentence without the defined term.
+
+placeholders:
+  term:
+    ja: 〇〇
+    en: the term
+  defined:
+    ja: 〇
+    en: N
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: structure
+summary:
+  ja: 文の途中で括弧に入れて定義した語を、その定義より前で使っている所
+  en: A term defined in passing, as in (the "Seller"), that is used before that point
+example:
+  ja:
+    before: |
+      買主は、毎月末日に代金を支払う。株式会社みなと（以下「買主」という。）と株式会社やまと（以下「売主」という。）は、次のとおり契約する。
+    after: |
+      株式会社みなと（以下「買主」という。）と株式会社やまと（以下「売主」という。）は、次のとおり契約する。買主は、毎月末日に代金を支払う。
+  en:
+    before: |
+      The Seller ships within five days. This agreement is between Harbour Ltd (the "Seller") and Hill Ltd (the "Buyer").
+    after: |
+      This agreement is between Harbour Ltd (the "Seller") and Hill Ltd (the "Buyer"). The Seller ships within five days.
+
+not_flagged:
+  ja: 定義の条（「X」とは…をいう）で定義した語は、前で使っても言いません。定義の条は文書の頭にも終わりにも置く書き方があるためです。最初の一か所だけを指します。
+  en: Terms defined in a definitions clause ("X" means ...) are not checked, since a definitions clause may come first or last. Only the first early use is pointed at.
+rewrite:
+  ja:
+    direction: 定義を、その語を最初に使う文へ移してください。移せないなら、前の文を定義した語を使わない書き方にします。
+    pairs:
+      - before: 買主は、毎月末日に代金を支払う。株式会社みなと（以下「買主」という。）と株式会社やまと（以下「売主」という。）は、次のとおり契約する。
+        after: 株式会社みなと（以下「買主」という。）と株式会社やまと（以下「売主」という。）は、次のとおり契約する。買主は、毎月末日に代金を支払う。
+      - before: 本規約の改定は、利用者に通知する。当社は、予約の仕組み（以下「本サービス」という。）を提供する。本サービスは無料である。
+        after: 当社は、予約の仕組み（以下「本サービス」という。）を提供する。本規約の改定は、利用者に通知する。本サービスは無料である。（前の文が「本規約」を使わずに書けないとき）
+    keep:
+      - 定義の中身と、それぞれの文の中身
+    avoid:
+      - 定義を二か所に書く
+  en:
+    direction: Move the definition to the sentence that first uses the term. If it cannot move, reword the earlier sentence without the defined term.
+    pairs:
+      - before: The Seller ships within five days. This agreement is between Harbour Ltd (the "Seller") and Hill Ltd (the "Buyer").
+        after: This agreement is between Harbour Ltd (the "Seller") and Hill Ltd (the "Buyer"). The Seller ships within five days.
+      - before: The Licensee may cancel at any time. Hill Ltd (the "Licensee") licenses the software from us.
+        after: Hill Ltd may cancel at any time. Hill Ltd (the "Licensee") licenses the software from us.
+    keep:
+      - what each sentence says
+    avoid:
+      - defining the term twice