chaffjs 0.18.0 → 0.20.0

package/rules/absolute-exception.yaml

@@ -0,0 +1,83 @@
+id: absolute-exception
+layer: L3
+status: experimental
+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]
+
+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,130 @@
+id: abstract-length
+layer: L3
+status: experimental
+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]
+
+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:
+  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

@@ -0,0 +1,82 @@
+id: acronym-expansion-conflict
+layer: L3
+status: experimental
+how_to_find: acronym-expansion-conflict
+severity: warning
+
+name:
+  ja: 同じ略語の二通りの展開
+  en: Abbreviation expanded two ways
+
+why:
+  ja: 同じ略語を二か所で違う名前に展開すると、読み手は二つが同じものか別のものか分かりません。片方は書き違いか、別の文書から貼った文であることが多いです。
+  en: An abbreviation spelled out as two different names leaves the reader unsure whether they are the same thing. One of them is usually a slip, or a sentence pasted from another document.
+
+message:
+  ja: 「{acronym}」をここでは「{name}」と、{firstLine} 行目では「{first}」と展開しています
+  en: '"{acronym}" is expanded as "{name}" here and as "{first}" on line {firstLine}'
+
+how_to_fix:
+  ja: どちらの名前が正しいかを確かめ、一つに揃えてください。別のものなら、別の略語にします。
+  en: Check which name is right and use it in both places. If they are different things, give them different abbreviations.
+
+placeholders:
+  acronym:
+    ja: 略語
+    en: the abbreviation
+  name:
+    ja: 名前
+    en: one name
+  first:
+    ja: 別の名前
+    en: another
+  firstLine:
+    ja: 〇
+    en: N
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: consistency
+summary:
+  ja: 同じ略語を、文書の中で違う名前に展開している所
+  en: The same abbreviation spelled out as two different names in one document
+example:
+  ja:
+    before: |
+      SLA（サービス品質保証）を毎月見直します。障害が続いた月は、SLA（サービスレベル契約）に従って返金します。
+    after: |
+      SLA（サービス品質保証）を毎月見直します。障害が続いた月は、SLA に従って返金します。
+  en:
+    before: |
+      We review the Service Level Agreement (SLA) every month. After an outage, refunds follow the Support Level Agreement (SLA).
+    after: |
+      We review the Service Level Agreement (SLA) every month. After an outage, refunds follow the SLA.
+
+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:
+  ja:
+    direction: 二つの展開のうち正しいほうを書き手に確かめ、もう一方を消すか正しい名前に替えてください。二度目以降は略語だけで書けます。
+    pairs:
+      - before: SLA（サービス品質保証）を毎月見直します。障害が続いた月は、SLA（サービスレベル契約）に従って返金します。
+        after: SLA（サービス品質保証）を毎月見直します。障害が続いた月は、SLA に従って返金します。
+      - before: CI（継続的インテグレーション）で毎晩試験します。失敗したら CI（構成情報）を見直します。
+        after: CI（継続的インテグレーション）で毎晩試験します。失敗したら構成情報を見直します。（二つが別のものであるとき）
+    keep:
+      - 正しいほうの名前
+    avoid:
+      - どちらが正しいかを書き手に聞かずに決める
+  en:
+    direction: Ask the writer which expansion is right, then remove or correct the other. After the first, the abbreviation alone is enough.
+    pairs:
+      - before: We review the Service Level Agreement (SLA) every month. After an outage, refunds follow the Support Level Agreement (SLA).
+        after: We review the Service Level Agreement (SLA) every month. After an outage, refunds follow the SLA.
+      - before: Tests run nightly in CI (Continuous Integration). On a failure, check the CI (Configuration Item).
+        after: Tests run nightly in CI (Continuous Integration). On a failure, check the configuration item. (when the two are different things)
+    keep:
+      - the right name
+    avoid:
+      - picking one without asking the writer

package/rules/adverb-overuse.yaml

@@ -43,5 +43,5 @@ not_flagged:
   ja: 短い文書（200 語より短いもの）は測りません。
   en: Documents under 200 words are not measured.
 level_meaning:
-  ja: 1000 語あたり {limit} 個まで
-  en: up to {limit} per 1000 words
+  ja: 1000 語あたり -ly 副詞 {limit} 個まで
+  en: up to {limit} -ly adverbs per 1000 words

package/rules/adversative-ga-repeat.yaml

@@ -0,0 +1,58 @@
+id: adversative-ga-repeat
+layer: L3
+status: experimental
+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:
+  ja:
+    direction: 一つ目の逆接の「が」の所で文を切ってください。次の文の頭に、前との関係を言う語（しかし、ただし）を置けます。
+    pairs:
+      - before: 予算は足りるが、人手が足りないが、納期は守ります。
+        after: 予算は足ります。人手は足りませんが、納期は守ります。
+      - before: 新機能は便利だが、設定が難しいが、慣れれば速い。
+        after: 新機能は便利です。ただし設定が難しく、慣れるまでは時間がかかります。
+    keep:
+      - 二つの逆接が言っている事柄
+    avoid:
+      - 「が」を「けれど」に替えるだけで、一文のまま残す

package/rules/agentless-passive.yaml

@@ -26,6 +26,7 @@ how_to_fix:
 levels: { strict: 1, normal: 1, relaxed: 2 }
 
 use_for: [business, legal, docs, academic, literature, speech]
+sources: [yasashii-nihongo-2020, plain-2011]
 
 group: wording
 summary:
@@ -45,3 +46,30 @@ not_flagged:
 level_meaning:
   ja: 一文に受け身が {limit} 個あれば指摘
   en: reported when a sentence has {limit} passives with no actor
+rewrite:
+  ja:
+    direction: 誰がしたのかを本文から探して主語にし、能動の文にしてください。本文のどこにも書かれていなければ、作らずに［誰が］と空けて書き手に聞きます。
+    pairs:
+      - before: 経営会議で検討した結果、予算が承認されました。
+        after: 経営会議が予算を承認しました。
+      - before: 仕様が変更されました。
+        after: ［誰が］仕様を変更しました。
+    keep:
+      - 何をしたのか、いつしたのか
+      - 誰がしたかが大事でない文の受け身（「資料は火曜日に配られます」）
+    avoid:
+      - 主語に「当社」「担当者」のような、本文に無い名前を作る
+      - 受け身を全部能動に直す
+  en:
+    direction: Find who acted in the text, make them the subject, and make the sentence active. If the text never says who, do not invent one; leave [who] for the writer.
+    pairs:
+      - before: After review by the steering group, the budget was approved.
+        after: The steering group approved the budget.
+      - before: The spec was changed.
+        after: "[who] changed the spec."
+    keep:
+      - what was done, and when
+      - a passive where who acted does not matter ("handouts are given out on Tuesday")
+    avoid:
+      - inventing an actor ("the team", "management") the text does not name
+      - making every passive active

package/rules/ai-generated-composite.yaml

@@ -18,6 +18,7 @@ from:
   - assistant-residue
   - announcing-opener
   - colon-lead-in
+  - ai-structure
 
 name:
   ja: 生成文の特徴がそろっている
@@ -38,7 +39,7 @@ 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]
 
 group: ai-tells
 summary:

package/rules/ai-structure.yaml

@@ -0,0 +1,202 @@
+id: ai-structure
+layer: L1
+status: experimental
+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 }
+
+# 基準にした人の記事はブログ。ビジネス文書は見ない。法務・説明書・論文・話し言葉は見出しの立て方がもともと違うので、genres.yaml で止める。
+use_for: [blog, legal, docs, academic, literature, speech]
+
+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:
+  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

package/rules/ai-tell.yaml

@@ -25,7 +25,8 @@ how_to_fix:
 # 重みの合計を 10 倍した点。0.9 の言い回しが 2 つで 18。
 levels: { strict: 10, normal: 18, relaxed: 30 }
 
-use_for: [blog, business, legal, docs, academic, literature, speech]
+use_for: [technical/readme, blog, business, legal, docs, academic, literature, speech]
+sources: [kobak-2025, liang-2024, juzek-ward-2025]
 
 group: ai-tells
 summary:
@@ -49,3 +50,36 @@ not_flagged:
 level_meaning:
   ja: 言い回しの重みの合計が {limit} 点まで
   en: up to a score of {limit}
+rewrite:
+  ja:
+    direction: 決まった言い回しを、その文が実際に言っている中身（誰が、何を、どれだけ）に置き換えてください。中身の無い文は消してください。
+    pairs:
+      - before: 現代社会において、在庫データは発注の判断で重要な役割を果たしています。
+        after: 発注は在庫データを見て決めています。
+      - before: 原因の調査に三日間、時間を溶かしました。
+        after: 原因の調査に三日かかりました。
+      - before: 本記事では、キャッシュの仕組みについて深く掘り下げていきます。
+        after: この記事では、キャッシュの仕組みを説明します。
+    keep:
+      - 数字、日付、名前、条件
+      - 書き手の確かさ（言い切りか、推量か）
+    avoid:
+      - 書き手が書いていない例や数字を作る
+      - 決まり文句を別の決まり文句に替える（「重要な役割を果たす」を「欠かせない存在だ」に）
+      - どの段落も同じ形に書き揃える
+  en:
+    direction: Replace the stock phrase with what the sentence actually claims, who does what and how much. If nothing is claimed, delete the sentence.
+    pairs:
+      - before: In today's fast-paced world, stock data plays a crucial role in ordering.
+        after: Orders are decided from stock data.
+      - before: Let's delve into how the cache works.
+        after: This section explains how the cache works.
+      - before: The release is a testament to the team's meticulous planning.
+        after: The team planned the release in detail.
+    keep:
+      - numbers, dates, names and conditions
+      - how sure the writer is
+    avoid:
+      - inventing an example or a number the writer did not give
+      - trading one stock phrase for another ("plays a crucial role" for "is pivotal")
+      - giving every paragraph the same shape