Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/mariusyvard/scriptorium

Atelier de redaction de haut niveau : six genres, moteur unifie, scripts deterministes, scorecard 0-100, charte graphique, style maison strict
https://github.com/mariusyvard/scriptorium

academic-writing ai-writing bibtex citations claude-code claude-code-plugin claude-plugin cowork editorial french imrad literature-review markdown python report-generation scientific-writing strategic-analysis technical-writing writing

Last synced: 1 day ago
JSON representation

Atelier de redaction de haut niveau : six genres, moteur unifie, scripts deterministes, scorecard 0-100, charte graphique, style maison strict

Awesome Lists containing this project

README 

          


  Scriptorium






  evals

  release

  version 0.6.2

  licence MIT

  python stdlib pur

  24 genres sourcés




Décrivez la cible. Scriptorium cadre, source, rédige, révise et met en forme un document rigoureux, sous le contrôle de garde-fous déterministes.



Scriptorium est un plugin Claude (Cowork et Claude Code) qui transforme une demande de rédaction en document fini. Il applique une méthodologie d'ingénierie textuelle, déplace la rigueur vérifiable du jugement du modèle vers dix-huit scripts déterministes, et impose un style maison à directives strictes. Quatre compétences couvrent le cycle de vie complet, du cadrage à la livraison, sur vingt-cinq genres adossés chacun à des sources faisant autorité.



## Comment ça marche



```mermaid

flowchart LR

  A["atelier
piloter · cadrer · projet"] --> P["produire
genre · sourcer · figure · tableau
equation · style · charte · image"]

  P --> C["controler
revue · contredire · consensus
humaniser · audit · relecteurs"]

  C --> L["livrer
document · decliner"]

  L --> O(["Word · PDF · HTML · PowerPoint"])

```



Deux moteurs travaillent ensemble. Le modèle tranche le jugement : rédiger, classer, résumer, décrire une image, formuler une contre-thèse. Le code tranche le mécanique et le reproductible : détecter un tiret cadratin, nettoyer une URL, noter un document sur cent, lire les dimensions d'une image. Une affirmation majeure sans preuve cartographiée est affaiblie ou retirée, c'est une contrainte dure et non une préférence.



## Installation



Télécharger `scriptorium-0.6.7.plugin` depuis la [page des releases](https://github.com/MariusYvard/Scriptorium/releases), puis l'installer.



- Cowork : ouvrir le fichier `.plugin` et accepter l'installation.

- Claude Code : `/plugin marketplace add MariusYvard/Scriptorium`, puis installer le plugin `scriptorium`.



Les compétences apparaissent sous le préfixe `scriptorium:`. Les scripts et le harnais d'évaluation tournent en Python sans dépendance (`python3 evals/run-evals.py`).



## Les quatre compétences



| Compétence | Sous-commandes | Rôle |

| --- | --- | --- |

| `atelier` | piloter · cadrer · projet | Point d'entrée. Orchestre la production de A à Z, cadre le sujet, garde le contexte du projet entre les sessions. |

| `produire` | genre · sourcer · revue-litterature · figure · tableau · equation · style · charte · image | Produit le contenu et fixe la forme. Rédige les vingt-cinq genres, trouve et vérifie les sources, génère figures et tableaux, pose les équations, applique style et charte, extrait les images d'un document source. |

| `controler` | revue · contredire · consensus · humaniser · audit · relecteurs | Éprouve un écrit. Revue adversariale, contradiction par le modèle de Toulmin, vote de consensus, détection d'empreinte IA, audit d'un document existant, réponse aux relecteurs. |

| `livrer` | document · decliner | Met en forme le livrable (Word, PDF, HTML) et le décline par canal (présentation, résumé, abstract, post, communiqué). |



Chaque sous-commande charge à la demande son fichier de référence, le contexte reste léger. Décrire la cible suffit à déclencher la bonne action ; il est aussi possible de nommer l'action, par exemple `produire figure`.



## En une demande



> « Rédige une analyse stratégique de 20 pages sur le marché X pour mon comité de direction, avec un SWOT et un PESTEL. »



`atelier` enchaîne le cadrage (problématique fermée, plan validé), le sourcing (sources pondérées, carte preuve-affirmation), la rédaction déléguée section par section à l'agent `redacteur`, les figures SWOT et PESTEL produites en SVG, la revue adversariale, puis la mise en forme à la charte. Trois points de contrôle reviennent vers vous : le périmètre, la suffisance des preuves, le verdict de révision.



## Garde-fous déterministes



Dix-huit scripts en Python pur déplacent la rigueur du jugement du modèle vers un contrôle mécanique et reproductible. Une porte d'intégration continue (`tools/check.py`) verrouille un document contre un seuil de note.



| Script | Ce qu'il attrape |

| --- | --- |

| `lint-style.py` | Tiret cadratin, typographie courbe, lexique promotionnel, virgule d'Oxford, métadiscours, paramètres de suivi. |

| `verify-sources.py` | URL à nettoyer, doublons, DOI douteux. |

| `scorecard.py` | Note déterministe de 0 à 100 sur cinq axes, calcul montré, verdict. |

| `traceability.py` | Références orphelines ou pendantes, appels de figures et de tableaux. |

| `ai-fingerprint.py` | Rythme uniforme, ouvertures répétées, cadence ternaire, connecteurs suremployés. |

| `numbers.py` | Pourcentages impossibles, partitions qui ne somment pas, séparateur décimal mixte. |

| `theme.py` | Validation de charte, contraste WCAG, émission du CSS du HTML. |

| `images.py` | Extraction d'images (Office, PDF), déduplication, dimensions, manifeste. |



Le catalogue complet est dans [`scripts/README.md`](scripts/README.md). Un hook lance le linter après chaque écriture et bloque la finalisation tant qu'un écart critique subsiste.



## Vingt-cinq genres sourcés



Chaque genre est adossé à des sources faisant autorité, citées dans son playbook (`skills/produire/references/genre-*.md`).



- Académique et recherche : rapport scientifique et mémoire (IMRAD), article, revue de littérature (PRISMA), demande de financement et proposition de recherche, dissertation et commentaire.

- Entreprise et conseil : long rapport décisionnel, analyse stratégique (SWOT, PESTEL, 5 forces, Mactor), prospective, étude de cas, business plan, étude de marché, proposition commerciale et réponse à appel d'offres.

- Technique : cahier des charges et spécification (IEEE 29148), documentation technique (Diátaxis), rapport d'incident et post-mortem.

- Finance : note d'analyse financière et mémo d'investissement.

- Public et droit : note de politique publique, rapport d'évaluation (critères OCDE/CAD), note et consultation juridique (IRAC), conclusions et mémoire contentieux, rédaction de contrat.

- Santé : cas clinique et protocole de recherche (CARE, CONSORT, STROBE, PRISMA).

- Communication : livre blanc, discours et allocution, présentation (soutenance), pitch (commercial et levée de fonds).



## Quatorze publics



| Public | Genres de prédilection |

| --- | --- |

| Chercheur | Rapport scientifique IMRAD, article, revue de littérature, demande de financement. |

| Ingénieur | Cahier des charges, documentation technique, post-mortem, étude de cas. |

| Analyste géopolitique | Analyse stratégique (Mactor, PESTEL), prospective, note de politique publique. |

| Juriste | Note et consultation juridique (IRAC), conclusions contentieuses, contrat. |

| Professionnel de santé | Cas clinique, protocole de recherche (CARE, CONSORT, STROBE). |

| Consultant et dirigeant | Long rapport décisionnel, analyse stratégique, business plan. |

| Communicant et marketing | Livre blanc, article, présentation, étude de marché. |

| Étudiant | Dissertation et commentaire, mémoire, présentation de soutenance. |

| Analyste financier | Note d'analyse financière, mémo d'investissement. |

| Entrepreneur | Business plan, étude de marché, proposition commerciale, pitch. |

| Enseignant | Support de cours, dissertation, présentation. |

| Chef de projet | Cahier des charges, proposition commerciale, rapport d'évaluation. |

| Agent public | Note de politique publique, rapport d'évaluation. |

| Journaliste | Article, enquête, tribune. |



La méthode et le style maison ne changent pas, seuls le genre et les exemples s'adaptent au domaine. Les profils de discipline (voir `controler` consensus) calibrent la norme de citation et le seuil d'exigence.



## Formats de sortie



Le format de travail est le Markdown. La finalisation produit un document Word (`.docx`), un PDF, un HTML autonome dont le CSS dérive de la charte graphique (jetons, focus visible, feuille d'impression, source idéale pour un PDF fidèle), ou une présentation PowerPoint. Les figures sortent en SVG, les tableaux en Markdown, les équations en PDF via LaTeX, et les images d'un document source sont extraites puis replacées, numérotées et à la charte.



## Style maison



Le style par défaut applique des directives strictes : registre encyclopédique et neutre, zéro tiret cadratin, pas de virgule d'Oxford, guillemets et apostrophes droits, lexique promotionnel banni, faits précis ou rien, sources vérifiées sans paramètres de suivi. Il vit dans [`skills/produire/references/directives-strictes.md`](skills/produire/references/directives-strictes.md) et le linter applique les mêmes règles. La compétence `produire` (style) peut régénérer une charte à partir de vos écrits.



## Agents délégués



Le travail lourd est confié à cinq agents lancés via l'outil Task : `redacteur` (rédaction long-format), `controle-qualite` (validation structurée), `synthese-sources` (recherche et triangulation), `contradicteur` (contre-thèse), `verificateur-faits` (vérification factuelle).



## Évaluations et release



`evals/run-evals.py` relie des cas piégés à des attentes précises et vérifie que les garde-fous attrapent ce qu'ils doivent, et que chaque playbook de genre porte une section Sources. La publication est automatisée : un tag `vX.Y.Z` déclenche la vérification des versions, les evals, la construction du `.plugin` et la création de la Release. Voir [`docs/RELEASE.md`](docs/RELEASE.md) et [`CHANGELOG.md`](CHANGELOG.md).



## Licence



MIT. Voir [`LICENSE`](LICENSE).