chaffjs 0.17.0 → 0.18.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chaffjs",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "Prose validation harness. Finds what is hard to read, and never rewrites it for you.",
   "keywords": [
     "chaff",
@@ -42,8 +42,10 @@
     "dist",
     "genres.yaml",
     "profiles",
+    "reference-headings.yaml",
     "rules",
     "skills",
+    "styles",
     "src"
   ],
   "engines": {
@@ -55,8 +57,8 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.125.0",
-    "@chaffjs/lang-en": "0.15.0",
-    "@chaffjs/lang-ja": "0.16.0",
+    "@chaffjs/lang-en": "0.16.0",
+    "@chaffjs/lang-ja": "0.17.0",
     "mdast-util-from-markdown": "^2.0.3",
     "mdast-util-frontmatter": "^2.0.1",
     "mdast-util-gfm-table": "^2.0.0",

package/reference-headings.yaml

@@ -0,0 +1,17 @@
+# 文献一覧の見出し。言語の見当付け（どの言語パッケージを読むか）は、この見出しの下の一覧を数えない。
+# 文献一覧は本文の言語ではなく、引いた文献の言語で書かれる。日本語の論文の英語の文献が多いと、文書が英語に見える。
+# 見当付けは言語パッケージを読む前に動くので、どちらの言語の見出しもここに置く。大文字と小文字は区別しない。
+headings:
+  - 参考文献
+  - 引用文献
+  - 参照文献
+  - 文献
+  - 文献一覧
+  - 引用・参考文献
+  - 参考・引用文献
+  - References
+  - Reference
+  - Bibliography
+  - Works Cited
+  - Literature Cited
+  - Cited Literature

package/rules/adverb-overuse.yaml

@@ -26,3 +26,22 @@ how_to_fix:
 levels: { strict: 10, normal: 15, relaxed: 25 }
 
 use_for: [blog, business, legal, docs, academic, literature, speech]
+
+group: readability
+summary:
+  ja: 英語で、-ly の副詞が多すぎる所（弱い動詞の印になりやすい）
+  en: Too many -ly adverbs, which usually prop up a weak verb
+example:
+  en:
+    pad: true
+    before: |
+      She quickly walked to the room and quietly opened the door. He really badly needed the report and angrily asked for it.
+    after: |
+      She hurried to the room and eased the door open. He needed the report and demanded it.
+
+not_flagged:
+  ja: 短い文書（200 語より短いもの）は測りません。
+  en: Documents under 200 words are not measured.
+level_meaning:
+  ja: 1000 語あたり {limit} 個まで
+  en: up to {limit} per 1000 words

package/rules/agentless-passive.yaml

@@ -26,3 +26,22 @@ how_to_fix:
 levels: { strict: 1, normal: 1, relaxed: 2 }
 
 use_for: [business, legal, docs, academic, literature, speech]
+
+group: wording
+summary:
+  ja: 「〜が決定されました」のように、受け身で書いて、誰がしたのかが書かれていない所
+  en: A passive sentence ("the budget was approved") that never says who did it
+example:
+  ja:
+    before: 来期の予算が承認されました。
+    after: 取締役会が、来期の予算を承認しました。
+  en:
+    before: The budget for next year was approved.
+    after: The board approved the budget for next year.
+
+not_flagged:
+  ja: 「〜によって」のように、した人が同じ文に書いてある受け身は指しません。法務のジャンルは、受け身が書き方そのものなので見ません。
+  en: A passive that names the actor in the same sentence ("by the board") is not reported. Legal genres, where the passive is the form, do not run this rule.
+level_meaning:
+  ja: 一文に受け身が {limit} 個あれば指摘
+  en: reported when a sentence has {limit} passives with no actor

package/rules/agreement-slip.yaml

@@ -31,6 +31,19 @@ how_to_fix:
   ja: 限定詞か名詞のどちらかに揃えてください（a significant change / significant changes）。所有の語なら、主語の語に直してください（Your can → You can、their is → there is）。
   en: Make the determiner and the noun agree ("a significant change" or "significant changes"). For a possessive, write the subject you meant ("Your can" becomes "You can", "their is" becomes "there is").
 
-levels: { strict: 1, normal: 1, relaxed: 1 }
+levels: { strict: error, normal: warning, relaxed: info }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: slips
+summary:
+  ja: 英語で、「these new version」のように単数と複数が合っていない所
+  en: Words that no longer agree after an edit, as in "these new version"
+example:
+  en:
+    before: These new version will ship in May.
+    after: This new version will ship in May.
+
+not_flagged:
+  ja: 単数と複数で形が同じ名詞（series、data）、this や these の直後の語、名詞を修飾する名詞（a sales team）は指しません。
+  en: Nouns spelled alike in both numbers ("series", "data"), a word right after "this" or "these", and nouns that modify another noun ("a sales team") are not reported.

package/rules/ai-generated-composite.yaml

@@ -13,6 +13,11 @@ from:
   - padded-intro
   - closing-cliche
   - no-em-dash
+  - contrast-framing
+  - stock-transition
+  - assistant-residue
+  - announcing-opener
+  - colon-lead-in
 
 name:
   ja: 生成文の特徴がそろっている
@@ -34,3 +39,100 @@ how_to_fix:
 levels: { strict: 2, normal: 3, relaxed: 5 }
 
 use_for: [blog, business, legal, docs, academic, literature, speech]
+
+group: ai-tells
+summary:
+  ja: 生成された文章の特徴がいくつも一つの文書にそろっている所（生成だと決めつけはしません）
+  en: Several signals of generated text together in one document (a place to reread, not a verdict)
+example:
+  ja:
+    config: { genre: blog/tech, rules: { ai-generated-composite: strict } }
+    before: |
+      # 在庫管理を見直す
+
+      現代社会において、データは重要な役割を果たすと言えるでしょう。
+
+      - 正確さ
+      - 速さ
+      - 安さ
+
+      毎日することです。
+
+      - 数える
+      - 記録する
+      - 見返す
+
+      よくある失敗です。
+
+      - 数え忘れ
+      - 記録の漏れ
+      - 見返さない
+    after: |
+      # 在庫管理を見直す
+
+      当社では、在庫の数を毎朝データで確かめてから発注しています。
+
+      - 正確さ
+      - 速さ
+
+      毎日することです。
+
+      - 数える
+      - 記録する
+      - 見返す
+      - 月末の棚卸しと突き合わせる
+
+      よくある失敗です。
+
+      - 数え忘れ
+      - 記録の漏れ
+      - 見返さない
+  en:
+    config: { genre: blog/tech, rules: { ai-generated-composite: strict } }
+    before: |
+      # Rethinking stock control
+
+      In today's fast-paced world, data plays a crucial role. Let us delve into why.
+
+      - Accuracy
+      - Speed
+      - Cost
+
+      Every day we:
+
+      - Count
+      - Record
+      - Review
+
+      Common mistakes:
+
+      - Missed counts
+      - Gaps in the record
+      - No review
+    after: |
+      # Rethinking stock control
+
+      We check stock levels every morning before placing orders.
+
+      - Accuracy
+      - Speed
+
+      Every day we:
+
+      - Count
+      - Record
+      - Review
+      - Match against the month-end count
+
+      Common mistakes:
+
+      - Missed counts
+      - Gaps in the record
+      - No review
+
+not_flagged:
+  ja: 特徴が一つだけなら何も言いません。そろっても、生成された文章だとは言いません。読み返す場所の目印です。
+  en: One signal alone says nothing. Even several together do not say the text was generated; they mark a place to reread.
+level_meaning:
+  ja: 特徴が {limit} 種そろえば指摘
+  en: reported once {limit} signals occur together

package/rules/ai-tell.yaml

@@ -26,3 +26,26 @@ how_to_fix:
 levels: { strict: 10, normal: 18, relaxed: 30 }
 
 use_for: [blog, business, legal, docs, academic, literature, speech]
+
+group: ai-tells
+summary:
+  ja: 「重要な役割を果たす」「と言えるでしょう」のような、生成された文章にありがちな言い回しが重なった所
+  en: Phrases common in generated text ("delve into", "plays a crucial role") piling up
+example:
+  ja:
+    before: |
+      現代社会において、データは重要な役割を果たすと言えるでしょう。
+    after: |
+      当社では、在庫の数を毎朝データで確かめてから発注しています。
+  en:
+    before: |
+      In today's fast-paced world, data plays a crucial role. Let us delve into why.
+    after: |
+      We check stock levels every morning before placing orders.
+
+not_flagged:
+  ja: どの言い回しも、一つだけなら普通の文章にあります。重みの合計が上限を超えるまでは何も言いません。これだけで生成された文章だとは言いません。
+  en: Each phrase is ordinary on its own; nothing is said until the weights add up past the limit. This alone never says the text was generated.
+level_meaning:
+  ja: 言い回しの重みの合計が {limit} 点まで
+  en: up to a score of {limit}

package/rules/announced-count-mismatch.yaml

@@ -0,0 +1,57 @@
+id: announced-count-mismatch
+layer: L3
+status: experimental
+how_to_find: announced-count
+severity: warning
+
+name:
+  ja: 予告した数と箇条書きの数が合わない
+  en: A list that does not have the number of items announced
+
+why:
+  ja: 「以下の3点」と書いたのに、すぐ下の箇条書きが2つや4つだと、読み手は抜けた項目があるのか、数え間違いなのかを確かめることになります。項目を足したり消したりしたあとに、予告の数を直し忘れると起きます。箇条書きのすぐ前の文が、「以下の」「次の」のような先を指す語か、終わりのコロン（：）と一緒に数（3点、2つ、4項目）を書いているときだけ、その数を箇条書きのいちばん外側の項目の数と比べます。
+  en: When a sentence says "the following three steps" and the list right below it has two or four, the reader has to check whether an item is missing or the count is wrong. It happens when an item is added or removed and the count is not updated. The number is compared with the items at the top level of the list only when the sentence right before the list announces it, with a word pointing ahead ("following", "below") or a colon at its end, and the number names what the list holds ("three steps", "two reasons").
+
+message:
+  ja: 「{phrase}」と予告していますが、すぐ下の箇条書きは{listed}項目です
+  en: '"{phrase}" is announced, but the number of items in the list below is {listed}'
+
+how_to_fix:
+  ja: 項目が抜けていないか確かめて、足りなければ足し、数が違うなら予告の数を直してください。
+  en: Check whether an item is missing. Add it, or correct the number in the announcement.
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: facts
+summary:
+  ja: 「以下の3点」と書いたのに、下の箇条書きの数が違う所
+  en: A list whose number of items differs from the number announced just before it
+example:
+  ja:
+    before: |
+      申し込みの前に、次の3点を確認してください。
+
+      - 本人確認の書類
+      - 振込先の口座
+    after: |
+      申し込みの前に、次の2点を確認してください。
+
+      - 本人確認の書類
+      - 振込先の口座
+  en:
+    before: |
+      Before you apply, check the following three items:
+
+      - Your ID
+      - Your bank account
+    after: |
+      Before you apply, check the following two items:
+
+      - Your ID
+      - Your bank account
+
+not_flagged:
+  ja: 目安の数（約3点、3つ以上）、順番（3つ目）、選ぶ数（以下から1つ選ぶ）、見出しや表の前の数、箇条書きがすぐ後ろに無い数は比べません。予告の文に数が二つあるときも比べません。
+  en: An estimate (about three, three or more), a rank (the first three), how many to pick (choose two), a number before a heading or a table, and a number with no list right after it are not compared. Nor is a sentence with two numbers in it.

package/rules/announcing-opener.yaml

@@ -0,0 +1,51 @@
+id: announcing-opener
+layer: L2
+status: experimental
+how_to_find: opener-pile
+word_list: announcing-opener
+uses: [pos]
+severity: info
+
+name:
+  ja: 予告で始まる文が多い
+  en: Too many sentences that announce before they say
+
+why:
+  ja: 「重要なのは、」「ポイントは、」「正直に言うと、」は、中身の前に「これから大事なことを言う」と予告します。1 つなら目印ですが、重なるとどの文も同じ重さに見え、予告だけが残ります。生成文によく見られる癖として知られています。
+  en: '"The key point is", "Here''s the thing" and "Honestly," announce a point before making it. Once, that is a signpost; piled up, every sentence claims the same weight and the announcements are all that stand out. A habit well known in generated text.'
+
+message:
+  ja: 「{matched}」など、予告で始まる文が {count} 個あります（{limit} 個から）
+  en: '"{matched}" and other announcing openers start {count} sentences ({limit} needed)'
+
+how_to_fix:
+  ja: 予告を消して、中身から書き始めてください。本当に一番大事な一つだけなら、予告を残してもかまいません。
+  en: Delete the announcement and start with the point. If it really is the one point that matters most, keep that one.
+
+# 指摘に要る数。長さで割らない：人の記事は長くても 1 つ 2 つで、生成文は短くても重ねる。
+levels: { strict: 2, normal: 3, relaxed: 5 }
+
+use_for: [blog, business, legal, docs, academic, literature, speech]
+
+group: ai-tells
+summary:
+  ja: 「重要なのは、」「ポイントは、」「正直に言うと、」のように、中身の前に予告する文頭が重なっている所
+  en: 'Openers that announce a point before making it ("The key point is", "Here''s the thing", "Honestly,") piling up'
+example:
+  ja:
+    before: |
+      重要なのは、設定を先に確かめることです。ポイントは、ログを残すことです。正直に言うと、手順書は古くなっています。
+    after: |
+      まず設定を確かめ、そのときのログを残してください。手順書は去年の版のままなので、画面の名前が違います。
+  en:
+    before: |
+      The key point is that settings come first. Here's the thing: logs matter too. Honestly, the manual is out of date.
+    after: |
+      Check the settings first and keep the log of that check. The manual is last year's, so the screen names differ.
+
+not_flagged:
+  ja: 文の途中の「このポイントは」と、指摘に要る数に届かない予告は言いません。「大事なのは」「結論から言うと」は、生成 AI 以前の人の記事にも同じくらいあるので数えません。
+  en: An announcing phrase inside a sentence, and fewer than the level needs, are not reported.
+level_meaning:
+  ja: 予告で始まる文が {limit} 個あれば指摘
+  en: reported once {limit} sentences open with an announcement

package/rules/assistant-residue.yaml

@@ -0,0 +1,52 @@
+id: assistant-residue
+layer: L2
+status: experimental
+how_to_find: assistant-residue
+word_list: assistant-residue
+uses: [pos]
+severity: warning
+
+name:
+  ja: 会話の返事の名残
+  en: Chat-reply residue
+
+why:
+  ja: 「私の知識は」「お役に立てれば幸いです」は、チャットの返事を文書に貼ったときに残る言葉です。知識の期限や AI としての断り書きは 1 つで言い、人も書く礼の言葉は 2 つ重なったときだけ言います。
+  en: '"As of my last knowledge update" and "I hope this helps" are what a chat reply leaves behind when pasted into a document. A knowledge-cutoff or AI disclaimer counts on its own; a courtesy people also write counts only when two come together.'
+
+message:
+  ja: 「{matched}」は会話の返事の言葉です（点 {density}、{limit} から）
+  en: '"{matched}" is chat-reply wording (score {density}, from {limit})'
+
+how_to_fix:
+  ja: 文書の読み手に向けた言葉に書き直すか、消してください。知識の期限を書いた文は、確かめた日付と出典に置き換えてください。
+  en: Rewrite it for the document's reader, or delete it. Replace a knowledge-cutoff line with the date you checked and the source.
+
+# 語彙表の重みの合計を 10 倍した点。名残そのものは重み 1 で 1 つで届き、人も書く礼は 0.5 で 2 つ重なって届く。
+# strict でも礼 1 つでは言わない。1 つなら人の書き方と区別がつかない。
+levels: { strict: 10, normal: 10, relaxed: 20 }
+
+use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: ai-tells
+summary:
+  ja: 「私の知識は」「お役に立てれば幸いです」のような、チャットの返事を貼ったときに残る言葉
+  en: What a pasted chat reply leaves behind ("As of my last knowledge update", "I hope this helps")
+example:
+  ja:
+    before: |
+      新しい棟の計画は検討中でした。私の知識は2023年時点のものです。
+    after: |
+      新しい棟の計画は、2026年9月の議会資料では検討中でした。
+  en:
+    before: |
+      As of my last knowledge update, plans for a new wing were under discussion.
+    after: |
+      The council's minutes of September 2026 say plans for a new wing are under discussion.
+
+not_flagged:
+  ja: 人も書く礼の言葉（「お役に立てれば幸いです」）が一つだけなら、何度書いてあっても指しません。同じ文の中の二つの言い回しは一つと数えます。
+  en: A single courtesy people also write ("I hope this helps"), however often it is repeated, is not reported. Two listed phrases in one sentence count as one.
+level_meaning:
+  ja: 重みの合計が {limit} 点で指摘
+  en: reported from a score of {limit}

package/rules/bold-density.yaml

@@ -28,3 +28,34 @@ levels:
   relaxed: 40
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: readability
+summary:
+  ja: 太字が多すぎて、どこが大事なのか分からなくなった所
+  en: So much bold text that nothing stands out any more
+example:
+  ja:
+    before: |
+      ## 申し込み
+
+      **申し込み**は**今月末**までに、**専用の用紙**で**総務部**へ出してください。用紙は社内の共有フォルダにあり、印刷して手で書いても、画面で入力してから印刷してもかまいません。**上長の印**が要るので、締め切りの三日前までには上長に渡してください。**遅れた場合**は、どんな理由でも**受け付けません**。分からないことがあれば、総務部の窓口に電話で問い合わせてください。受付の時間は平日の午前九時から午後五時までです。書き方の見本も、同じ共有フォルダに置いてあります。
+    after: |
+      ## 申し込み
+
+      申し込みは、専用の用紙で総務部へ出してください。**締め切りは今月末で、遅れた場合はどんな理由でも受け付けません。**用紙は社内の共有フォルダにあり、印刷して手で書いても、画面で入力してから印刷してもかまいません。上長の印が要るので、締め切りの三日前までには上長に渡してください。分からないことがあれば、総務部の窓口に電話で問い合わせてください。受付の時間は平日の午前九時から午後五時までです。書き方の見本も、同じ共有フォルダに置いてあります。
+  en:
+    before: |
+      ## How to apply
+
+      Send the **form** to **HR** by the **end of the month**. The form is in the shared folder. You can print it and fill it in by hand, or type into it on screen and then print it. It needs your **manager's signature**, so give it to your manager at least three days before the deadline. **Late forms** will **not** be **accepted**, whatever the reason. If you have a question, call the HR desk between nine and five on a weekday.
+    after: |
+      ## How to apply
+
+      Send the form to HR. **The deadline is the end of the month, and late forms will not be accepted, whatever the reason.** The form is in the shared folder. You can print it and fill it in by hand, or type into it on screen and then print it. It needs your manager's signature, so give it to your manager at least three days before the deadline. If you have a question, call the HR desk between nine and five on a weekday.
+
+not_flagged:
+  ja: 200 字より短い節は、1 箇所で割合が跳ねるので測りません。
+  en: Sections under 200 characters are not measured, since one bold span would swing the rate.
+level_meaning:
+  ja: 1000 字あたり太字 {limit} 箇所まで
+  en: up to {limit} bold spans per 1000 characters

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,36 @@ 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 section is checked; "to sum up" in the middle of the text is an ordinary link and is not reported.
+level_meaning:
+  ja: 当てはまる結びが {limit} 箇所あれば指摘
+  en: reported once there are {limit}

package/rules/colon-lead-in.yaml

@@ -0,0 +1,59 @@
+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 つだけのコロンの前置きと、コロンで終わらない前置き（「次のとおりとする。」）は数えません。説明書・法務・技術文書のジャンルでは見ません。短い文書は測りません。英語の文書は、人もよくこの形で書くので見ません。
+  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.
+level_meaning:
+  ja: 1000 字あたり {limit} 個まで
+  en: up to {limit} per 1000 characters

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