Commit c9f7076d by PLN (Algolia)

docs: README gains the anatomie figure and a science & references section

parent 318c8c16
...@@ -10,6 +10,8 @@ bilingual frameworks, one EN framework), scored by a ratified barème, and ...@@ -10,6 +10,8 @@ bilingual frameworks, one EN framework), scored by a ratified barème, and
tested. Zero config, by design — like black, the formatting is the tool's; tested. Zero config, by design — like black, the formatting is the tool's;
the words stay the author's. the words stay the author's.
![Anatomie d'une bavure — one slop sentence, three hits, 100 → 77](docs/anatomie-du-slop.svg)
```bash ```bash
git clone https://git.nech.pl/pln/buvard.git && cd buvard git clone https://git.nech.pl/pln/buvard.git && cd buvard
sudo ln -sf "$PWD/bin/buvard.js" /usr/local/bin/buvard sudo ln -sf "$PWD/bin/buvard.js" /usr/local/bin/buvard
...@@ -37,9 +39,8 @@ buvard is a **style linter**, not an AI detector. It finds statistically ...@@ -37,9 +39,8 @@ buvard is a **style linter**, not an AI detector. It finds statistically
over-represented patterns; it cannot and does not claim to detect machine over-represented patterns; it cannot and does not claim to detect machine
authorship. Its catalog is deliberately regex-shaped (high precision, low authorship. Its catalog is deliberately regex-shaped (high precision, low
recall): règle de trois, synonyme acrobatique and sentence-length monotony recall): règle de trois, synonyme acrobatique and sentence-length monotony
stay manual checks. docs/research.md holds the clustering study; stay manual checks. See [Science and references](#science-and-references)
docs/research-litreview.md (in progress) holds the literature review and for the evidence behind the catalog.
the falsifiable recommendations that will become catalog v3.
## Agents ## Agents
...@@ -56,6 +57,34 @@ catalog as an agent skill: load it, run the linter, apply the findings by hand. ...@@ -56,6 +57,34 @@ catalog as an agent skill: load it, run the linter, apply the findings by hand.
Hits are review candidates, never verdicts — the agent edits prose like an Hits are review candidates, never verdicts — the agent edits prose like an
editor, not like a filter. editor, not like a filter.
## Science and references
The catalog is data with provenance, and the barème is a ratified decision —
both are written down:
- **[docs/research.md](docs/research.md)** — the clustering study: five
anti-slop sources (fr1, fr2, étape, no-slop, ui-sk), what each contributes,
and how the shared patterns became the catalog.
- **[docs/research-litreview.md](docs/research-litreview.md)** — the
literature review on AI-text detection, and the **ten falsifiable
recommendations** that will become catalog v3. Read it before touching
the catalog.
Core citations, one line each — the lit review holds the full bibliography:
- Liang et al., 2023 — [GPT detectors are biased against non-native English writers](https://arxiv.org/abs/2304.02819): a 61.22% false-positive rate on TOEFL essays. The case for staying a linter.
- [MULTITuDE](https://arxiv.org/abs/2310.13606) — the large multilingual detection benchmark omits French; [INRIA's French ChatGPT-detection study](https://arxiv.org/abs/2306.05871) shows French is open territory.
- [GLTR](https://arxiv.org/abs/1906.04043), [DetectGPT](https://arxiv.org/abs/2301.11305), [Binoculars](https://arxiv.org/abs/2401.12070) — the detection toolbox; each degrades on short or paraphrased text.
- Sadasivan et al., 2024 — [paraphrase attacks collapse detection](https://arxiv.org/abs/2303.11156) on ~300-token passages. Why buvard never plays that game.
- Kobak et al., 2024 — [excess vocabulary](https://arxiv.org/abs/2403.07183) as a population-level AI marker. A cousin of our lexique.
- Sibling linters — [proselint](https://github.com/amperser/proselint) and [Vale](https://docs.vale.sh/) are the ancestors; [Wikipedia's "Signs of AI writing"](https://en.wikipedia.org/wiki/Wikipedia:Signs_of_AI_writing) is the shared folklore.
**Methodology, going forward (catalog v3):** every new rule must pass a
false-positive gate — under 2% per rule on a pre-2022 Gutenberg corpus,
human-written by construction. Model-generated text is used only to measure
sensitivity, never to admit a rule; a catalog tuned on one model's slop
learns that model's fingerprints.
## Skill ## Skill
`SKILL.md` ships the catalog as an agent skill: load it, run the linter, `SKILL.md` ships the catalog as an agent skill: load it, run the linter,
......
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 880 470" role="img" aria-labelledby="t d">
<title id="t">Anatomie d'une bavure</title>
<desc id="d">One slop sentence dissected: buvard's catalog flags a binary contrast (−8), a servile promise (−10) and a second tiret cadratin beyond budget (−5); the score falls from 100 to 77.</desc>
<defs>
<style>
.ink { fill:#1f2a33; }
.rouge{ fill:#a63d2f; }
.muted{ fill:#7a6f5d; }
.serif{ font-family: Georgia, 'Times New Roman', serif; }
.sans { font-family: 'Avenir Next', 'Helvetica Neue', Arial, sans-serif; }
.line { stroke:#1f2a33; fill:none; stroke-linecap:round; }
.rouged { stroke:#a63d2f; fill:none; stroke-linecap:round; }
</style>
</defs>
<!-- paper -->
<rect width="880" height="470" fill="#faf5ea"/>
<!-- title -->
<text x="90" y="62" class="sans ink" font-size="15" letter-spacing="6">ANATOMIE D'UNE BAVURE</text>
<path d="M90 74 q 60 4 120 1 t 122 -1" class="line" stroke-width="1.4"/>
<text x="790" y="62" class="sans muted" font-size="11" text-anchor="end" letter-spacing="2">buvard</text>
<!-- the sentence, segment by segment so the boxes align exactly -->
<g class="serif ink" font-size="21">
<text x="90" y="140" textLength="24" lengthAdjust="spacingAndGlyphs">«&#160;</text>
<text x="114" y="140" textLength="222" lengthAdjust="spacingAndGlyphs">Ce n'est pas un outil,</text>
<text x="336" y="140" textLength="205" lengthAdjust="spacingAndGlyphs">c'est un compagnon</text>
<text x="90" y="182" textLength="100" lengthAdjust="spacingAndGlyphs">de voyage</text>
<text x="196" y="182" textLength="26" lengthAdjust="spacingAndGlyphs">&#160;—&#160;</text>
<text x="228" y="182" textLength="92" lengthAdjust="spacingAndGlyphs">et il va</text>
<text x="326" y="182" textLength="200" lengthAdjust="spacingAndGlyphs">vous changer la vie</text>
<text x="532" y="182" textLength="52" lengthAdjust="spacingAndGlyphs">&#160;!&#160;»</text>
</g>
<!-- red-pencil boxes around the three hits -->
<rect x="108" y="118" width="234" height="33" rx="7" class="rouged" stroke-width="1.6" stroke-dasharray="1 0"/>
<rect x="191" y="160" width="36" height="33" rx="7" class="rouged" stroke-width="1.6"/>
<rect x="320" y="160" width="212" height="33" rx="7" class="rouged" stroke-width="1.6"/>
<!-- leader lines -->
<path d="M225 151 Q 200 205 150 236" class="line" stroke-width="1" stroke-dasharray="3 4"/>
<circle cx="150" cy="236" r="2.2" class="rouge" stroke="none"/>
<path d="M209 193 Q 250 240 310 284" class="line" stroke-width="1" stroke-dasharray="3 4"/>
<circle cx="310" cy="284" r="2.2" class="rouge" stroke="none"/>
<path d="M426 193 Q 480 240 533 296" class="line" stroke-width="1" stroke-dasharray="3 4"/>
<circle cx="533" cy="296" r="2.2" class="rouge" stroke="none"/>
<!-- the three verdicts -->
<g class="serif">
<text x="90" y="266" class="rouge" font-size="17" font-weight="bold">contraste binaire <tspan class="rouge">&#8722;8</tspan></text>
<text x="90" y="286" class="muted" font-size="12.5" font-style="italic">« pas X, c'est Y » — la bascule creuse</text>
<text x="320" y="300" class="rouge" font-size="17" font-weight="bold">tiret cadratin <tspan class="rouge">&#8722;5</tspan></text>
<text x="320" y="320" class="muted" font-size="12.5" font-style="italic">budget : un seul pour 500 mots</text>
<text x="545" y="312" class="rouge" font-size="17" font-weight="bold">servile <tspan class="rouge">&#8722;10</tspan></text>
<text x="545" y="332" class="muted" font-size="12.5" font-style="italic">la promesse d'émerveillement</text>
</g>
<!-- the gauge: 0–100, threshold at 80, ink fill to 77 -->
<g>
<text x="90" y="368" class="sans ink" font-size="12" letter-spacing="3">SCORE</text>
<line x1="90" y1="400" x2="790" y2="400" class="line" stroke-width="1.2"/>
<line x1="90" y1="400" x2="646" y2="400" class="line" stroke-width="7"/>
<!-- threshold tick at 80 : 90 + 0.80*700 = 650 -->
<line x1="650" y1="390" x2="650" y2="410" class="rouged" stroke-width="1.6"/>
<text x="650" y="426" class="rouge sans" font-size="10.5" text-anchor="middle" letter-spacing="1">SEUIL 80</text>
<text x="790" y="426" class="muted sans" font-size="10.5" text-anchor="end">100</text>
<text x="90" y="426" class="muted sans" font-size="10.5">0</text>
<text x="646" y="384" class="rouge serif" font-size="26" font-weight="bold" text-anchor="end">77</text>
<text x="676" y="368" class="muted serif" font-size="13" font-style="italic">réécrire, puis re-passer</text>
</g>
<text x="440" y="458" class="sans muted" font-size="10" text-anchor="middle" letter-spacing="2">HITS ARE REVIEW CANDIDATES, NEVER VERDICTS — THE AUTHOR'S VOICE ALWAYS WINS</text>
</svg>
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment