Aller au contenu
roomi fields

Outils pour travailler avec des agents IA

paper-trail

Greffon Claude Code qui fait acquérir et lire les sources avant d'écrire une revue de littérature, puis contrôle chaque citation contre le texte de la source.

actif version v0.4.0, 3 septembre 2026 dernière modification 3 septembre 2026 licence MIT

Code source

Les citations inventées, attributions inversées et auteurs confondus naissent quand on écrit de mémoire et qu’on cherche la source après ; paper-trail impose l’ordre inverse, de la source au texte. Sa limite principale : il vérifie qu’une référence existe, que le PDF obtenu est le bon et qu’une citation se retrouve dans la source ; il ne dit pas si le raisonnement est juste, et une source qu’aucune voie n’atteint reste « non vérifiable ».

Pas de démo jouable : le greffon travaille sur un coffre de recherche local.

Un registre avec un guichet

Chaque référence est un fichier YAML dans un registre, lisible dans Obsidian. Elle franchit des états dans un ordre fixe : candidate, identifiant résolu, PDF acquis, page 1 validée, citée et confirmée. D’autres états couvrent l’attente d’une reconnaissance de texte, la réacquisition et le retrait.

Une revue de littérature ne cite que des références arrivées à « page 1 validée ». La validation compare la première page du PDF à l’auteur, au titre et aux mots-clés du domaine attendus : c’est la garde contre l’homonyme, le bon titre d’un autre auteur. Les candidats écartés sont listés avec leur motif.

Commencer

Dans Claude Code, par le catalogue roomi-fields/claude-plugins :

/plugin marketplace add roomi-fields/claude-plugins
/plugin install paper-trail@roomi-fields

Le greffon refuse de démarrer sans coffre. Déclarez-le une fois pour tous les projets :

mkdir -p ~/.config/paper-trail
cat > ~/.config/paper-trail/env <<'EOF'
RESEARCH_VAULT_PATH=~/Documents/MyResearch
RESEARCH_CONTACT_EMAIL=you@example.org
EOF
chmod 600 ~/.config/paper-trail/env

La recherche bibliographique passe par le serveur MCP paper-search, à installer depuis son dépôt git (voir INSTALL.md). python3 -m pipeline preflight vérifie l’installation et donne la commande qui corrige chaque manque. Puis :

/paper-trail:status
/paper-trail:new-sota "votre sujet"
/paper-trail:audit-article chemin/article.tex

Ce qu’il fait

  • Chercher sur 22 plateformes par paper-search ; vous choisissez les candidats.
  • Acquérir le PDF par une cascade de 10 sources ouvertes : l’adresse fournie, Crossref, arXiv, OpenAlex, Unpaywall, HAL, CORE, la page de l’éditeur suivie depuis le DOI, archive.org, puis une file de recherche web. Avec Playwright et un écran, des voies par navigateur montent à 13 sources.
  • Écrire en dernier : le greffon refuse de rédiger quand le corpus lu est trop mince.
  • Auditer une revue ou un article : chaque citation est classée valide, à ajuster, invalide ou non vérifiable, dans RECEIPTS.md. --purge retire les citations fautives d’une revue (avec sauvegarde) ; --warn insère un avertissement à côté dans l’article.
  • Contrôler le registre : 19 invariants, et /paper-trail:doctor --fix répare les écarts sans risque.
  • S’adapter au coffre : Obsidian, dossier Markdown simple ou Zotero. NotebookLM et RTFM sont des compléments optionnels.

Des sources étendues, jusqu’à 17, dont des bibliothèques fantômes, sont désactivées par défaut. Elles ne s’activent que par un choix explicite, session par session ; leur légalité relève de l’utilisateur (DISCLAIMER.md).

Où il en est

La première version date du 25 mai 2026 ; l’historique est dans le journal des versions du dépôt. Pas d’intégration continue sur GitHub. La structure peut encore changer d’une version mineure à l’autre avant la 1.0. paper-search doit s’installer depuis git : la version publiée sur PyPI n’expose qu’une partie des outils.

Dépôt · NotebookLM · RTFM

Le greffon reprend des motifs et des composants d’autres projets de l’écosystème Claude Code, crédités dans NOTICE.md.

Fabrication. Claude Code (Claude Opus 5.5), à partir du dépôt, de son README et de ses notes de version. Méthode

Tickets ouverts