C'EST QUOI ?
notabene est un outil de collaboration documentaire qui combine un générateur de site statique et un système de commentaires ancrés directement sur la page rendue. On sélectionne un passage, on laisse une note, puis l'agent IA (Claude Code en tête, via le plugin fourni) lit le dossier .notabene/, applique les modifications dans les sources, résout les fils de discussion et journalise chaque changement. Pas de SaaS, pas de base de données : tout est stocké en JSON dans le dépôt git.
POURQUOI C'EST INTÉRESSANT ?
- Le commentaire est l'instruction : ancré sur le passage exact, il est localisé et sans ambiguïté. Plus besoin de citer le texte concerné ni de rédiger un prompt à côté, l'agent sait précisément quoi modifier et où.
- Protocole file-I/O : l'agent lit et écrit des fichiers, rien d'autre. Pas de serveur à lancer, pas de MCP à configurer. Un plugin Claude Code avec skill intégrée est fourni, mais n'importe quel agent capable de manipuler des fichiers fait l'affaire.
- Boucle de revue auditable : un mode en deux phases permet de valider les diffs avant application, et chaque intervention génère une entrée de journal documentant ce qui a changé et pourquoi. L'historique complet est consultable sur
/journal. - Générateur complet : MDX et CommonMark/GFM, documentation multi-langue avec commentaires par langue, recherche full-text via Pagefind, diagrammes Mermaid avec lightbox, export PDF avec signets et sommaires cliquables.
- Git-natif et auto-hébergé : commentaires, résolutions et journal sont versionnés avec le code. Le build statique en lecture seule se publie sur GitHub Pages avec le workflow inclus.
CAS D'USAGE
- Boucle d'amélioration continue des docs : on annote sur la page rendue, l'agent corrige les sources
- Documentation de projet open source avec piste d'audit complète des évolutions
- Docs multilingues avec retours et corrections localisés par langue
- Relecture distribuée en équipe : chacun commente, un agent centralise les modifications
- Publication GitHub Pages avec export PDF pour les livrables clients