chaffjs 0.19.0 → 0.21.0

package/rules/absolute-exception.yaml

@@ -0,0 +1,85 @@
+id: absolute-exception
+layer: L3
+status: stable
+how_to_find: absolute-exception
+word_list: absolute-word
+extra_word_lists: [exception-marker, light-verb]
+requires: [structure, pos]
+severity: warning
+
+name:
+  ja: 言い切った決まりに、別の所で例外がある
+  en: An absolute rule with an exception written elsewhere
+
+why:
+  ja: 「すべての〜は…しなければならない」「一切…してはならない」と例外なしに言い切った決まりに、後の別の条や段落で「ただし…を除く」と例外を書くと、言い切った文だけを読んだ人は例外を知らずに従います。後から足した条や、別の文書から写した例外で起きます。例外を言い切った文と同じ条や段落に書いていれば（ただし書）、それは決まりの一部なので、ここには出ません。二つの文が同じ行為について言っているかは、中身の語の重なりで見ます。
+  en: 'A rule stated without exception ("all staff must", "must never") that a later article or paragraph makes an exception to ("except", "unless") misleads a reader who stops at the rule. It happens when an exception is added later or copied from another document. An exception in the same article or paragraph is the rule''s own proviso and is not reported. Whether two sentences are about the same act is read from the content words they share.'
+
+message:
+  ja: 「{word}」と言い切っていますが、{otherLine} 行目に同じ行為の例外（「{exception}」）があります
+  en: 'This says "{word}", but line {otherLine} makes an exception ("{exception}") for the same act'
+
+how_to_fix:
+  ja: 言い切った文に例外を書き足すか（「次条に定める場合を除き」）、例外のほうを消すかを決めてください。
+  en: Either add the exception to the absolute rule ("except as set out in section 5") or remove the exception.
+
+placeholders:
+  word:
+    ja: すべて
+    en: always
+  exception:
+    ja: ただし
+    en: except
+  otherLine:
+    ja: 〇
+    en: N
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+off_for:
+  literature: 'A character who says "never" and later makes an exception is the story, not a drafting slip.'
+
+group: structure
+summary:
+  ja: 「すべての〜は…しなければならない」と言い切った決まりに、別の条や段落で「ただし…を除く」と例外を書いた所
+  en: 'A rule stated without exception ("must always") that another article or paragraph makes an exception to ("except")'
+example:
+  ja:
+    before: |
+      ## 第1条（提出）
+
+      社員は、すべての経費の領収書を経理部に提出しなければならない。
+
+      ## 第2条（少額の経費）
+
+      千円未満の経費は、領収書を経理部に提出する対象から除く。
+    after: |
+      ## 第1条（提出）
+
+      社員は、次条に定めるものを除き、すべての経費の領収書を経理部に提出しなければならない。
+
+      ## 第2条（少額の経費）
+
+      千円未満の経費は、領収書を経理部に提出する対象から除く。
+  en:
+    before: |
+      ## 1. Receipts
+
+      Staff must always send the receipt for every expense to the finance team.
+
+      ## 2. Small expenses
+
+      Staff need not send the receipt to the finance team for an expense under ten dollars, except for travel.
+    after: |
+      ## 1. Receipts
+
+      Except as set out in section 2, staff must always send the receipt for every expense to the finance team.
+
+      ## 2. Small expenses
+
+      Staff need not send the receipt to the finance team for an expense under ten dollars, except for travel.
+
+not_flagged:
+  ja: 例外を言い切った文と同じ条や段落に書いた文（ただし書）、言い切った文そのものが例外を持つ文、言い切った文の中身の語を半分以上くり返さない例外は指摘しません。義務の語（しなければならない・してはならない）の無い言い切りと、鉤括弧の中の語も見ません。
+  en: An exception in the same article or paragraph (a proviso), an absolute rule that carries its own exception, and an exception that does not repeat most of the rule's content words are not reported. A statement with no obligation word (must, shall, must not) and words inside quotation marks are not read.

package/rules/abstract-length.yaml

@@ -0,0 +1,136 @@
+id: abstract-length
+layer: L3
+status: stable
+how_to_find: abstract-length
+severity: info
+
+name:
+  ja: 要旨が長すぎる、または無い
+  en: Abstract too long, or missing
+
+why:
+  ja: 読み手は要旨だけを読んで、本文を読むかを決めます。要旨が長すぎると、その判断に本文と同じだけ時間がかかり、投稿先の字数の上限も超えがちです。節を立てた論文に要旨が無いと、読み手は本文を読み進めないと何の研究かが分かりません。要旨は、「要旨」「抄録」「Abstract」の見出しの下の文、それだけを書いた行の次の段落、または段落の頭の「要旨：」「【要旨】」の後ろの文です。和文の論文の英文の Abstract は、英語の語数で測ります。
+  en: 'Readers decide from the abstract alone whether to read the paper. An abstract that runs long takes as much time as the paper to judge, and tends to exceed the venue''s word limit. A paper with sections but no abstract makes the reader read on before learning what the study is. The abstract is the text under an "Abstract" heading, the paragraph after a line that says only "Abstract", or the text after "Abstract:" at the head of a paragraph. The Japanese abstract (要旨) of a bilingual paper is measured in characters.'
+
+message:
+  ja: 要旨が長すぎます
+  en: The abstract is too long
+
+messages:
+  chars:
+    ja: 要旨が {count} 字あります（{limit} 字まで）
+    en: The abstract has {count} characters (up to {limit})
+  words:
+    ja: 要旨が {count} 語あります（{limit} 語まで）
+    en: The abstract has {count} words (up to {limit})
+  missing:
+    ja: 節を立てた論文ですが、要旨がありません
+    en: This paper has sections but no abstract
+
+how_to_fix:
+  ja: 要旨は、目的・方法・結果・結論を一、二文ずつに絞ってください。要旨が無ければ、本文の前に「要旨」の節を足します。
+  en: Cut the abstract to a sentence or two each for the aim, the method, the results and the conclusion. If there is none, add an "Abstract" section before the body.
+
+levels:
+  ja: { strict: 600, normal: 1000, relaxed: 1400 }
+  en: { strict: 250, normal: 400, relaxed: 500 }
+
+use_for: [academic, legal, docs, literature, speech]
+off_for:
+  legal: "A paper's citations, figures and abstract: only the academic paper genre turns these on."
+  docs: "A paper's citations, figures and abstract: only the academic paper genre turns these on."
+  literature: "A paper's citations, figures and abstract: only the academic paper genre turns these on."
+  speech: "A paper's citations, figures and abstract: only the academic paper genre turns these on."
+
+group: structure
+summary:
+  ja: 字数（英語は語数）の上限を超える要旨と、節を立てた論文で要旨が無いもの
+  en: An abstract over the length limit, or a paper with sections that has no abstract
+example:
+  ja:
+    config: { genre: academic/paper }
+    before: |
+      # 昼寝と記憶
+
+      ## はじめに
+
+      昼寝が記憶に与える影響を調べた。
+
+      ## 方法
+
+      大学生 40 人に単語を覚えてもらった。
+    after: |
+      # 昼寝と記憶
+
+      ## 要旨
+
+      大学生 40 人で、昼寝が単語の記憶を助けるかを調べた。
+
+      ## はじめに
+
+      昼寝が記憶に与える影響を調べた。
+
+      ## 方法
+
+      大学生 40 人に単語を覚えてもらった。
+  en:
+    config: { genre: academic/paper }
+    before: |
+      # Naps and memory
+
+      ## Introduction
+
+      We studied how naps affect memory.
+
+      ## Methods
+
+      Forty students learned a list of words.
+    after: |
+      # Naps and memory
+
+      ## Abstract
+
+      With forty students, we tested whether a nap helps them remember words.
+
+      ## Introduction
+
+      We studied how naps affect memory.
+
+      ## Methods
+
+      Forty students learned a list of words.
+
+not_flagged:
+  ja: 要旨の有無は、「はじめに」「方法」「結果」「考察」のような論文の節の見出しが二つ以上ある文書だけで見ます。要旨に付けた札（要旨：、【要旨】）は数えません。論文のジャンルでだけ見ます。
+  en: 'Whether an abstract is present is checked only in a document with two or more headings that name a paper''s sections (Introduction, Methods, Results, Discussion). The label itself ("Abstract:") is not counted. Only the academic paper genre runs this rule.'
+level_meaning:
+  ja: 要旨 {limit} 字まで
+  en: up to {limit} words in the abstract
+rewrite:
+  depth: structure
+  ja:
+    direction: 要旨を、目的・方法・結果・結論をそれぞれ一、二文で言う形に縮めてください。背景の説明や先行研究の紹介は本文に移します。数字は、結論を支える一つか二つだけを残します。要旨が無ければ、本文から目的・方法・結果・結論を抜き出して要旨を書きます。
+    pairs:
+      - before: 近年、睡眠と記憶の関係については多くの研究が行われており、さまざまな知見が得られてきた。本研究では、そうした流れを踏まえ、昼寝が単語の記憶に与える影響について、大学生を対象として詳しく調べることとした。
+        after: 昼寝が単語の記憶を助けるかを、大学生 40 人で調べた。
+      - before: 実験の結果、昼寝をした群は、昼寝をしなかった群と比べて、翌日の再生率が高い傾向が見られ、その差は統計的にも意味のあるものであった。
+        after: 昼寝をした群は、翌日の再生率が 12 ポイント高かった。
+    keep:
+      - 本文にある目的・方法・結果・結論
+      - 結論を支える数字
+    avoid:
+      - 本文に無い結果を書く
+      - 結論を弱める・強める
+  en:
+    direction: Shorten the abstract to a sentence or two each for the aim, the method, the results and the conclusion. Move background and earlier work into the body. Keep only the one or two figures the conclusion rests on. If there is no abstract, write one from the aim, method, results and conclusion in the body.
+    pairs:
+      - before: In recent years, a great deal of research has examined the relationship between sleep and memory, and many findings have been reported. Building on this body of work, the present study set out to examine in detail the effect of naps on word memory in university students.
+        after: We tested whether a nap helps forty university students remember words.
+      - before: The results of the experiment showed that the group that napped tended to recall more words the next day than the group that did not, and the difference was statistically significant.
+        after: Students who napped recalled 12 points more words the next day.
+    keep:
+      - the aim, method, results and conclusion stated in the body
+      - the figures the conclusion rests on
+    avoid:
+      - stating a result the body does not report
+      - softening or strengthening the conclusion

package/rules/acronym-expansion-conflict.yaml

@@ -1,6 +1,6 @@
 id: acronym-expansion-conflict
 layer: L3
-status: experimental
+status: stable
 how_to_find: acronym-expansion-conflict
 severity: warning
 
@@ -58,6 +58,7 @@ not_flagged:
   ja: 名前の大文字小文字、ハイフン、終わりの複数の s の違いは同じ名前と見ます。英語の名前は、頭文字が略語と揃うときだけ展開と読みます。
   en: Differences of case, hyphens and a final plural s are not counted. An English name counts as an expansion only when its initials spell the abbreviation.
 rewrite:
+  depth: light
   ja:
     direction: 二つの展開のうち正しいほうを書き手に確かめ、もう一方を消すか正しい名前に替えてください。二度目以降は略語だけで書けます。
     pairs:

package/rules/adverb-overuse.yaml

@@ -1,6 +1,6 @@
 id: adverb-overuse
 layer: L3
-status: experimental
+status: stable
 how_to_find: adverb-density
 requires: [pos]
 languages: [en]
@@ -26,6 +26,12 @@ how_to_fix:
 levels: { strict: 10, normal: 15, relaxed: 25 }
 
 use_for: [blog, business, legal, docs, academic, literature, speech]
+off_for:
+  legal: "Legal drafting repeats its terms and its sentence heads on purpose, puts the actor in the passive (shall be deemed), and joins long noun compounds (個人情報取扱事業者). This rule would only flag the form."
+  docs: "A help page repeats its heading in its first line (To upload a file, ...) and states no claims to back up."
+  academic: "Science writes in the passive, hedges its claims on purpose (may, suggest) and cites numbers as its evidence."
+  literature: "Length, rhythm, repetition and register are the author's choices in literature, and dialogue mixes styles. Only what one work can hold itself to runs: consistent spacing and commas, and numbering without gaps."
+  speech/transcript: "A transcript records what was said: its sentences, repeats and register are the speaker's, not the writer's to fix."
 
 group: readability
 summary:

package/rules/adverb-without-negation.yaml

@@ -0,0 +1,60 @@
+id: adverb-without-negation
+layer: L3
+status: stable
+how_to_find: adverb-polarity
+word_list: negative-polarity-adverb
+extra_word_lists: [negation-word]
+requires: [pos]
+languages: [ja]
+severity: info
+
+name:
+  ja: 打ち消しを伴わない「全然」「決して」
+  en: 全然 or 決して with no negation
+
+why:
+  ja: 「全然」「決して」「到底」は、書き言葉では「全然足りない」「決して許されない」のように打ち消しと組む副詞です。「全然大丈夫です」のように打ち消し無しで使うのは話し言葉で、報告書や案内では砕けて読まれます。文の後ろに打ち消しの語（ない、ません、ず、違う、不〜、無〜）が一つも無いときだけ指します。
+  en: In written Japanese, adverbs such as 全然 and 決して pair with a negation (全然足りない, "not at all enough"). Without one (全然大丈夫です, "totally fine") they are spoken usage and read as casual in a report or a notice. chaff reports one only when no negating word (ない, ません, ず, 違う, a 不 or 無 prefix) follows it in the sentence.
+
+message:
+  ja: 「{word}」の後に打ち消しがありません
+  en: '"{word}" has no negation after it'
+
+how_to_fix:
+  ja: 打ち消しを伴わないなら、別の副詞に替えてください（全然大丈夫です → まったく問題ありません、十分に間に合います）。
+  en: Without a negation, use another adverb (全然大丈夫です → まったく問題ありません).
+
+levels: { strict: warning, normal: info, relaxed: info }
+
+use_for: [business, technical, legal, docs, academic, literature, speech]
+off_for:
+  literature: "Spoken 全然大丈夫, なので and より in a character's voice; classical verse has a たり that does not list."
+  speech: "Spoken Japanese says 全然大丈夫, opens with なので and greets with より参りました."
+
+group: wording
+summary:
+  ja: 「全然大丈夫です」のように、打ち消しと組む副詞を打ち消し無しで使った所
+  en: A Japanese adverb that pairs with a negation (全然, 決して) used without one
+example:
+  ja:
+    before: |
+      納期は全然大丈夫です。
+    after: |
+      納期には十分に間に合います。
+
+not_flagged:
+  ja: 後ろに打ち消しの語（ない、ません、ず、まい、違う、異なる、駄目）か、不・未・無・非で始まる語（不十分、無理）があれば指しません。「まったく」は「まったく同じ」が正しいので見ません。ブログ、文芸、話し言葉のジャンルでは動きません。
+  en: Not reported when a negating word (ない, ません, ず, 違う, 駄目) or a word opening with 不, 未, 無 or 非 follows. まったく is not checked, since まったく同じ is correct. Off for blogs, literature and speech.
+rewrite:
+  depth: light
+  ja:
+    direction: 打ち消しの無い「全然」「決して」を、肯定と組む言い方に替えてください。打ち消しを言いたかったのなら、打ち消しの形にします。
+    pairs:
+      - before: 納期は全然大丈夫です。
+        after: 納期には十分に間に合います。
+      - before: 新しい手順は全然簡単です。
+        after: 新しい手順はとても簡単です。
+    keep:
+      - 文が言っている判断の向き（問題が無い、簡単だ）
+    avoid:
+      - 打ち消しを足して文の意味を逆にする

package/rules/adversative-ga-repeat.yaml

@@ -0,0 +1,59 @@
+id: adversative-ga-repeat
+layer: L3
+status: stable
+how_to_find: sentence-conjunctive-count
+word_list: adversative-particle
+requires: [pos]
+languages: [ja]
+severity: info
+
+name:
+  ja: 一文に逆接の「が」が二度
+  en: Two contrastive が in one sentence
+
+why:
+  ja: 「〜だが、〜するが、〜」のように逆接の「が」を一文で二度使うと、話が二度ひっくり返り、書き手の言いたい向きが読み手に分からなくなります。数えるのは接続助詞の「が」だけで、「私が」のような格助詞の「が」は数えません。
+  en: In Japanese, a sentence that turns twice with the contrastive particle が (〜だが、〜するが、) leaves the reader unsure which way it finally points. Only the conjunctive が is counted, not the case particle (私が).
+
+message:
+  ja: 一文に逆接の「が」が {count} 個あります（{limit} 個まで）
+  en: "{count} contrastive が in one sentence (limit {limit})"
+
+how_to_fix:
+  ja: 一つ目の「が」の所で文を切り、次の文を「しかし」で始めるか、どちらかの逆接を順接に言い換えてください。
+  en: Split the sentence at the first が and open the next with しかし, or turn one of the two into a plain link.
+
+levels: { strict: 1, normal: 1, relaxed: 2 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: readability
+summary:
+  ja: 「〜だが、〜するが、」のように、一文の中で逆接の「が」を二度使った所
+  en: A Japanese sentence that turns twice on the contrastive particle が
+example:
+  ja:
+    before: |
+      予算は足りるが、人手が足りないが、納期は守ります。
+    after: |
+      予算は足ります。人手は足りませんが、納期は守ります。
+
+not_flagged:
+  ja: 接続助詞の「が」だけを数えます。格助詞の「が」（私が、会社が）と、鉤括弧で引いたものの中は数えません。「けれど」「けど」も数えません。
+  en: Only the conjunctive が, outside 「」. The case particle が (私が) and けれど / けど are not counted.
+level_meaning:
+  ja: 一文の逆接の「が」{limit} 個まで
+  en: up to {limit} contrastive が in a sentence
+rewrite:
+  depth: light
+  ja:
+    direction: 一つ目の逆接の「が」の所で文を切ってください。次の文の頭に、前との関係を言う語（しかし、ただし）を置けます。
+    pairs:
+      - before: 予算は足りるが、人手が足りないが、納期は守ります。
+        after: 予算は足ります。人手は足りませんが、納期は守ります。
+      - before: 新機能は便利だが、設定が難しいが、慣れれば速い。
+        after: 新機能は便利です。ただし設定が難しく、慣れるまでは時間がかかります。
+    keep:
+      - 二つの逆接が言っている事柄
+    avoid:
+      - 「が」を「けれど」に替えるだけで、一文のまま残す

package/rules/agentless-passive.yaml

@@ -1,6 +1,6 @@
 id: agentless-passive
 layer: L3
-status: experimental
+status: stable
 how_to_find: agentless-passive
 word_list: agent-marker
 requires: [pos]
@@ -26,6 +26,14 @@ how_to_fix:
 levels: { strict: 1, normal: 1, relaxed: 2 }
 
 use_for: [business, legal, docs, academic, literature, speech]
+off_for:
+  legal: "Legal drafting repeats its terms and its sentence heads on purpose, puts the actor in the passive (shall be deemed), and joins long noun compounds (個人情報取扱事業者). This rule would only flag the form."
+  docs: "A help page repeats its heading in its first line (To upload a file, ...) and states no claims to back up."
+  academic: "Science writes in the passive, hedges its claims on purpose (may, suggest) and cites numbers as its evidence."
+  literature: "Length, rhythm, repetition and register are the author's choices in literature, and dialogue mixes styles. Only what one work can hold itself to runs: consistent spacing and commas, and numbering without gaps."
+  speech: "A speech opens with greetings and closes with thanks: that is its form, not padding."
+  business/meeting-notes: "Minutes record what the meeting did (the meeting was held, 了承された): the actor is the meeting, by the form. In the corpus the rule fires on nearly every set of minutes, English and Japanese."
+  business: measured by yarn rules:measure
 sources: [yasashii-nihongo-2020, plain-2011]
 
 group: wording
@@ -47,6 +55,7 @@ level_meaning:
   ja: 一文に受け身が {limit} 個あれば指摘
   en: reported when a sentence has {limit} passives with no actor
 rewrite:
+  depth: light
   ja:
     direction: 誰がしたのかを本文から探して主語にし、能動の文にしてください。本文のどこにも書かれていなければ、作らずに［誰が］と空けて書き手に聞きます。
     pairs:

package/rules/agreement-slip.yaml

@@ -1,6 +1,6 @@
 id: agreement-slip
 layer: L3
-status: experimental
+status: stable
 how_to_find: agreement-slip
 requires: [pos]
 languages: [en]
@@ -34,6 +34,9 @@ how_to_fix:
 levels: { strict: error, normal: warning, relaxed: info }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+off_for:
+  literature: "Length, rhythm, repetition and register are the author's choices in literature, and dialogue mixes styles. Only what one work can hold itself to runs: consistent spacing and commas, and numbering without gaps."
+  speech/transcript: "A transcript records what was said: its sentences, repeats and register are the speaker's, not the writer's to fix."
 
 group: slips
 summary:

package/rules/ai-generated-composite.yaml

@@ -1,6 +1,6 @@
 id: ai-generated-composite
 layer: L1
-status: experimental
+status: stable
 how_to_find: composite
 severity: warning
 
@@ -18,6 +18,7 @@ from:
   - assistant-residue
   - announcing-opener
   - colon-lead-in
+  - ai-structure
 
 name:
   ja: 生成文の特徴がそろっている
@@ -38,7 +39,12 @@ how_to_fix:
 # 何種そろったら出すか。spec §20.2 は 3。
 levels: { strict: 2, normal: 3, relaxed: 5 }
 
-use_for: [blog, business, legal, docs, academic, literature, speech]
+use_for: [technical/readme, blog, business, legal, docs, academic, literature, speech]
+off_for:
+  legal: "Legal drafting repeats its terms and its sentence heads on purpose, puts the actor in the passive (shall be deemed), and joins long noun compounds (個人情報取扱事業者). This rule would only flag the form."
+  docs: "A help page repeats its heading in its first line (To upload a file, ...) and states no claims to back up."
+  literature: "Length, rhythm, repetition and register are the author's choices in literature, and dialogue mixes styles. Only what one work can hold itself to runs: consistent spacing and commas, and numbering without gaps."
+  speech/transcript: "A transcript records what was said: its sentences, repeats and register are the speaker's, not the writer's to fix."
 
 group: ai-tells
 summary:

package/rules/ai-structure.yaml

@@ -0,0 +1,208 @@
+id: ai-structure
+layer: L1
+status: stable
+how_to_find: ai-structure
+requires: [headings]
+severity: info
+
+name:
+  ja: 構成が人の記事から外れている
+  en: The outline is unlike human articles
+
+why:
+  ja: 生成した記事は、文より先に構成に形が出ます。一段落ごとの見出し、3 つに分けた小見出し、太字の札の箇条書き、同じ長さの節、本文を言い直すまとめです。どれも 1 つなら人の記事にもあります。chaff は見出しの多さや節の長さのばらつきなどの項目を、生成 AI が広まる前の人の記事と比べ、人の記事の 9 割を超えた項目がいくつそろったかを数えます。**これでも「AI が書いた」とは言えません。** 構成を見直す目印です。
+  en: Generated articles show their shape in the outline before the sentences, with a heading every paragraph, headings split into three, bold-label lists, sections of one size, and a closing that restates the body. Each of these turns up in human articles too. chaff compares measures such as heading density and section length variation with articles written before generated text was common, and counts how many lie past 90% of those articles. **Even then it does not say the text was generated.** It marks an outline to rethink.
+
+message:
+  ja: 構成の {count} 項目が、人の記事の 9 割を超えています（{limit} 項目から）。{word}
+  en: "{count} structure {count|measure lies|measures lie} past 90% of human articles ({limit} needed): {word}"
+
+how_to_fix:
+  ja: "`chaff outline` で項目ごとの値と人の記事の値を見て、構成から書き直してください。薄い節は合わせ、一段落だけの見出しは外し、3 つに揃えた小見出しは中身の数に合わせ、本文を言い直すだけのまとめは消します。"
+  en: Run `chaff outline` to see each measure against human articles, then rewrite from the outline. Merge thin sections, drop a heading over a single paragraph, split only as many ways as the content has, and cut a closing that only restates the body.
+
+# 人の記事の 9 割を超えた項目が何個そろったら出すか。人の記事で何個そろうかは scripts/structure-baseline.ts --values で数え直せる。
+levels: { strict: 2, normal: 3, relaxed: 4 }
+
+# 基準にした人の記事はブログ。ビジネス文書は見ない。法務・説明書・論文・話し言葉は見出しの立て方がもともと違うので、off_for で止める。
+use_for: [blog, legal, docs, academic, literature, speech]
+off_for:
+  legal: "Legal drafting repeats its terms and its sentence heads on purpose, puts the actor in the passive (shall be deemed), and joins long noun compounds (個人情報取扱事業者). This rule would only flag the form."
+  docs: "A help page repeats its heading in its first line (To upload a file, ...) and states no claims to back up."
+  academic: "Science writes in the passive, hedges its claims on purpose (may, suggest) and cites numbers as its evidence."
+  speech: "A speech opens with greetings and closes with thanks: that is its form, not padding."
+
+group: ai-tells
+summary:
+  ja: 見出しの多さや節の揃い方など、構成の項目がいくつも人の記事から外れている文書
+  en: An outline that lies past human articles on several structure measures at once
+example:
+  ja:
+    config: { genre: blog/tech, rules: { ai-structure: strict } }
+    before: |
+      # 勉強会を見直す
+
+      ## 課題
+
+      ### 人が減った
+
+      来る人が減りました。
+
+      ### 話す人が偏った
+
+      同じ人ばかりが話しました。
+
+      ### 題材が遠かった
+
+      業務と関係のない話が多くなりました。
+
+      ## 対策
+
+      ### 題材を選ぶ
+
+      題材を業務から選びました。
+
+      ### 短く話す
+
+      発表を五分にしました。
+
+      ### 記録を残す
+
+      話した内容を残しました。
+
+      ## 学んだこと
+
+      - **仕組み**：意志だけでは続きません
+      - **小ささ**：短い発表なら誰でも話せます
+    after: |
+      # 勉強会は、発表を短くしたら人が戻った
+
+      来る人が減り、話す人も同じ顔ぶれに偏っていました。業務と関係のない題材が多かったからです。
+
+      ## 業務の題材を、短く話す
+
+      そこで題材を業務から選び、発表を五分にして、話した内容を残しました。続けるには、意志より仕組みが要りました。
+  en:
+    config: { genre: blog/tech, rules: { ai-structure: strict } }
+    before: |
+      # Rethinking our demo
+
+      ## Challenges
+
+      ### Fewer people came
+
+      Attendance dropped.
+
+      ### The same people presented
+
+      Two people gave most of the talks.
+
+      ### Topics were far from work
+
+      Most topics had nothing to do with our work.
+
+      ## Solutions
+
+      ### Pick topics from work
+
+      We chose topics from the week's work.
+
+      ### Keep it short
+
+      We cut each slot to five minutes.
+
+      ### Write it down
+
+      We kept notes of every talk.
+
+      ## Lessons learned
+
+      - **Systems**: willpower alone does not last
+      - **Small steps**: anyone can give a short talk
+    after: |
+      # Our demo came back when we shortened the slots
+
+      Attendance dropped, and the same two people gave most of the talks, mostly on topics far from our work.
+
+      ## Short talks on the week's work
+
+      So we chose topics from the week's work, cut each slot to five minutes and kept notes. What kept it going was the format, not willpower.
+
+not_flagged:
+  ja: 見出しの無い文書は見ません。項目ごとに、測るのに足りない文書（短い文書、節や箇条書きの少ない文書）はその項目を数えません。基準の人の記事がブログなので、ビジネス文書・法務・説明書・論文・話し言葉のジャンルでは見ません（`chaff outline` と `chaff fix-plan` は、どのジャンルでも構成を測ります）。
+  en: A document without headings is not checked. A measure the document is too small for (a short text, few sections or lists) is not counted. The baseline is blog articles, so business, legal, documentation, academic and speech genres do not run this rule (`chaff outline` and `chaff fix-plan` measure the structure in any genre).
+level_meaning:
+  ja: 人の記事の 9 割を超えた項目が {limit} 個そろえば指摘
+  en: reported once {limit} measures lie past 90% of human articles
+rewrite:
+  depth: structure
+  ja:
+    direction: 構成から書き直してください。`chaff outline` が人の記事の 9 割を超えたと言う項目を、人の記事の範囲に戻します。見出しは中身のまとまりごとに立て、一段落ごとに立てません。小見出しの数は中身の数に合わせ、3 つに揃えません。太字の札の箇条書きは文に戻し、本文を言い直すだけのまとめは消します。
+    pairs:
+      - before: |
+          ## 直面した課題
+
+          ### 参加者が減った
+
+          始めて 2 か月で、参加者は 5 人に減りました。
+
+          ### 話す人が偏った
+
+          最初の 8 回のうち 6 回は、同じ 2 人が発表していました。
+        after: |
+          ## 人が減ったのは、話が遠かったから
+
+          始めて 2 か月で、参加者は 5 人に減りました。最初の 8 回のうち 6 回は、同じ 2 人が発表していました。
+      - before: |
+          ## はじめに
+
+          本記事では、社内勉強会を半年続けた経験を紹介します。
+
+          ## 勉強会の概要
+
+          毎週木曜日に、開発チームの 12 人で始めました。
+        after: |
+          毎週木曜日に、開発チームの 12 人で社内勉強会を始めました。
+    keep:
+      - 事実、数、日付、名前
+      - 手順やコマンドの並び
+      - 書き手の経験と主張
+    avoid:
+      - 見出しの文言だけを変えて、同じ数の見出しを残す
+      - 見出しを消して、太字の一文に置き換える
+      - 節を合わせるために、書き手が書いていない繋がりを足す
+  en:
+    direction: Rewrite from the outline. Bring each measure that `chaff outline` puts past 90% of human articles back into their range. Give a heading to a unit of content, not to every paragraph. Split a section as many ways as its content has, not into three by habit. Turn bold-label lists back into sentences, and cut a closing that only restates the body.
+    pairs:
+      - before: |
+          ## Challenges
+
+          ### Fewer people came
+
+          Within two months, 6 people were coming.
+
+          ### The same people presented
+
+          Two people gave 7 of the first 10 demos.
+        after: |
+          ## Fewer people came because the demos felt far away
+
+          Within two months, 6 people were coming. Two people gave 7 of the first 10 demos.
+      - before: |
+          ## Introduction
+
+          In this post, we'll look at how our team started a weekly demo.
+
+          ## Overview
+
+          We met every Friday, 14 people from the product team.
+        after: |
+          We started a weekly demo, every Friday, for the 14 people on the product team.
+    keep:
+      - every fact, number, date and name
+      - the order of steps and commands
+      - the writer's own experience and claims
+    avoid:
+      - renaming the headings but keeping as many
+      - replacing a heading with a bold sentence
+      - adding links between sections that the writer did not make