Skip to content
Projects
Groups
Snippets
Help
This project
Loading...
Sign in / Register
Toggle navigation
B
buvard
Overview
Overview
Details
Activity
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Issues
0
Issues
0
List
Board
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Charts
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
PLN
buvard
Commits
ea7d48e7
Commit
ea7d48e7
authored
Nov 11, 2026
by
PLN (Algolia)
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
docs: README section for buvard fix — the local-only loop, the guards, the two-liner
parent
19f0fc05
Show whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
26 additions
and
0 deletions
+26
-0
README.md
README.md
+26
-0
No files found.
README.md
View file @
ea7d48e7
...
@@ -98,6 +98,32 @@ catalog as an agent skill: load it, run the linter, apply the findings by hand.
...
@@ -98,6 +98,32 @@ 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.
## Fix — the loop with a local model
`buvard fix article.md`
closes the loop: it runs the linter, hands the flagged
excerpts — with each rule's one-line rationale — to a
**local**
language model,
then checks the suggestions before believing any of them.
-
**Local only.**
The endpoint is LM Studio's OpenAI-compatible server at
`http://127.0.0.1:1234/v1`
by default.
`BUVARD_FIX_URL`
points at another
local endpoint, and that is all: the text never leaves the machine.
-
**Dry run by default.**
You get the diff, a per-suggestion table (applied /
KEEP / dropped, with the reason) and before/after scores. Nothing is written
until
`--write`
, and
`--json`
gives the whole structured result.
-
**The guards outrank the model.**
A suggestion that alters a number or a
name is dropped. A suggestion whose excerpt does not match the text exactly
once is dropped. A suggestion the linter cannot confirm — score up, or hits
down — is dropped. KEEP is always honored: the voice wins.
-
**Three rounds maximum.**
Each round feeds the remaining flags back; the
loop stops as soon as a round stops improving the score.
Setup, two lines:
```
LM Studio → Developer → Start Server # serves http://127.0.0.1:1234
buvard fix article.md # BUVARD_FIX_MODEL picks the model
```
## Science and references
## Science and references
The catalog is data with provenance, and the barème is a ratified decision —
The catalog is data with provenance, and the barème is a ratified decision —
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment