claude-code-my-workflow : périmètre, usage et limites
Aperçu du projet : Un modèle Claude Code prêt à l'emploi pour les universitaires utilisant LaTeX/Beamer + R. Examen multi-agents, contrôles de qualité, assurance qualité contradictoire et protocoles de réplication.
En bref
- De quoi s’agit-il ?
- Analyse du dépôt pedrohcgs/claude-code-my-workflow, de son parcours documenté et des vérifications propres à son usage.
- À qui s’adresse-t-il ?
- claude-code-my-workflow s’adresse aux personnes dont le besoin correspond au périmètre décrit par pedrohcgs/claude-code-my-workflow. Il convient moins à une intégration qui exige des garanties absentes du README.
- Puis-je l’utiliser commercialement ?
- Oui. MIT est une licence permissive : vous pouvez utiliser, modifier et vendre un logiciel qui en dépend, à condition de conserver les mentions de droit d’auteur et de licence.
- Est-il encore maintenu ?
- Oui. Les derniers commits datent d’il y a 22 jours.
- En quel langage est-il écrit ?
- Principalement HTML, d’après les statistiques de langage de GitHub.
Ces réponses reposent sur les données GitHub du projet (dernière synchronisation le 15 septembre 2026) et sur notre analyse. Elles ne constituent pas un avis juridique.
ANALYSE OPEN SOURCE APPROFONDIE
claude-code-my-workflow : Périmètre déclaré par le dépôt
Le dépôt est un point de départ forkable pour utiliser Claude Code dans le travail académique. Selon le README, il couvre les diapositives de cours, les articles de recherche, l'analyse de données et les packages de réplication. Vous décrivez un objectif, et Claude planifie l'approche, exécute des agents spécialisés, corrige les problèmes, vérifie la qualité et présente les résultats. Le projet a été extrait d'un cours de doctorat en production (Econ 730 : Données de panel causales à l'Université Emory) et est étendu par une communauté d'utilisateurs fork. Le README liste 18 agents, 52 compétences, 32 règles et 7 hooks comme inventaire actuel, mais ces chiffres sont présentés comme un détail dépliable.
Pour pedrohcgs/claude-code-my-workflow, la description du README fixe un périmètre précis : A ready-to-fork Claude Code template for academics using LaTeX/Beamer + R. Multi-agent review, quality gates, adversarial QA, and replication protocols.. Cette formulation explique à qui le dépôt peut servir, mais elle ne transforme pas une déclaration en garantie de performance, de compatibilité ou de support. Les métadonnées du dépôt donnent un contexte utile, sans remplacer l’examen des fichiers réellement livrés.
claude-code-my-workflow : Le parcours décrit dans le README
Le changement v2.0 décrit dans le README consiste à passer de la création d'un prompt parfait à l'énoncé d'un objectif et à laisser la boucle de travail s'en approcher sous des portes. Des agents spécialisés font le travail, des portes imposent quand c'est assez bon, et l'utilisateur tranche les désaccords qu'elles soulèvent. Trois mécanismes rendent cela concret : un hook pre-commit versionné qui exécute la synchronisation de surface et les contrôles de qualité à chaque commit, un runtime d'orchestration qui fan-out vers des agents forkés et réduit les constats via un schéma partagé avec une porte anti-hallucination, et un processus qui enregistre les explications alternatives défendables comme EXPLAINED tandis que les vraies erreurs restent en échec. Le README note que ce n'est pas un démon autonome ; la boucle est toujours initiée par l'utilisateur ou une compétence.
Le parcours pertinent commence par le modèle de workflow académique Claude Code. Lisez la section d’installation et relevez les versions, variables, arguments et services explicitement nommés. Une équipe peut alors comparer son environnement avec celui décrit par pedrohcgs/claude-code-my-workflow. Les étapes absentes de la documentation restent indéterminées ; il serait imprudent de compléter ces lacunes avec une hypothèse tirée d’un outil voisin.
claude-code-my-workflow : Fichiers, dépendances et interfaces
Le README énumère 18 agents spécialisés, chacun vérifiant une dimension : proofreader pour la grammaire, slide-auditor pour la mise en page visuelle, pedagogy-reviewer pour la qualité d'enseignement, r-reviewer pour le code R, domain-reviewer comme modèle spécifique au domaine, plus un pipeline de revue par les pairs avec domain-referee, methods-referee et editor. Il liste également 52 compétences, dont /compile-latex, /deploy, /qa-quarto, /review-paper, /data-analysis, /verify-claims, /humanize, /simulation-study et /r-package-check, entre autres. Les règles sont divisées en règles toujours actives chargées à chaque session et règles limitées par chemin qui se déclenchent sur les types de fichiers correspondants, comme verification-protocol pour les fichiers .tex et .qmd, et r-code-conventions pour les fichiers .R. Le README souligne que la portée par chemin maintient la charge toujours active à environ 100 lignes.
L’entrée technique à examiner est les fichiers LaTeX, Beamer et R du template. Ouvrez les fichiers associés, suivez l’exemple fourni et conservez les messages affichés. Cette lecture permet de distinguer une fonction exposée par l’interface d’une capacité seulement évoquée dans le texte. Elle donne aussi un point de départ pour repérer les dépendances, les formats acceptés et les erreurs que le projet laisse à la charge de l’utilisateur.
claude-code-my-workflow : Ce que le projet permet réellement d’observer
La qualité est notée sur une échelle de 0 à 100 avec trois seuils documentés : 80 pour les commits, 90 pour les pull requests et 95 comme niveau d'excellence aspirational. Le README décrit plusieurs couches de vérification : /verify-claims utilise un vérificateur forké qui n'a pas vu le brouillon, avec des niveaux de gravité et une porte HIGH-WARN qui bloque /commit pour les citations fabriquées ; /audit-reproducibility recoupe les affirmations numériques avec la sortie de script et maintient un fichier d'état passport.yaml ; /humanize détecte les marqueurs de voix IA en lecture seule ; et /review-paper --variance N rapporte une distribution de décision plutôt qu'un résultat unique. Le hook pre-commit installé via ./scripts/install-hooks.sh exécute les contrôles de synchronisation de surface et de qualité (>=80) à chaque commit, avec SKIP_QUALITY_GATE=1 ou git commit --no-verify comme options de retrait par commit.
Le résultat observable est les rapports des agents et les portes de qualité. Comparez un cas nominal avec une entrée minimale ou volontairement incorrecte, puis notez le fichier produit, le statut de sortie et le journal associé. Pour pedrohcgs/claude-code-my-workflow, cette comparaison est plus informative qu’une affirmation générale sur la qualité du code : elle montre si le chemin documenté correspond au besoin concret et si les limites apparaissent clairement.
claude-code-my-workflow : Limites de maintenance et d’intégration
Les exigences minimales pour forker le modèle sont Claude Code, git et Python 3, préinstallé sur macOS et Linux. Pour exécuter les démos HelloWorld incluses de bout en bout, vous avez également besoin de XeLaTeX pour l'exemple Beamer et de Quarto pour l'exemple Quarto. R et le CLI GitHub sont recommandés, et pdf2svg est nécessaire pour l'extraction TikZ vers SVG. Le démarrage rapide implique de forker le dépôt, de le cloner et d'exécuter ./scripts/validate-setup.sh, qui signale les outils manquants avec des liens d'installation. Ensuite, vous démarrez Claude Code et collez un prompt de démarrage qui lui demande de lire les fichiers de configuration et de les adapter à votre projet. Le README note que vous pouvez sauter les démos LaTeX et Quarto si vous n'avez besoin que de Python, R ou markdown, car les agents, règles et compétences fonctionnent pour tout artefact texte ou code.
L’intégration de pedrohcgs/claude-code-my-workflow dépend de contraintes que le README ne couvre pas toujours : versions de dépendances, système d’exploitation, ressources, authentification, formats d’échange et comportement en cas d’échec. La licence indiquée dans les métadonnées doit aussi être lue avec le fichier LICENSE avant redistribution. Elle fixe des obligations juridiques, sans fournir une garantie de sécurité ni une équipe de support.
claude-code-my-workflow : Vérification ciblée avant usage
Le README liste sept étapes de personnalisation : remplir le modèle de base de connaissances avec votre notation et vos applications, personnaliser l'agent domain-reviewer avec des lentilles spécifiques au domaine, mettre à jour la palette de couleurs à la fois dans Preambles/header.tex et Quarto/theme-template.scss et exécuter check-palette-sync.sh pour vérifier la concordance, ajouter des pièges R spécifiques au domaine dans r-code-conventions.md, remplir la correspondance de cours dans beamer-quarto-sync.md, personnaliser la référence rapide du workflow et configurer le dossier explorations/ pour le travail expérimental. La synchronisation de palette est décrite comme un contrat à deux surfaces, car oublier une surface produit des rendus Beamer et Quarto incompatibles.
Avant de retenir pedrohcgs/claude-code-my-workflow, exécutez le scénario propre au dépôt décrit dans le README, avec les fichiers LaTeX, Beamer et R du template. Fixez la version et l’environnement, contrôlez les rapports des agents et les portes de qualité, puis répétez avec une entrée qui exerce la limite la plus visible dans la documentation. Conservez la commande, la sortie et l’erreur : ces éléments permettent de décider pour ce projet précis, sans attribuer au dépôt une promesse qu’il ne formule pas.
Conclusion éditoriale
claude-code-my-workflow s’adresse aux personnes dont le besoin correspond au périmètre décrit par pedrohcgs/claude-code-my-workflow. Il convient moins à une intégration qui exige des garanties absentes du README. Commencez par les fichiers LaTeX, Beamer et R du template, contrôlez les rapports des agents et les portes de qualité, puis examinez les erreurs et les dépendances avant d’utiliser des données réelles.
Notes de la communauté