Scriptorium
MariusYvard/Scriptorium
Orquestra redação rigorosa com scripts determinísticos e charte gráfica obrigatória
Ver no GitHubPlugin de engenharia textual que transforma pedidos de redação em documentos estruturados e verificáveis. Combina julgamento do modelo com 18 scripts determinísticos para aplicar rigor, estilo e conformidade a 25 gêneros de conteúdo, cobrindo ciclo completo de enquadramento, produção, controle e entrega em múltiplos formatos (Word, PDF, HTML, PowerPoint).
Instalação
npx convez-ai MariusYvard/Scriptorium1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Produção de documentos técnicos e relatórios com verificação de fontes
- Geração de 25 gêneros textuais com estilo corporativo consistente
- Redação colaborativa com controle de qualidade adversarial e auditorias de coerência
Veredito

Ferramenta robusta para equipes que exigem documentos verificáveis com alta conformidade. Deslocar a rigurosidade do modelo para código é abordagem sólida, mas demanda curva de aprendizado significativa com suas 4 competências e 18+ scripts específicos.
README
A tradução para o português deste README ainda está na fila.
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
flowchart LR
A["<b>atelier</b><br/>piloter · cadrer · projet"] --> P["<b>produire</b><br/>genre · sourcer · figure · tableau<br/>equation · style · charte · image"]
P --> C["<b>controler</b><br/>revue · contredire · consensus<br/>humaniser · audit · relecteurs"]
C --> L["<b>livrer</b><br/>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, puis l'installer.
- Cowork : ouvrir le fichier
.pluginet accepter l'installation. - Claude Code :
/plugin marketplace add MariusYvard/Scriptorium, puis installer le pluginscriptorium.
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. 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 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 et CHANGELOG.md.
Licence
MIT. Voir LICENSE.