Skip to content Aller au contenu

Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Introduction

Conçu pour les lecteurs dont l'attention est sollicitée — TDAH, dyslexie, fatigue, langue seconde, ou contexte d'accessibilité.

lucid-lint lit votre Markdown ou texte brut et repère les passages qui alourdissent la lecture. Il ne réécrit pas votre voix. Il vous tend une liste courte, puis s’efface.

Avant

Le sous-système de cache, introduit lors d'un jalon antérieur, s'est révélé mal interagir avec la nouvelle chaîne de traitement des requêtes sous charge soutenue, et l'enquête qui a suivi a exigé plusieurs rondes de profilage.

Après

Le sous-système de cache a été introduit plus tôt. Il interagit mal avec la nouvelle chaîne de traitement des requêtes sous charge soutenue. L'enquête a exigé plusieurs rondes de profilage.

Trois idées, teintées de la même couleur à gauche et à droite — la réécriture raccourcit les phrases sans en perdre une seule. lucid-lint a signalé sentence-too-long (43 mots) et consecutive-long-sentences. Il n'a pas proposé la réécriture — elle est de vous.

Ce qui le distingue

La plupart des outils mesurent le style (write-good), la grammaire (Antidote) ou un score de lisibilité de surface (Flesch). lucid-lint mesure la charge cognitive — l’effort mental qu’un lecteur dépense pour comprendre une phrase. Il repère les motifs que la recherche de Sweller, Gibson, Graesser et Coh-Metrix ont isolés.

  • Bilingue EN/FR dès le premier jour, à qualité égale.
  • Déterministe par défaut. Une même entrée produit une même sortie. Les règles fondées sur un LLM vivent dans des extensions optionnelles.
  • Pensé pour l’intégration continue. Sorties texte et JSON ; codes de retour que pre-commit et GitHub Actions comprennent sans adaptateur.
  • Par profil. Choisissez dev-doc, public ou falc (Facile À Lire et à Comprendre), puis ajustez chaque règle si besoin.

État du projet

lucid-lint est en v0.2 (publiée le 2026-04-22). Les 25 règles listées dans RULES.md sont livrées (17 en v0.1, 8 ajoutées pendant le cycle v0.2), accompagnées du modèle de score hybride — un score global X / max et cinq sous-scores par catégorie, calculés au-dessus des diagnostics. Pré-1.0 : des changements de rupture restent possibles entre versions mineures. La feuille de route indique la suite.

Aperçu

Un fichier sans diagnostic obtient le score complet 100/100 et la bannière du logo — le moment fort d’une analyse réussie :

Capture terminal : une analyse lucid-lint sans diagnostic, avec la bannière du logo en trois parties, le message « No issues found. », et un bloc de score 100/100 — chaque barre de catégorie pleine

~~~~~ ⟨ • ⟩ ─────  lucid-lint  v0.2.0
                   cognitive accessibility linter · prose · EN / FR
                   ────────────────────────────────────────────────

No issues found.

────────────────────────────────────────────────────────────
score: 100/100
       structure    █████  20/20
       rhythm       █████  20/20
       lexicon      █████  20/20
       syntax       █████  20/20
       readability  █████  20/20
cargo install lucid-lint

# Analyser un fichier
lucid-lint check README.md

# Profil le plus strict (FALC)
lucid-lint check --profile=falc docs/

# Entrée standard
echo "Ceci est une phrase de test." | lucid-lint check -

# JSON pour la CI
lucid-lint check --format=json docs/

# Échouer la build si le score global passe sous 85/100 (v0.2+)
lucid-lint check --min-score=85 docs/

Pour aller plus loin

Préférences de lecture

Tout le site est conçu comme un compagnon de lecture. Choisissez la police qui vous convient le mieux — elle sera mémorisée entre les pages.

Atkinson Hyperlegible Next

Un paragraphe dense peut beaucoup demander à un esprit sollicité. Chaque virgule, chaque proposition, chaque parenthèse ajoute son coût. Une bonne prose maintient ce coût bas.

L'interligne et la taille du texte arriveront bientôt sous forme de curseurs. En attendant, choisissez une police et le zoom du navigateur est respecté.

Version anglaise

Licence

Double licence MIT ou Apache-2.0, à votre choix.