chaffjs 0.19.0 → 0.20.0

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,7 @@ 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

package/rules/announcing-opener.yaml

@@ -25,7 +25,7 @@ how_to_fix:
 # 指摘に要る数。長さで割らない：人の記事は長くても 1 つ 2 つで、生成文は短くても重ねる。
 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/article-sound.yaml

@@ -0,0 +1,58 @@
+id: article-sound
+layer: L2
+status: experimental
+how_to_find: article-sound
+word_list: article-sound
+requires: [pos]
+languages: [en]
+severity: warning
+
+name:
+  ja: a と an の取り違え
+  en: '"a" or "an" against the next sound'
+
+why:
+  ja: 英語の「a」と「an」は、次の語の綴りではなく音で決まります（a user、an hour、an MBA）。取り違えると、読み手はそこで引っかかります。綴りと音が食い違う語と、大文字を一字ずつ読むか語として読むか（an MBA、a NASA probe）、どちらでもよい語（a SQL / an SQL）は、言語ごとの語彙表にあります。
+  en: '"A" and "an" follow the sound of the next word, not its spelling ("a user", "an hour", "an MBA"). A slip trips the reader. Words whose spelling and sound disagree, capitals read letter by letter or as a word ("an MBA", "a NASA probe"), and words said both ways ("a SQL", "an SQL") are listed in the lexicon.'
+
+message:
+  ja: 「{matched}」は、次の語の音から「{article}」です
+  en: '"{matched}" takes "{article}" before that sound'
+
+how_to_fix:
+  ja: 次の語の頭の音に合わせて、a か an に直してください。
+  en: Use "an" before a vowel sound and "a" before a consonant sound.
+
+levels: { strict: 1, normal: 1, relaxed: 2 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: slips
+summary:
+  ja: 英語で、「a apple」「an user」のように、次の語の音に合わない a / an
+  en: '"a" before a vowel sound or "an" before a consonant sound, such as "a apple" or "an user"'
+example:
+  en:
+    before: |
+      We waited a hour for an user to reply.
+    after: |
+      We waited an hour for a user to reply.
+
+not_flagged:
+  ja: 数字の前（a 8-hour day）と、語彙表でどちらでもよいとした語（SQL、historic など）は見ません。大文字の語は語彙表のとおりに読み、載っていなければ、三字までか母音の無いもの（MBA、NTSB）だけを一字ずつ読むものとして見ます。それより長く母音のあるもの（SALT）は語として読むかもしれないので見ません。小説と話し言葉では既定で止めています。
+  en: Not before digits ("a 8-hour day"), nor before words the lexicon says are said both ways (SQL, historic). Capitals are read as the lexicon says; unlisted ones are read letter by letter only when short or without a vowel (MBA, NTSB), since longer ones (SALT) may be said as a word. The fiction and speech presets turn it off.
+level_meaning:
+  ja: "{limit} 箇所あれば指摘"
+  en: reported once there are {limit}
+rewrite:
+  en:
+    direction: Change only the article, to "an" before a vowel sound and "a" before a consonant sound.
+    pairs:
+      - before: We waited a hour.
+        after: We waited an hour.
+      - before: Send it to an user in the team.
+        after: Send it to a user in the team.
+    keep:
+      - every other word
+    avoid:
+      - changing the noun to fit the article

package/rules/bold-label-list.yaml

@@ -27,7 +27,7 @@ how_to_fix:
 # 指摘に要る項目の数。長さで割らない：人の記事は長くても 1 つ 2 つで、生成文は短くても並べる。
 levels: { strict: 3, normal: 5, relaxed: 8 }
 
-use_for: [blog, business, legal, docs, academic, literature, speech]
+use_for: [technical/readme, blog, business, legal, docs, academic, literature, speech]
 sources: [zhang-2024]
 
 group: ai-tells
@@ -52,8 +52,8 @@ example:
       月の費用は下がり、権限も細かく分けられます。
 
 not_flagged:
-  ja: 札がコードだけの項目（`--flag` の説明のような、設定や引数の一覧）は数えません。札の後ろにコロンが無い項目と、コロンの後ろに何も無い項目も数えません。技術文書・法務・説明書・論文・文学のジャンルでは見ません。英語の文書は、人もよくこの形で書くので見ません。
-  en: An item whose label is only code (a list of options or fields) is not counted, nor is one without a colon after the label or without text after the colon. Technical, legal, documentation, academic and literary genres do not run this rule. Japanese documents only; English writers use this shape as a matter of course.
+  ja: 札がコードだけの項目（`--flag` の説明のような、設定や引数の一覧）は数えません。札の後ろにコロンが無い項目と、コロンの後ろに何も無い項目も数えません。仕様書（technical/spec）・法務・説明書・論文・文学のジャンルでは見ません。英語の文書は、人もよくこの形で書くので見ません。
+  en: An item whose label is only code (a list of options or fields) is not counted, nor is one without a colon after the label or without text after the colon. Specification (technical/spec), legal, documentation, academic and literary genres do not run this rule. Japanese documents only; English writers use this shape as a matter of course.
 level_meaning:
   ja: 太字の札で始まる項目が {limit} 個あれば指摘
   en: reported once {limit} list items open with a bold label

package/rules/bracket-nesting.yaml

@@ -0,0 +1,74 @@
+id: bracket-nesting
+layer: L3
+status: experimental
+how_to_find: bracket-nesting
+severity: info
+
+name:
+  ja: 括弧の中に括弧が重なっている
+  en: Brackets nested too deep
+
+why:
+  ja: 括弧の中に括弧があり、その中にまた括弧があると、読み手は開いた括弧をいくつも覚えたまま読み進めることになり、どこで本文に戻ったのかを見失います。二重までは注や引用でよくある形ですが、それより深いものは、文を分けるか、注を外に出すほうが読めます。数えるのは丸括弧・角括弧・鉤括弧・隅付き括弧と、開きと閉じの形が違う引用符です。開きの無い閉じ括弧（箇条の「1)」）と、数式（$…$）の中の括弧は数えません。
+  en: A bracket inside a bracket inside a bracket makes the reader hold every open one while reading on, and lose where the sentence resumed. Two levels are common in notes and quotations; deeper than that reads better as a separate sentence or a note. Round and square brackets, Japanese corner brackets and curly double quotes are counted. A closing bracket with no opener (the "1)" of a list) and brackets inside a formula ($…$) are not.
+
+message:
+  ja: 括弧が {count} 重になっています（{limit} 重まで）
+  en: Brackets nested {count} deep (limit {limit})
+
+how_to_fix:
+  ja: 一番内側の括弧を外して、別の文にするか注にしてください。
+  en: Take the innermost bracket out into its own sentence or a note.
+
+levels: { strict: 1, normal: 2, relaxed: 3 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: readability
+summary:
+  ja: 「（注（a（b）））」のように、括弧の中に括弧が何重にも重なった文
+  en: Brackets inside brackets inside brackets in one sentence
+example:
+  ja:
+    before: |
+      費用は本部が負担します（ただし、出張費（交通費（特急料金を除く）を含む）は各部の負担）。
+    after: |
+      費用は本部が負担します。ただし、出張費は各部が負担します。出張費には交通費を含み、特急料金は含みません。
+  en:
+    before: |
+      The fee is waived (for members (including student members (under 25))) on request.
+    after: |
+      The fee is waived on request for members, including student members under 25.
+
+not_flagged:
+  ja: 二重までの括弧、開きの無い閉じ括弧（「1)」）、コードと数式（$…$）の中の括弧、波括弧は数えません。
+  en: Two levels of brackets, a closing bracket with no opener ("1)"), brackets in code or in a formula ($…$), and curly braces are not counted.
+level_meaning:
+  ja: 括弧の重なり {limit} 重まで
+  en: brackets nested up to {limit} deep
+rewrite:
+  ja:
+    direction: 一番内側の括弧を外して、別の文か注にしてください。括弧の中身は落とさずに残します。
+    pairs:
+      - before: 費用は本部が負担します（ただし、出張費（交通費（特急料金を除く）を含む）は各部の負担）。
+        after: 費用は本部が負担します。ただし、出張費は各部が負担します。出張費には交通費を含み、特急料金は含みません。
+      - before: 申請書（様式1（別紙（記入例）参照））を出してください。
+        after: 申請書（様式1）を出してください。記入例は別紙にあります。
+    keep:
+      - 括弧の中に書いてあった条件や例外
+      - 何がどこに係るのか
+    avoid:
+      - 括弧の中身を消す
+      - 括弧を読点やダッシュに替えて、同じ重なりを残す
+  en:
+    direction: Take the innermost bracket out into its own sentence or a note. Keep everything the brackets said.
+    pairs:
+      - before: The fee is waived (for members (including student members (under 25))) on request.
+        after: The fee is waived on request for members, including student members under 25.
+      - before: Submit the form (Form A (see the sample (Annex 2))) by Friday.
+        after: Submit Form A by Friday. A sample is in Annex 2.
+    keep:
+      - every condition and exception the brackets held
+    avoid:
+      - deleting what was in the brackets
+      - swapping the brackets for dashes and keeping the same nesting

package/rules/chat-citation-residue.yaml

@@ -0,0 +1,77 @@
+id: chat-citation-residue
+layer: L2
+status: experimental
+how_to_find: chat-citation-residue
+word_list: chat-citation-marker
+severity: warning
+
+name:
+  ja: チャットの出典の名残
+  en: Chat citation residue
+
+why:
+  ja: 「?utm_source=chatgpt.com」の付いたリンクや「:contentReference[oaicite:0]」は、チャットの答えを貼ったときに残る印です。文体の好みではなく、貼った後に確かめていない印です。リンク先が本当にその記述の出典なのかも、確かめられていません。
+  en: 'A link ending in "?utm_source=chatgpt.com" and a ":contentReference[oaicite:0]" are marks a chat answer leaves when it is pasted. This is not a matter of style: it shows the paste was never checked, and that nobody has confirmed the link supports the sentence it sits on.'
+
+message:
+  ja: 「{matched}」はチャットの答えの名残です
+  en: '"{matched}" is left over from a chat answer'
+
+how_to_fix:
+  ja: リンクを開いて、その記述の出典になっているか確かめてください。出典なら、末尾の「?utm_source=…」を消してリンクを残します。出典の印（oaicite、contentReference）は消します。
+  en: Open the link and check it supports the sentence. If it does, keep the link and drop the "?utm_source=…" at its end. Delete citation marks (oaicite, contentReference).
+
+# 指摘に要る印の数。1 つで言う。
+levels: { strict: 1, normal: 1, relaxed: 2 }
+
+use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: slips
+summary:
+  ja: 「?utm_source=chatgpt.com」の付いたリンクや「oaicite」のように、チャットの答えを貼ったときに残る印
+  en: 'Marks a pasted chat answer leaves behind: links ending in "?utm_source=chatgpt.com", ":contentReference[oaicite:0]"'
+example:
+  ja:
+    before: |
+      手順は[公式の説明](https://example.com/setup?utm_source=chatgpt.com)のとおりです。
+    after: |
+      手順は[公式の説明](https://example.com/setup)のとおりです。
+  en:
+    before: |
+      The steps follow [the official guide](https://example.com/setup?utm_source=chatgpt.com).
+    after: |
+      The steps follow [the official guide](https://example.com/setup).
+
+not_flagged:
+  ja: コードの中（`?utm_source=chatgpt.com` と書いて説明している所）は数えません。utm_source でも、チャット以外の値（qiita、twitter）は数えません。
+  en: Code is not read (an article that explains the parameter in backticks). Other utm_source values (newsletter, twitter) are not counted.
+level_meaning:
+  ja: 名残の印が {limit} 個あれば指摘
+  en: reported once there are {limit}
+rewrite:
+  ja:
+    direction: リンク先を開いて、その文の出典になっているかを確かめてから、チャットの印だけを消してください。出典にならないリンクは消し、確かめた出典に替えます。
+    pairs:
+      - before: 手順は[公式の説明](https://example.com/setup?utm_source=chatgpt.com)のとおりです。
+        after: 手順は[公式の説明](https://example.com/setup)のとおりです。
+      - before: 料金は月 500 円です。:contentReference[oaicite:0]{index=0}
+        after: 料金は月 500 円です（[料金表](［確かめた出典の URL］)）。
+    keep:
+      - リンク先のページそのもの（印を消すだけで、別のページに替えない）
+      - 文の中身と数字
+    avoid:
+      - 確かめずに印だけを消す
+      - 出典の無い数字に、それらしい出典を足す
+  en:
+    direction: Open the link and check it supports the sentence, then remove only the chat marks. A link that does not support the sentence goes, replaced by a source you checked.
+    pairs:
+      - before: The steps follow [the official guide](https://example.com/setup?utm_source=chatgpt.com).
+        after: The steps follow [the official guide](https://example.com/setup).
+      - before: The plan costs $5 a month. :contentReference[oaicite:0]{index=0}
+        after: The plan costs $5 a month ([pricing]([URL of the source you checked])).
+    keep:
+      - the page the link points to (remove the mark, do not swap the page)
+      - what the sentence says, and its numbers
+    avoid:
+      - removing the mark without checking the source
+      - adding a plausible source to a number that had none

package/rules/citation-reference-mismatch.yaml

@@ -0,0 +1,110 @@
+id: citation-reference-mismatch
+layer: L3
+status: experimental
+how_to_find: citation-entry
+severity: warning
+
+name:
+  ja: 引用と文献一覧が合っていない
+  en: Citations and reference list do not match
+
+why:
+  ja: 本文が [5] を引いているのに文献一覧に 5 番が無いと、読み手は根拠を確かめられません。文献一覧にあるのに本文で一度も引かない文献は、消し忘れか、引用を消してしまったかのどちらかです。文献を足したり消したりして番号を振り直したときに起きます。番号で引く論文は番号どうしを、著者と年で引く論文は著者の姓と年どうしを比べます。読み取れる引用が文献の半分に満たない文書（上付きの番号がコピーで消えた文書など）では、引かれていない文献を指しません。
+  en: When the text cites [5] and the reference list has no entry 5, the reader cannot check the source. An entry the text never cites was either left behind or lost its citation. It happens when references are added or removed and renumbered. A paper that cites by number is compared number by number; one that cites by author and year, by surname and year. When fewer than half of the entries are cited in a form chaff reads (superscript numbers lost in a copy, say), uncited entries are not reported.
+
+message:
+  ja: 引用と文献一覧が合っていません
+  en: A citation and the reference list do not match
+
+messages:
+  missing:
+    ja: 引用「{citation}」の {key} が、文献一覧にありません
+    en: 'The citation "{citation}" names {key}, which is not in the reference list'
+  uncited:
+    ja: この文献は、本文で一度も引いていません
+    en: This entry of the reference list is never cited in the text
+
+how_to_fix:
+  ja: 本文の番号がずれていないか確かめて、引用か文献一覧を直してください。引かない文献は消すか、引く所を足してください。
+  en: Check whether the numbers shifted, and correct the citation or the list. Remove an entry that is never cited, or cite it where it belongs.
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [academic, legal, docs, literature, speech]
+
+group: facts
+summary:
+  ja: 文献一覧に無い文献を引く引用と、本文で一度も引かない文献
+  en: A citation with no entry in the reference list, or an entry the text never cites
+example:
+  ja:
+    config: { genre: academic/paper }
+    before: |
+      # 睡眠と記憶
+
+      睡眠は記憶の定着を助ける[1]。短い昼寝でも効果がある[3]。
+
+      ## 参考文献
+
+      - [1] 佐藤一郎. 睡眠の研究. 2019.
+      - [2] 鈴木花子. 昼寝の効果. 2021.
+    after: |
+      # 睡眠と記憶
+
+      睡眠は記憶の定着を助ける[1]。短い昼寝でも効果がある[2]。
+
+      ## 参考文献
+
+      - [1] 佐藤一郎. 睡眠の研究. 2019.
+      - [2] 鈴木花子. 昼寝の効果. 2021.
+  en:
+    config: { genre: academic/paper }
+    before: |
+      # Sleep and memory
+
+      Sleep helps memories settle [1]. A short nap helps too [3].
+
+      ## References
+
+      - [1] Smith, A. Sleep. 2019.
+      - [2] Jones, B. Naps. 2021.
+    after: |
+      # Sleep and memory
+
+      Sleep helps memories settle [1]. A short nap helps too [2].
+
+      ## References
+
+      - [1] Smith, A. Sleep. 2019.
+      - [2] Jones, B. Naps. 2021.
+
+not_flagged:
+  ja: 「参考文献」「References」のような見出しの下に文献一覧が無い文書、番号も著者と年も読み取れない文献、文献が一つしか無い一覧は見ません。番号で引く引用と番号の文献、著者と年で引く引用と著者と年の文献は、それぞれの組の中だけで比べます。論文のジャンルでだけ見ます。
+  en: 'A document without a list under a heading such as "References", entries that give neither a number nor an author and a year, and a list of one entry are left alone. Numbered citations are compared only with numbered entries, and author-year citations only with author-year entries. Only the academic paper genre runs this rule.'
+rewrite:
+  ja:
+    direction: 引用と文献一覧のどちらがずれたのかを書き手に確かめ、ずれたほうを直してください。番号を推測で書き換えず、確かめられないときはその旨を書き手に伝えます。引かない文献は、消すか、引く所を書き手に尋ねます。
+    pairs:
+      - before: 短い昼寝でも効果がある[3]。
+        after: 短い昼寝でも効果がある[2]。
+      - before: 先行研究（山田, 2019）でも同じ結果が出ている。
+        after: 先行研究（山田, 2020）でも同じ結果が出ている。
+    keep:
+      - どの文献を引いているか
+      - 文献一覧の書誌情報
+    avoid:
+      - 文献一覧に無い文献を作る
+      - どちらが正しいかを推測で決める
+  en:
+    direction: Ask the writer whether the citation or the list shifted, and correct the one that did. Do not guess a number; if it cannot be checked, say so. For an entry never cited, remove it or ask the writer where it is cited.
+    pairs:
+      - before: A short nap helps too [3].
+        after: A short nap helps too [2].
+      - before: Earlier work found the same (Smith, 2019).
+        after: Earlier work found the same (Smith, 2020).
+    keep:
+      - which work is cited
+      - the bibliographic details in the list
+    avoid:
+      - inventing an entry the list does not have
+      - guessing which side is right